=== Embedder === 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.4 A powerful, easy-to-use plugin for embedding HTML into your blog's posts, pages, titles, and comments. == Description == Create **local HTML embeds** for blog post simply by adding one or more **custom fields**. Any custom field name enclosed in square brackets **[]** will be recognized as an embed when used in the post. For example, you can quickly create your own tag language for posts (and comments) by adding custom fields like **[b]**, **[i]**, **[quote]**, **[link]**, etc., and you can create embeds for YouTube Videos, Google Maps, and much more. Embed attributes makes it easy to add much more flexibility to your embeds. For example, to highlight any text in your posts (and comments), just add the following custom field: Name: [color] Value: %content% Then, in your posts, you can use the embed like this: The quick [color col="brown"]brown[color] fox jumps over the [color col="yellow"]lazy dog[/color]. The **%col%** attribute is replaced by the value you set, and the special **%content%** attribute is replaced by the text between the open and close embed tags. If you want to use your embeds in all your posts, create **global HTML embeds** using the *Manage Embeds* settings page, and take advantage of the following advanced features: * Use embed attributes to increase the flexibility of your embedded HTML. * NEW! Nested embeds (including a workaround to WordPress's nested shortcode problems) * NEW! Set default values for your attributes. * NEW! Use embeds in titles and comments too. * 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 an early public version of the Embedder Plugin, and while it has been tested, and nobody has reported any major issues so far (which is good news!), there still could be to be a few teething problems, 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 was the first version. = Version 0.2 = Added support for nested embeds. = Version 0.3 = Added support for attribute defaults. = Version 0.4 = Added support for embeds in titles and (optionally) in comments. == Upgrade Notice == This version is compatible with all previous versions. No special instructions required.