=== Ads EZ Plugin for Google AdSense ===
Contributors: manojtd
Donate link: http://buy.thulasidas.com/google-adsense
Tags: google adsense, adsense, adsense plugin, ads, advertising, income
Requires at least: 3.2
Tested up to: 4.1
Stable tag: 3.21
License: GPL2 or later

Ads EZ Plugin for Google AdSense inserts Google ads on your blog, with customization using color pickers, widget support and robust placement options.

== Description ==

Ads EZ Plugin for Google AdSense provides a streamlined interface to deploy Google ads on your blog. You can customize the colors, sizes and placement of the ad blocks and activate them right from the plugin interface.The admin interface uses a highly functional and modern interface based on the twitter bootstrap framework with generous, context-sensitive help on every single option.

= Live Demo =

**Google AdSense admin interface is feature-rich, user-friendly and functional. Please visit this fully operational [live demo site](http://demo.thulasidas.com/google-adsense "Play with Google AdSense Admin Interface") to see what it can do for you.**

Ads EZ Plugin for Google AdSense is a specialized version of [Google AdSense Ultra](http://buy.thulasidas.com/google-adsense "Most versatile AdSense plugin for your blog"), which lets you manage in basic, standard and expert modes, all in a beautifully designed modern interface.

= Features =
1. Tabbed and intuitive interface.
2. Rich display and alignment options.
3. Widgets for your sidebar.
4. Robust codebase and option/object models.
5. Control over the positioning and display of ad blocks in each post or page.
6. Customized Google interface with color pickers.
7. Popover help for every option in the plugin.
8. An interface tour to familiarize yourself with the plugin features and layout.
9. Ability to spawn the plugin interface as a separate tab/window independent of the WordPress admin interface.

= Pro Version =

Ads EZ Plugin for Google AdSense is the freely distributed version of a premium plugin. The [Ultra version](http://buy.thulasidas.com/google-adsense "Pro version of the Ads EZ Plugin for Google AdSense plugin for $9.45") gives you even more features.

1. Safe Content filter: To ensure that your Google AdSense ads show only on those pages that seem to comply with Google AdSense policies, which can be important since some comments may render your pages inconsistent with those policies.
2. IP filter: Ability to specify a list of computers where your ads will not be shown, in order to prevent accidental clicks on your own ads -- one of the main reasons AdSense bans you. These features will minimize your chance of getting banned.
3. Compatibility mode: To solve the issue of the ad insertion messing up your page appearances when using some themes.
5. Category/Post Control: Ability to suppress ads on specific categories, posts and pages.
5. Shortcode Support: Show the ads only on the pages or posts you want, and exactly where you want them.
6. Mobile Support: Ability to show different sets of ads on mobile devices, or to suppress ads.
7. Excerpts: Ability to show a configurable number of ads on Excerpts (which make up the home page in some themes).
8. Option Sets: Multiple option sets can be defined and easily switched between.
9. Suspend Ads: Ability to temporarily suppress ad serving.
10. Admin Interface Themes: Multiple color schemes for the admin interface.
11. Ad Serving Statistics: Keep an eye on your ad serving statistics to make sure that Google is not shortchanging you. (Optional paid module)
12. Basic/Expert Modes: You can choose to operate it in basic or expert modes in addition to the standard mode.

The Ultra version costs $9.45 and can be [purchased online](http://buy.thulasidas.com/google-adsense "Pro version of the Ads EZ Plugin for Google AdSense plugin for $9.45") with instant download link.

== Upgrade Notice ==

Improvements in the admin dashboard.

== Screenshots ==

1. Ads EZ Plugin for Google AdSense "Overview" tab.
2. How to set the options for Ads EZ Plugin for Google AdSense.
3. Advanced configuration of the plugin.
4. Options to support safety, compatibility, mobile devices and category/post control.

== Installation ==

= Searching =

The easiest way to install this plugin is to use the WordPress Admin interface. Go to your admin dashboard, find the "Plugins" menu, and click on "Add New". Search for this plugin and click on "Install Now" and follow the WordPress instructions.

= Uploading =

If you want to download it and manually install, you can again use the WordPress dashboard interface. First download the plugin zip file to your local computer. Then go to your admin dashboard, find the "Plugins" menu, and click on "Add New". After clicking on the "Add New" menu item as above, click on "Upload" (below the title "Install Plugins" near the top). Browse for your downloaded zip file, upload it and activate the plugin.

= Using Plugin Interface =

Further updates (and Pro upgrades and module installations) to the plugin can be done easily from the plugin admin page itself, by clicking on the *Updates* button on the top right corner.

== Frequently Asked Questions ==

= How can I control the appearance of the ad blocks using CSS? =

All `<div>`s that Ads EZ Plugin for Google AdSense creates have the class attribute `adsense`. Furthermore, they have class attributes like `adsense-top`, `adsense-bottom` etc., You can set the style for these classes in your theme `style.css` to control their appearance.

= Can I control how the ad blocks are formatted in each page? =

Yes! In Ads EZ Plugin for Google AdSense, you have more options [through **custom fields**] to control ad blocks in individual posts/pages. Add custom fields with keys like **adsense-top, adsense-middle, adsense-bottom** and with values like **left, right, center** or **no** to have control how the ad blocks show up in each post or page. The value "**no**" suppresses all the ad blocks in the post or page for that provider.

= I don't understand the Pro features. Porn and site block - can't you set those during Asdense ad setup? =

What you have in AdSense is an ability to block ads from certain sites. For instance, if you don't like ads *from* my site "thulasidas.com", you can block them. What the pro version gives you is the ability to block ads *to* certain clients. That is, if you don't want visitors from certain IP addresses see your ads (because they may click on too many of them, getting your AdSense account banned, for instance), you can with my plugin.

Porn block also is similar -- Google lets you choose non-porn ads (I think). What my plugin does is to look at the content of your page, and block ads if it looks like a porn page. (This can happen if a spammer posts a porn kind of comment on your blog, which again may get your AdSense account banned.)

= How do I report a bug or ask a question? =

Please report any problems, and share your thoughts and comments [at the plugin forum at WordPress](http://wordpress.org/tags/google-adsense-lite "Post comments/suggestions/bugs on the WordPress.org forum. [Requires login/registration]") Or [contact me](http://support.thulasidas.com/ "Contact Manoj").

**If you have a question or comment about the Pro version, please do not use the forum hosted at WordPress.org, but [contact the plugin author](http://support.thulasidas.com/ "Contact Manoj") using our support portal.**

= Can I go back to the previous version of the plugin? I don't like the modern bootstrap/AJAX interface. =

You can download the [previous version](https://downloads.wordpress.org/plugin/google-adsense-lite.2.50.zip "Last version before the fancy AJAX interface") and install it. First deactivate and delete the latest version of the plugin, and then follow the *Uploading* method under the *Installation* section of this document. The new version uses an completely different options model, and your old options are left intact in your database, so that you can go back anytime.

= Why do I get error message saying something about direct access to plugin files? =

This plugin admin interface is designed with a loosely coupled architecture, which means it interacts with the WordPress core only for certain essential services (login check, plugin activation status, database access etc). Loosely coupled systems tend to be more robust and flexible than tightly integrated ones because they make fewer assumptions about each other. My plugin admin pages are fairly independent, and do not pollute the global scope or leak the style directives or JavaScript functions. In order to achieve this, they are loaded in iFrames within the WordPress admin interface.

Your web server needs direct access to the plugin files to load anything in an iFrame. Some aggressive security settings block this kind of access, usually through an `.htaccess` file in your `wp-content` or `plugins` folders, which is why this plugin gives a corresponding error message if it detects inability to access the files (checked through a `file_get_contents` call on a plugin file URL). But some systems implement further blocks specifically on `file_get_contents` or on iFrames with specific styles (using `mod_securty` rules, for instance), which is why the plugin provides a means to override this auto-detection and force the admin page.

= Is the direct access to plugin files a security hole? =

Note that it is only your own webserver that needs direct access to the PHP files. The reason for preventing such access is that a hacker might be able to upload a malicious PHP (or other executable script) to your web host, which your webserver will run if asked to. Such a concern is valid only on systems where you explicitly permit unchecked file uploads. For instance, if anyone can upload any file to your media folder, and your media folder is not protected against direct access and script execution, you have given the potential hacker an attack vector. This plugin has no upload facility, so allowing your webserver to serve the plugin admin files in an iFrame is completely safe, in my judgement.

== Change Log ==

* V3.21: Improvements in the admin dashboard. [April 14, 2015]
* V3.20: Launching a demo site. [April 11, 2015]
* V3.19: More changes in the compatibility check. [April 7, 2015]
* V3.18: Fixing a style that may have caused the admin page not to appear on some blogs. [April 4, 2014]
* V3.17: More compatibility checks. [April 2, 2015]
* V3.16: Minor fixes. [Mar 27, 2015]
* V3.15: Fixing a bug that prevented custom fields from working properly. [Mar 26, 2015]
* V3.14: Minor bug fix on ad suppression while not in loop. [Mar 25, 2015]
* V3.13: Adding error handling for updates. [Mar 24, 2015]
* V3.12: Serious bug fix related to multiple passes of the content filter. Introducing a verbosity option. [Mar 22, 2015]
* V3.11: Minor bug fixes, and adding diagnostic comments. [Mar 21, 2015]
* V3.10: This twitter-bootstrap version of the plugin is now feature-complete. [Mar 19, 2015]
* V3.09: Adding information about how to revert to the non-AJAX version of the plugin. [Mar 16, 2015]
* V3.08: Documentation and usability enhancements. [Mar 13, 2015]
* V3.07: Documentation and usability enhancements. [Mar 11, 2015]
* V3.06: More changes for compatibility with PHP5.30. [Mar 11, 2015]
* V3.04: Improvements in the login check functions. Various accumulated fixes. [Mar 9, 2015]
* V3.03: Killing anonymous functions for compatibility with PHP versions older than 5.3. [Mar 8, 2015]
* V3.02: Changes to the activation validation checks. [Mar 7, 2015]
* V3.01: Modifications to the update module. Minor code clean up. [Mar 5, 2015]
* V3.00: Complete rewrite of the plugin with a lot more features. Admin page based on the twitter bootstrap framework. [Mar 3, 2015]
* V2.50: Compatibility with WP4.1. [Jan 8, 2015]
* V2.40: Renaming the plugin as requested by Google. [Nov 30, 2014]
* V2.30: Automatic options migration upon plugin activation. [Sep 26, 2014]
* V2.22: Minor change to the admin interface. [Sep 9, 2011]
* V2.21: Compatibility with WP4.0. [Sep 8, 2014]
* V2.20: Compatibility with WP4.0. [Sep 7, 2014]
* V2.12: Updating translations, minor bug fixes. [Jul 17, 2014]
* V2.11: Minor bug fix. [May 8, 2014]
* V2.10: Internationalization and compatibility with WP3.9. [May 7, 2014]
* V2.00: Major changes to the design -- adding a translation interface, getting ready to change options handling. [Mar 22, 2014]
* V1.81: Adding options to suppress ads on sticky front page or search pages. [Jan 5, 2013]
* V1.80: Compatibility checks for WordPress V3.8. Bug fixes in options migration. [Dec 18, 2013]
* V1.70: Compatibility checks for WordPress V3.7. [Nov 11, 2013]
* V1.60: Compatibility with WP3.6. [Aug 10, 2013]
* V1.50: Adding an admin page translator. [May 22, 2013]
* V1.46: Bug fixes (Fatal error: Call-time pass-by-reference has been removed). [Jan 24, 2013]
* V1.45: Bug fix. [Dec 22, 2012]
* V1.44: Enforcing the Google policy on the number of ads, and making the pub-id entry flexible. [Nov 4, 2012]
* V1.43: Minor changes to validate the readme.txt. [Oct 21, 2012]
* V1.42: Minor changes to validate the readme.txt. [Oct 21, 2012]
* V1.41: Initial public release of the lite version. [Oct 21, 2012]
* V1.40: Admin interface modifications. [Sep 30, 2012]
* V1.31: Taking care of some debug notices from WordPress debug mode. [Aug 28, 2012]
* V1.30: Initial public listing at WordPress.org. [July 18, 2012]
* V1.20: Bug fixes, coding improvements. [Sep 9, 2011]
* V1.00: Initial release. [Nov 15, 2010]