whatisgithub

What is discourse-adplugin?

discourse/discourse-adplugin — explained in plain English

Analysis updated 2026-07-25 · repo last pushed 2025-07-22

135JavaScriptAudience · ops devopsComplexity · 2/5StaleSetup · easy

In one sentence

A Discourse plugin that lets forum owners show ads from networks like Google AdSense and Amazon, or create their own custom ads, with control over where ads appear and who sees them.

Mindmap

mindmap
  root((repo))
    What it does
      Shows ads on forums
      Connects ad networks
      House Ads feature
    Supported platforms
      Google AdSense
      DoubleClick
      Amazon Affiliates
      Carbon Ads and AdButler
    Ad placements
      Top of homepage
      Above topic content
      Between posts
      Above suggested topics
    Audience controls
      Trust level filtering
      Exempt groups
      Exempt categories
    Audience
      Forum operators
      Community managers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Monetize a Discourse forum by showing Google AdSense ads to logged-out visitors.

USE CASE 2

Create custom House Ads to promote your own content or sell private ad space.

USE CASE 3

Show ads only to casual visitors while rewarding trusted members with an ad-free experience.

USE CASE 4

Place ads between specific posts in a thread using DoubleClick or AdButler.

What is it built with?

JavaScriptDiscourse PluginHTML

How does it compare?

discourse/discourse-adpluginangieruiz17/codex-gpt-pluginmatchameleon/moneyclaw
Stars135135135
LanguageJavaScriptJavaScriptJavaScript
Last pushed2025-07-22
MaintenanceStale
Setup difficultyeasyhardmoderate
Complexity2/54/53/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Now bundled into Discourse core by default, so no separate installation is needed for current versions.

No license information is provided in the explanation.

So what is it?

The Discourse Ad Plugin lets forum owners display advertisements on their Discourse forums. If you run a community on Discourse and want to earn revenue by showing ads, this plugin connects your forum to major advertising platforms so you can start serving ads without needing custom development work. It supports several ad platforms including Google AdSense, Google DoubleClick for Publishers, Amazon Affiliates, Carbon Ads, and AdButler. There is also a "House Ads" feature that lets you create and serve your own ads directly from Discourse, which is useful if you want to promote your own content or sell ad space privately rather than using an external ad network. You write the ad as HTML, style it with your forum's theme, and assign it to display slots. Once installed, you choose where ads appear on your forum. Available placements include the top of the homepage, above topic content, above suggested topics, and between specific posts in a thread. You can also control who sees ads using Discourse's trust level system, for example, showing ads only to logged-out visitors while hiding them from trusted community members. You can further exempt specific groups, categories, tags, or personal messages from showing ads, which gives you fine-grained control over the experience. This would appeal to any forum operator looking to monetize their community. A hobby forum might use House Ads to cross-promote a related project, while a larger community might plug in AdSense or DoubleClick to generate ongoing ad revenue. The trust level controls are particularly practical, you can reward your most engaged members with an ad-free experience while still earning from casual visitors. One important note: the README states that this plugin has now been bundled into Discourse core, meaning it ships with Discourse by default rather than requiring a separate install. The standalone plugin still exists for reference and for older setups.

Copy-paste prompts

Prompt 1
I run a Discourse forum and want to show Google AdSense ads only to logged-out visitors while hiding them from trusted members. How do I configure the Discourse Ad Plugin trust level settings to do this?
Prompt 2
Help me create a House Ad in HTML for my Discourse forum that promotes a new sister community, and style it to match my forum's existing theme.
Prompt 3
How do I use the Discourse Ad Plugin to place ads between specific posts in a thread and exempt certain categories like our premium support section?
Prompt 4
I want to sell private ad space on my Discourse forum using House Ads instead of an external network. Walk me through setting up the ad slots and assigning my HTML ad to display above topic content.

Frequently asked questions

What is discourse-adplugin?

A Discourse plugin that lets forum owners show ads from networks like Google AdSense and Amazon, or create their own custom ads, with control over where ads appear and who sees them.

What language is discourse-adplugin written in?

Mainly JavaScript. The stack also includes JavaScript, Discourse Plugin, HTML.

Is discourse-adplugin actively maintained?

Stale — no commits in 1-2 years (last push 2025-07-22).

What license does discourse-adplugin use?

No license information is provided in the explanation.

How hard is discourse-adplugin to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is discourse-adplugin for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.