advanced-ads
Last commit date
admin
10 years ago
classes
10 years ago
includes
11 years ago
languages
10 years ago
modules
10 years ago
public
10 years ago
vendor
11 years ago
LICENSE.txt
12 years ago
advanced-ads.php
10 years ago
composer.json
11 years ago
composer.lock
11 years ago
index.php
12 years ago
readme.txt
10 years ago
uninstall.php
11 years ago
readme.txt
457 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.6.6 |
| 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 | * flash files including a fallback – included in [Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) |
| 37 | |
| 38 | = display ads = |
| 39 | |
| 40 | * auto inject ads (see _ad injection_ below) |
| 41 | * display ad in template files (with functions) |
| 42 | * display ad in post content (with shortcodes) |
| 43 | * widget to display ads in widget areas (sidebars) |
| 44 | * display grouped ads based on customizable ad weight |
| 45 | * use placements in your theme to change ads and groups in template files without coding |
| 46 | * disable all ads on individual single pages |
| 47 | * set start time and expiry date for ads |
| 48 | * display multiple ads from an ad group (ad blocks) |
| 49 | * define the order of ads from an ad group and allow default ads |
| 50 | |
| 51 | = display conditions = |
| 52 | |
| 53 | deliver ads based on conditions like |
| 54 | |
| 55 | * individual posts, pages and other post type |
| 56 | * post type |
| 57 | * posts by category, tags, taxonomies |
| 58 | * archive pages by category, tags, taxonomies |
| 59 | * special page types like 404, attachment and front page |
| 60 | * hide ads on secondary queries (e.g. posts in sidebars) |
| 61 | |
| 62 | global conditions |
| 63 | |
| 64 | * disable all ads in the frontend (e.g. when your ad network breaks down) |
| 65 | * disable all ads on 404 pages (e.g. AdSense doesn’t allow that) |
| 66 | * disable all ads on non-singular pages with a single click |
| 67 | * disable all ads in secondary queries |
| 68 | * hide ads from bots and web crawlers |
| 69 | |
| 70 | = visitor conditions = |
| 71 | |
| 72 | display ads by conditions based on the visitor |
| 73 | |
| 74 | * display or hide ads for mobile visitors |
| 75 | * display or hide ads for logged in visitors |
| 76 | * hide all ads from logged in users based on their role |
| 77 | * advanced visitor conditions: previous visited url (referrer), user capability, browser language, browser and device, url parameters included in [Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) |
| 78 | * display ads by exact browser width with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 79 | |
| 80 | = ad injection | placements = |
| 81 | |
| 82 | Placements to inject ads in pre-defined positions in your theme and content: |
| 83 | |
| 84 | * ads after any given paragraph or headline in the post content |
| 85 | * ads at the top of the post content |
| 86 | * ads at the bottom of the post content |
| 87 | * ads before closing `</head>` tag |
| 88 | * ads into page footer |
| 89 | * many more with [add-ons](https://wpadvancedads.com/add-ons/) |
| 90 | |
| 91 | = ad networks = |
| 92 | |
| 93 | Advanced Ads is compatible with all ad networks and banners from affiliate programs like Google AdSense, Chitika, Clickbank, Amazon, etc. |
| 94 | You can also use it to add additional ad network tags into header or footer of your site without additional coding) |
| 95 | |
| 96 | = Google AdSense = |
| 97 | |
| 98 | There is an ad type dedicated to Google AdSense that supports: |
| 99 | |
| 100 | * switch ad sizes |
| 101 | * switch between normal and responsive |
| 102 | * automatic limit 3 AdSense ads according to AdSense terms of service (can be disabled) |
| 103 | * assistant for exact sizes of responsive ads with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 104 | |
| 105 | = based on WordPress standards = |
| 106 | |
| 107 | * integrated into WordPress using standards like custom post types, taxonomies and hooks |
| 108 | * easily customizable by any WordPress plugin developer |
| 109 | |
| 110 | Learn more on the [plugin homepage](https://wpadvancedads.com). |
| 111 | |
| 112 | Localizations: English, German, Italien, Portuguese |
| 113 | |
| 114 | > <strong>Add-Ons</strong> |
| 115 | > |
| 116 | > * [Advanced Ads Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) – powerful tools for ad optimizations: cache-busting, more placements, etc. |
| 117 | > * [Tracking](https://wpadvancedads.com/add-ons/tracking/) – ad tracking and statistics |
| 118 | > * [Responsive Ads ](https://wpadvancedads.com/add-ons/responsive-ads/) – create mobile ads or ads for specific browser sizes |
| 119 | > * [Sticky Ads](https://wpadvancedads.com/sticky-ads/demo/) – increase click rates with fixed, sticky, and anchor ads |
| 120 | > * [PopUp and Layer Ads](https://wpadvancedads.com/add-ons/popup-and-layer-ads/) – display ads and other content in layers and popups |
| 121 | > * [Slider](https://wpadvancedads.com/add-ons/slider/) – create a simple slider from your ads |
| 122 | |
| 123 | == Installation == |
| 124 | |
| 125 | How to install the plugin and get it working? |
| 126 | |
| 127 | = Using The WordPress Dashboard = |
| 128 | |
| 129 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 130 | 2. Search for 'advanced ads' |
| 131 | 3. Click 'Install Now' |
| 132 | 4. Activate Advanced Ads on the Plugin dashboard |
| 133 | |
| 134 | = Uploading in WordPress Dashboard = |
| 135 | |
| 136 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 137 | 2. Navigate to the 'Upload' area |
| 138 | 3. Select `advanced-ads.zip` from your computer |
| 139 | 4. Click 'Install Now' |
| 140 | 5. Activate Advanced Ads in the Plugin dashboard |
| 141 | |
| 142 | = Using FTP = |
| 143 | |
| 144 | 1. Download `advanced-ads.zip` |
| 145 | 2. Extract the `advanced-ads` directory to your computer |
| 146 | 3. Upload the `advanced-ads` directory to the `/wp-content/plugins/` directory |
| 147 | 4. Activate Advanced Ads in the Plugin dashboard |
| 148 | |
| 149 | == Displaying Ads == |
| 150 | |
| 151 | You can use functions and shortcodes to display ads and ad groups. |
| 152 | |
| 153 | The integers in this example are the IDs of the elements. |
| 154 | |
| 155 | Use these shortcode to insert an ad or ad group into your post/page. |
| 156 | |
| 157 | `[the_ad id="24"]` |
| 158 | `[the_ad_group id="5"]` |
| 159 | |
| 160 | Use these functions to insert an ad or ad group into your template file. |
| 161 | |
| 162 | `<?php the_ad(24); ?>` |
| 163 | `<?php the_ad_group(5); ?>` |
| 164 | |
| 165 | In addition to directly displaying ads and groups you can define ad placements and assign either an ad or group to them. |
| 166 | |
| 167 | `[the_ad_placement id="header-left"]` |
| 168 | `<?php the_ad_placement('header-left'); ?>` |
| 169 | |
| 170 | == Frequently Asked Questions == |
| 171 | |
| 172 | = Is there a revenue share? = |
| 173 | |
| 174 | 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. |
| 175 | |
| 176 | == Screenshots == |
| 177 | |
| 178 | 1. Create an ad almost like you would create an article or page. |
| 179 | 2. Align the ad and set a margin to other elements |
| 180 | 3. Choose from various conditions where and where not to display your ad. |
| 181 | 4. Placements that let you inject ads anywhere into your site without coding (6 in Advanced Ads + 9 through add-ons) |
| 182 | |
| 183 | == Changelog == |
| 184 | |
| 185 | = 1.6.6 = |
| 186 | |
| 187 | *features* |
| 188 | |
| 189 | * added images to placement form ui |
| 190 | * allow to select item when creating a new placement |
| 191 | * always display placement form if no placement exists |
| 192 | * display shortcode and function for default placement type |
| 193 | * display notice if license keys are invalid, expired, or expire soon |
| 194 | * display error when AdSense Publisher ID is missing |
| 195 | * log error message in case regular expression is used wrong in visitor conditions |
| 196 | |
| 197 | *fixes and under-the-hood* |
| 198 | |
| 199 | * extended advanced js by move and fix_element function |
| 200 | * minified advanced js file |
| 201 | * added `advanced-ads-sanitize-settings` filter to sanitize plugin options |
| 202 | * added `advanced-ads-can-inject-into-content` filter |
| 203 | * added `advanced-ads-dashboard-screens` filter |
| 204 | * removed wrong output on Responsive settings |
| 205 | * store jquery ui css locally |
| 206 | * fixed saving empty placement options |
| 207 | * fixed free add-on notice showing up twice |
| 208 | * fixed error message in ads list when AdSense ad is empty |
| 209 | * fixed saving quick edit on ad list returning wrong columns |
| 210 | |
| 211 | = 1.6.5 = |
| 212 | |
| 213 | * removed "use strict" from js |
| 214 | * hide error message caused by third party code that uses post_updated_messages filter wrong |
| 215 | * hide licenses tab on non-main-blogs on multisites |
| 216 | * made plugin name untranslatable |
| 217 | |
| 218 | = 1.6.4.1 = |
| 219 | |
| 220 | * fixed free-add-on notice not closing forever |
| 221 | |
| 222 | = 1.6.4 = |
| 223 | |
| 224 | COOL: newsletter subscribers now receive 2 free add-ons |
| 225 | |
| 226 | * changed newsletter subscription text |
| 227 | * display description of visitor conditions, if selected |
| 228 | * minor fix to display conditions ui |
| 229 | * updated German translation |
| 230 | |
| 231 | = 1.6.3 = |
| 232 | |
| 233 | * added visitor condition to check for logged in visitors |
| 234 | * fixed display conditions buttons |
| 235 | * updated German translation |
| 236 | |
| 237 | = 1.6.2.1 = |
| 238 | |
| 239 | * added missing files to repository |
| 240 | |
| 241 | = 1.6.2 = |
| 242 | |
| 243 | * display dashboard widget only to authors and higher roles |
| 244 | * include admin javascript file only on pages which need it |
| 245 | * no need to save AdSense publisher ID separately anymore |
| 246 | * added warning if AdSense publisher ID has wrong format |
| 247 | * list more than 10 ads from a group on the group overview page |
| 248 | * active settings and conditions are now blue |
| 249 | * clear object cache when saving an ad (thanks to pete-sch) |
| 250 | |
| 251 | = 1.6.1 = |
| 252 | |
| 253 | * fix secondary query condition (this was revered in 1.6) |
| 254 | * fix wrong constant displaying errors on add-on license page |
| 255 | * display license expire date for add-ons |
| 256 | * prevent accidental removal of license keys |
| 257 | |
| 258 | = 1.6 = |
| 259 | |
| 260 | THIS IS A MAJOR UPDATE, PLEASE HELP ME WITH YOUR BUG REPORTS |
| 261 | |
| 262 | [Update post](https://wpadvancedads.com/advanced-ads-1-6) |
| 263 | |
| 264 | Changes you can test: |
| 265 | |
| 266 | * fixed ordered ad groups displaying ads with 0 ad weight |
| 267 | * fixed order of ad groups to deliver ad with highest weight first |
| 268 | * added option to allow ad injections on archive pages and outside the loop |
| 269 | * minor layout fix for update button after selecting rich content ad type |
| 270 | * fixed timestamp issues using GMT only now (might shift old ad expiry timestamps by timezone offset) |
| 271 | * load adsense script with every ad request |
| 272 | |
| 273 | Changes under the hood: |
| 274 | |
| 275 | * allow to cache groups when persistend object cache is available |
| 276 | * pass placement options to underlying ad/ group |
| 277 | * allow to exchange loaded ad ids for ajax callback |
| 278 | * fix override option for ad select |
| 279 | * wp query is now prepared as ad argument on selection |
| 280 | * moved query based display conditions to own module |
| 281 | * fixed ajax request parser |
| 282 | * actually serve placement on injection (and allow to use placement arguments) |
| 283 | * `advanced-ads-ajax-ad-select-init` action when ad is going to be selected by ajax call |
| 284 | * provide action when plugin was loaded |
| 285 | |
| 286 | = 1.5.6 = |
| 287 | |
| 288 | * check out the new [Slider add-on](https://wpadvancedads.com/add-ons/slider/) |
| 289 | * please [vote for your preferred support channel](http://webgilde.com/en/how-would-you-like-to-get-help/) |
| 290 | * display usage help after an ad was published |
| 291 | * fixed AdSense ads counting when injected outside the loop |
| 292 | * added better explanation for visitor conditions |
| 293 | * updated German translation |
| 294 | |
| 295 | = 1.5.5 = |
| 296 | |
| 297 | * fixed outdated links to the manual and feature requests |
| 298 | * added hooks and options to be able to extend ad groups |
| 299 | |
| 300 | = 1.5.4.1 = |
| 301 | |
| 302 | * hotfix for new visitor conditions not showing up |
| 303 | |
| 304 | = 1.5.4 = |
| 305 | |
| 306 | * PLEASE READ the [update notice](https://wpadvancedads.com/advanced-ads-1-5-4/) to learn more about the changes on visitor conditions |
| 307 | * visitor conditions completely rewritten to allow combination of multiple conditions |
| 308 | * created simpler placement creation |
| 309 | * reordered Advanced Ads dashboard |
| 310 | * added AdSense tutorial |
| 311 | |
| 312 | = 1.5.3 = |
| 313 | |
| 314 | * display all ads of an ad group |
| 315 | * no ad wrapper is created if the main ad content is empty |
| 316 | * hide ad meta box on posts and pages for non admins |
| 317 | * display if ad expired on group overview |
| 318 | * added tutorial subscription |
| 319 | * added notices and newsletter logic |
| 320 | * new hook `advanced-ads-debug-after` |
| 321 | * updated all class names from "Advads_" to "Advanced_Ads_" |
| 322 | * updated German translation |
| 323 | |
| 324 | = 1.5.2.1 = |
| 325 | |
| 326 | * fixed inclusion / exclusion of ads for single posts |
| 327 | |
| 328 | = 1.5.2 = |
| 329 | |
| 330 | * fixed empty bots not excluded if option is activated |
| 331 | * fixed updated placements not showing up right away |
| 332 | * removing spaces from AdSense publisher id |
| 333 | * simplify admin capabilities for modules |
| 334 | * fixed admin includes to avoid relative paths |
| 335 | * fixed a warning in add-on admin settings |
| 336 | * fixed wrong path to advanced.js |
| 337 | * removed old code and global ad conditions previously saved in field 'advads-ads-by-conditions' |
| 338 | * updated German translation |
| 339 | |
| 340 | = 1.5.1 = |
| 341 | |
| 342 | * added tab menu für settings |
| 343 | * allow to set ad weights for pending, future and private ads |
| 344 | * improvements to groups overview based on group types |
| 345 | * fixed switching ad types |
| 346 | * fixed individual post conditions not showing up |
| 347 | * fixed update message being displayed for new installations |
| 348 | * other fixes under the hood |
| 349 | * new hooks: `advanced-ads-setting-tabs`, `advanced-ads-adsense-settings-init` |
| 350 | * removed hooks: `advanced-ads-gadsense-after-id-changed` |
| 351 | |
| 352 | = 1.5.0 = |
| 353 | |
| 354 | * major changes in the code base to support upcoming features |
| 355 | * further interface cleanup |
| 356 | * fully implemented autoloading |
| 357 | * added composer definitions |
| 358 | * hook modules deep into ad selection and display |
| 359 | * autoload modules (for base plugin and add-ons) |
| 360 | * added `advanced-ads-ad-select-args` filter to modify ad selection arguments |
| 361 | * added `advanced-ads-ad-select-methods` filter to append or override ad code selection methods |
| 362 | * standardise and autoload modules |
| 363 | * add AJAX handler |
| 364 | |
| 365 | = 1.4.9 = |
| 366 | |
| 367 | * added option to hide ads from crawlers and other bots (option is disabled by default) |
| 368 | * added Secondary Queries display condition, e.g. to hide ads from posts in sidebars |
| 369 | * added frontend function `advads_can_display_ads()` to check if ads are displayed in general |
| 370 | * global option to disable all ads in secondary queries |
| 371 | * search for term ids in display conditions |
| 372 | * fixed ad conditions using conditional tags of subquery instead of the main query |
| 373 | * fixed search for terms in display conditions |
| 374 | |
| 375 | = 1.4.8 = |
| 376 | |
| 377 | * COMPLETE MAKEOVER OF AD GROUPS |
| 378 | * added ordered ad group type to control the order of ads displayed |
| 379 | * display multiple ads from an ad group (allowing ad blocks) |
| 380 | * fixed wrong group ids displaying ads |
| 381 | * fixed ads group output being empty on first frontend impression |
| 382 | * added filter `advanced-ads-group-types` |
| 383 | |
| 384 | = 1.4.7 = |
| 385 | |
| 386 | * COOL: beautiful selection of terms in display conditions |
| 387 | * search for terms if there are more than 50 in the current taxonomy |
| 388 | * updated more messages in the dashboard |
| 389 | * fixed expiry date discrepancy |
| 390 | * minor general code fixes |
| 391 | * minor fix for AdSense ads |
| 392 | |
| 393 | = 1.4.6 = |
| 394 | |
| 395 | * hotfix |
| 396 | |
| 397 | = 1.4.5 = |
| 398 | |
| 399 | * optimized code for some WordPress coding standards |
| 400 | * ad content injection now also supports tags with attributes (e.g. `<h2 class="headline">) |
| 401 | * added `advanced-ads-output-inside-wrapper` filter |
| 402 | * avoid session for gadsense module option page |
| 403 | * complete makeover of display conditions for specific page types |
| 404 | * added logic for important update messages |
| 405 | * fix for `is_home` condition |
| 406 | |
| 407 | = 1.4.4 = |
| 408 | |
| 409 | * possible hotfix for update issue |
| 410 | * cleared unneeded sessions for better performance |
| 411 | |
| 412 | = 1.4.3 = |
| 413 | |
| 414 | * COOL: complete makeover of the plugin dashboard based on WP standards |
| 415 | * added `advanced-ads-admin-overview-after` action hook to overview page |
| 416 | * fixed display of only 10 posts for display conditions |
| 417 | * minor optimization |
| 418 | * updated German translation |
| 419 | |
| 420 | = 1.4.2 = |
| 421 | |
| 422 | * COOL: [vote for and suggest features](http://wpadvancedads.com/feature-requests/) |
| 423 | * switching from an existing plain text ad with AdSense code into the AdSense ad type gets the right options automatically |
| 424 | * added Advanced Ads Tutorials rss to dashboard widget |
| 425 | |
| 426 | Need ad analytics and impression tracking? Try the [tracking add-on](http://wpadvancedads.com/ad-tracking/). |
| 427 | |
| 428 | = 1.4.1 = |
| 429 | |
| 430 | * COOL: limitation of AdSense ads prevents you from breaking the AdSense terms of service (can be disabled) |
| 431 | * added option to change the content injection priority |
| 432 | * load ad output for content injection only, if injection is possible |
| 433 | * added hook `advanced-ads-settings-init` to add new settings |
| 434 | * renamed multiple hooks in the AdSense module |
| 435 | * updated German translation |
| 436 | |
| 437 | = 1.4.0 = |
| 438 | |
| 439 | * COOL: AdSense ad type, [manual](http://wpadvancedads.com/manual/ad-types/adsense-ads/) |
| 440 | * added multiple action hooks |
| 441 | * fix translation of textdomain if the plugin folder is renamed |
| 442 | * load pro module, if exists |
| 443 | * updated German translation |
| 444 | |
| 445 | [Changelog Archive](http://wpadvancedads.com/advancedads/codex/changelog-archive/) |
| 446 | |
| 447 | == Upgrade Notice == |
| 448 | |
| 449 | = 1.3.2 = |
| 450 | |
| 451 | Hotfix: prevent infinite loops (ads within ads) for rich content ads |
| 452 | |
| 453 | = 1.3 = |
| 454 | |
| 455 | Don’t miss out on the new layout options to align ads and set margins |
| 456 | Also fixed issues with languages and added Italien and German translation (partial) |
| 457 |