WordPress.org

Installation:

1. Download the bannergarden.zip from here. [no link, i am waiting for the wordpress plugin page activation].
2. Unzip it into your wp-content/plugins/ directory.
3. Go to the Plugins page at Dashboard.
4. Activate the plugin.

Usage:

1. Go to the Dashboard -> Settings -> BannerGarden
2. Create a new campaign, and set it to Active
3. Add new banner(s) to your campaign
4. Insert anywhere this shortcode with your Campaign ID: [bannergarden id="xxx"] where xxx is the ID of campaign.
5. If you want to translate it, use PoEdit to translate.

You can read more, how Banner Garden works, at the Banner Garden home page: http://vaso.sma.hu/blog/banner-garden-plugin-for-wordpress/

Notes:

I used WordPress 2.9.2 for developing this plugin, i don't know, is it works with previous versions of it. I tested it with these browsers under Windows XP Pro SP3 (32-bit):

• Firefox 3.6 rv.1.9.2,
• Google Chrome 4.1.249.1045 (42898)
• Opera 10.10 Build 1893
• Safari 4.0.4 (531.21.10)
• Internet Explorer 8.0.6001.18702

Please write me if you have other configuration, and it works.

Localization:

I translated it to Hungarian. If you translate it to other language(s), please send me the .mo/.po files, and i will add it to the package.

How Banner Garden works [detailed usage]:

Place a shortcode anywhere in your page (see below): [bannergarden id="xxx"]

The xxx is the ID of your campaign what you found at list of campaigns page. The quotes are important! You have several options to insert this shortcode into your page.

• You can add it to your posts or pages through the WordPress editor.
• You can use the Banner Garden widget, and place it to your sidebar(s).
• Edit the .php file what you want, and insert this code.

So, before your WordPress engine start to render the page, the plugin is search for this shortcode. If it founds, it try to process it.

About the process method. The processor get out the id of the campaign. Check, is this campaign exists, if yes, check is this campaign active, and if it is active, check, is the time settings are right. If everything is all right, it check is there any banner in this campaign. If there is/are banner(s), then select one randomly, and replace the shortcode with your media.

If any of above condition fails, it will show the default banner what is placed in the plugin dirs media subdirectory named “default_banner.jpg”. This happens only, if you did not checked out the “Show default banner if anything fails” option.

I included a test falsh and a test image banner for you in this media subdirectory.

That's it. You can read more about this plugin, updates, users comments at http://vaso.sma.hu/blog/banner-garden-plugin-for-wordpress/

I did work very hard on this very first plugin, it tooks me 4 days, because i know wordpress only since a week.

Thank You!