advanced-ads
Last commit date
admin
10 years ago
classes
10 years ago
includes
10 years ago
languages
10 years ago
modules
10 years ago
public
10 years ago
vendor
10 years ago
LICENSE.txt
12 years ago
advanced-ads.php
10 years ago
composer.json
11 years ago
composer.lock
10 years ago
index.php
12 years ago
readme.txt
10 years ago
uninstall.php
11 years ago
readme.txt
482 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 4.2, PHP 5.3 |
| 6 | Tested up to: 4.4.1 |
| 7 | Stable tag: 1.6.16 |
| 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 | [Full Feature List](https://wpadvancedads.com/features/). |
| 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 | = best support for mobile devices = |
| 97 | |
| 98 | * display ads for mobile or desktop only |
| 99 | * display responsive image ads (WordPress 4.4 and later) |
| 100 | * ads for specific browser sizes only using [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 101 | |
| 102 | = Google AdSense = |
| 103 | |
| 104 | * switch sizes of an ad |
| 105 | * switch between normal and responsive ads |
| 106 | * automatic limit 3 AdSense ads according to AdSense terms of service (can be disabled) |
| 107 | * hide AdSense on 404 pages by default (to comply with AdSense terms) |
| 108 | * insert Page-Level ads code globally |
| 109 | * assistant for exact sizes of responsive ads with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 110 | |
| 111 | = ad blocker = |
| 112 | |
| 113 | * basic features to prevent ad blocks from being removed by AdBlock and co |
| 114 | * prevent ad blockers from breaking sites where plugin scripts are running |
| 115 | |
| 116 | = based on WordPress standards = |
| 117 | |
| 118 | * integrated into WordPress using standards like custom post types, taxonomies and hooks |
| 119 | * easily customizable by any WordPress plugin developer |
| 120 | |
| 121 | Learn more on the [plugin homepage](https://wpadvancedads.com). |
| 122 | |
| 123 | Localizations: English, German, Dutch, Italian, Portuguese |
| 124 | |
| 125 | > <strong>Add-Ons</strong> |
| 126 | > |
| 127 | > * [Advanced Ads Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) – powerful tools for ad optimizations: cache-busting, more placements, etc. |
| 128 | > * [Tracking](https://wpadvancedads.com/add-ons/tracking/) – ad tracking and statistics |
| 129 | > * [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) – create mobile ads or ads for specific browser sizes |
| 130 | > * [Sticky Ads](https://wpadvancedads.com/sticky-ads/demo/) – increase click rates with fixed, sticky, and anchor ads |
| 131 | > * [PopUp and Layer Ads](https://wpadvancedads.com/add-ons/popup-and-layer-ads/) – display ads and other content in layers and popups |
| 132 | > * [Slider](https://wpadvancedads.com/add-ons/slider/) – create a simple slider from your ads |
| 133 | |
| 134 | == Installation == |
| 135 | |
| 136 | How to install the plugin and get it working? |
| 137 | |
| 138 | = Using The WordPress Dashboard = |
| 139 | |
| 140 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 141 | 2. Search for 'advanced ads' |
| 142 | 3. Click 'Install Now' |
| 143 | 4. Activate Advanced Ads on the Plugin dashboard |
| 144 | |
| 145 | = Uploading in WordPress Dashboard = |
| 146 | |
| 147 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 148 | 2. Navigate to the 'Upload' area |
| 149 | 3. Select `advanced-ads.zip` from your computer |
| 150 | 4. Click 'Install Now' |
| 151 | 5. Activate Advanced Ads in the Plugin dashboard |
| 152 | |
| 153 | = Using FTP = |
| 154 | |
| 155 | 1. Download `advanced-ads.zip` |
| 156 | 2. Extract the `advanced-ads` directory to your computer |
| 157 | 3. Upload the `advanced-ads` directory to the `/wp-content/plugins/` directory |
| 158 | 4. Activate Advanced Ads in the Plugin dashboard |
| 159 | |
| 160 | == Displaying Ads == |
| 161 | |
| 162 | You can use functions and shortcodes to display ads and ad groups. |
| 163 | |
| 164 | The integers in this example are the IDs of the elements. |
| 165 | |
| 166 | Use these shortcode to insert an ad or ad group into your post/page. |
| 167 | |
| 168 | `[the_ad id="24"]` |
| 169 | `[the_ad_group id="5"]` |
| 170 | |
| 171 | Use these functions to insert an ad or ad group into your template file. |
| 172 | |
| 173 | `<?php the_ad(24); ?>` |
| 174 | `<?php the_ad_group(5); ?>` |
| 175 | |
| 176 | In addition to directly displaying ads and groups you can define ad placements and assign either an ad or group to them. |
| 177 | |
| 178 | `[the_ad_placement id="header-left"]` |
| 179 | `<?php the_ad_placement('header-left'); ?>` |
| 180 | |
| 181 | == Frequently Asked Questions == |
| 182 | |
| 183 | = Is there a revenue share? = |
| 184 | |
| 185 | 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. |
| 186 | |
| 187 | == Screenshots == |
| 188 | |
| 189 | 1. Create an ad almost like you would create an article or page. |
| 190 | 2. Align the ad and set a margin to other elements |
| 191 | 3. Choose from various conditions where and where not to display your ad. |
| 192 | 4. Placements that let you inject ads anywhere into your site without coding (6 in Advanced Ads + 9 through add-ons) |
| 193 | |
| 194 | == Changelog == |
| 195 | |
| 196 | = 1.6.16 = |
| 197 | |
| 198 | * added link to manual for mobile devices visitor condition |
| 199 | * added links to support and add-ons to plugin page |
| 200 | * fixed potential issue for licenses on multisites |
| 201 | * fixed missing wrapper for placements with a group |
| 202 | * fixed missing index error for widget |
| 203 | * fixed missing index error for display conditions |
| 204 | |
| 205 | = 1.6.15 = |
| 206 | |
| 207 | * added overview widget for [Geo Targeting add-on](https://wpadvancedads.com/add-ons/geo-targeting/) |
| 208 | * added ad block disguise for plugin files |
| 209 | * fixed missing wrapper id |
| 210 | * fixed link to license page on multisites |
| 211 | * fixed links on intro page |
| 212 | * fixed rare license activation error |
| 213 | * fixed license issue on multisites |
| 214 | * under the hood: changes for ad select of ads and groups for auto cache-busting |
| 215 | |
| 216 | = 1.6.14 = |
| 217 | |
| 218 | Please [share your ideas](https://wpadvancedads.com/advanced-ads-1-6-14/) about more capabilities. |
| 219 | |
| 220 | * option to allow editors to manage ads |
| 221 | * remove shortcut icon from tinymce editor for non-admins |
| 222 | |
| 223 | = 1.6.13 = |
| 224 | |
| 225 | * added responsive images as introduced in WordPress 4.4 |
| 226 | * tested with WordPress 4.4 beta 4 |
| 227 | * hide AdSense on 404 pages by default |
| 228 | * fix add-on updates check in front ajax calls |
| 229 | * noindex image ad attachment pages |
| 230 | * fixed random bug where already existing class causes the plugin not to work |
| 231 | |
| 232 | = 1.6.12 = |
| 233 | |
| 234 | * added filters to ad list |
| 235 | * display expired date in ad list |
| 236 | * display ad dates in ads list on group page |
| 237 | * hide unrelated columns in ad list |
| 238 | * fix saving adsense ad unit as non-superadmin |
| 239 | * error message for possible jQueryUI library conflicts |
| 240 | * fix widget_title override |
| 241 | |
| 242 | = 1.6.11.1 = |
| 243 | |
| 244 | * hotfix for widgets |
| 245 | |
| 246 | = 1.6.11 = |
| 247 | |
| 248 | * added icon to rich media editor to quickly add shortcodes |
| 249 | * added widget placement type |
| 250 | * added new column for ad planning |
| 251 | * TinyMCE is now working when ad type is switched to content ad |
| 252 | * enable license key deactivation |
| 253 | * hide unnecessary fields for image ads in media gallery |
| 254 | * loading jQuery ui styles only on Advanced Ads dashboard pages now |
| 255 | * fixed AdSense ad not retrieving values due to slashes |
| 256 | * fixed issue with licenses being activated twice |
| 257 | |
| 258 | = 1.6.10.2 = |
| 259 | |
| 260 | * warn on support page if ads are (partially) disabled |
| 261 | * inform users of Pro that AdSense limit does not work with cache-busting |
| 262 | * added hooks to extend content injection |
| 263 | * group slug hidden, because it currently serves no purpose |
| 264 | * fixed possible issues with content injection priority being lower than wpautop |
| 265 | |
| 266 | = 1.6.10.1 = |
| 267 | |
| 268 | * hotfix for empty id field |
| 269 | |
| 270 | = 1.6.10 = |
| 271 | |
| 272 | * added image ad type |
| 273 | * added option to set id and class attributes |
| 274 | * added check for conflicting plugins |
| 275 | * allow a higher number of visible ads in a group if more are existing |
| 276 | |
| 277 | = 1.6.9.4 = |
| 278 | |
| 279 | * last settings tab is now opened again after being saved |
| 280 | * exchanged text domain constants with string to match wp.org translate criteria |
| 281 | |
| 282 | = 1.6.9.3 = |
| 283 | |
| 284 | * order placement list by slug (which normally equals name) |
| 285 | * updated Autoptimize message. If you use the Autoptimize plugin then check out the Autoptimize-Support in [Advanced Ads Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) |
| 286 | * unquote json request |
| 287 | * added missing advertisement image for AdBlock check |
| 288 | * added `advanced-ads-can-inject-into-content-` hook to check if individual placements can be injected into the content |
| 289 | |
| 290 | = 1.6.9.2 = |
| 291 | |
| 292 | * small adjustment to make cache-busting from [Advanced Ads Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) compatible with [Sticky Ads](https://wpadvancedads.com/add-ons/sticky-ads/) |
| 293 | |
| 294 | = 1.6.9.1 = |
| 295 | |
| 296 | * fixed AdBlocker check on Support page |
| 297 | * display Advanced Ads notices on Support page |
| 298 | |
| 299 | = 1.6.9 = |
| 300 | |
| 301 | *features* |
| 302 | |
| 303 | * add AdSense Page-Level ads code globally |
| 304 | * added hours and minutes to expiry date |
| 305 | * allow to set content priority to negative value |
| 306 | * added checks for main issues to the Support page |
| 307 | * added check for AdBlocker to all Advanced Ads pages in the dashboard |
| 308 | |
| 309 | *fixes and maintenance* |
| 310 | |
| 311 | * don’t display error message if not on archive page |
| 312 | * fixed issue with placement tooltips not showing up |
| 313 | * optimized content injection code |
| 314 | * added collapsed field for advanced placement options |
| 315 | * fix "support email sent" message showing all the time |
| 316 | * allow JSON encoded arguments for ajax callback |
| 317 | * make conditions case insensitive and binary safe |
| 318 | * renamed some classes belonging to AdSense module |
| 319 | * updated composer |
| 320 | * display warning on AdSense settings page if publisher ID is missing |
| 321 | * optimized support form layout |
| 322 | * added can-display check + filter for placements |
| 323 | |
| 324 | = 1.6.8.3 = |
| 325 | |
| 326 | * Hoe vet is dat!? – added Dutch translation |
| 327 | * fix selecting placement type in IE 11 |
| 328 | * fix errors with content injection when mbstring extension is missing on the server |
| 329 | |
| 330 | = 1.6.8.2 = |
| 331 | |
| 332 | * added introduction page with first steps |
| 333 | * optimized error handling in placement form |
| 334 | * added option to remove the public id from widgets completely |
| 335 | * rewritten dismiss buttons of notices based on new WP standard |
| 336 | |
| 337 | = 1.6.8.1 = |
| 338 | |
| 339 | * added menu page to get support from within your dashboard |
| 340 | * stricter control of ad group archives not being public |
| 341 | * fix: content-injection requires more than one item per level for p-tags only |
| 342 | * updated German translation |
| 343 | |
| 344 | = 1.6.8 = |
| 345 | |
| 346 | * added option to change the prefix of ids and classes in the frontend to prevent widgets from being ad-blocked |
| 347 | * minor optimization to autocomplete feature of post display condition |
| 348 | * minor changes to align with changes in WordPress 4.3 |
| 349 | * content-injection now detects wrappers around content up to the third level |
| 350 | |
| 351 | = 1.6.7.1 = |
| 352 | |
| 353 | * hotfix to prevent error message on empty content injection placements |
| 354 | |
| 355 | = 1.6.7 = |
| 356 | |
| 357 | *features* |
| 358 | |
| 359 | * allow to inject ads into content starting from bottom |
| 360 | * prevent ad injection into lower-level paragraphs (e.g. into tables or containers) |
| 361 | * hide ad widget when the content is empty |
| 362 | * show post type or date when searching an individual post display condition |
| 363 | |
| 364 | *fixes and maintenance* |
| 365 | |
| 366 | * fix placement types images not showing up completely |
| 367 | * warn if any used placement type is missing |
| 368 | * added `advads-ad-allow-php` class to php-setting of plain text |
| 369 | * added `advanced-ads-activate-advanced-js` filter to allow add-ons to attach advanced js file without bothering the user |
| 370 | * updated German translation |
| 371 | |
| 372 | = 1.6.6.1 = |
| 373 | |
| 374 | * removed link to no-longer-existing manual page |
| 375 | * the option to close internal notices now also hides update messages |
| 376 | * fixed broken html on placement page |
| 377 | |
| 378 | = 1.6.6 = |
| 379 | |
| 380 | *features* |
| 381 | |
| 382 | * added images to placement form ui |
| 383 | * allow to select item when creating a new placement |
| 384 | * always display placement form if no placement exists |
| 385 | * display shortcode and function for default placement type |
| 386 | * display notice if license keys are invalid, expired, or expire soon |
| 387 | * display error when AdSense Publisher ID is missing |
| 388 | * log error message in case regular expression is used wrong in visitor conditions |
| 389 | |
| 390 | *fixes and under-the-hood* |
| 391 | |
| 392 | * extended advanced js by move and fix_element function |
| 393 | * minified advanced js file |
| 394 | * added `advanced-ads-sanitize-settings` filter to sanitize plugin options |
| 395 | * added `advanced-ads-can-inject-into-content` filter |
| 396 | * added `advanced-ads-dashboard-screens` filter |
| 397 | * removed wrong output on Responsive settings |
| 398 | * store jquery ui css locally |
| 399 | * fixed saving empty placement options |
| 400 | * fixed free add-on notice showing up twice |
| 401 | * fixed error message in ads list when AdSense ad is empty |
| 402 | * fixed saving quick edit on ad list returning wrong columns |
| 403 | |
| 404 | = 1.6.5 = |
| 405 | |
| 406 | * removed "use strict" from js |
| 407 | * hide error message caused by third party code that uses post_updated_messages filter wrong |
| 408 | * hide licenses tab on non-main-blogs on multisites |
| 409 | * made plugin name untranslatable |
| 410 | |
| 411 | = 1.6.4.1 = |
| 412 | |
| 413 | * fixed free-add-on notice not closing forever |
| 414 | |
| 415 | = 1.6.4 = |
| 416 | |
| 417 | COOL: newsletter subscribers now receive 2 free add-ons |
| 418 | |
| 419 | * changed newsletter subscription text |
| 420 | * display description of visitor conditions, if selected |
| 421 | * minor fix to display conditions ui |
| 422 | * updated German translation |
| 423 | |
| 424 | = 1.6.3 = |
| 425 | |
| 426 | * added visitor condition to check for logged in visitors |
| 427 | * fixed display conditions buttons |
| 428 | * updated German translation |
| 429 | |
| 430 | = 1.6.2.1 = |
| 431 | |
| 432 | * added missing files to repository |
| 433 | |
| 434 | = 1.6.2 = |
| 435 | |
| 436 | * display dashboard widget only to authors and higher roles |
| 437 | * include admin javascript file only on pages which need it |
| 438 | * no need to save AdSense publisher ID separately anymore |
| 439 | * added warning if AdSense publisher ID has wrong format |
| 440 | * list more than 10 ads from a group on the group overview page |
| 441 | * active settings and conditions are now blue |
| 442 | * clear object cache when saving an ad (thanks to pete-sch) |
| 443 | |
| 444 | = 1.6.1 = |
| 445 | |
| 446 | * fix secondary query condition (this was revered in 1.6) |
| 447 | * fix wrong constant displaying errors on add-on license page |
| 448 | * display license expire date for add-ons |
| 449 | * prevent accidental removal of license keys |
| 450 | |
| 451 | = 1.6 = |
| 452 | |
| 453 | THIS IS A MAJOR UPDATE, PLEASE HELP ME WITH YOUR BUG REPORTS |
| 454 | |
| 455 | [Update post](https://wpadvancedads.com/advanced-ads-1-6) |
| 456 | |
| 457 | Changes you can test: |
| 458 | |
| 459 | * fixed ordered ad groups displaying ads with 0 ad weight |
| 460 | * fixed order of ad groups to deliver ad with highest weight first |
| 461 | * added option to allow ad injections on archive pages and outside the loop |
| 462 | * minor layout fix for update button after selecting rich content ad type |
| 463 | * fixed timestamp issues using GMT only now (might shift old ad expiry timestamps by timezone offset) |
| 464 | * load adsense script with every ad request |
| 465 | |
| 466 | Changes under the hood: |
| 467 | |
| 468 | * allow to cache groups when persistend object cache is available |
| 469 | * pass placement options to underlying ad/ group |
| 470 | * allow to exchange loaded ad ids for ajax callback |
| 471 | * fix override option for ad select |
| 472 | * wp query is now prepared as ad argument on selection |
| 473 | * moved query based display conditions to own module |
| 474 | * fixed ajax request parser |
| 475 | * actually serve placement on injection (and allow to use placement arguments) |
| 476 | * `advanced-ads-ajax-ad-select-init` action when ad is going to be selected by ajax call |
| 477 | * provide action when plugin was loaded |
| 478 | |
| 479 | [Changelog Archive](http://wpadvancedads.com/codex/changelog-archive/) |
| 480 | |
| 481 | == Upgrade Notice == |
| 482 |