advanced-ads
Last commit date
admin
11 years ago
classes
11 years ago
includes
11 years ago
languages
11 years ago
public
11 years ago
LICENSE.txt
12 years ago
advanced-ads.php
11 years ago
composer.json
11 years ago
index.php
12 years ago
readme.txt
11 years ago
uninstall.php
11 years ago
readme.txt
259 lines
| 1 | === Advanced Ads === |
| 2 | Contributors: webzunft |
| 3 | Donate link:https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=5RRRCEBGN3UT2 |
| 4 | Tags: ads, ad, adsense, display, banner, advertisements, adverts, advert, monetization |
| 5 | Requires at least: WP 3.5, PHP 5.3 |
| 6 | Tested up to: 4.1. |
| 7 | Stable tag: 1.3.12 |
| 8 | License: GPLv2 or later |
| 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 | |
| 11 | Manage and optimize your ads in WordPress as easy as creating posts. + ad injection, ad planning and ad rotation. |
| 12 | |
| 13 | == Description == |
| 14 | |
| 15 | Advanced Ads is a simple ad manager made by publishers for publishers. Based on my experience delivering millions of ads per month I build this plugin as a powerful, but light weight solution to not only manage and serve ads in WordPress, but to test and optimize them as well. |
| 16 | |
| 17 | Learn more on the [plugin homepage](http://wpadvancedads.com). |
| 18 | |
| 19 | = create and manage ads = |
| 20 | |
| 21 | * create ads as easy as creating posts |
| 22 | * group ads to create ad rotations |
| 23 | * create drafts or ads only visible to logged in users |
| 24 | * set a date for when to publish the ad |
| 25 | |
| 26 | = ad types = |
| 27 | |
| 28 | choose between different ad types that enable you to: |
| 29 | |
| 30 | * insert ad networks code (e.g. Google AdSense) |
| 31 | * display images |
| 32 | * use shortcodes (to also deliver ads from other ad plugins) |
| 33 | * create content rich ad with the tinymc editor |
| 34 | |
| 35 | = display ads = |
| 36 | |
| 37 | * auto inject ads (see _ad injection_ below) |
| 38 | * display ad in template files (with functions) |
| 39 | * display ad in post content (with shortcodes) |
| 40 | * widget to display ads in widget areas (sidebars) |
| 41 | * display grouped ads based on customizable ad weight |
| 42 | * use placements in your theme to change ads and groups in template files without coding |
| 43 | * disable all ads on individual single pages |
| 44 | |
| 45 | = display conditions = |
| 46 | |
| 47 | deliver ads based on conditions like |
| 48 | |
| 49 | * individual posts, pages and other post type |
| 50 | * post type |
| 51 | * posts by category, tags, taxonomies |
| 52 | * archive pages by category, tags, taxonomies |
| 53 | * special page types like 404, attachment and front page |
| 54 | |
| 55 | global conditions |
| 56 | |
| 57 | * disable all ads in the frontend (e.g. when your ad network breaks down) |
| 58 | * disable all ads on 404 pages (e.g. AdSense doesn’t allow that) |
| 59 | * disable all ads on non-singular pages with a single click |
| 60 | |
| 61 | = visitor conditions = |
| 62 | |
| 63 | display ads by conditions based on the visitor |
| 64 | |
| 65 | * all devices, mobile only or exclude mobile users |
| 66 | * hide all ads from logged in users based on their role |
| 67 | |
| 68 | = ad injection = |
| 69 | |
| 70 | Advanced Ads comes with many options for ad injection (= display ads without the need to alter content or code) |
| 71 | |
| 72 | * inject ads into header and footer |
| 73 | * inject ads into posts content (top, bottom, by paragraph) |
| 74 | * inject ads into content before or after a specific paragraph or headline |
| 75 | |
| 76 | = ad networks = |
| 77 | |
| 78 | Advanced Ads is compatible with all ad networks and banners from affiliate programs like Google AdSense, Chitika, Clickbank, Amazon, etc. |
| 79 | You can also use it to add additional ad network tags into header or footer of your site without additional coding) |
| 80 | |
| 81 | = based on WordPress standards = |
| 82 | |
| 83 | * integrated into WordPress using standards like custom post types, taxonomies and hooks |
| 84 | * easily customizable by any WordPress plugin developer |
| 85 | |
| 86 | Learn more on the [plugin homepage](http://wpadvancedads.com). |
| 87 | |
| 88 | Localizations: English, German, Italien |
| 89 | |
| 90 | = Add-Ons = |
| 91 | |
| 92 | * Responsive Ads – load and display ads only for specific browser sizes - [Demo](http://wpadvancedads.com/responsive-ads/) |
| 93 | * PopUp and Layer Ads – display ads and any other content in layers and popups - [Demo](http://wpadvancedads.com/layer-ads/) |
| 94 | * Sticky Ads – increase click rates with fixed, sticky and anchor ads - [Demo](http://wpadvancedads.com/sticky-ads/demo/) |
| 95 | |
| 96 | == Installation == |
| 97 | |
| 98 | How to install the plugin and get it working? |
| 99 | |
| 100 | = Using The WordPress Dashboard = |
| 101 | |
| 102 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 103 | 2. Search for 'advanced ads' |
| 104 | 3. Click 'Install Now' |
| 105 | 4. Activate Advanced Ads on the Plugin dashboard |
| 106 | |
| 107 | = Uploading in WordPress Dashboard = |
| 108 | |
| 109 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 110 | 2. Navigate to the 'Upload' area |
| 111 | 3. Select `advanced-ads.zip` from your computer |
| 112 | 4. Click 'Install Now' |
| 113 | 5. Activate Advanced Ads in the Plugin dashboard |
| 114 | |
| 115 | = Using FTP = |
| 116 | |
| 117 | 1. Download `advanced-ads.zip` |
| 118 | 2. Extract the `advanced-ads` directory to your computer |
| 119 | 3. Upload the `advanced-ads` directory to the `/wp-content/plugins/` directory |
| 120 | 4. Activate Advanced Ads in the Plugin dashboard |
| 121 | |
| 122 | == Displaying Ads == |
| 123 | |
| 124 | You can use functions and shortcodes to display ads and ad groups. |
| 125 | |
| 126 | The integers in this example are the IDs of the elements. |
| 127 | |
| 128 | Use these shortcode to insert an ad or ad group into your post/page. |
| 129 | |
| 130 | `[the_ad id="24"]` |
| 131 | `[the_ad_group id="5"]` |
| 132 | |
| 133 | Use these functions to insert an ad or ad group into your template file. |
| 134 | |
| 135 | `<?php the_ad(24); ?>` |
| 136 | `<?php the_ad_group(5); ?>` |
| 137 | |
| 138 | In addition to directly displaying ads and groups you can define ad placements and assign either an ad or group to them. |
| 139 | |
| 140 | `[the_ad_placement id="header-left"]` |
| 141 | `<?php the_ad_placement('header-left'); ?>` |
| 142 | |
| 143 | == Frequently Asked Questions == |
| 144 | |
| 145 | = Is there a revenue share? = |
| 146 | |
| 147 | There is no revenue share. Advanced Ads doesn’t alter your ad codes in a way that you earn less than you would directly including the ad code in your template. |
| 148 | |
| 149 | == Screenshots == |
| 150 | |
| 151 | 1. Create an ad almost like you would create an article or page. |
| 152 | 2. Align the ad and set a margin to other elements |
| 153 | 3. Choose from various conditions where and where not to display your ad. |
| 154 | |
| 155 | == Changelog == |
| 156 | |
| 157 | = 1.3.12 = |
| 158 | |
| 159 | * limited number of terms on ad edit screen to 200, introduced _advanced-ads-admin-max-terms_ filter |
| 160 | * wrapped placement ads in a container with a unique id and a class to target them with css and js |
| 161 | * added dashboard widget with plugin version and news about ad optimization |
| 162 | |
| 163 | Good to know: [What you didn’t know about the AdSense Program Policies](http://webgilde.com/en/adsense-program-policies/). |
| 164 | |
| 165 | = 1.3.11 = |
| 166 | |
| 167 | * COOL: disable ads completely, on 404 pages or for non-singular pages with a single click |
| 168 | * renamed hooks starting with _advads_ to _advanced-ads_ for better names consistency |
| 169 | * ordered ads by ad title not by date in placement and widget ad select list |
| 170 | |
| 171 | Good to know: AdSense does not allow ads on 404 pages, so if you use AdSense a lot, be sure to check this new option on your settings page. |
| 172 | |
| 173 | = 1.3.10 = |
| 174 | |
| 175 | * COOL: disable all ads on individual single pages |
| 176 | * fixed saving some ad conditions to global array |
| 177 | * fixed minor issue with empty ad condition |
| 178 | * updated translation files |
| 179 | * updated German translation |
| 180 | |
| 181 | Developers might want to take a look at the [Codex](http://wpadvancedads.com/advancedads/codex/). I am currently updating the cool stuff in there. |
| 182 | |
| 183 | = 1.3.9 = |
| 184 | |
| 185 | * disabled empty css file in frontend |
| 186 | * removed older changelog from readme |
| 187 | * fixed saving new ad conditions type "other" into global array |
| 188 | |
| 189 | = 1.3.8 = |
| 190 | |
| 191 | * fixed empty content placements still being parsed |
| 192 | * fixed missing or double tags created by content placements |
| 193 | |
| 194 | = 1.3.7 = |
| 195 | |
| 196 | * fixed bug with display conditions not working for custom post types and taxonomies |
| 197 | * minor fix in ad injection |
| 198 | |
| 199 | = 1.3.6 = |
| 200 | |
| 201 | * COOL: inject ads into content before or after specific paragraphs or headlines |
| 202 | * Updated translation files, German translation |
| 203 | |
| 204 | = 1.3.5 = |
| 205 | |
| 206 | * hotfix: fix the use of shortcodes within ads |
| 207 | |
| 208 | = 1.3.4 = |
| 209 | |
| 210 | * hotfix: display ads for placements when no ad group exists |
| 211 | |
| 212 | = 1.3.3 = |
| 213 | |
| 214 | * added column with ad details |
| 215 | * removed the date column from ad list |
| 216 | * fixed saving and retrieving of settings |
| 217 | * changed the dashboard icon |
| 218 | * renamed admin images so they won’t get blocked by ad blockers |
| 219 | |
| 220 | * ACTION REQUIRED: please check and resave settings (_Advanced Ads > Settings_) |
| 221 | |
| 222 | = 1.3.2 = |
| 223 | |
| 224 | * hotfix: prevent infinite loops (ads within ads…) for rich content ads |
| 225 | |
| 226 | = 1.3.1 = |
| 227 | |
| 228 | * COOL: new ad type: rich media and formatable content – it’s like editing a normal post |
| 229 | * parse ad content as post content; this allows the use of shortcodes |
| 230 | * increased priority of content filter to reduce the risk of `wpautop` not being run yet |
| 231 | * finished German translation |
| 232 | |
| 233 | = 1.3 = |
| 234 | |
| 235 | * COOL: layout options for ads, e.g. to set floating and margins (see the [manual](http://wpadvancedads.com/advancedads/manual/optimizing-the-ad-layout/)) |
| 236 | * list ad groups before ads when selecting them for a placement |
| 237 | * fixed error when removing an ad that is still in a group |
| 238 | * fixed possible translation issue |
| 239 | * added partial German translation |
| 240 | * added Italien translation (thanks to sangkavr) |
| 241 | |
| 242 | == Upgrade Notice == |
| 243 | |
| 244 | = 1.3.2 = |
| 245 | |
| 246 | Hotfix: prevent infinite loops (ads within ads) for rich content ads |
| 247 | |
| 248 | = 1.3 = |
| 249 | |
| 250 | Don’t miss out on the new layout options to align ads and set margins |
| 251 | Also fixed issues with languages and added Italien and German translation (partial) |
| 252 | |
| 253 | = 1.2.4 = |
| 254 | |
| 255 | Fixes bug that prevented to create and edit ad groups |
| 256 | |
| 257 | = 1.2.3 = |
| 258 | |
| 259 | Fixes a bug with the missing menu item |