=== Plugin Name ===
Contributors: Mike Walker
Donate link: http://moztools.com/wordpress/embedder-plugin/ 
Tags: embed, embedder, embed html, imbed, include, shortcode, shortcodes, macros, macro, substitution, moztools
Requires at least: 2.5
Tested up to: 3.0.1
Stable tag: 0.2

A sophisticated plugin from moztools.com for organizing and inserting snippets of text and HTML into your blog. 
 
== Description ==

These days almost every popular web site is offering some kind of icon, button, widget, or gadget 
for your blog or web page. Whether it's Facebook's Like Button, Twitter's Tweet Button, maps or 
calendar pages from Google, there is a whole bunch of stuff on offer that can be embedded directly
into your WordPress blog.

Now, instead of manually inserting some convoluted HTML code (which can be easily messed up)
or having to install yet another plugin designed just for that snippet of HTML, you can use
the all purpose Embedder plugin to insert any snippet of text of HTML wherever you want.

You can create and manage as many **embeds** as you need using the *Manage Embeds* settings page,
and take advantage of the following advanced features:

* Quickly create local embeds for a single post.
* Create global embeds for use anywhere in your blog posts or pages.
* Use embed attributes to increase the flexibility of your embedded HTML.
* Auto-embed HTML at the top and bottom of blog posts and pages.
* Include or exclude auto-embeds from posts/pages based on tags, categories, or parent pages.
* Wrap your embeds in a *div* or *span* to modify an embed's position or appearance.
* Call out to a user-specified PHP function to generate the embed's HTML for you.

For more information, go to the [Embedder Plugin's Home Page](http://moztools.com/wordpress/embedder-plugin/)
where you will find extensive documentation for the plugin, and the 
[Embedder Plugin Support Forum](http://moztools.com/wordpress/embedder-plugin/support-forum/).

**IMPORTANT NOTE**

This is the very first public version of the Embedder Plugin, and while it has been tested, 
and is already being used on a couple of websites, there are likely
to be some teething problems you could come across if you decide you use it, especially if
you are using earlier versions or WordPress, PHP, or MYSQL than those tested.

That said, if you decide the Embedder a whirl, please let me know how you get on by
leaving feedback in the [Embedder Plugin Support Forum](http://moztools.com/wordpress/embedder-plugin/support-forum/).
There is no need to register, just go there and post your comments.

== Installation ==

Installation Instructions:

For WordPress 2.7 and above:

1. Navigate to the **Plugins** >> **Add New** page in your blog's administration section.
1. Search for **Embedder**.
1. Locate the plugin then click **Install** and follow the on-screen instructions. 

For older versions of WordPress:

1. Download the plugin zip file. 
1. Upload the plugin contents into your WordPress installation's plugin directory.
1. The plugin's .php files and readme.txt should be installed in the 'wp-content/plugins/embedder/' directory. 
1. From the Plugin Management page, activate the Embedder plugin.

Getting Started (these instructions are for WordPress 2.7 and above):   
   
1. To create a new embed, go to **Settings** >> **Embeds** and click on the **'Add New'**.
1. Enter a Name and (optionally) a Description for your embed.
1. Now enter the HTML or text you want to embed in your blog. (Or copy and paste it from another website.)
1. Click the **Add Embed** button to add your new embed.
1. Now edit the post or page where you want the embed to appear. 
1. Scroll down to the place you need it, and enter the embed's name surrounded by square brackets.
For example, **[smiley-face]**
1. Save the post/page and view it. The embedded HTML should appear where you put it. 

== Frequently Asked Questions ==

= What are the minimum versions of software the plugin has been tested with? =

* WordPress 2.5 is the known minimum required (will definitely not work with older versions of WordPress)
* WordPress 3.0.1 is the minimum version the plugin has been tested on
* PHP5 5.2.6 (will probably work with earlier versions of PHP4 and PHP5)
* MYSQL 5.0.5 (will probably work with earlier versions of MYSQL 4.0 and 5.0)

== Screenshots ==

None at the moment.

== Known issues ==
 
None so far.

== Changelog ==

= Version 0.1 =

This is the first version.

= Version 0.2 =

Added support for nested embeds.

== Upgrade Notice ==
  
This version is compatible with all previous versions.  
  
No special instructions required.