=== Ad Codes Widget ===

Version: 2.1
Stable tag: 2.1
Framework: WS-W-3.5

SSL Compatible: yes
WordPress Compatible: yes
WP Multisite Compatible: yes
Multisite Blog Farm Compatible: yes

Tested up to: 3.1
Requires at least: 3.0
Requires: WordPress® 3.0+, PHP 5.2+

Copyright: © 2009 WebSharks, Inc.
License: GNU General Public License
Contributors: WebSharks, PriMoThemes
Author URI: http://www.primothemes.com/
Author: PriMoThemes.com / WebSharks, Inc.
Donate link: http://www.primothemes.com/donate/

Plugin Name: Ad Codes Widget
Forum URI: http://www.primothemes.com/forums/viewforum.php?f=8
Plugin URI: http://www.primothemes.com/post/product/ad-codes-widget/
Description: The Ad Codes Widget allows you to place ANY size banner ( ad, ads, advertisements ) into a widget-ready bar for WordPress®. It supports AdSense®, Javascript, XHTML and more.
Tags: widget, widgets, ad codes, ads, adsense, google, sponsors, advertise, advertisements, banners, ad networks, banner rotation, options panel included, websharks framework, w3c validated code, multi widget support, includes extensive documentation, highly extensible

Supports AdSense®, Javascript, XHTML and PHP code. The Ad Codes widget allows you to place ANY size banner ( ad, ads, advertisements ) into a widget-ready bar for WordPress®. PHP code can be disabled for security when its installed on a Multisite Blog Farm.

== Installation ==

1. Upload the `/ad-codes-widget` folder to your `/wp-content/plugins/` directory.
2. Activate the plugin through the `Plugins` menu in WordPress®.
3. Navigate to `Appearance->Widgets` and add the widget.

***Special instructions for Multisite Blog Farms:** If you're installing this plugin on WordPress® with Multisite/Networking enabled, and you run a Blog Farm ( i.e. you give away free blogs to the public ); please `define("MULTISITE_FARM", true);` in your /wp-config.php file. When this plugin is running on a Multisite Blog Farm, it will mutate itself ( including its menus ) for safe compatiblity with Blog Farms. You don't need to do this unless you run a Blog Farm. If you're running the standard version of WordPress®, or you run WordPress® Multisite to host your own sites, you can ( and should ) skip this step.*

== Description ==

The Ad Codes widget allows you to place ANY size banner into a widget-ready bar for WordPress®. You can paste HTML, JavaScript, an IFrame, or even PHP code into this widget without any problem at all. The Ad Codes widget also supports multi-widget options, so you can add more than one banner to your sidebar, or even more than one size if you�'d like. This widget also supports shuffle-rotations, allowing you to place more than one ad code into a single widget box. All you do is separate each code block using a special `<!--rotate-->` tag.

The Ad Codes widget supports embedded PHP code. If you know a little PHP scripting, you could add conditionals to the code that you place into this widget. For example, if you wanted to show different ads based on the category that is currently being displayed on your blog, you could do something like this:<!--more-->

	<?php if(is_category("green-lizards")): ?>

	  insert green lizard ad campaign here

	<?php elseif(is_category("purple-socks")): ?>

	  insert purple socks ad here

	<?php else: ?>

	  insert default ad code here

	<?php endif; ?>

== Screenshots ==

1. Ad Codes Widget / Screenshot #1

== Frequently Asked Questions ==

= What is the best size ( width x height ) to use? =
The recommended size is 336x280, but it does not have to be that exact size. You can use ANY size you like.

= What type of code can I put in? =
Feel free to paste any type of ad code into the squares. AdSense®, XHTML, PHP, IFrame, JavaScript, whatever.

= Can I automatically rotate various ad codes? =
If you'd like to rotate a few different ads, just insert this tag: `<!--rotate-->` between every ad code that you want to rotate through. All of your codes go into the one single form field, separated by the `<!--rotate-->` tag.

== Changelog ==

= 2.1 =
* Framework updated; general cleanup.
* Updated with static class methods. This plugin now uses PHP's SPL autoload functionality to further optimize all of its routines.
* Optimizations. Further internal optimizations applied through configuration checksums that allow this plugin to load with even less overhead now.

= 2.0.8 =
* Framework updated; general cleanup.
* Updated for compatibility with WordPress® 3.1.

= 2.0.7 =
* Framework updated; general cleanup.

= 2.0.6 =
* Framework updated; general cleanup.

= 2.0.5 =
* Framework updated; general cleanup.
* Updated minimum requirements to WordPress® 3.0.

= 2.0.4 =
* Framework updated to WS-W-3.0.

= 2.0.3 =
* Framework updated to WS-W-2.3.

= 2.0.2 =
* Updated minimum requirements to WordPress® 2.9.2.
* Framework updated to WS-W-2.2.

= 2.0.1 =
* Stable tag updated in support of tagged releases within the repository at WordPress.org.

= 2.0 =
* WebSharks Framework for Widgets has been updated to W-2.1.

= 1.9 =
* License updated to GPLv2.

= 1.8 =
* Re-organized core framework. Updated to: W-2.0.
* Updated to support WP 2.9+.

= 1.7 =
* Added some additional documentation.
* Added support for embedded PHP code.
* Changed the rotation tag format to: `<!--rotate-->`.
* Replaced deprecated `split()` function with `preg_split()`.

= 1.6 =
* Updated to provide better instruction on the options panel.

= 1.5 =
* Added default placeholders when no ad code is present.

= 1.4 =
* Code re-organized / optimized for better performance.

= 1.3 =
* Added a feature that allows you to re-title the widget.

= 1.2 =
* Updated to support ad shuffling / rotations.

= 1.1 =
* Updated to support WordPress® 2.8.4.

= 1.0 =
* Initial release.