WordPress.org Plugin Mirror
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
adsizes.php
help.php
icon.png
index.php
options.php
pro.png
readme.txt
screenshot.png
screenshot_pro.png
widget.png

readme.txt

=== Google AdSense for Responsive Design - GARD ===
Contributors: The Digital Hippies
Donate link: http://thedigitalhippies.com/donate
Tags: responsive, AdSense, responsive AdSense, Google AdSense, responsive ads, responsive design, responsive design, gard
Requires at least: 3.0.1
Tested up to: 3.5.1
Stable tag: 3.5.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

GARD (Google AdSense for Responsive Design) allows you to easily place Google AdSense in your website's content via the use of a shortcode.

== Description ==

GARD allows you to easily place responsive (asynchronous optional) Google AdSense in your website's content via the use of the shortcode [GARD], custom shortcode option available in [GARD Pro](http://thedigitalhippies.com/gardpro "GARD Pro: Google AdSense for Responsive Design Pro").

The inserted ads will never exceed the content area width, and will select the right size ad to show depending on which ads you have provided GARD to pick from.

GARD does not resize ads on the fly, because most users don't resize their browsers while viewing your website. Instead on initial page load, it determines the optimal ad for that position, and shows that ad.

Setup is easy. Create AdSense ads for the different sizes that you want to use on your website, then input the AdSense google_ad_slot number into the GARD settings page next to that ads dimension. That's it!

