From a0ab6a607b992f72dacd39c904e7558b945ff119 Mon Sep 17 00:00:00 2001 From: ladydanger Date: Fri, 4 Sep 2015 11:26:37 +1000 Subject: [PATCH 01/13] Corrected sizes corrected sizes on table --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 15095fa..39cde92 100644 --- a/README.md +++ b/README.md @@ -143,11 +143,11 @@ This plugin supports the following ad sizes for the following locations. All locations except post bottom | Post bottom location | Mobile --- | --- | --- 728 x 90 | 728 x 90 | 320 x 50 -336 x 280 | 960 x 90 | -300 x 250 | 468 x 60 | -960 x 90 | 234 x 60 | -468 x 60 | | -234 x 60 | | +336 x 280 | 336 x 280 | +300 x 250 | 300 x 250 | +970 x 90 | 970 x 90 | +468 x 60 | 468 x 60 | +234 x 60 | 234 x 60 | 125 x 125 | | 180 x 150 | | 200 x 200 | | From 4a4c9728138630d6812a634d09d2ae8c903cc20e Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 10:14:20 +1000 Subject: [PATCH 02/13] added images to the readme and features --- README.md | 31 ++++++++++++++++++++++++++++--- 1 file changed, 28 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 39cde92..91f836d 100644 --- a/README.md +++ b/README.md @@ -53,12 +53,37 @@ There are 2 easy steps for configuring your Discourse settings to enable adverti * Choose your advertisement platform by clicking on "Adsense Plugin" if using Adsense as your advertisement platform and/or click "DFP Plugin" if using the DoubleClick for Publishers advertisement platform. -#### Step 2(b)(i) - Input Your Details (Adsense) +#### Step 2(b) - Input Your Details + +Depending on which ad platform you are using, to input your ad details you need to: + +* Get the Advertisement Tag from your Ad Provider +* Add parts of your ad code to Discourse's site settings as per the color coding in the images below. Only use the image for your ad platform. + +**Adsense Ad Tag Into SiteSettings** +![](https://www.dropbox.com/sc/pguxq17zo2rovyd/AAD--LTH_IIgVhgczoaY1Ljva?dl=1) + +**DoubleClick for Publishers' Ad Tag Into SiteSettings** + +![](https://www.dropbox.com/sc/0inoc1iduux0gsf/AADi8tfKX9S6Tx9S8RndcUE8a?dl=1) + + +In Ad Plugin Features: + +* Available Locations for Ad Display +* Ad Sizes Supported +* Other.... (TBC) + +Locations to be in a table... + +Post Bottom ![](https://www.dropbox.com/sc/pguxq17zo2rovyd/AAD--LTH_IIgVhgczoaY1Ljva?dl=1) +Topic Above Post ![](https://www.dropbox.com/sc/1ze0dikrmkfj0wg/AADMGWGVsECEOwZdnmSLGkhZa?dl=1) +Topic Above Suggested ![](https://www.dropbox.com/sc/y3p2iqwggb5he0e/AAAbrTqZCAYgIhIYE4necmfXa?dl=1) +Topic List Top ![](https://www.dropbox.com/sc/cpm9i6jj5dtivjc/AACmgp6qxI-8kMp3F2VVWsvba?dl=1) + -* Insert Image + Explain the code in the provided tag from ad provider. -#### Step 2(b)(ii) - Input Your Details (DoubleClick for Publishers) * Insert Image + Explain the code in the provided tag from ad provider. From d80c557d474cb7d56299d2932d8946133330b5ad Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 10:22:07 +1000 Subject: [PATCH 03/13] Edited input details + added items to features --- README.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 91f836d..cb7f1ae 100644 --- a/README.md +++ b/README.md @@ -57,13 +57,18 @@ There are 2 easy steps for configuring your Discourse settings to enable adverti Depending on which ad platform you are using, to input your ad details you need to: -* Get the Advertisement Tag from your Ad Provider -* Add parts of your ad code to Discourse's site settings as per the color coding in the images below. Only use the image for your ad platform. +1. Add in your publisher ID - your publisher ID can be obtained from your ad provider and can also be found in your ad tag (see picture below). +2. Choose your trust level from the dropdown box. This will only display ads to users with a certain level of trust. For more details about trust levels go to the **Plugin Features** heading. +3. Get the Advertisement Tag from your Ad Provider - see the images below to see what a tag looks like. +4. Add parts of your ad code to Discourse's site settings as per the color coding in the images below. Only use the image for your ad platform. +5. Choose Your Ad Size - this is the same size that you've put into your ad provider to create your ad. Go to the **Plugin Features** heading to see a list of supported Ad sizes. + + +##### Adsense Ad Tag Into SiteSettings -**Adsense Ad Tag Into SiteSettings** ![](https://www.dropbox.com/sc/pguxq17zo2rovyd/AAD--LTH_IIgVhgczoaY1Ljva?dl=1) -**DoubleClick for Publishers' Ad Tag Into SiteSettings** +##### DoubleClick for Publishers' Ad Tag Into SiteSettings ![](https://www.dropbox.com/sc/0inoc1iduux0gsf/AADi8tfKX9S6Tx9S8RndcUE8a?dl=1) @@ -72,6 +77,7 @@ In Ad Plugin Features: * Available Locations for Ad Display * Ad Sizes Supported +* Trust Levels * Other.... (TBC) Locations to be in a table... @@ -84,10 +90,6 @@ Topic List Top ![](https://www.dropbox.com/sc/cpm9i6jj5dtivjc/AACmgp6qxI-8kMp3F2 - -* Insert Image + Explain the code in the provided tag from ad provider. - - // TO BE FIXED START Add GIFS, Images ✘ this is a cross From bd551b0a155b61a35e7a7311e2429c30f848680d Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 10:39:46 +1000 Subject: [PATCH 04/13] Added location table and edited input details --- README.md | 96 +++++++++++++++++++++---------------------------------- 1 file changed, 37 insertions(+), 59 deletions(-) diff --git a/README.md b/README.md index cb7f1ae..ae4cf4d 100644 --- a/README.md +++ b/README.md @@ -55,77 +55,25 @@ There are 2 easy steps for configuring your Discourse settings to enable adverti #### Step 2(b) - Input Your Details -Depending on which ad platform you are using, to input your ad details you need to: - -1. Add in your publisher ID - your publisher ID can be obtained from your ad provider and can also be found in your ad tag (see picture below). +1. Add in your publisher ID - your publisher ID can be obtained from your ad platform and can also be found in your ad tag (see picture below). 2. Choose your trust level from the dropdown box. This will only display ads to users with a certain level of trust. For more details about trust levels go to the **Plugin Features** heading. -3. Get the Advertisement Tag from your Ad Provider - see the images below to see what a tag looks like. +3. Get the Advertisement Tag from your Ad Platform - see the images below to see what a tag looks like. 4. Add parts of your ad code to Discourse's site settings as per the color coding in the images below. Only use the image for your ad platform. 5. Choose Your Ad Size - this is the same size that you've put into your ad provider to create your ad. Go to the **Plugin Features** heading to see a list of supported Ad sizes. +6. To disable your ad (and not have it display), click on the disable button. - -##### Adsense Ad Tag Into SiteSettings +##### Adsense Advertisement Tag to Discourse's Site Settings ![](https://www.dropbox.com/sc/pguxq17zo2rovyd/AAD--LTH_IIgVhgczoaY1Ljva?dl=1) -##### DoubleClick for Publishers' Ad Tag Into SiteSettings +##### DoubleClick for Publishers' Advertisement Tag to Discourse's Site Settings ![](https://www.dropbox.com/sc/0inoc1iduux0gsf/AADi8tfKX9S6Tx9S8RndcUE8a?dl=1) -In Ad Plugin Features: - -* Available Locations for Ad Display -* Ad Sizes Supported -* Trust Levels -* Other.... (TBC) - -Locations to be in a table... - -Post Bottom ![](https://www.dropbox.com/sc/pguxq17zo2rovyd/AAD--LTH_IIgVhgczoaY1Ljva?dl=1) -Topic Above Post ![](https://www.dropbox.com/sc/1ze0dikrmkfj0wg/AADMGWGVsECEOwZdnmSLGkhZa?dl=1) -Topic Above Suggested ![](https://www.dropbox.com/sc/y3p2iqwggb5he0e/AAAbrTqZCAYgIhIYE4necmfXa?dl=1) -Topic List Top ![](https://www.dropbox.com/sc/cpm9i6jj5dtivjc/AACmgp6qxI-8kMp3F2VVWsvba?dl=1) - - - - -// TO BE FIXED START -Add GIFS, Images -✘ this is a cross -✓ this is a tick -After installation users likely want to: -- Choose platform - DONE -- Input ad codes + do a few other things. - DFP in detail with custom targeting - write guide on this. -- Display ad. - - -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 tDOcso input are (width*height) 300*250 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) -// TO BE FIXED END - - -* Finally, if you wish to disable the ad, tick ad disabling box - ### Step 3 - See Your Ad -Once you've configured your settings and your advertising platform has ads that are ready to serve, navigate to the page where you've inputted for the location and you should see ads. For example, a Discourse forum serving ads looks like this: - -INSERT_IMAGE_HERE - +Once you've configured your settings and your advertising platform has ads that are ready to serve, navigate to the page where you've inputted for the location and you should see ads. ## Other Installation @@ -162,8 +110,38 @@ For example: ln -s ~/discourse-plugin-test . * You can now make changes in your locally held Discourse Adplugin folder and see the effect of your changes when your run ```rails s``` in your locally held Discourse Forum files. +### Plugin Features -## Advertisement Sizes Supported + +// TO BE FIXED START +Add GIFS, Images +✘ this is a cross +✓ this is a tick +After installation users likely want to: +- Choose platform - DONE +- Input ad codes + do a few other things. - DFP in detail with custom targeting - write guide on this. +- Display ad. + + +* Available Locations for Ad Display +* Ad Sizes Supported +* Trust Levels +* Other.... (TBC) + + + + +### Available Locations for Ad Display + +Location Name | Description | Image of Location +--- | --- | --- +Topic List Top | Ad will appear at the header of Discourse homepage | [Topic list top](https://www.dropbox.com/sc/cpm9i6jj5dtivjc/AACmgp6qxI-8kMp3F2VVWsvba?dl=1) +Topic Above Post Stream | Ad will appear in the header of all Discourse forum topics | [Topic above post stream](https://www.dropbox.com/sc/1ze0dikrmkfj0wg/AADMGWGVsECEOwZdnmSLGkhZa?dl=1) +Topic Above Suggested | Ad will appear in the footer above suggested topics of all Discourse forum topics | [Topic above suggested](https://www.dropbox.com/sc/y3p2iqwggb5he0e/AAAbrTqZCAYgIhIYE4necmfXa?dl=1) +Post Bottom & Nth Post | Ad will appear on the stipulated nth post within a topic. So if you have 5 posts in a topic and you want the ad to display after on the 2nd post, put 2 in ```ad_platform_nth_post_code```. | [Post bottom](https://www.dropbox.com/sc/pguxq17zo2rovyd/AAD--LTH_IIgVhgczoaY1Ljva?dl=1) + + +### Advertisement Sizes Supported This plugin supports the following ad sizes for the following locations. From 0c8873d37d4001117417ae10c40996cdd9e73cfa Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 10:44:28 +1000 Subject: [PATCH 05/13] cleaned up features --- README.md | 28 +++++++++++++--------------- 1 file changed, 13 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index ae4cf4d..8df5d94 100644 --- a/README.md +++ b/README.md @@ -110,25 +110,11 @@ For example: ln -s ~/discourse-plugin-test . * You can now make changes in your locally held Discourse Adplugin folder and see the effect of your changes when your run ```rails s``` in your locally held Discourse Forum files. -### Plugin Features - - -// TO BE FIXED START -Add GIFS, Images -✘ this is a cross -✓ this is a tick -After installation users likely want to: -- Choose platform - DONE -- Input ad codes + do a few other things. - DFP in detail with custom targeting - write guide on this. -- Display ad. - +## Plugin Features * Available Locations for Ad Display * Ad Sizes Supported * Trust Levels -* Other.... (TBC) - - ### Available Locations for Ad Display @@ -159,6 +145,18 @@ All locations except post bottom | Post bottom location | Mobile 250 x 250 | | + +TBC: +Add GIFS, Images +✘ this is a cross +✓ this is a tick +After installation users likely want to: +- Choose platform - DONE +- Input ad codes + do a few other things. - DFP in detail with custom targeting - write guide on this. +- Display ad. + + + ## Questions or Want to Contribute? Open an Issue on this repository to start a chat. From c83b1c833693d6f0ddabe007cbfb5d5e590bc65c Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 10:44:47 +1000 Subject: [PATCH 06/13] cleaned up features From c68a5a4f1ba9fe36a91c237d9bff3a02d2c66cc8 Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 11:51:39 +1000 Subject: [PATCH 07/13] added licence and modified content --- README.md | 111 +++++++++++++++++++++++++++--------------------------- 1 file changed, 55 insertions(+), 56 deletions(-) diff --git a/README.md b/README.md index 8df5d94..a18d23c 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,9 @@ This is the official Discourse advertising plugin. It allows advertisements to be served by supported advertising platforms for users with a Discourse forum. +**Authors**: [cyber_koi](https://github.com/cyberkoi) (insert_web_page) and [ladydanger](https://github.com/ladydanger) +**Contributors**: See Credits section below +**Copyright**: 2015 **License**: MIT License **Supported Discourse Version**: 1.4

