advanced-ads
Last commit date
admin
8 years ago
classes
8 years ago
includes
8 years ago
languages
8 years ago
modules
8 years ago
public
8 years ago
vendor
8 years ago
LICENSE.txt
12 years ago
advanced-ads.php
8 years ago
composer.json
11 years ago
composer.lock
8 years ago
index.php
12 years ago
readme.txt
8 years ago
readme.txt
456 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: 4.6 |
| 6 | Tested up to: 4.8 |
| 7 | Requires PHP: 5.2 |
| 8 | Stable tag: 1.8.10 |
| 9 | License: GPLv2 or later |
| 10 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 11 | |
| 12 | Manage and optimize your ads and increase your revenue. Support for all ad codes, AdSense, ad injection, ad widget, and ad rotation. |
| 13 | |
| 14 | == Description == |
| 15 | |
| 16 | Are you looking for an ad manager plugin? These are the top arguments to use Advanced Ads: |
| 17 | |
| 18 | * most features to test and optimize ads |
| 19 | * unlimited ad units |
| 20 | * works with all ad types and networks |
| 21 | * the only solution with *Ad Health* integration and AdSense violation checks |
| 22 | * [best rated](https://wordpress.org/support/plugin/advanced-ads/reviews/?filter=5) and free email support |
| 23 | |
| 24 | I built Advanced Ads based on my experience delivering millions of ads per month. |
| 25 | |
| 26 | [Full Feature List](https://wpadvancedads.com/features/). |
| 27 | |
| 28 | = create and manage ads = |
| 29 | |
| 30 | * create and display **unlimited** ad units |
| 31 | * rotate ads |
| 32 | * schedule ads and set expiry date |
| 33 | * target ads by content and user groups |
| 34 | * inject ads into posts and pages automatically without coding |
| 35 | * sell ads on your website automatically with the [Selling Ads add-on](https://wpadvancedads.com/add-ons/selling-ads/) |
| 36 | |
| 37 | = ad types = |
| 38 | |
| 39 | choose between different ad types that enable you to: |
| 40 | |
| 41 | * insert code for any ad and affiliate networks (e.g., AdSense, Chitika, Amazon, BuySellAds, DoubleClick, media.net, … ) |
| 42 | * dedicated support for all types of Google AdSense banners, including Responsive, InFeed and InArticle ads |
| 43 | * display images and image banners |
| 44 | * create content-rich ads with the WordPress TinyMCE editor |
| 45 | * use shortcodes within ads (to also deliver advertisements from other ad plugins like AdRotate or Simple Ads Manager) |
| 46 | |
| 47 | = display ads = |
| 48 | |
| 49 | * use functions to display ads in template files |
| 50 | * use shortcodes to place them manually in post content |
| 51 | * show ads in sidebars and widget areas |
| 52 | * disable all ads on specific pages |
| 53 | * display multiple ads (ad blocks) |
| 54 | * display a customizable label, e.g., “Advertisements” above each ad |
| 55 | |
| 56 | = display conditions = |
| 57 | |
| 58 | show ads based on conditions like |
| 59 | |
| 60 | * individual posts, pages, and other post types |
| 61 | * posts by category, tags, taxonomies, author, and age |
| 62 | * archive pages by category, tags, taxonomies |
| 63 | * special page types like 404, attachment and front page |
| 64 | * hide ads on secondary queries (e.g., posts in sidebars) |
| 65 | * display or hide banners within the post feed |
| 66 | * hide all ads from specific page types, e.g., 404 pages, feed |
| 67 | * hide ads from bots and web crawlers |
| 68 | |
| 69 | = visitor conditions = |
| 70 | |
| 71 | display ads by conditions based on the visitor. [List of all visitor conditions](https://wpadvancedads.com/manual/visitor-conditions/) |
| 72 | |
| 73 | * display or hide a banner by device: mobile and tablet or desktop |
| 74 | * display or hide a banner by role and for logged in visitors |
| 75 | * advanced visitor conditions: previously visited URL (referrer), user capability, browser language, browser and device, URL parameters included in [Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) |
| 76 | * display ads by geolocation with the [Geo Targeting add-on](https://wpadvancedads.com/add-ons/geo-targeting/) |
| 77 | * display ads by browser width with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 78 | |
| 79 | = ad injection | placements = |
| 80 | |
| 81 | Placements to insert ads in pre-defined positions in your theme and content. [List of all placements](https://wpadvancedads.com/manual/placements/) |
| 82 | |
| 83 | * ads after any given paragraph or headline |
| 84 | * ads at the top or bottom of the post content |
| 85 | * ads before closing `</head>` tag |
| 86 | * ads in the footer |
| 87 | * test placements against each other with [Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) |
| 88 | * many more ad positions with [add-ons](https://wpadvancedads.com/add-ons/) |
| 89 | |
| 90 | = mobile devices = |
| 91 | |
| 92 | * display ads for mobile and tablets or desktop only |
| 93 | * display responsive image ads |
| 94 | * ads for specific browser sizes only using [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 95 | * insert ads on AMP pages with [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 96 | |
| 97 | = Google AdSense = |
| 98 | |
| 99 | * supports all ad units, including display ads, link units, InFeed, InArticle, and matched content |
| 100 | * change type and sizes of an ad without going into your AdSense account |
| 101 | * optional limit to 3 AdSense banners |
| 102 | * hide AdSense advertisements on 404 pages by default (to comply with AdSense terms) |
| 103 | * insert AdSense verification, Page-Level ads and QuickStart code |
| 104 | * Ad Health integration and AdSense violation checks |
| 105 | * assistant for exact sizes of responsive ads with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 106 | |
| 107 | = ad blocker = |
| 108 | |
| 109 | * basic features to prevent ad blocks from being removed by AdBlock and others |
| 110 | * prevent ad blockers from breaking sites where plugin scripts are running |
| 111 | |
| 112 | Learn more on the [plugin homepage](https://wpadvancedads.com). |
| 113 | |
| 114 | Localizations: English, German, French, Spanish, Dutch, Italian, Portuguese, Vietnamese |
| 115 | |
| 116 | > <strong>Add-Ons</strong> |
| 117 | > |
| 118 | > * [Advanced Ads Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) – powerful tools for ad optimizations: cache-busting, more placements, etc. |
| 119 | > * [Selling Ads](https://wpadvancedads.com/add-ons/selling-ads/) - allows you to sell ads on your website fully automated, including payments and advertiser profiles. |
| 120 | > * [Geo Targeting](https://wpadvancedads.com/add-ons/geo-targeting/) – display ads based on geo location of the visitor |
| 121 | > * [Tracking](https://wpadvancedads.com/add-ons/tracking/) – ad tracking and statistics |
| 122 | > * [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) – create mobile ads or ads for specific browser sizes |
| 123 | > * [Sticky Ads](https://wpadvancedads.com/add-ons/sticky-ads/) – increase click rates with fixed, sticky, and anchor ads |
| 124 | > * [PopUp and Layer Ads](https://wpadvancedads.com/add-ons/popup-and-layer-ads/) – display ads and other content in layers and popups |
| 125 | > * [Slider](https://wpadvancedads.com/add-ons/slider/) – create a simple slider from your ads |
| 126 | |
| 127 | If you have problems with Advanced Ads, please reach out to [our support](https://wpadvancedads.com/support/). |
| 128 | |
| 129 | == Installation == |
| 130 | |
| 131 | How to install the plugin and get it working? |
| 132 | |
| 133 | = Using The WordPress Dashboard = |
| 134 | |
| 135 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 136 | 2. Search for 'advanced ads' |
| 137 | 3. Click 'Install Now' |
| 138 | 4. Activate Advanced Ads on the Plugin dashboard |
| 139 | |
| 140 | = Uploading in WordPress Dashboard = |
| 141 | |
| 142 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 143 | 2. Navigate to the 'Upload' area |
| 144 | 3. Select `advanced-ads.zip` from your computer |
| 145 | 4. Click 'Install Now' |
| 146 | 5. Activate Advanced Ads in the Plugin dashboard |
| 147 | |
| 148 | = Using FTP = |
| 149 | |
| 150 | 1. Download `advanced-ads.zip` |
| 151 | 2. Extract the `advanced-ads` directory to your computer |
| 152 | 3. Upload the `advanced-ads` directory to the `/wp-content/plugins/` directory |
| 153 | 4. Activate Advanced Ads in the Plugin dashboard |
| 154 | |
| 155 | == Frequently Asked Questions == |
| 156 | |
| 157 | = Which ad networks are supported? = |
| 158 | |
| 159 | Advanced Ads is compatible with all ad networks and banners from affiliate programs like Google AdSense, Chitika, Clickbank, Amazon, and also Google Double Click (DFP), media.net. |
| 160 | |
| 161 | You can also use it to insert additional ad network tags into header or footer of your site without coding. |
| 162 | |
| 163 | AdSense has even a dedicated ad type leveling the specific options this ad network provides. |
| 164 | |
| 165 | = PHP functions and shortcodes = |
| 166 | |
| 167 | You can use functions and shortcodes to display ads and ad groups. |
| 168 | |
| 169 | The integers in this example are the IDs of the elements. |
| 170 | |
| 171 | Use these shortcodes to insert an ad or group into your post/page. |
| 172 | |
| 173 | `[the_ad id="24"]` |
| 174 | `[the_ad_group id="5"]` |
| 175 | |
| 176 | Use these functions to insert an ad or ad group into your template file. |
| 177 | |
| 178 | `<?php the_ad(24); ?>` |
| 179 | `<?php the_ad_group(5); ?>` |
| 180 | |
| 181 | In addition to directly displaying ads and groups you can define ad placements and assign either an ad or group to them. |
| 182 | |
| 183 | `[the_ad_placement id="header-left"]` |
| 184 | `<?php the_ad_placement('header-left'); ?>` |
| 185 | |
| 186 | = Is there a revenue share? = |
| 187 | |
| 188 | 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. |
| 189 | |
| 190 | = Can I place ads directly in my theme files? = |
| 191 | |
| 192 | Yes. I would add a "Manual" placement into your theme files. It would allow you to change the displayed ads or groups later without changing your code again. |
| 193 | |
| 194 | = Does it work with other ad plugins? = |
| 195 | |
| 196 | Yes. Advanced Ads can be combined with other ad plugins. |
| 197 | Just use their shortcodes in our "Rich Media" ad type to combine both features. |
| 198 | Works with AdRotate, Ad Inserter, Ad Injection, Quick AdSense, QuickAdSense Reloaded (WPQUADS), Simple Ads Manager, and other plugins. |
| 199 | |
| 200 | = Can I use Flash ads? = |
| 201 | |
| 202 | There is a dedicated Flash ad type in [Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/). |
| 203 | |
| 204 | = Is the plugin compatible with site builders? = |
| 205 | |
| 206 | Yes. It works out of the box with all site builders that allow shortcodes or widgets, like SiteOrigin, Beaver Builder, Visual Composer, and others. |
| 207 | There is also a [free add-on to support Visual Composer](https://wordpress.org/plugins/ads-for-visual-composer/). |
| 208 | |
| 209 | = I am a developer. Can I customize the plugin? = |
| 210 | |
| 211 | Yes. Advanced Ads is based on WordPress standards and therefore easily customizable using either WordPress hooks or the ones we defined [here](https://wpadvancedads.com/codex/). |
| 212 | |
| 213 | == Screenshots == |
| 214 | |
| 215 | 1. Placements that let you inject ads anywhere into your site without coding (7 in Advanced Ads + 14 through add-ons). |
| 216 | 2. Support for all kinds of ad types, including dedicated AdSense type. AMP is included in the Responsive add-on. |
| 217 | 3. Flexible ad input with the Plain Text ad type. |
| 218 | 4. Align your ads within the content. |
| 219 | 5. Choose from various conditions where and to whom to display your ads. |
| 220 | |
| 221 | == Changelog == |
| 222 | |
| 223 | = 1.8.10 = |
| 224 | |
| 225 | * added Ad Health warning if ads are disabled in the frontend |
| 226 | * fix for Wizard navigation |
| 227 | |
| 228 | = 1.8.9 = |
| 229 | |
| 230 | * added option to disable AdSense-related Ad-Health warnings |
| 231 | * fixed search for terms with numbers in them |
| 232 | * added check for hidden AdSense units |
| 233 | * added warning that AdSense InFeed and InArticle ads can’t be aligned left or right |
| 234 | |
| 235 | = 1.8.8 = |
| 236 | |
| 237 | * fix to feedback form |
| 238 | |
| 239 | = 1.8.7 = |
| 240 | |
| 241 | * added option to analyze the number of visitors using an ad blocker |
| 242 | * exchanged Dummy ad image and URL to something more neutral |
| 243 | * compatibility with PHP 5.2 |
| 244 | * use margin: auto to center reserved ad space |
| 245 | * renamed Groups menu item to also mention "Rotations" |
| 246 | * do not execute shortcodes of the current ad in its own content |
| 247 | * updated first-ad video tutorial link |
| 248 | * fixed wizard skipping a step after being stopped and reopened |
| 249 | * fixed wrong scheduled time displayed on ad overview list |
| 250 | |
| 251 | = 1.8.6 = |
| 252 | |
| 253 | * hotfix for PHP below 5.4 |
| 254 | * fixed HTTPS warning showing up for links |
| 255 | |
| 256 | = 1.8.5 = |
| 257 | |
| 258 | * optimized Wizard – fewer steps and less clutter |
| 259 | * added more options to the placement box after a new ad is saved |
| 260 | * load dashboard widget using AJAX |
| 261 | * show a warning in Ad Health if an ad contains HTTPS, but the site is using HTTP |
| 262 | * fixed problem when multiple add-ons were updated at once |
| 263 | |
| 264 | = 1.8.4 = |
| 265 | |
| 266 | * added "Taxonomy" Display Condition |
| 267 | * display arrow if an Ad Health message is a link |
| 268 | * removed "jQuery not in Header" warning after we fixed all known issues |
| 269 | * renamed and updated add-on updater class to use SSL only |
| 270 | * updated pt_BR translation |
| 271 | * added Japanese translation |
| 272 | * replaced "Cheatin' uh?" message with something useful if user role does not have required permissions |
| 273 | * prevent output of Adsense ads on AMP pages if they are not converted to AMP-format with Responsive add-on |
| 274 | |
| 275 | = 1.8.3 = |
| 276 | |
| 277 | * introduced `advads_is_amp` function to fix ad injections on AMP pages |
| 278 | * implemented a simple ad block counter with Google Analytics |
| 279 | |
| 280 | = 1.8.2 = |
| 281 | |
| 282 | * fixed Content Age condition |
| 283 | * fixed group options not changing correctly when switching types |
| 284 | |
| 285 | = 1.8.1 = |
| 286 | |
| 287 | * added support for new AdSense InFeed and InArticle ad codes |
| 288 | * create a new ad group on group page |
| 289 | * add group wrapper even if the group was not edited on the group edit page |
| 290 | * add the 'advanced-ads-output-wrapper-after-content-group' filter |
| 291 | * removed unused MarketPress license code |
| 292 | * removed debug page |
| 293 | * removed license expires notice |
| 294 | * updated composer |
| 295 | * updated translation files |
| 296 | * fixed issue with inheriting settings of ad group ad type |
| 297 | * removed PHP notice in Import feature |
| 298 | |
| 299 | = 1.8 = |
| 300 | |
| 301 | This release is even larger under the hood than the following list. Please make sure to also update all [your add-ons](https://wpadvancedads.com/add-ons/) and let us know directly about any issues [here](https://wpadvancedads.com/support/). |
| 302 | |
| 303 | * new Content Age display condition added – display ads based on post age |
| 304 | * allow to enable/disable ad label for each placement |
| 305 | * complete rework of group and placement options |
| 306 | * added Dummy ad type |
| 307 | * show AdSense code form inline instead of in a popup |
| 308 | * optimized workflow in wizard to show only relevant information |
| 309 | * select draft, pending and future posts in the Specific Pages condition, too |
| 310 | * warn if QuickStart ads from AdSense are loaded |
| 311 | * show ads on AMP pages for all bots |
| 312 | * properly escaped output of image ad title and alt attribute |
| 313 | * removed description field from groups since we have never seen this being used, let us know when you need it though |
| 314 | * updated all translation files |
| 315 | * fixed wrong month names in translated versions of the ad overview list |
| 316 | * fixed with small image ads not appearing on AMP pages |
| 317 | * fixed missing and wrong textdomains |
| 318 | * fixed search for single digit IDs in Specific Pages condition not working |
| 319 | |
| 320 | = 1.7.25 = |
| 321 | |
| 322 | * added explicit "link ads" AdSense type with normal and responsive format |
| 323 | * included link to AdSense types manual |
| 324 | * optimized bot check |
| 325 | * removed TinyMCE security features from links added to the rich media ad type to not break affiliate links |
| 326 | * fixed error appearing when image of an image ad does not exist anymore |
| 327 | * fixed wizard not going to ad parameters box automatically after selecting ad type |
| 328 | |
| 329 | = 1.7.24 = |
| 330 | |
| 331 | * fixed issue with shortcode button that caused some page builders and scripts to break |
| 332 | * fixed saving settings on multisite sub-blogs |
| 333 | * applied fix to updater class |
| 334 | * fixed basic fix function needed for Sticky ads |
| 335 | |
| 336 | = 1.7.23 = |
| 337 | |
| 338 | * fix a warning that appears when wp admin bar is missing. |
| 339 | |
| 340 | = 1.7.22 = |
| 341 | |
| 342 | * added option to also consider elements in containers for ad content injection |
| 343 | * show warning in Ad Health bar when not all ads could be injected |
| 344 | * added logic to display ad specific warnings and possible conflicts |
| 345 | * added warning to disable shortcode button or ad blocker in order to use the visual editor for posts |
| 346 | * reapplied user capabilities to create or edit ads to make sure they are never wrong |
| 347 | * added warning about left and right position not working with responsive AdSense units |
| 348 | * edited feedback form |
| 349 | * add ad/group wrapper, if needed |
| 350 | |
| 351 | = 1.7.21 = |
| 352 | |
| 353 | * fixed jumping "more terms" button in taxonomy conditions |
| 354 | * fixed advanced JavaScript for frontend picker in Pro |
| 355 | |
| 356 | = 1.7.20 = |
| 357 | |
| 358 | * updated local storage script |
| 359 | * fixed issue causing passive-cache busting and layer not to work together |
| 360 | |
| 361 | = 1.7.19 = |
| 362 | |
| 363 | * check if local storage is supported by the browser, if needed |
| 364 | * use flexbox layout for longer input fields in conditions |
| 365 | * use `advanced-ads-admin-max-terms` filter also for limit in author condition |
| 366 | * updated EDD Updater Class for add-on updates |
| 367 | * fixed error message when all placements were removed |
| 368 | * fixed adblock disguise folder not working correctly on https pages |
| 369 | |
| 370 | = 1.7.18 = |
| 371 | |
| 372 | * use the same ad block disguise settings for all sites in a multisite |
| 373 | * update to advanced.js to allow injection into hidden elements |
| 374 | * fixed group options being overridden, when filtered groups are being saved |
| 375 | * fixed missing attribute for responsive Matched Content ads |
| 376 | * fixed issue with MarketPress license check |
| 377 | |
| 378 | = 1.7.17 = |
| 379 | |
| 380 | * add `ADVANCED_ADS_DISABLE_SHORTCODE_BUTTON` constant to wp-config.php in order to remove the shortcode button from the TinyMCE interface |
| 381 | * don’t move ads into hidden elements |
| 382 | * set license key fields to readonly after updated |
| 383 | * show "reserve ad space" only for ad types where it makes sense |
| 384 | * using WordPress Filesystem to create ad block disguise folder |
| 385 | * disable page level ads on pages where all ads are disabled |
| 386 | * hide double compatibility warning with cache-busting in Advanced Ads Pro |
| 387 | * hide warning about unexcaped `&` in urls |
| 388 | |
| 389 | = 1.7.16 = |
| 390 | |
| 391 | * added helpful links when download of an add-on failed |
| 392 | * set active license key fields to readonly |
| 393 | * bundles add-on related functions into one class |
| 394 | * updated Spanish translation |
| 395 | * added Vietnamese translation |
| 396 | |
| 397 | = 1.7.15 = |
| 398 | |
| 399 | * allow Unlimited Ad Injection setting to specify the number of posts in the loop to show ads |
| 400 | * allow to override specific options in functions and shortcodes |
| 401 | * added feedback form on deactivation |
| 402 | * fixed Visitor Conditions connector being saved wrongly first |
| 403 | * fixed ads not appearing on AMP pages |
| 404 | |
| 405 | = 1.7.14 = |
| 406 | |
| 407 | * added `ADVANCED_ADS_ENABLE_REVISIONS` constant to allow revisions for ads |
| 408 | * fixed wrong output after using quick edit in the ads list |
| 409 | * fixed custom position logic to not leave critical errors when localStorage is disabled |
| 410 | * fixed update checks on every admin page impression due to W3TC object cache breaking transients |
| 411 | |
| 412 | = 1.7.13 = |
| 413 | |
| 414 | * fix for class name sensitive systems and Tracking autoloader |
| 415 | |
| 416 | = 1.7.12 = |
| 417 | |
| 418 | * better highlighting of AND and OR connectors in display and visitor conditions |
| 419 | * removed general conditions as default from display conditions |
| 420 | * highlighted video and manual links for conditions |
| 421 | * show is_home and is_front_page as the same item in ad debug mode |
| 422 | * show warning if plain ad code contains HTTP, but the website is using HTTPS |
| 423 | * added notice if add-on licenses expired to plugin page |
| 424 | * changed "mobile device" into "device" condition with better option descriptions (mobile + tablet | desktop) |
| 425 | * changed "Post Content" placement label into "Content" since it is used for all post types |
| 426 | * hide manage ads link in dashboard widget from users who can not edit ads |
| 427 | * fixed dependency issue with Tracking add-on |
| 428 | * fixed dependency issue with AJAX cache-busting |
| 429 | * fixed missing scripts for ad block disguise |
| 430 | |
| 431 | = 1.7.11 = |
| 432 | |
| 433 | * added filter to change General display conditions set |
| 434 | * set `ADVANCED_ADS_AD_DEBUG_FOR_ADMIN_ONLY` in order to allow only admins to see ad debug mode |
| 435 | * introduced `advanced-ads-output-final` filter |
| 436 | * only check once per day for add-on updates |
| 437 | * fixed one support link |
| 438 | * fixed multiple add-on update checks |
| 439 | * fixed error message when ad group is empty |
| 440 | |
| 441 | = 1.7.10 = |
| 442 | |
| 443 | * highlight ads in the frontend through the "Ad Health" options |
| 444 | * check if PHP DOM module is enabled and warn in "Ad Health" if not |
| 445 | * added DFP debug link to "Ad Health" |
| 446 | * added button to check Add-On license keys for changes |
| 447 | * extended ad debug mode with more information |
| 448 | * restructured support page to reach helper more quickly |
| 449 | * fixed header ad bug |
| 450 | * fixed compatibility issues with Yoast SEO, WPML, and Jetpack |
| 451 | * confirmed working with Divi Themes and NewsMag |
| 452 | |
| 453 | [Changelog Archive](https://wpadvancedads.com/codex/changelog-archive/) |
| 454 | |
| 455 | == Upgrade Notice == |
| 456 |