[GARD Pro](http://thedigitalhippies.com/gardpro "GARD Pro: Google AdSense for Responsive Design Pro") extends the capabilities of GARD by allowing things like customizing the shortcode, auto insert GARD into posts & pages, and a responsive widget.

[Click here to find out more about GARD Pro now](http://thedigitalhippies.com/gardpro "GARD Pro: Google AdSense for Responsive Design Pro").

Support: [The Digital Hippies Official WordPress Plugin Support Forums](http://thedigitalhippies.com/pluginsupport "The Digital Hippies WordPress Plugin Support Forums")

== Installation ==

1. Install from WordPress admin dashboard or extract and upload the contents of 'google-adsense-for-responsive-design-gard.zip' to the '/wp-content/plugins/' directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Place the shortcode [GARD] inside any posts and/or pages where you want your responsive AdSense ads to show
1. Profit??? (Literally, it's AdSense, so.... Profit!)

== Frequently Asked Questions ==

= Do I need my own AdSense account to make this work? =

Yes.

= Can I make my ads align left or right? =

Yes. If you would like your ads to align left, use the shortcode [GARD align="left"]. The same is true for center and right.  
Samples:  
[GARD] will not center or wrap text.  
[GARD align="left"] will make your ad align left and text wrap around it.  
[GARD align="center"] will make your ad centered and text wrap NOT around it.  
[GARD align="right"] will make your ad align right and text wrap around it.  

= Do I have to create ads for every size? =

No. You will only need to create an ad for each size that you want displayed. Feel free to leave the field(s) blank to skip that size.

= How do you prevent GARD from displaying more than 3 ads on one page? =

Google will not allow more than three AdSense ads to load per page. GARD cannot show more, even if you wanted it to.  
[Google content ad limit per page](https://support.google.com/adsense/answer/1346295?hl=en "Google content ad limit per page"): If you place more than one ad unit on a page, our system will display unique ads to each ad unit. Because the system automatically displays an optimal number of highly targeted Google ads on each page, in some cases, the maximum number of ads may not always appear.

= Can I change the shortcode text? =

Yes, with [GARD Pro](http://thedigitalhippies.com/gardpro "GARD Pro: Google AdSense for Responsive Design Pro"). (See "What are the GARD Pro Features" below.)

= Can I use GARD in widget areas? =

Yes, with [GARD Pro](http://thedigitalhippies.com/gardpro "GARD Pro: Google AdSense for Responsive Design Pro"). (See "What are the GARD Pro Features" below.)

= Can I use GARD automatically in old posts and pages? =

Yes, with [GARD Pro](http://thedigitalhippies.com/gardpro "GARD Pro: Google AdSense for Responsive Design Pro"). (See "What are the GARD Pro Features" below.)

= What are the different versions of the plugin? =

GARD (What you're looking at now)  
[GARD Pro](http://thedigitalhippies.com/gardpro "GARD Pro: Google AdSense for Responsive Design Pro") (Offers many additional features to extend GARD)  
* GARD Pro costs $34.95, and is appropriate if you expect to make more than $34.95 in ad revenue from your site. :P

= GARD Pro FAQ =

= What are the GARD Pro Features? =

[GARD Pro](http://thedigitalhippies.com/gardpro "GARD Pro: Google AdSense for Responsive Design Pro") offers the following additional features: 

1. Create ad groups. This allows you to have groups specific to links, banners, skyscrapers, etc.
2. Define a custom shortcode for inserting each group in to the content.
3. Auto insert GARD into user specified content types.
4. Select which group to auto insert, or let it be random.
5. Select which paragraphs your ads are inserted after, or let them appear randomly through your content.
6. A responsive widget for each ad group, with the option to show to everyone, or guests only.
7. Clone ad groups for easier setup.
8. Disable output of ads on pages with certain keywords.
9. Disable output of ads when the referring website is on a list of websites you specify.
10. Disable output of ads when the visitors IP address is on a user definable list.
11. Specify default alignment of ads: Float Left, Float Right, Centered or None. 
12. You may also select to position the ads randomly from the choices above.

= Can I use my own shortcode instead of the shortcode [GARD]? =
Yes. Enter your custom shortcode in the settings page. If you want to disable [GARD] and use only your shortcode, check the box "Only Allow Custom Shortcode".

= Can I choose to show the widget ads to guests only? =
Yes. Simply leave the checkbox on the widget titled "Display GARD for registered users?" unchecked. To show to both registered users and guests, check the checkbox.

= Can I give my widget a custom title? =
Yes. Just fill in the widget title after you place the widget.

= Can I have GARD Pro insert ads randomly throughout all content? =
Yes. In the option titled 'Auto insert AdSense after paragraphs' enter the word *random*. Once you enter the word random in that option, you'll see a second set of options asking you how many ads you want to automatically enter per article. You can select 1,2,3 or random to show between 1 and 3 ads per article.

= Can I specify which post types get ads automatically inserted? =
Yes. GARD Pro automatically detects all custom content types, and allows you to specify which types will get ads.

= Can I specify the default alignment of automatically inserted ads? =
Yes. You can select from the following; No Alignment, Aligned Left, Centered, Aligned Right, Random from the previous choices.

= How do I contact the plugin developer for help? =
Support is available on [The Digital Hippies Official WordPress Plugin Support Forums](http://thedigitalhippies.com/pluginsupport "The Digital Hippies WordPress Plugin Support Forums").

== Screenshots ==

1. Admin Options Page. Enter your AdSense publisher ID on the top line, and any ads you want displayed below. (screenshot.png)
2. Pro Options Page. Pro options include custom shortcode, auto insert GARD into posts, and a responsive widget. (screenshot_pro.png)
3. Widget Setup. Enable the GARD widget for all users, or only guests, and give it a title. (widget.png)

== Changelog ==

= 1.3 =
* [NEW FEATURE] GARD: Allow users to specify positioning of left, right, or center manually per ad.
* [NEW FEATURE] GARD Pro: Insert ads randomly throughout content.
* [NEW FEATURE] GARD Pro: Insert random number of ads in content.
* [NEW FEATURE] GARD Pro: Default positioning of left, right, or center.
* [NEW FEATURE] GARD Pro: Specify which custom post types to insert ads into.
* [NEW BETA FEATURE] GARD & GARD Pro: Asynchronous AdSense

= 1.2.1 =
* Added 320x50 Mobile Banner Size

= 1.2 =
* Added a help page, complete with video setup guide.

= 1.1 =
* Prepared for integration with GARD Pro: http://thedigitalhippies.com/gardpro
* Fixed icon on settings page

= 1.0.1 =
* Fixed incorrect admin icon code.

= 1.0 =
* Initial release.

== Upgrade Notice ==

= 1.3 =
* Added ability to align ads left, right, or center.
* Enabled Asynchronous AdSense [BETA FEATURE]

= 1.2.1 =
* Added 320x50 Mobile Banner Size

= 1.2 =
* Added a help page, complete with video setup guide.

= 1.1 =
* Prepared for integration with GARD Pro: http://thedigitalhippies.com/gardpro
* Fixed icon on settings page
* Other minor code changes

= 1.0.1 =
Only upgrade to fix icon in admin dashboard. No functionality changes.

= 1.0 =
Initial release. No upgrade needed.