advanced-ads
Last commit date
admin
11 years ago
classes
11 years ago
includes
11 years ago
languages
11 years ago
modules
11 years ago
public
11 years ago
vendor
11 years ago
LICENSE.txt
12 years ago
advanced-ads.php
11 years ago
composer.json
11 years ago
composer.lock
11 years ago
index.php
12 years ago
readme.txt
11 years ago
uninstall.php
11 years ago
readme.txt
339 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.2.2 |
| 7 | Stable tag: 1.5.5 |
| 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. Including support for AdSense, ad injection, ad planning and ad rotation. |
| 12 | |
| 13 | == Description == |
| 14 | |
| 15 | Advanced Ads is a simple ad manager made by a publisher for publishers. Based on my experience delivering millions of ads per month I built 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](https://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 | * make internal notes about each ad |
| 26 | |
| 27 | = ad types = |
| 28 | |
| 29 | choose between different ad types that enable you to: |
| 30 | |
| 31 | * insert code for ad and affiliate networks (e.g., Chitika, Amazon) |
| 32 | * dedicated support for Google AdSense |
| 33 | * display images and image banners |
| 34 | * use shortcodes (to also deliver ads from other ad plugins) |
| 35 | * create content rich ad with the tinymc editor |
| 36 | |
| 37 | = display ads = |
| 38 | |
| 39 | * auto inject ads (see _ad injection_ below) |
| 40 | * display ad in template files (with functions) |
| 41 | * display ad in post content (with shortcodes) |
| 42 | * widget to display ads in widget areas (sidebars) |
| 43 | * display grouped ads based on customizable ad weight |
| 44 | * use placements in your theme to change ads and groups in template files without coding |
| 45 | * disable all ads on individual single pages |
| 46 | * set start time and expiry date for ads |
| 47 | * display multiple ads from an ad group (ad blocks) |
| 48 | * define the order of ads from an ad group and allow default ads |
| 49 | |
| 50 | = display conditions = |
| 51 | |
| 52 | deliver ads based on conditions like |
| 53 | |
| 54 | * individual posts, pages and other post type |
| 55 | * post type |
| 56 | * posts by category, tags, taxonomies |
| 57 | * archive pages by category, tags, taxonomies |
| 58 | * special page types like 404, attachment and front page |
| 59 | * hide ads on secondary queries (e.g. posts in sidebars) |
| 60 | |
| 61 | global conditions |
| 62 | |
| 63 | * disable all ads in the frontend (e.g. when your ad network breaks down) |
| 64 | * disable all ads on 404 pages (e.g. AdSense doesn’t allow that) |
| 65 | * disable all ads on non-singular pages with a single click |
| 66 | * disable all ads in secondary queries |
| 67 | * hide ads from bots and web crawlers |
| 68 | |
| 69 | = visitor conditions = |
| 70 | |
| 71 | display ads by conditions based on the visitor |
| 72 | |
| 73 | * display ads on all devices, mobile only or exclude mobile users |
| 74 | * hide all ads from logged in users based on their role |
| 75 | * display ads by exact browser width with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 76 | |
| 77 | = ad injection = |
| 78 | |
| 79 | Advanced Ads comes with many options for ad injection (= display ads without the need to alter content or code) |
| 80 | |
| 81 | * inject ads into header and footer |
| 82 | * inject ads into posts content (top, bottom, by paragraph) |
| 83 | * inject ads into content before or after a specific paragraph or headline |
| 84 | |
| 85 | = ad networks = |
| 86 | |
| 87 | Advanced Ads is compatible with all ad networks and banners from affiliate programs like Google AdSense, Chitika, Clickbank, Amazon, etc. |
| 88 | You can also use it to add additional ad network tags into header or footer of your site without additional coding) |
| 89 | |
| 90 | = Google AdSense = |
| 91 | |
| 92 | There is an ad type dedicated to Google AdSense that supports: |
| 93 | |
| 94 | * switch ad sizes |
| 95 | * switch between normal and responsive |
| 96 | * automatic limit 3 AdSense ads according to AdSense terms of service (can be disabled) |
| 97 | * assistant for exact sizes of responsive ads with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 98 | * (more coming soon) |
| 99 | |
| 100 | = based on WordPress standards = |
| 101 | |
| 102 | * integrated into WordPress using standards like custom post types, taxonomies and hooks |
| 103 | * easily customizable by any WordPress plugin developer |
| 104 | |
| 105 | Learn more on the [plugin homepage](https://wpadvancedads.com). |
| 106 | |
| 107 | Localizations: English, German, Italien, Portuguese |
| 108 | |
| 109 | > <strong>Add-Ons</strong> |
| 110 | > |
| 111 | > * Tracking – ad tracking and statistics – [more](https://wpadvancedads.com/add-ons/tracking/) |
| 112 | > * Responsive Ads – create mobile ads or ads for specific browser sizes - [Demo](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 113 | > * Sticky Ads – increase click rates with fixed, sticky, and anchor ads - [Demo](https://wpadvancedads.com/sticky-ads/demo/) |
| 114 | > * PopUp and Layer Ads – display ads and other content in layers and popups - [Demo](https://wpadvancedads.com/add-ons/layer-ads/) |
| 115 | |
| 116 | == Installation == |
| 117 | |
| 118 | How to install the plugin and get it working? |
| 119 | |
| 120 | = Using The WordPress Dashboard = |
| 121 | |
| 122 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 123 | 2. Search for 'advanced ads' |
| 124 | 3. Click 'Install Now' |
| 125 | 4. Activate Advanced Ads on the Plugin dashboard |
| 126 | |
| 127 | = Uploading in WordPress Dashboard = |
| 128 | |
| 129 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 130 | 2. Navigate to the 'Upload' area |
| 131 | 3. Select `advanced-ads.zip` from your computer |
| 132 | 4. Click 'Install Now' |
| 133 | 5. Activate Advanced Ads in the Plugin dashboard |
| 134 | |
| 135 | = Using FTP = |
| 136 | |
| 137 | 1. Download `advanced-ads.zip` |
| 138 | 2. Extract the `advanced-ads` directory to your computer |
| 139 | 3. Upload the `advanced-ads` directory to the `/wp-content/plugins/` directory |
| 140 | 4. Activate Advanced Ads in the Plugin dashboard |
| 141 | |
| 142 | == Displaying Ads == |
| 143 | |
| 144 | You can use functions and shortcodes to display ads and ad groups. |
| 145 | |
| 146 | The integers in this example are the IDs of the elements. |
| 147 | |
| 148 | Use these shortcode to insert an ad or ad group into your post/page. |
| 149 | |
| 150 | `[the_ad id="24"]` |
| 151 | `[the_ad_group id="5"]` |
| 152 | |
| 153 | Use these functions to insert an ad or ad group into your template file. |
| 154 | |
| 155 | `<?php the_ad(24); ?>` |
| 156 | `<?php the_ad_group(5); ?>` |
| 157 | |
| 158 | In addition to directly displaying ads and groups you can define ad placements and assign either an ad or group to them. |
| 159 | |
| 160 | `[the_ad_placement id="header-left"]` |
| 161 | `<?php the_ad_placement('header-left'); ?>` |
| 162 | |
| 163 | == Frequently Asked Questions == |
| 164 | |
| 165 | = Is there a revenue share? = |
| 166 | |
| 167 | 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. |
| 168 | |
| 169 | == Screenshots == |
| 170 | |
| 171 | 1. Create an ad almost like you would create an article or page. |
| 172 | 2. Align the ad and set a margin to other elements |
| 173 | 3. Choose from various conditions where and where not to display your ad. |
| 174 | |
| 175 | == Changelog == |
| 176 | |
| 177 | = 1.5.5 = |
| 178 | |
| 179 | * fixed outdated links to the manual and feature requests |
| 180 | * added hooks and options to be able to extend ad groups |
| 181 | |
| 182 | = 1.5.4.1 = |
| 183 | |
| 184 | * hotfix for new visitor conditions not showing up |
| 185 | |
| 186 | = 1.5.4 = |
| 187 | |
| 188 | * PLEASE READ the [update notice](https://wpadvancedads.com/advanced-ads-1-5-4/) to learn more about the changes on visitor conditions |
| 189 | * visitor conditions completely rewritten to allow combination of multiple conditions |
| 190 | * created simpler placement creation |
| 191 | * reordered Advanced Ads dashboard |
| 192 | * added AdSense tutorial |
| 193 | |
| 194 | = 1.5.3 = |
| 195 | |
| 196 | * display all ads of an ad group |
| 197 | * no ad wrapper is created if the main ad content is empty |
| 198 | * hide ad meta box on posts and pages for non admins |
| 199 | * display if ad expired on group overview |
| 200 | * added tutorial subscription |
| 201 | * added notices and newsletter logic |
| 202 | * new hook `advanced-ads-debug-after` |
| 203 | * updated all class names from "Advads_" to "Advanced_Ads_" |
| 204 | * updated German translation |
| 205 | |
| 206 | = 1.5.2.1 = |
| 207 | |
| 208 | * fixed inclusion / exclusion of ads for single posts |
| 209 | |
| 210 | = 1.5.2 = |
| 211 | |
| 212 | * fixed empty bots not excluded if option is activated |
| 213 | * fixed updated placements not showing up right away |
| 214 | * removing spaces from AdSense publisher id |
| 215 | * simplify admin capabilities for modules |
| 216 | * fixed admin includes to avoid relative paths |
| 217 | * fixed a warning in add-on admin settings |
| 218 | * fixed wrong path to advanced.js |
| 219 | * removed old code and global ad conditions previously saved in field 'advads-ads-by-conditions' |
| 220 | * updated German translation |
| 221 | |
| 222 | = 1.5.1 = |
| 223 | |
| 224 | * added tab menu für settings |
| 225 | * allow to set ad weights for pending, future and private ads |
| 226 | * improvements to groups overview based on group types |
| 227 | * fixed switching ad types |
| 228 | * fixed individual post conditions not showing up |
| 229 | * fixed update message being displayed for new installations |
| 230 | * other fixes under the hood |
| 231 | * new hooks: `advanced-ads-setting-tabs`, `advanced-ads-adsense-settings-init` |
| 232 | * removed hooks: `advanced-ads-gadsense-after-id-changed` |
| 233 | |
| 234 | = 1.5.0 = |
| 235 | |
| 236 | * major changes in the code base to support upcoming features |
| 237 | * further interface cleanup |
| 238 | * fully implemented autoloading |
| 239 | * added composer definitions |
| 240 | * hook modules deep into ad selection and display |
| 241 | * autoload modules (for base plugin and add-ons) |
| 242 | * added `advanced-ads-ad-select-args` filter to modify ad selection arguments |
| 243 | * added `advanced-ads-ad-select-methods` filter to append or override ad code selection methods |
| 244 | * standardise and autoload modules |
| 245 | * add AJAX handler |
| 246 | |
| 247 | = 1.4.9 = |
| 248 | |
| 249 | * added option to hide ads from crawlers and other bots (option is disabled by default) |
| 250 | * added Secondary Queries display condition, e.g. to hide ads from posts in sidebars |
| 251 | * added frontend function `advads_can_display_ads()` to check if ads are displayed in general |
| 252 | * global option to disable all ads in secondary queries |
| 253 | * search for term ids in display conditions |
| 254 | * fixed ad conditions using conditional tags of subquery instead of the main query |
| 255 | * fixed search for terms in display conditions |
| 256 | |
| 257 | = 1.4.8 = |
| 258 | |
| 259 | * COMPLETE MAKEOVER OF AD GROUPS |
| 260 | * added ordered ad group type to control the order of ads displayed |
| 261 | * display multiple ads from an ad group (allowing ad blocks) |
| 262 | * fixed wrong group ids displaying ads |
| 263 | * fixed ads group output being empty on first frontend impression |
| 264 | * added filter `advanced-ads-group-types` |
| 265 | |
| 266 | = 1.4.7 = |
| 267 | |
| 268 | * COOL: beautiful selection of terms in display conditions |
| 269 | * search for terms if there are more than 50 in the current taxonomy |
| 270 | * updated more messages in the dashboard |
| 271 | * fixed expiry date discrepancy |
| 272 | * minor general code fixes |
| 273 | * minor fix for AdSense ads |
| 274 | |
| 275 | = 1.4.6 = |
| 276 | |
| 277 | * hotfix |
| 278 | |
| 279 | = 1.4.5 = |
| 280 | |
| 281 | * optimized code for some WordPress coding standards |
| 282 | * ad content injection now also supports tags with attributes (e.g. `<h2 class="headline">) |
| 283 | * added `advanced-ads-output-inside-wrapper` filter |
| 284 | * avoid session for gadsense module option page |
| 285 | * complete makeover of display conditions for specific page types |
| 286 | * added logic for important update messages |
| 287 | * fix for `is_home` condition |
| 288 | |
| 289 | = 1.4.4 = |
| 290 | |
| 291 | * possible hotfix for update issue |
| 292 | * cleared unneeded sessions for better performance |
| 293 | |
| 294 | = 1.4.3 = |
| 295 | |
| 296 | * COOL: complete makeover of the plugin dashboard based on WP standards |
| 297 | * added `advanced-ads-admin-overview-after` action hook to overview page |
| 298 | * fixed display of only 10 posts for display conditions |
| 299 | * minor optimization |
| 300 | * updated German translation |
| 301 | |
| 302 | = 1.4.2 = |
| 303 | |
| 304 | * COOL: [vote for and suggest features](http://wpadvancedads.com/feature-requests/) |
| 305 | * switching from an existing plain text ad with AdSense code into the AdSense ad type gets the right options automatically |
| 306 | * added Advanced Ads Tutorials rss to dashboard widget |
| 307 | |
| 308 | Need ad analytics and impression tracking? Try the [tracking add-on](http://wpadvancedads.com/ad-tracking/). |
| 309 | |
| 310 | = 1.4.1 = |
| 311 | |
| 312 | * COOL: limitation of AdSense ads prevents you from breaking the AdSense terms of service (can be disabled) |
| 313 | * added option to change the content injection priority |
| 314 | * load ad output for content injection only, if injection is possible |
| 315 | * added hook `advanced-ads-settings-init` to add new settings |
| 316 | * renamed multiple hooks in the AdSense module |
| 317 | * updated German translation |
| 318 | |
| 319 | = 1.4.0 = |
| 320 | |
| 321 | * COOL: AdSense ad type, [manual](http://wpadvancedads.com/manual/ad-types/adsense-ads/) |
| 322 | * added multiple action hooks |
| 323 | * fix translation of textdomain if the plugin folder is renamed |
| 324 | * load pro module, if exists |
| 325 | * updated German translation |
| 326 | |
| 327 | [Changelog Archive](http://wpadvancedads.com/advancedads/codex/changelog-archive/) |
| 328 | |
| 329 | == Upgrade Notice == |
| 330 | |
| 331 | = 1.3.2 = |
| 332 | |
| 333 | Hotfix: prevent infinite loops (ads within ads) for rich content ads |
| 334 | |
| 335 | = 1.3 = |
| 336 | |
| 337 | Don’t miss out on the new layout options to align ads and set margins |
| 338 | Also fixed issues with languages and added Italien and German translation (partial) |
| 339 |