**Supported Ad Platforms**: @@ -9,6 +12,7 @@ This is the official Discourse advertising plugin. It allows advertisements to * [Google Double Click for Publishers](https://www.google.com/dfp) + ## Quick Start in 3 Steps This quick start shows you how to install this plugin and use it. Recommended if you have: @@ -47,7 +51,6 @@ There are 2 easy steps for configuring your Discourse settings to enable adverti #### Step 2(a) - Choose Your Advertisement Platform - * Navigate to the Admin section in your Discourse forum. * Click on Settings and a left vertical navigation bar should appear. * Choose your advertisement platform by clicking on "Adsense Plugin" if using Adsense as your advertisement platform and/or click "DFP Plugin" if using the DoubleClick for Publishers advertisement platform. @@ -58,7 +61,7 @@ There are 2 easy steps for configuring your Discourse settings to enable adverti 1. Add in your publisher ID - your publisher ID can be obtained from your ad platform and can also be found in your ad tag (see picture below). 2. Choose your trust level from the dropdown box. This will only display ads to users with a certain level of trust. For more details about trust levels go to the **Plugin Features** heading. 3. Get the Advertisement Tag from your Ad Platform - see the images below to see what a tag looks like. -4. Add parts of your ad code to Discourse's site settings as per the color coding in the images below. Only use the image for your ad platform. +4. Add parts of your ad code to Discourse's site settings for the locations you wish your ad to appear. Refer to image for your ad platform to where parts of your ad tag should go. For more detail about where the ad will appear 5. Choose Your Ad Size - this is the same size that you've put into your ad provider to create your ad. Go to the **Plugin Features** heading to see a list of supported Ad sizes. 6. To disable your ad (and not have it display), click on the disable button. @@ -76,6 +79,54 @@ There are 2 easy steps for configuring your Discourse settings to enable adverti Once you've configured your settings and your advertising platform has ads that are ready to serve, navigate to the page where you've inputted for the location and you should see ads. +## Plugin Features + +In this section, we go into more detail on: +* Available Locations for Ad Display +* Ad Sizes Supported +* Trust Levels + +### Available Locations for Ad Display + +Location Name | Description | Image of Location +--- | --- | --- +Topic List Top | Ad will appear at the header of Discourse homepage | [Topic list top](https://www.dropbox.com/sc/cpm9i6jj5dtivjc/AACmgp6qxI-8kMp3F2VVWsvba?dl=1) +Topic Above Post Stream | Ad will appear in the header of all Discourse forum topics | [Topic above post stream](https://www.dropbox.com/sc/1ze0dikrmkfj0wg/AADMGWGVsECEOwZdnmSLGkhZa?dl=1) +Topic Above Suggested | Ad will appear in the footer above suggested topics of all Discourse forum topics | [Topic above suggested](https://www.dropbox.com/sc/y3p2iqwggb5he0e/AAAbrTqZCAYgIhIYE4necmfXa?dl=1) +Post Bottom & Nth Post | Ad will appear on the stipulated nth post within a topic. So if you have 5 posts in a topic and you want the ad to display after on the 2nd post, put 2 in ```ad_platform_nth_post_code```. | [Post bottom](https://www.dropbox.com/sc/pguxq17zo2rovyd/AAD--LTH_IIgVhgczoaY1Ljva?dl=1) + + +### Advertisement Sizes Supported + +This plugin supports the following ad sizes for the following locations. + +All locations except post bottom | Post bottom location | Mobile +--- | --- | --- +728 x 90 | 728 x 90 | 320 x 50 +336 x 280 | 336 x 280 | +300 x 250 | 300 x 250 | +970 x 90 | 970 x 90 | +468 x 60 | 468 x 60 | +234 x 60 | 234 x 60 | +125 x 125 | | +180 x 150 | | +200 x 200 | | +250 x 250 | | + + +### Trust Levels + +You can use the ```ad_platform_through_trust_level``` dropdown to disable ads for users above a certain trust levels. As a guide, choosing: + +* 0 shows ads to users that are not logged in. +* 1 shows ads to users that are not logged in, and to new and basic users. +* 2 shows ads to regular users as well, but not to leaders and elders. +* 3 shows ads to everyone but elders. +* 4 shows ads to everyone including elders. + +To find more about trust levels in Discourse, refer to [Discourse's posts on trust levels](https://meta.discourse.org/t/what-do-user-trust-levels-do/4924/7) + + ## Other Installation There are two sets of installation instructions: @@ -110,53 +161,6 @@ For example: ln -s ~/discourse-plugin-test . * You can now make changes in your locally held Discourse Adplugin folder and see the effect of your changes when your run ```rails s``` in your locally held Discourse Forum files. -## Plugin Features - -* Available Locations for Ad Display -* Ad Sizes Supported -* Trust Levels - - -### Available Locations for Ad Display - -Location Name | Description | Image of Location ---- | --- | --- -Topic List Top | Ad will appear at the header of Discourse homepage | [Topic list top](https://www.dropbox.com/sc/cpm9i6jj5dtivjc/AACmgp6qxI-8kMp3F2VVWsvba?dl=1) -Topic Above Post Stream | Ad will appear in the header of all Discourse forum topics | [Topic above post stream](https://www.dropbox.com/sc/1ze0dikrmkfj0wg/AADMGWGVsECEOwZdnmSLGkhZa?dl=1) -Topic Above Suggested | Ad will appear in the footer above suggested topics of all Discourse forum topics | [Topic above suggested](https://www.dropbox.com/sc/y3p2iqwggb5he0e/AAAbrTqZCAYgIhIYE4necmfXa?dl=1) -Post Bottom & Nth Post | Ad will appear on the stipulated nth post within a topic. So if you have 5 posts in a topic and you want the ad to display after on the 2nd post, put 2 in ```ad_platform_nth_post_code```. | [Post bottom](https://www.dropbox.com/sc/pguxq17zo2rovyd/AAD--LTH_IIgVhgczoaY1Ljva?dl=1) - - -### Advertisement Sizes Supported - -This plugin supports the following ad sizes for the following locations. - -All locations except post bottom | Post bottom location | Mobile ---- | --- | --- -728 x 90 | 728 x 90 | 320 x 50 -336 x 280 | 336 x 280 | -300 x 250 | 300 x 250 | -970 x 90 | 970 x 90 | -468 x 60 | 468 x 60 | -234 x 60 | 234 x 60 | -125 x 125 | | -180 x 150 | | -200 x 200 | | -250 x 250 | | - - - -TBC: -Add GIFS, Images -✘ this is a cross -✓ this is a tick -After installation users likely want to: -- Choose platform - DONE -- Input ad codes + do a few other things. - DFP in detail with custom targeting - write guide on this. -- Display ad. - - - ## Questions or Want to Contribute? Open an Issue on this repository to start a chat. @@ -166,11 +170,6 @@ Issues and Pull Requests are greatly appreciated. Bear in mind that when submit ## Credits -Discourse.org - Thanks to our mentor @eviltrout and the Discourse team - @LIST_OUT_THEIR_GITHUB_HANDLE -Rails Girls - Thanks @sareg0 and the Rails Girls Team. +Discourse.org - Thanks to our mentor [eviltrout](https://github.com/eviltrout) and the Discourse team - @LIST_OUT_THEIR_GITHUB_HANDLE +Rails Girls - Thanks [sareg0](https://github.com/...) and the Rails Girls Team. Our Coaches - @LIST_OUT_THEIR_GITHUB_HANDLE - - -## License - -TBC: GPL v2 or MIT From ab9aca7c992678741ba3c2d696563f0797a80021 Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 11:53:35 +1000 Subject: [PATCH 08/13] Add line formatting --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index a18d23c..910748d 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,9 @@ This is the official Discourse advertising plugin. It allows advertisements to be served by supported advertising platforms for users with a Discourse forum. -**Authors**: [cyber_koi](https://github.com/cyberkoi) (insert_web_page) and [ladydanger](https://github.com/ladydanger) -**Contributors**: See Credits section below -**Copyright**: 2015 **License**: MIT License +**Authors**: [cyberkoi](https://github.com/cyberkoi) (insert_web_page) and [ladydanger](https://github.com/ladydanger) (insert_web_page) :heart:

+**Contributors**: See Credits section below

+**Copyright**: 2015 **License**: MIT License

**Supported Discourse Version**: 1.4

**Supported Ad Platforms**: From 51b9aa4992227e2a4f25957efaabf139c6a21e9e Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 12:09:08 +1000 Subject: [PATCH 09/13] Added details to plugin and fixed next line --- README.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 910748d..636d04f 100644 --- a/README.md +++ b/README.md @@ -2,17 +2,15 @@ This is the official Discourse advertising plugin. It allows advertisements to be served by supported advertising platforms for users with a Discourse forum. -**Authors**: [cyberkoi](https://github.com/cyberkoi) (insert_web_page) and [ladydanger](https://github.com/ladydanger) (insert_web_page) :heart:

-**Contributors**: See Credits section below

-**Copyright**: 2015 **License**: MIT License

-**Supported Discourse Version**: 1.4

-**Supported Ad Platforms**: - +**Authors**: [cyberkoi](https://github.com/cyberkoi) (insert_web_page) and [ladydanger](https://github.com/ladydanger) (insert_web_page) :heart: +**Contributors**: See credits section below +**License**: MIT License +**Supported Discourse Version**: 1.4 +**Supported Ad Platforms**: * [Google Adsense](http://www.google.com.au/adsense/start/why-adsense.html) * [Google Double Click for Publishers](https://www.google.com/dfp) - ## Quick Start in 3 Steps This quick start shows you how to install this plugin and use it. Recommended if you have: From a1cc02a8e51bc61975bcb23c1ecf84416ab66a19 Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 12:18:13 +1000 Subject: [PATCH 10/13] finalised structure of readme and credits remaining --- README.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 636d04f..2724399 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ This quick start shows you how to install this plugin and use it. Recommended i * A live discourse forum * You have deployed that forum using Docker. Most people using Digital Ocean will have deployed Discourse using Docker. -For installation for non-docker or local development (those with programming experience), see Other Installation. +For non-docker or local development installation (those with programming experience), see **Other Installation**. ### Step 1 - Install the Official Discourse Advertising Plugin @@ -56,7 +56,7 @@ There are 2 easy steps for configuring your Discourse settings to enable adverti #### Step 2(b) - Input Your Details -1. Add in your publisher ID - your publisher ID can be obtained from your ad platform and can also be found in your ad tag (see picture below). +1. Add in your publisher ID - your publisher ID can be obtained from your ad platform and can also be found in your ad tag (see pictures below). 2. Choose your trust level from the dropdown box. This will only display ads to users with a certain level of trust. For more details about trust levels go to the **Plugin Features** heading. 3. Get the Advertisement Tag from your Ad Platform - see the images below to see what a tag looks like. 4. Add parts of your ad code to Discourse's site settings for the locations you wish your ad to appear. Refer to image for your ad platform to where parts of your ad tag should go. For more detail about where the ad will appear @@ -86,6 +86,8 @@ In this section, we go into more detail on: ### Available Locations for Ad Display +The following are available locations along with a description and an image showing their location within Discourse to display ads for all platforms. + Location Name | Description | Image of Location --- | --- | --- Topic List Top | Ad will appear at the header of Discourse homepage | [Topic list top](https://www.dropbox.com/sc/cpm9i6jj5dtivjc/AACmgp6qxI-8kMp3F2VVWsvba?dl=1) @@ -168,6 +170,6 @@ Issues and Pull Requests are greatly appreciated. Bear in mind that when submit ## Credits -Discourse.org - Thanks to our mentor [eviltrout](https://github.com/eviltrout) and the Discourse team - @LIST_OUT_THEIR_GITHUB_HANDLE -Rails Girls - Thanks [sareg0](https://github.com/...) and the Rails Girls Team. +Discourse.org - Thanks to our mentor [@viltrout](https://github.com/eviltrout) and the Discourse team - @LIST_OUT_THEIR_GITHUB_HANDLE +Rails Girls - Thanks [@sareg0](https://github.com/...) and the Rails Girls Team. Our Coaches - @LIST_OUT_THEIR_GITHUB_HANDLE From a960d01976f941271c67ba1ee46637373ff9aac8 Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 13:04:46 +1000 Subject: [PATCH 11/13] added links to coaches --- README.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 2724399..619077e 100644 --- a/README.md +++ b/README.md @@ -170,6 +170,14 @@ Issues and Pull Requests are greatly appreciated. Bear in mind that when submit ## Credits -Discourse.org - Thanks to our mentor [@viltrout](https://github.com/eviltrout) and the Discourse team - @LIST_OUT_THEIR_GITHUB_HANDLE -Rails Girls - Thanks [@sareg0](https://github.com/...) and the Rails Girls Team. -Our Coaches - @LIST_OUT_THEIR_GITHUB_HANDLE +**Discourse.org**: Thanks to our mentor [@eviltrout](https://github.com/eviltrout) and the wonderful [Discourse team!](http://www.discourse.org/) + +**Our Coaches**: Very special thank you to our coaches and honorary coach - [@georg](https://github.com/georg), [@betaass](https://github.com/betaass), [@adelsmee](https://github.com/adelsmee), [@davich](https://github.com/davich), [@link664](https://github.com/link664), [@tomjadams](https://github.com/tomjadams), [@compactcode](https://github.com/compactcode), [@joffotron](https://github.com/joffotron), [@jocranford](https://github.com/jocranford), [@saramic](https://github.com/saramic), [@madpilot](https://github.com/madpilot), [@catkins](https://github.com/catkins) + +**Rails Girls**: Thanks [@sareg0](https://github.com/sareg0) and the Rails Girls Team for the opportunity to participate in Rails Girls Summer of Code 2015. + + + + + + From d2ab2d99ffcfcfb916dd1e6a206d1e019d219ae8 Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 13:13:06 +1000 Subject: [PATCH 12/13] Further refinement to the plugin wording --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index 619077e..fb7b3a0 100644 --- a/README.md +++ b/README.md @@ -165,8 +165,6 @@ For example: ln -s ~/discourse-plugin-test . Open an Issue on this repository to start a chat. -Issues and Pull Requests are greatly appreciated. Bear in mind that when submitting feature requests, if it's not something that most people will use, it probably won't get merged. - ## Credits From 2891a3e355c6018ad3b19e3c1b2e727782fd2c48 Mon Sep 17 00:00:00 2001 From: ladydanger Date: Mon, 7 Sep 2015 13:18:08 +1000 Subject: [PATCH 13/13] polished up the authorship --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index fb7b3a0..1ddc8ba 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ This is the official Discourse advertising plugin. It allows advertisements to be served by supported advertising platforms for users with a Discourse forum. -**Authors**: [cyberkoi](https://github.com/cyberkoi) (insert_web_page) and [ladydanger](https://github.com/ladydanger) (insert_web_page) :heart: +**Authors**: [cyberkoi](https://github.com/cyberkoi) & [ladydanger](https://github.com/ladydanger) **Contributors**: See credits section below **License**: MIT License **Supported Discourse Version**: 1.4