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
348 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.5.2 |
| 7 | Stable tag: 1.7.4.2 |
| 8 | License: GPLv2 or later |
| 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 | |
| 11 | Manage and optimize your ads as easy as creating posts. Including support for AdSense, ad injection, ad planning, 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 for mobile visitors |
| 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 | * many more ad inserters with [add-ons](https://wpadvancedads.com/add-ons/) |
| 99 | |
| 100 | = ad networks = |
| 101 | |
| 102 | Advanced Ads is compatible with all ad networks and banners from affiliate programs like Google AdSense, Chitika, Clickbank, Amazon, and also Google DoubleClick (DFP). |
| 103 | You can also use it to insert additional ad network tags into header or footer of your site without additional coding. |
| 104 | |
| 105 | = best support for mobile devices = |
| 106 | |
| 107 | * display ads for mobile or desktop only |
| 108 | * display responsive image ads (WordPress 4.4 and later) |
| 109 | * ads for specific browser sizes only using [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 110 | |
| 111 | = Google AdSense = |
| 112 | |
| 113 | * switch sizes of an ad |
| 114 | * switch between normal and responsive ads |
| 115 | * automatic limit to 3 AdSense banners according to AdSense terms of service (can be disabled) |
| 116 | * hide AdSense advertisements on 404 pages by default (to comply with AdSense terms) |
| 117 | * insert Page-Level ads code globally |
| 118 | * assistant for exact sizes of responsive ads with the [Responsive add-on](https://wpadvancedads.com/add-ons/responsive-ads/) |
| 119 | |
| 120 | = ad blocker = |
| 121 | |
| 122 | * basic features to prevent ad blocks from being removed by AdBlock and co |
| 123 | * prevent ad blockers from breaking sites where plugin scripts are running |
| 124 | |
| 125 | = based on WordPress standards = |
| 126 | |
| 127 | * integrated into WordPress using standards like custom post types, taxonomies and hooks |
| 128 | * easily customizable by any WordPress plugin developer |
| 129 | |
| 130 | Learn more on the [plugin homepage](https://wpadvancedads.com). |
| 131 | |
| 132 | Localizations: English, German, French, Spanish, Dutch, Italian, Portuguese |
| 133 | |
| 134 | > <strong>Add-Ons</strong> |
| 135 | > |
| 136 | > * [Advanced Ads Pro](https://wpadvancedads.com/add-ons/advanced-ads-pro/) – powerful tools for ad optimizations: cache-busting, more placements, etc. |
| 137 | > * [Geo Targeting](https://wpadvancedads.com/add-ons/geo-targeting/) – display ads based on geo location of the visitor |
| 138 | > * [Tracking](https://wpadvancedads.com/add-ons/tracking/) – ad tracking and statistics |
| 139 | > * [Responsive Ads](https://wpadvancedads.com/add-ons/responsive-ads/) – create mobile ads or ads for specific browser sizes |
| 140 | > * [Sticky Ads](https://wpadvancedads.com/sticky-ads/demo/) – increase click rates with fixed, sticky, and anchor ads |
| 141 | > * [PopUp and Layer Ads](https://wpadvancedads.com/add-ons/popup-and-layer-ads/) – display ads and other content in layers and popups |
| 142 | > * [Slider](https://wpadvancedads.com/add-ons/slider/) – create a simple slider from your ads |
| 143 | |
| 144 | == Installation == |
| 145 | |
| 146 | How to install the plugin and get it working? |
| 147 | |
| 148 | = Using The WordPress Dashboard = |
| 149 | |
| 150 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 151 | 2. Search for 'advanced ads' |
| 152 | 3. Click 'Install Now' |
| 153 | 4. Activate Advanced Ads on the Plugin dashboard |
| 154 | |
| 155 | = Uploading in WordPress Dashboard = |
| 156 | |
| 157 | 1. Navigate to the 'Add New' in the plugins dashboard |
| 158 | 2. Navigate to the 'Upload' area |
| 159 | 3. Select `advanced-ads.zip` from your computer |
| 160 | 4. Click 'Install Now' |
| 161 | 5. Activate Advanced Ads in the Plugin dashboard |
| 162 | |
| 163 | = Using FTP = |
| 164 | |
| 165 | 1. Download `advanced-ads.zip` |
| 166 | 2. Extract the `advanced-ads` directory to your computer |
| 167 | 3. Upload the `advanced-ads` directory to the `/wp-content/plugins/` directory |
| 168 | 4. Activate Advanced Ads in the Plugin dashboard |
| 169 | |
| 170 | == Displaying Ads == |
| 171 | |
| 172 | You can use functions and shortcodes to display ads and ad groups. |
| 173 | |
| 174 | The integers in this example are the IDs of the elements. |
| 175 | |
| 176 | Use these shortcode to insert an ad or ad group into your post/page. |
| 177 | |
| 178 | `[the_ad id="24"]` |
| 179 | `[the_ad_group id="5"]` |
| 180 | |
| 181 | Use these functions to insert an ad or ad group into your template file. |
| 182 | |
| 183 | `<?php the_ad(24); ?>` |
| 184 | `<?php the_ad_group(5); ?>` |
| 185 | |
| 186 | In addition to directly displaying ads and groups you can define ad placements and assign either an ad or group to them. |
| 187 | |
| 188 | `[the_ad_placement id="header-left"]` |
| 189 | `<?php the_ad_placement('header-left'); ?>` |
| 190 | |
| 191 | == Frequently Asked Questions == |
| 192 | |
| 193 | = Is there a revenue share? = |
| 194 | |
| 195 | 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. |
| 196 | |
| 197 | == Screenshots == |
| 198 | |
| 199 | 1. Create an ad almost like you would create an article or page. |
| 200 | 2. Align the ad and set a margin to other elements |
| 201 | 3. Choose from various conditions where and where not to display your ad. |
| 202 | 4. Placements that let you inject ads anywhere into your site without coding (6 in Advanced Ads + 9 through add-ons) |
| 203 | |
| 204 | == Changelog == |
| 205 | |
| 206 | = 1.7.4.2 = |
| 207 | |
| 208 | * hide contrainer class, id and ad debug mode in Wizard |
| 209 | * fixed term query showing on every page impression |
| 210 | * fixed capabilities issue with Theia post slider |
| 211 | * fixed unnecessary admin notifications queries |
| 212 | * fixed ad title disappear when type was selected |
| 213 | * fixed ad group parameter layout |
| 214 | * fixed init hook to allow adding custom taxonomies |
| 215 | * ad meta boxes are now forced to be visible |
| 216 | * added link to advertisement label manual |
| 217 | |
| 218 | = 1.7.4.1 = |
| 219 | |
| 220 | * order ads in widgets and placements by ad title |
| 221 | * set OR as default connector in Display Conditions |
| 222 | * force OR on Display Conditions where conditions with AND never show the ad |
| 223 | |
| 224 | = 1.7.4 = |
| 225 | |
| 226 | * added Wizard to quickly create new ads, [manual](https://wpadvancedads.com/manual/wizard/) |
| 227 | * import / export feature |
| 228 | * optimized ad setting lists layout |
| 229 | * select scheduled ads for placements or in the ad widget |
| 230 | * allow wrapper class to include uppercase letters |
| 231 | * display ad image icon on ad overview page |
| 232 | * reactivate existing add-on licenses after shop upgrade |
| 233 | * don’t show ads on unrelated page types when a "show" + category display condition is set |
| 234 | * fix for using groups in some advanced placements |
| 235 | * fixed caching of dashboard widget |
| 236 | * fixed missing user capabilities after update |
| 237 | * fixed public url for ads due to possible WP bug |
| 238 | * updated Portuguese (Brazil) translation |
| 239 | |
| 240 | = 1.7.3 = |
| 241 | |
| 242 | * allow ad injection with just one click after ad was published |
| 243 | * fix for unset ad type breaks saving the ad |
| 244 | * fix for ads injected into main content which use document.write with closing tags |
| 245 | * fixed pro placements not visible when adblocker is enabled |
| 246 | * forces ad type metabox to stay open for new ads |
| 247 | |
| 248 | = 1.7.2.1 = |
| 249 | |
| 250 | * fix for missing index with newly created ads |
| 251 | |
| 252 | = 1.7.2 = |
| 253 | |
| 254 | * license settings page rewritten |
| 255 | * added Ad Group ad type |
| 256 | * added ad specific capabilities |
| 257 | * added label above ads |
| 258 | * collapse ad type meta box for existing ads |
| 259 | * added links to manual and inline videos to the meta box headline |
| 260 | * updated translation files |
| 261 | * remove hyphen from automatically created id prefix to not break ID creation |
| 262 | |
| 263 | = 1.7.1.5 = |
| 264 | |
| 265 | * hotfix: added missing file |
| 266 | |
| 267 | = 1.7.1.4 = |
| 268 | |
| 269 | * search for title or id instead of content when selecting a Specific Page Display Condition |
| 270 | * fixed double display conditions |
| 271 | * fixes notices appearing once after update |
| 272 | * fixed display condition error warning |
| 273 | * fixed content injection breaking when unescaped `</script>` was used within `document.write` |
| 274 | * added taxonomies created by Custom Post Type UI plugin to the display conditions |
| 275 | * add content placement for paragraphs without images |
| 276 | |
| 277 | = 1.7.1.3 = |
| 278 | |
| 279 | * fixed error when $wp_query is not set |
| 280 | * added French translation |
| 281 | |
| 282 | = 1.7.1.2 = |
| 283 | |
| 284 | * tested with WP 4.5 |
| 285 | * create random widget id, if not set yet |
| 286 | * allow content injection into nested paragraphs if none found at level 1 and 2 |
| 287 | * minor security update for admin ajax actions |
| 288 | * fixed home condition for some cases |
| 289 | * fixed secondary query check |
| 290 | * fixed de/activation hook |
| 291 | * fixed Spanish translation |
| 292 | * updated translation files |
| 293 | |
| 294 | = 1.7.1.1 = |
| 295 | |
| 296 | * added Feed condition to General Display Conditions |
| 297 | * trim license keys when saving |
| 298 | * reverted too strict display condition checks for taxonomies |
| 299 | * shortened debug page |
| 300 | |
| 301 | = 1.7.1 = |
| 302 | |
| 303 | * introduced AND/OR connectors for Display Conditions |
| 304 | * display conditions for some pages (archive page) are now stricter |
| 305 | * connectors for existing visitor conditions can be changed now |
| 306 | * added option to reserve ad space |
| 307 | * set ADVANCED_ADS_DISALLOW_PHP constant to prevent usage of PHP in plain ad code |
| 308 | * update ad block disguise files automatically, when Advanced Ads scripts changed after an update |
| 309 | |
| 310 | = 1.7.0.3 = |
| 311 | |
| 312 | * added debug mode for ads, see [manual](https://wpadvancedads.com/manual/ad-debug-mode/) |
| 313 | * skip check for general conditions if all are on (allows ad injection also in iframes and new wp instances) |
| 314 | * display jQuery issue notice in display conditions |
| 315 | * lifted the restriction to choose each display condition only once |
| 316 | * add notice when ad block folder needs to be rebuild |
| 317 | * hide an ad with a tag condition in posts that don’t have a tag at all |
| 318 | * prevent broken custom queries to interfere with display conditions |
| 319 | |
| 320 | = 1.7.0.2 = |
| 321 | |
| 322 | * hide ad if no term is selected for taxonomy display conditions |
| 323 | * show warning, if no items selected in display conditions |
| 324 | * fixed 500 error caused by plugins using WP_Query unsecured |
| 325 | |
| 326 | = 1.7.0.1 = |
| 327 | |
| 328 | * hotfix for missing get_current_screen issue |
| 329 | |
| 330 | = 1.7 = |
| 331 | |
| 332 | * rewritten Display Conditions interface and logic, see [manual](http://wpadvancedads.com/manual/display-conditions/) |
| 333 | * rich content ads now render oembed links |
| 334 | * added author display condition |
| 335 | * added link to Visitor Conditions manual |
| 336 | * added incompatibility warning for Q2W3 plugin |
| 337 | * home page display condition honored also on static pages |
| 338 | * single post display condition honored also on archive pages |
| 339 | * prevent ads from being loaded in wp_head when they are not a header placement |
| 340 | * optimized support form and added feedback messages |
| 341 | * fixed general secondary query setting |
| 342 | * fixes for jQuery issues and message for solutions |
| 343 | * fix error when editor role is missing |
| 344 | |
| 345 | [Changelog Archive](http://wpadvancedads.com/codex/changelog-archive/) |
| 346 | |
| 347 | == Upgrade Notice == |
| 348 |