| 1 | === Easy AdSense ===
|
|---|
| 2 | Contributors: manojtd
|
|---|
| 3 | Donate link: http://www.Thulasidas.com/buy
|
|---|
| 4 | Tags: adsense, ad, ads, advertising, google
|
|---|
| 5 | Requires at least: 2.6
|
|---|
| 6 | Tested up to: 2.8.*
|
|---|
| 7 | Stable tag: 2.6
|
|---|
| 8 |
|
|---|
| 9 | Easy AdSense manages all aspects of Google AdSense for your blog: insert ads into posts and sidebar, and add a Google Search box. Easy and complete!
|
|---|
| 10 |
|
|---|
| 11 | == Description ==
|
|---|
| 12 |
|
|---|
| 13 | *Easy AdSense* provides a very easy way to generate revenue from your blog using Google AdSense. With its full set of features, *Easy AdSense* is perhaps the first plugin to give you a complete solution for everything AdSense-related.
|
|---|
| 14 |
|
|---|
| 15 | = Features =
|
|---|
| 16 |
|
|---|
| 17 | 1. Remembers AdSense code and your options by theme, so that you don't have to re-enter them if you play with multiple themes. [This feature provides a solution to Google's unwillingness to let you modify and customize the AdSense code -- you just store all the code variants in your blog database.]
|
|---|
| 18 | 1. Enforces the Google policy of not more than three ad blocks per page.
|
|---|
| 19 | 1. Sidebar Widgets:
|
|---|
| 20 | * For AdSense for content with custom title.
|
|---|
| 21 | * For search with customizable text or image title.
|
|---|
| 22 | * For Link Units.
|
|---|
| 23 | 1. Rich set of Options:
|
|---|
| 24 | * To put Link Units or Ad Blocks in header or footer.
|
|---|
| 25 | * To suppress ads on all pages (as opposed to posts), or on the front/home page.
|
|---|
| 26 | * To add a customizable mouse-over border decoration on ad blocks.
|
|---|
| 27 | 1. Control over the positioning and display of AdSense blocks in each post or page.
|
|---|
| 28 | 1. Simplest possible configuration interface -- nothing more than cutting and pasting AdSense code, and with sensible defaults for the few options present, all with clear instructions.
|
|---|
| 29 | 1. Internationalized (multiple languages supported).
|
|---|
| 30 |
|
|---|
| 31 | If you feel that these features are a bit too much, consider my lean and mean AdSense plugin [AdSense Now!](http://wordpress.org/extend/plugins/adsense-now/ "The simplest possible way to AdSense enable your blog")
|
|---|
| 32 |
|
|---|
| 33 | = New Feature [in 2.60] =
|
|---|
| 34 |
|
|---|
| 35 | Translation tool (called *Easy Translator*) for internationalization. English (en_US) users will see no difference, and have no reason to update.
|
|---|
| 36 |
|
|---|
| 37 | *Easy Translator* (very soon to become a stand-alone plugin) picks up translatable strings (in _[_e]() functions) in my AdSense plugins and presents them and their existing translations (from the MO object of the current text-domain) in a user editable form. It can generate a valid PO file that can be emailed to the plugin author, streamlining the translator's work. (Requires WordPress 2.8+.)
|
|---|
| 38 |
|
|---|
| 39 | PS: You'll need a [Google AdSense Account](http://adsense.google.com/).
|
|---|
| 40 |
|
|---|
| 41 | If you like *Easy AdSense*, you may want to check out my other plugins: [Theme Tweaker](http://wordpress.org/extend/plugins/theme-tweaker/ "To tweak the colors in your theme with no CSS/PHP editing") and [Easy LaTeX](http://wordpress.org/extend/plugins/easy-latex/ "To display mathematical equations in your blog using LaTeX").
|
|---|
| 42 |
|
|---|
| 43 | == Screenshots ==
|
|---|
| 44 |
|
|---|
| 45 | 1. How to set the options for *Easy AdSense*
|
|---|
| 46 | 2. *Easy AdSense* in action - on my own blog.
|
|---|
| 47 |
|
|---|
| 48 | == Installation ==
|
|---|
| 49 |
|
|---|
| 50 | 1. Upload the *Easy AdSense* plugin (the whole easy-adsenser folder) to the '/wp-content/plugins/' directory.
|
|---|
| 51 | 2. Activate the plugin through the 'Plugins' menu in WordPress.
|
|---|
| 52 | 3. Go to the Setup -> Easy AdSense and enter your AdSense code and options.
|
|---|
| 53 | 4. Go to Themes -> Widgets to add widgets to your side bar(s).
|
|---|
| 54 |
|
|---|
| 55 | = Tips =
|
|---|
| 56 |
|
|---|
| 57 | Although the *Easy AdSense* plugin is designed to handle Google AdSense efficiently, there is nothing preventing you from using the text boxes to place any other kind of text in your blog posts and pages. In particular, you can use ad text from other providers, especially in the header and footer.
|
|---|
| 58 |
|
|---|
| 59 | == Frequently Asked Questions ==
|
|---|
| 60 |
|
|---|
| 61 | = How can I control the appearance of the adsense using CSS? =
|
|---|
| 62 |
|
|---|
| 63 | All `<div>`s that *Easy AdSense* creates have the class attribute `adsense`. Furthermore, they have attributes like `adsense-leadin`, `adsense-midtext`, `adsense-leadout`, `adsense-widget` and `adsense-lu` depending on the type. You can set the style for these classes in your theme `style.css` to control their appearance.
|
|---|
| 64 |
|
|---|
| 65 | = Ad Space sharing? =
|
|---|
| 66 |
|
|---|
| 67 | There is an ad-space sharing scheme implemented starting version 2.5 of *Easy AdSense*, if you would like to support its future development. It gives you an option to share a small fraction of your ad slots to show the author's ads. You can configure this fraction - the default is 5%. (Five percent means my ad would appear roughly once in twenty of your ads). I have extra code to ensure that my ads don't appear more than once on the same page.
|
|---|
| 68 |
|
|---|
| 69 | You can turn off this ad space sharing by entering 0% (starting version 2.57).
|
|---|
| 70 |
|
|---|
| 71 | = Why does my AdSense code disappear when I switch to a new theme? =
|
|---|
| 72 |
|
|---|
| 73 | One of my motivations in writing *Easy AdSense* was the fact that every time I switched between themes, I had to regenerate the AdSense code to match my new colors. Since I often switched back to the original theme (when I would have to regenerate the code again), I wanted to keep the AdSense code *per theme* in my database. Now, with *Easy AdSense* activated, I can switch among my themes without worrying about the AdSense color mismatch. This is what I meant when I said, "Remembers AdSense code and your options by theme, so that you don't have to re-enter them if you play with multiple themes. [This feature provides a solution to Google's unwillingness to let you modify and customize the AdSense code -- you just store all the code variants in your blog database.]" as the most important feature of *Easy AdSense*.
|
|---|
| 74 |
|
|---|
| 75 | But this unfortunately means that you do have to set the code *once* whenever you switch to a new theme. I suppose I could have checked your database for some other AdSense code and presented it as defaults, but such complex logic usually results in less robust programs, and pain and suffering down the road.
|
|---|
| 76 |
|
|---|
| 77 | = Can I control how the ad blocks are formatted in each page? =
|
|---|
| 78 |
|
|---|
| 79 | Yes! Now, in V2.1+, you 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, adsense-widget, adsense-search** 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 AdSense ad blocks in the post or page.
|
|---|
| 80 |
|
|---|
| 81 | = I find this *easy* plugin too complex with too many options. Any alternatives? =
|
|---|
| 82 |
|
|---|
| 83 | If you feel that the features of *Easy AdSense* are a bit too much, consider my lean and mean AdSense plugin [AdSense Now!](http://wordpress.org/extend/plugins/adsense-now/ "The simplest possible way to AdSense enable your blog")
|
|---|
| 84 |
|
|---|
| 85 | = I just upgraded to WordPress version 2.8. My widget is gone and I'm mad. What gives? =
|
|---|
| 86 |
|
|---|
| 87 | WP2.8 uses a different widget API. *Easy AdSense* is comapatible with it. Just go to your widget page, and drag and drop it again in the sidebar of your choice at the right point. Fret not, your settings and AdSense code are safely saved (per theme), and you don't have to cut and paste those details again.
|
|---|
| 88 |
|
|---|
| 89 | = I just activated the plugin. How come I don't see any ads in my blog? =
|
|---|
| 90 |
|
|---|
| 91 | Note that you have to generate your adsense code from Google, and paste the *entire* code in the text boxes, replacing the existing text. Changing the publisher id alone is not good enough.
|
|---|
| 92 |
|
|---|
| 93 | If you just created the new Google AdSense code, it may not be active yet. Google takes about ten minutes or so before serving ads. Please try again later.
|
|---|
| 94 |
|
|---|
| 95 | = I am having a difficult time getting the middle of post ads to show. They show in some posts, but not all of them. Any possible recommendations? =
|
|---|
| 96 |
|
|---|
| 97 | The middle ads are designed to show up only on long posts (of more than 20 paragraphs). Use the option to force the mid-text ads (in v1.82+) to override this length check.
|
|---|
| 98 |
|
|---|
| 99 | = How do I report a bug or ask a question? =
|
|---|
| 100 |
|
|---|
| 101 | Please report any problems, and share your thoughts and comments [at the plugin forum at WordPress](http://wordpress.org/tags/easy-adsenser "Post comments/suggestions/bugs on the WordPress.org forum. [Requires login/registration]") Or send an [email to the plugin author](http://manoj.thulasidas.com/mail.shtml "Email the author").
|
|---|
| 102 |
|
|---|
| 103 | == Translations ==
|
|---|
| 104 |
|
|---|
| 105 | * Turkish: [Omer Faruk](http://ramerta.com "Easy AdSense in Turkish (Turkce Ceviri)").
|
|---|
| 106 | * Spanish: [Joaquin R. Rizer](http://www.shanky.com.ar "Joaquin R. Rizer") and [Maikel Frias](http://www.maikeladas.es "Maikel Frias").
|
|---|
| 107 | * Portuguese: [Ivan Carlos](http://www.icarlos.net "Ivan Carlos").
|
|---|
| 108 | * Italian: [Angelo D Agostino](http://www.console-war.com "Angelo D Agostino").
|
|---|
| 109 | * Bahasa Indonesia: [Hendry](http://debuk.com/ "Hendry").
|
|---|
| 110 | * Belarusian: [Marcis Gasuns](http://www.fatcow.com/ "Marcis Gasuns").
|
|---|
| 111 | * German: Ole Emken.
|
|---|
| 112 | * Simplified Chinese: [Akii Snow](http://www.akii.org "Akii Snow").
|
|---|
| 113 | * French: Moi!
|
|---|
| 114 |
|
|---|
| 115 | PS: Plugin author does not endorse any of the translators' websites, nor is he responsible for the contents therein.
|
|---|
| 116 |
|
|---|
| 117 | A big "Thank You" to all my translators. *Easy AdSense* V2.6+ sports an *Easy Translator* interface that will make the maintenance of translations a breeze. Please take a look (by following the link on the plugin admin page inviting you to improve the existing translation) and update your translations, when you get a chance. This translation interface is a bit experimental and works only on WP2.8+; please report any issues you encounter so that I can improve it. Thanks!
|
|---|
| 118 |
|
|---|
| 119 | == Change Log ==
|
|---|
| 120 |
|
|---|
| 121 | * V2.60: Translation tool (called *Easy Translator*) for internationalization. English (en_US) users will see no difference, and have no reason to update. [July 12, 2009]
|
|---|
| 122 | * V2.59: Option to suppress ads on attachment pages. Simplified Chinese translation. [July 8, 2009]
|
|---|
| 123 | * V2.58: Admin page enhancements. [July 2, 2009]
|
|---|
| 124 | * V2.57: Removing min-max enforcing on ad space sharing. [June 30, 2009]
|
|---|
| 125 | * V2.56: Fixing a typo in `is_category()`. [June 26, 2009]
|
|---|
| 126 | * V2.55: Fixing the issue with submit buttons in IE8. [June 23, 2009]
|
|---|
| 127 | * V2.54: Providing `htmlspecialchars_decode()` for compatibility with older versions of PHP. [June 23, 2009]
|
|---|
| 128 | * V2.53: The `<div>`s containing the adsense code have class names set so that they can be controlled from the theme CSS. The shared ad-slots are of the same size and show only text ads now. [June 23, 2009]
|
|---|
| 129 | * V2.52: German translation. [June 20,2009]
|
|---|
| 130 | * V2.51: Widgets modified to handle the new Widgets API in WP2.8+. (Fully backward compatible.) [June 13, 2009]
|
|---|
| 131 | * V2.50: Option to suppress ads on category/tag/archive pages -- requested feature. Changing the plugin name (dropping the last "r"). Configurable ad-space sharing to support the plugin development. [June 12, 2009]
|
|---|
| 132 | * V2.41: Option to change the mouse-over border color and width for the ad blocks. Also, option to enable mouse-over decoration for the sidebar widget and link units. [June 6, 2009]
|
|---|
| 133 | * V2.40: Major improvements on the admin page. Sponsored links on the admin page. Adding a requested Feature: Option to suppress ad blocks in front page/home page. [May 29, 2009]
|
|---|
| 134 | * V2.38: Fixing a but that prevented the Google search title from being displayed. [May 22, 2009]
|
|---|
| 135 | * V2.37: Belarusian translation. [May 11, 2009]
|
|---|
| 136 | * V2.36: Turkish translation. [May 4, 2009]
|
|---|
| 137 | * V2.35: Added some HTML comments in the page with version number and ad block sequence number for easy trouble shooting. [May 1, 2009]
|
|---|
| 138 | * V2.34: A new option to put a border around the ad blocks as a mouse over decoration. [April 28, 2009]
|
|---|
| 139 | * V2.33: More fixes to finally make the admin page totally "Valid XHTML 1.0 Transitional." Also releasing translation in Bahasa Indonesia [April 17, 2009]
|
|---|
| 140 | * V2.32: Minor bug fixes related to W3 Validation. [April 13, 2009]
|
|---|
| 141 | * V2.31: Updating some language files and correcting minor SVN commit errors. [April 12, 2009]
|
|---|
| 142 | * V2.30: Major overhaul of the interface. New clean look with javascript tooltips hiding details. New options to clean up the database entries and uninstall the plugin. [April 12, 2009]
|
|---|
| 143 | * V2.26: An option to show ads only in blog posts (and not on pages). [April 9, 2009]
|
|---|
| 144 | * V2.25: More robust handling of internationalization. [April 4, 2009]
|
|---|
| 145 | * V2.24: Releasing in Italian, revising Spanish. [April 3, 2009]
|
|---|
| 146 | * V2.23: Releasing in Portuguese. [March 29, 2009]
|
|---|
| 147 | * V2.22: Releasing in Spanish and French. [March 28, 2009]
|
|---|
| 148 | * V2.21: Internationalization -- second pass with my own localization in francais (pathetic though the translation is). [March 26, 2009]
|
|---|
| 149 | * V2.20: Internationalization (I18n) -- first pass. [March 26, 2009]
|
|---|
| 150 | * V2.11: Bug fix: the plugin wasn't gracefully handling posts with no custom fields. [March 10, 2009]
|
|---|
| 151 | * V2.10: Adding more control over displaying AdSense blocks in individual posts/pages. [March 8, 2009]
|
|---|
| 152 | * V2.01: An option to prioritize the sidebar widget when enforcing the Google policy of not more than three ad blocks. [March 3, 2009]
|
|---|
| 153 | * V2.00: [Feb 22, 2009]
|
|---|
| 154 | 1. New widget for Link units.
|
|---|
| 155 | 2. Complete revamping of the settings page, including an option to reload default settings.
|
|---|
| 156 | 3. Coding improvements, including separating the HTML of the setting page from the PHP file.
|
|---|
| 157 | 4. Ability to center ad blocks. [Due to this new feature, you may have to re-enter the alignment options of your existing ads if you are upgrading from an earlier version.]
|
|---|
| 158 | * V1.82: Option to remove all back-links to my blog, by user demand. Option to force mid-text ad-block even in short posts. [Feb 15, 2009]
|
|---|
| 159 | * V1.81: Simplifying the options on Google policy and limiting link-backs. [Feb 12, 2009]
|
|---|
| 160 | * V1.80: An option to limit link-backs, and to show ad blocks in feeds. [Feb 7, 2009]
|
|---|
| 161 | * V1.70: An option on Google policy -- to have two ad blocks plus the side bar widget, three ad blocks (with or without the side bar widget) or none at all. [Jan 25, 2009]
|
|---|
| 162 | * V1.61: Restricting the "Easy AdSense by Unreal" plug only to posts and pages. [Jan 18, 2009]
|
|---|
| 163 | * V1.60: Enforcing the Google AdSense policy of three ad blocks or less per page. [Jan 16, 2009]
|
|---|
| 164 | * V1.50: Another sidebar widget for Google search, making this plugin a complete solution for all things AdSense-related. [Jan 7, 2009]
|
|---|
| 165 | * V1.40: A sidebar widget. [Jan 2, 2009]
|
|---|
| 166 | * V1.30: Theme-specific configurations saved, so that if you switch back and forth between themes, you don't have to change the settings. [Dec 28, 2008]
|
|---|
| 167 | * V1.20: Tested with WordPress 2.7. Style modifications in the Admin-menu page to match the new WordPress. [Dec 13, 2008]
|
|---|
| 168 | * V1.10: Use of WordPress style sheets for better look and feel integration. Coding improvements. [Dec. 7, 2008]
|
|---|
| 169 | * V1.02: Added "Settings" link to the WP plugin page. [Nov 30, 2008]
|
|---|
| 170 | * V1.01: Minor fix for restricting the filter to single posts. [Nov 29, 2008]
|
|---|
| 171 | * V1.00: Initial release. [Nov 27, 2008]
|
|---|
