advanced-ads
Last commit date
admin
9 years ago
classes
9 years ago
includes
9 years ago
languages
9 years ago
modules
9 years ago
public
9 years ago
vendor
9 years ago
LICENSE.txt
12 years ago
advanced-ads.php
9 years ago
composer.json
11 years ago
composer.lock
9 years ago
index.php
12 years ago
readme.txt
9 years ago
readme.txt
475 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, ad inserter, ad injection, ad manager, ads manager, ad widget, adrotate, adsense, advertise, advertisements, advertising, adverts, advert, amazon, banner, banners, buysellads, chitika, clickbank, dfp, doubleclick, geotarget, geolocation, geo location, google dfp, monetization, widget |
| 5 | Requires at least: WP 4.2, PHP 5.3 |
| 6 | Tested up to: 4.7 |
| 7 | Stable tag: 1.7.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 and ads performance with support for AdSense, ad injection, ad widget, 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 advertising plugin as a powerful, but light weight solution to not only manage and insert banners 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 a banner is as easy as creating a post |
| 22 | * group ads to create ad rotations |
| 23 | * create drafts of advertisements only visible to logged in users |
| 24 | * set a date for when to publish the ad |
| 25 | * make internal notes about each ad |
| 26 | * import / export ads and settings |
| 27 | * Wizard to quickly create and place simple ads |
| 28 | |
| 29 | = ad types = |
| 30 | |
| 31 | choose between different ad types that enable you to: |
| 32 | |
| 33 | * insert code for ad and affiliate networks (e.g., AdSense, Chitika, Amazon, BuySellAds, DoubleClick) |
| 34 | * dedicated support for Google AdSense banners |
| 35 | * display images and image banners |
| 36 | * use shortcodes within ads (to also deliver advertisements from other ad plugins like AdRotate or Simple Ads Manager) |
| 37 | * create content rich ads with the tinymc editor |
| 38 | * use flash file advertisements including a fallback – included in [Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) |
| 39 | * ad group to allow ads from the same group to share conditions and settings |
| 40 | |
| 41 | = display ads = |
| 42 | |
| 43 | * auto inject banner (see _ad injection_ below) |
| 44 | * display advertising in template files (with functions) |
| 45 | * display advertising in post content (with shortcodes) |
| 46 | * ad widget for sidebars and widget areas |
| 47 | * display ad groups based on customizable ad weight |
| 48 | * use placements in your theme to insert ads and ad groups in template files without coding |
| 49 | * disable all ads on individual single pages |
| 50 | * set start time and expiry date for advertising |
| 51 | * display multiple ads from a banner group (ad blocks) |
| 52 | * define the order of ads from an ad group and allow default ads |
| 53 | * display a label, e.g. “Advertisements” above each ad |
| 54 | * compatible with site builders: SiteOrigin |
| 55 | |
| 56 | = display conditions = |
| 57 | |
| 58 | show ads based on conditions like |
| 59 | |
| 60 | * individual posts, pages and other post type |
| 61 | * post type |
| 62 | * posts by category, tags, taxonomies |
| 63 | * author |
| 64 | * archive pages by category, tags, taxonomies |
| 65 | * special page types like 404, attachment and front page |
| 66 | * hide ads on secondary queries (e.g. posts in sidebars) |
| 67 | * display or hide banners within the post feed |
| 68 | |
| 69 | global conditions |
| 70 | |
| 71 | * disable all ads in the frontend (e.g. when your ad network breaks down) |
| 72 | * disable all ads on 404 pages (e.g. AdSense doesn’t allow that) |
| 73 | * disable all ads on non-singular pages |
| 74 | * disable all ads in secondary queries |
| 75 | * disable all ads in the feed |
| 76 | * hide ads from bots and web crawlers |
| 77 | |
| 78 | = visitor conditions = |
| 79 | |
| 80 | display ads by conditions based on the visitor. [List of all visitor conditions](https://wpadvancedads.com/manual/visitor-conditions/) |
| 81 | |
| 82 | * display or hide a banner by device: mobile and tablet or desktop |
| 83 | * display or hide a banner for logged in visitors |
| 84 | * hide advertising from logged in users based on their role |
| 85 | * 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/) |
| 86 | * display ads by geo location with the [Geo Targeting add-on](https://wpadvancedads.com/add-ons/geo-targeting/) |
| 87 | * display ads by browser width with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 88 | |
| 89 | = ad injection | placements = |
| 90 | |
| 91 | Placements to insert ads in pre-defined positions in your theme and content. [List of all placements](https://wpadvancedads.com/manual/placements/) |
| 92 | |
| 93 | * ads after any given paragraph or headline in the post content |
| 94 | * ads at the top of the post content |
| 95 | * ads at the bottom of the post content |
| 96 | * ads before closing `</head>` tag |
| 97 | * ads page footer |
| 98 | * test placements against each other with [Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) |
| 99 | * many more ad inserters with [add-ons](https://wpadvancedads.com/add-ons/) |
| 100 | |
| 101 | = ad networks = |
| 102 | |
| 103 | The Advanced Ads ad manager is compatible with all ad networks and banners from affiliate programs like Google AdSense, Chitika, Clickbank, Amazon, and also Google DoubleClick (DFP). |
| 104 | You can also use it to insert additional ad network tags into header or footer of your site without additional coding. |
| 105 | |
| 106 | = best support for mobile devices = |
| 107 | |
| 108 | * display ads for mobile and tablets or desktop only |
| 109 | * display responsive image ads (WordPress 4.4 and later) |
| 110 | * ads for specific browser sizes only using [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 111 | |
| 112 | = Google AdSense = |
| 113 | |
| 114 | * switch sizes of an ad |
| 115 | * switch between normal and responsive ads |
| 116 | * optional limit to 3 AdSense banners according to AdSense terms of service |
| 117 | * hide AdSense advertisements on 404 pages by default (to comply with AdSense terms) |
| 118 | * insert Page-Level ads code globally |
| 119 | * assistant for exact sizes of responsive ads with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 120 | |
| 121 | = ad blocker = |
| 122 | |
| 123 | * basic features to prevent ad blocks from being removed by AdBlock and co |
| 124 | * prevent ad blockers from breaking sites where plugin scripts are running |
| 125 | |
| 126 | = based on WordPress standards = |
| 127 | |
| 128 | * integrated into WordPress using standards like custom post types, taxonomies and hooks |
| 129 | * easily customizable by any WordPress plugin developer |
| 130 | |
| 131 | Learn more on the [plugin homepage](https://wpadvancedads.com). |
| 132 | |
| 133 | Localizations: English, German, French, Spanish, Dutch, Italian, Portuguese |
| 134 | |
| 135 | > <strong>Add-Ons</strong> |
| 136 | > |
| 137 | > * [Advanced Ads Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) – powerful tools for ad optimizations: cache-busting, more placements, etc. |
| 138 | > * [Geo Targeting](https://wpadvancedads.com/add-ons/geo-targeting/) – display ads based on geo location of the visitor |
| 139 | > * [Tracking](https://wpadvancedads.com/add-ons/tracking/) – ad tracking and statistics |
| 140 | > * [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) – create mobile ads or ads for specific browser sizes |
| 141 | > * [Sticky Ads](https://wpadvancedads.com/sticky-ads/demo/) – increase click rates with fixed, sticky, and anchor ads |
| 142 | > * [PopUp and Layer Ads](https://wpadvancedads.com/add-ons/popup-and-layer-ads/) – display ads and other content in layers and popups |
| 143 | > * [Slider](https://wpadvancedads.com/add-ons/slider/) – create a simple slider from your ads |
| 144 | |
| 145 | If you have problems with Advanced Ads, please reach out to [our support](https://wpadvancedads.com/support/). |
| 146 | |
| 147 | == Installation == |
| 148 | |
| 149 | How to install the plugin and get it working? |
| 150 | |
| 151 | = Using The WordPress Dashboard = |
| 152 | |
| 153 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 154 | 2. Search for 'advanced ads' |
| 155 | 3. Click 'Install Now' |
| 156 | 4. Activate Advanced Ads on the Plugin dashboard |
| 157 | |
| 158 | = Uploading in WordPress Dashboard = |
| 159 | |
| 160 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 161 | 2. Navigate to the 'Upload' area |
| 162 | 3. Select `advanced-ads.zip` from your computer |
| 163 | 4. Click 'Install Now' |
| 164 | 5. Activate Advanced Ads in the Plugin dashboard |
| 165 | |
| 166 | = Using FTP = |
| 167 | |
| 168 | 1. Download `advanced-ads.zip` |
| 169 | 2. Extract the `advanced-ads` directory to your computer |
| 170 | 3. Upload the `advanced-ads` directory to the `/wp-content/plugins/` directory |
| 171 | 4. Activate Advanced Ads in the Plugin dashboard |
| 172 | |
| 173 | == Displaying Ads == |
| 174 | |
| 175 | You can use functions and shortcodes to display ads and ad groups. |
| 176 | |
| 177 | The integers in this example are the IDs of the elements. |
| 178 | |
| 179 | Use these shortcode to insert an ad or ad group into your post/page. |
| 180 | |
| 181 | `[the_ad id="24"]` |
| 182 | `[the_ad_group id="5"]` |
| 183 | |
| 184 | Use these functions to insert an ad or ad group into your template file. |
| 185 | |
| 186 | `<?php the_ad(24); ?>` |
| 187 | `<?php the_ad_group(5); ?>` |
| 188 | |
| 189 | In addition to directly displaying ads and groups you can define ad placements and assign either an ad or group to them. |
| 190 | |
| 191 | `[the_ad_placement id="header-left"]` |
| 192 | `<?php the_ad_placement('header-left'); ?>` |
| 193 | |
| 194 | == Frequently Asked Questions == |
| 195 | |
| 196 | = Is there a revenue share? = |
| 197 | |
| 198 | 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. |
| 199 | |
| 200 | == Screenshots == |
| 201 | |
| 202 | 1. Create an ad almost like you would create an article or page. |
| 203 | 2. Align the ad and set a margin to other elements |
| 204 | 3. Choose from various conditions where and where not to display your ad. |
| 205 | 4. Placements that let you inject ads anywhere into your site without coding (6 in Advanced Ads + 9 through add-ons) |
| 206 | |
| 207 | == Changelog == |
| 208 | |
| 209 | = 1.7.12 = |
| 210 | |
| 211 | * better highlighting of AND and OR connectors in display and visitor conditions |
| 212 | * removed general conditions as default from display conditions |
| 213 | * highlighted video and manual links for conditions |
| 214 | * show is_home and is_front_page as the same item in ad debug mode |
| 215 | * show warning if plain ad code contains HTTP, but the website is using HTTPS |
| 216 | * added notice if add-on licenses expired to plugin page |
| 217 | * changed "mobile device" into "device" condition with better option descriptions (mobile + tablet | desktop) |
| 218 | * changed "Post Content" placement label into "Content" since it is used for all post types |
| 219 | * hide manage ads link in dashboard widget from users who can not edit ads |
| 220 | * fixed dependency issue with Tracking add-on |
| 221 | * fixed dependency issue with AJAX cache-busting |
| 222 | * fixed missing scripts for ad block disguise |
| 223 | |
| 224 | = 1.7.11 = |
| 225 | |
| 226 | * added filter to change General display conditions set |
| 227 | * set `ADVANCED_ADS_AD_DEBUG_FOR_ADMIN_ONLY` in order to allow only admins to see ad debug mode |
| 228 | * introduced `advanced-ads-output-final` filter |
| 229 | * only check once per day for add-on updates |
| 230 | * fixed one support link |
| 231 | * fixed multiple add-on update checks |
| 232 | * fixed error message when ad group is empty |
| 233 | |
| 234 | = 1.7.10 = |
| 235 | |
| 236 | * highlight ads in the frontend through the "Ad Health" options |
| 237 | * check if PHP DOM module is enabled and warn in "Ad Health" if not |
| 238 | * added DFP debug link to "Ad Health" |
| 239 | * added button to check Add-On license keys for changes |
| 240 | * extended ad debug mode with more information |
| 241 | * restructured support page to reach helper more quickly |
| 242 | * fixed header ad bug |
| 243 | |
| 244 | = 1.7.9.3 = |
| 245 | |
| 246 | * added Selling Ads widget on overview page |
| 247 | * removed add-on update transient hopefully fixing update checks |
| 248 | * updated EDD class |
| 249 | * workaround for empty post-id error caused by BuddyPress |
| 250 | |
| 251 | = 1.7.9.2 = |
| 252 | |
| 253 | * display ad health menu only to ad admins |
| 254 | * removed update notices prior to 1.7 |
| 255 | * fixed is_not operator for specific pages did not display the ad on archive pages |
| 256 | * fixed disabled-ads notice showing on support page when no option was selected |
| 257 | * fixed user rights not set correctly on network activate in a multisite – please disable and reenable the plugin if you have it network activated |
| 258 | |
| 259 | = 1.7.9.1 = |
| 260 | |
| 261 | * removed the `the_content` check from non-singular pages |
| 262 | * moved ad blocker check into footer |
| 263 | |
| 264 | = 1.7.9 = |
| 265 | |
| 266 | * added frontend error checks to the admin bar |
| 267 | * changed default value for AdSense limit from true to false due to AdSense policy change, [read more](https://webgilde.com/en/ad-limit-adsense/) |
| 268 | * fixed unhighlighted placement type in Chrome |
| 269 | |
| 270 | = 1.7.8 = |
| 271 | |
| 272 | * prevent any ad container output in the header |
| 273 | * show advertisement label also for manually placed ads |
| 274 | * fixed AdSense slot ID when delivered through cache-busting |
| 275 | * fixed reserved place option not working after image upload |
| 276 | * fixed placement type display |
| 277 | * fixed missing translation for show/hide options |
| 278 | |
| 279 | = 1.7.7 = |
| 280 | |
| 281 | * allow to inject a new ad into existing placements |
| 282 | * added is/is_not operator to “post type” display condition |
| 283 | * show ads with the “specific pages” display condition only on these pages and not on archives |
| 284 | * set expired ads to “draft” post status |
| 285 | * highlight draft and pending ads in ad list |
| 286 | * updated AdSense 3-ads-limit text. AdSense has no explicit limit anymore |
| 287 | |
| 288 | = 1.7.6 = |
| 289 | |
| 290 | * prevent third part meta boxes in the ad edit screen |
| 291 | * set `ADVANCED_ADS_DISABLE_FRONTEND_AD_WEIGHT_UPDATE` constant to disable frontend group updates (for high traffic sites) |
| 292 | * enabled overriding placements through the import |
| 293 | * added uninstall option to remove all data on plugin uninstall (default: not removed) |
| 294 | * optimized element selector script used in Pro and Sticky |
| 295 | * fixed specific page display condition on archive pages |
| 296 | * fixed output of wrong publisher ID in admin panel |
| 297 | * fixed missing index error with ad block disguise |
| 298 | * fixed minor widget error on ad dashboard page |
| 299 | |
| 300 | = 1.7.5.1 = |
| 301 | |
| 302 | * add and remove ads in groups in the group overview page |
| 303 | * separated admin code into multiple files for better overview |
| 304 | * log possible content injection errors only for admin users in the frontend |
| 305 | * double error messages hidden on plugin support page |
| 306 | |
| 307 | = 1.7.5 = |
| 308 | |
| 309 | * prepared for [Advanced Ads Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) 1.4 with ad reloads, single request mode and placement tests |
| 310 | |
| 311 | = 1.7.4.5 = |
| 312 | |
| 313 | * extended feed cache to 48 hours |
| 314 | * updated EDD add-on updater class |
| 315 | * display possible injection errors only, when WP_DEBUG is enabled |
| 316 | * fixed content injection when duplicate ids are found in content |
| 317 | * fixed JavaScript conflict that prevented Display Conditions from working |
| 318 | |
| 319 | = 1.7.4.4 = |
| 320 | |
| 321 | * linked first-ad tutorials above ad list if less than 3 ads created yet |
| 322 | * fixed Wizard buttons not working due to JavaScript conflict |
| 323 | * fixed manual added container id not displayed for ads not added through placement |
| 324 | |
| 325 | = 1.7.4.3 = |
| 326 | |
| 327 | * changed content injection parsing from xml to html to decrease issues with broken html |
| 328 | * added check for content injection compatibility on ad edit page |
| 329 | * fixed error when ad list columns are missing |
| 330 | * fixed missing post format display condition |
| 331 | * added fix for sticky ads with timeout |
| 332 | |
| 333 | = 1.7.4.2 = |
| 334 | |
| 335 | * hide contrainer class, id and ad debug mode in Wizard |
| 336 | * fixed term query showing on every page impression |
| 337 | * fixed capabilities issue with Theia post slider |
| 338 | * fixed unnecessary admin notifications queries |
| 339 | * fixed ad title disappear when type was selected |
| 340 | * fixed ad group parameter layout |
| 341 | * fixed init hook to allow adding custom taxonomies |
| 342 | * ad meta boxes are now forced to be visible |
| 343 | * added link to advertisement label manual |
| 344 | |
| 345 | = 1.7.4.1 = |
| 346 | |
| 347 | * order ads in widgets and placements by ad title |
| 348 | * set OR as default connector in Display Conditions |
| 349 | * force OR on Display Conditions where conditions with AND never show the ad |
| 350 | |
| 351 | = 1.7.4 = |
| 352 | |
| 353 | * added Wizard to quickly create new ads, [manual](https://wpadvancedads.com/manual/wizard/) |
| 354 | * import / export feature |
| 355 | * optimized ad setting lists layout |
| 356 | * select scheduled ads for placements or in the ad widget |
| 357 | * allow wrapper class to include uppercase letters |
| 358 | * display ad image icon on ad overview page |
| 359 | * reactivate existing add-on licenses after shop upgrade |
| 360 | * don’t show ads on unrelated page types when a "show" + category display condition is set |
| 361 | * fix for using groups in some advanced placements |
| 362 | * fixed caching of dashboard widget |
| 363 | * fixed missing user capabilities after update |
| 364 | * fixed public url for ads due to possible WP bug |
| 365 | * updated Portuguese (Brazil) translation |
| 366 | |
| 367 | = 1.7.3 = |
| 368 | |
| 369 | * allow ad injection with just one click after ad was published |
| 370 | * fix for unset ad type breaks saving the ad |
| 371 | * fix for ads injected into main content which use document.write with closing tags |
| 372 | * fixed pro placements not visible when adblocker is enabled |
| 373 | * forces ad type metabox to stay open for new ads |
| 374 | |
| 375 | = 1.7.2.1 = |
| 376 | |
| 377 | * fix for missing index with newly created ads |
| 378 | |
| 379 | = 1.7.2 = |
| 380 | |
| 381 | * license settings page rewritten |
| 382 | * added Ad Group ad type |
| 383 | * added ad specific capabilities |
| 384 | * added label above ads |
| 385 | * collapse ad type meta box for existing ads |
| 386 | * added links to manual and inline videos to the meta box headline |
| 387 | * updated translation files |
| 388 | * remove hyphen from automatically created id prefix to not break ID creation |
| 389 | |
| 390 | = 1.7.1.5 = |
| 391 | |
| 392 | * hotfix: added missing file |
| 393 | |
| 394 | = 1.7.1.4 = |
| 395 | |
| 396 | * search for title or id instead of content when selecting a Specific Page Display Condition |
| 397 | * fixed double display conditions |
| 398 | * fixes notices appearing once after update |
| 399 | * fixed display condition error warning |
| 400 | * fixed content injection breaking when unescaped `</script>` was used within `document.write` |
| 401 | * added taxonomies created by Custom Post Type UI plugin to the display conditions |
| 402 | * add content placement for paragraphs without images |
| 403 | |
| 404 | = 1.7.1.3 = |
| 405 | |
| 406 | * fixed error when $wp_query is not set |
| 407 | * added French translation |
| 408 | |
| 409 | = 1.7.1.2 = |
| 410 | |
| 411 | * tested with WP 4.5 |
| 412 | * create random widget id, if not set yet |
| 413 | * allow content injection into nested paragraphs if none found at level 1 and 2 |
| 414 | * minor security update for admin ajax actions |
| 415 | * fixed home condition for some cases |
| 416 | * fixed secondary query check |
| 417 | * fixed de/activation hook |
| 418 | * fixed Spanish translation |
| 419 | * updated translation files |
| 420 | |
| 421 | = 1.7.1.1 = |
| 422 | |
| 423 | * added Feed condition to General Display Conditions |
| 424 | * trim license keys when saving |
| 425 | * reverted too strict display condition checks for taxonomies |
| 426 | * shortened debug page |
| 427 | |
| 428 | = 1.7.1 = |
| 429 | |
| 430 | * introduced AND/OR connectors for Display Conditions |
| 431 | * display conditions for some pages (archive page) are now stricter |
| 432 | * connectors for existing visitor conditions can be changed now |
| 433 | * added option to reserve ad space |
| 434 | * set ADVANCED_ADS_DISALLOW_PHP constant to prevent usage of PHP in plain ad code |
| 435 | * update ad block disguise files automatically, when Advanced Ads scripts changed after an update |
| 436 | |
| 437 | = 1.7.0.3 = |
| 438 | |
| 439 | * added debug mode for ads, see [manual](https://wpadvancedads.com/manual/ad-debug-mode/) |
| 440 | * skip check for general conditions if all are on (allows ad injection also in iframes and new wp instances) |
| 441 | * display jQuery issue notice in display conditions |
| 442 | * lifted the restriction to choose each display condition only once |
| 443 | * add notice when ad block folder needs to be rebuild |
| 444 | * hide an ad with a tag condition in posts that don’t have a tag at all |
| 445 | * prevent broken custom queries to interfere with display conditions |
| 446 | |
| 447 | = 1.7.0.2 = |
| 448 | |
| 449 | * hide ad if no term is selected for taxonomy display conditions |
| 450 | * show warning, if no items selected in display conditions |
| 451 | * fixed 500 error caused by plugins using WP_Query unsecured |
| 452 | |
| 453 | = 1.7.0.1 = |
| 454 | |
| 455 | * hotfix for missing get_current_screen issue |
| 456 | |
| 457 | = 1.7 = |
| 458 | |
| 459 | * rewritten Display Conditions interface and logic, see [manual](http://wpadvancedads.com/manual/display-conditions/) |
| 460 | * rich content ads now render oembed links |
| 461 | * added author display condition |
| 462 | * added link to Visitor Conditions manual |
| 463 | * added incompatibility warning for Q2W3 plugin |
| 464 | * home page display condition honored also on static pages |
| 465 | * single post display condition honored also on archive pages |
| 466 | * prevent ads from being loaded in wp_head when they are not a header placement |
| 467 | * optimized support form and added feedback messages |
| 468 | * fixed general secondary query setting |
| 469 | * fixes for jQuery issues and message for solutions |
| 470 | * fix error when editor role is missing |
| 471 | |
| 472 | [Changelog Archive](http://wpadvancedads.com/codex/changelog-archive/) |
| 473 | |
| 474 | == Upgrade Notice == |
| 475 |