Official Discourse Advertising Plugin. Install & Start Serving Ads on Your Discourse Forum

adsense advertising amazon-affiliates discourse-plugin double-click google-ad-manager

Go to file

Sarah Ni 6d93faf871 Successful mobile slots - default to 320*50		2015-08-28 15:34:14 +10:00
assets	Successful mobile slots - default to 320*50	2015-08-28 15:34:14 +10:00
auto_generated	Successfully merge with bug in cmd push	2015-08-25 14:30:23 +10:00
config	Added custom targeting to all slots and Sebastian fixed the variable issue in adsense - thanks Seb!	2015-08-28 12:21:40 +10:00
.DS_Store	Working ads however, on change url dfp plain ad not displaying	2015-08-25 15:53:22 +10:00
README.md	Update README.md	2015-08-10 09:28:19 +10:00
plugin.rb	Successfully merge with bug in cmd push	2015-08-25 14:30:23 +10:00

README.md

Discourse-Adplugin

Ad plugin for Discourse forum.

Installation

Supported Discourse version: v1.4

Special Installation Instructions for RGSoC Coaches

You would have already gotten the discourse to load locally. If not, do that first. You can find instructions here.
Then clone this repo in a new local folder.
In the terminal, go into your discourse folder and then into plugins. Example cd ~/code/discourse/plugins
Create a symlink in this folder and do that by doing:

ln -s ~/whereever_your_cloned_ad_plugin_path_is .

For example: ln -s ~/discourse-plugin-test .

Now you are done. See 'Usage' heading for sample ad codes that you can input.

Non-docker installation

Run bundle exec rake plugin:install repo=http://github.com/team-melbourne-rgsoc2015/discourse-adplugin in your discourse directory
In development mode, run bundle exec rake assets:clean
In production, recompile your assets: bundle exec rake assets:precompile
Restart Discourse

Docker installation

As seen in a how-to on meta.discourse.org, simply add the plugin's repo url to your container's app.yml file:

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - mkdir -p plugins
          - git clone https://github.com/team-melbourne-rgsoc2015/discourse-adplugin.git

Rebuild the container

cd /var/docker
git pull
./launcher rebuild app

Usage

Go to Admin > Settings > Ad Plugin
Add DFP link into code boxes, input width and height based on Google Ad Ad units. Here are some sample ad codes that you can put in the input into the settings. But remember: ⋅⋅* Each slot requires a different sample ad code. That means, you cannot put the same ad sample ad codes multiple times in different slots. They won't appear.
⋅⋅* Don't click on the ad.
⋅⋅* On the last stroke of midnight, the magic will wear off. Make sure you leave the ball before then.

Please test both plugins individually - don't symlink both together, instead test them in isolation.

Input 3 parts - ad code (topmost box), width, height. And be sure to untick the disable box. Then, refresh the page for the inputs to take effect, and go to the ad location.

Usually google sizes to input are (widthheight) 300250 or 728*90 (best) respectively. Input your dfp ad code.

The namings in settings are with reference to the plugin outlets created by Discourse.

dfp_topic_list_top_code: ad will appear at the header of Discourse homepage

dfp_topic_above_post_stream_code: ad will appear at the header of all Discourse forum topics

dfp_topic_above_suggested_code: ad will appear at the footer above suggested topics of all Discourse forum topics

dfp_post_bottom_code: ad will appear on the Nth post (be sure to input N in the bottom-most box called

dfp_nth_post_code and ensure your total number of posts in topic >=N. For example, if you input N = 4, the forum should have at least 4 replies/posts)