=== RPS Include Content ===
Contributors: redpixelstudios
Donate link: http://redpixel.com/donate
Tags: include, content, post, page, nested content
Requires at least: 3.0
Tested up to: 3.3.1
Stable tag: 1.0.7

Makes it easy to pull content from one post or page and place it on another using a simple shortcode, even in a multisite environment.

== Description ==

The RPS Include Content plugin is useful when you need to include the same content across many posts or pages. For example, you may want to place your company boilerplate at the bottom of press releases in your News section. Instead of pasting the boilerplate copy at the end of each of these pages, you can now insert the shortcode (along with the post ID, and for multisite configurations, the blog ID) where that content should appear.

When you modify your source copy, changes will appear on all pages that contain the shortcode. There's no need to open and modify multiple pages.

When a user previews the post from the WordPress Administration, the included content is distinguished with an on-hover highlight. A link is provided so that the source content can be conveniently accessed and modified. The preview of the include will not distort the target page - the width, height and position will remain as defined by the site.


To easily obtain the blog ID and post ID, install the free [RPS Blog Info](http://wordpress.org/extend/plugins/rps-blog-info/) plugin, which places that information (and much more) on your WordPress 3.3 Toolbar.

= Features =
* Include a page or a post, with or without the title, in another page or post.
* Updates made to source content are reflected on all target pages.
* Source content pulled into a page is easily distinguishable and accessible when viewing the page on the front-end while logged into the WordPress back-end.
* Protects against generating include loops and calling nonexistent source content.
* Displays errors on the front-end to logged-in page/post editors.
* Compatible with single and multisite installs.

== Installation ==

1. Upload the <code>rps-include-content</code> directory and its containing files to the <code>/wp-content/plugins/</code> directory.
1. Activate the plugin through the "Plugins" menu in WordPress.

== Frequently Asked Questions ==

= How does the RPS Include Content shortcode work? =

The basic syntax of the shortcode is [rps-include blog=# post=#]. You do not need to specify the blog ID if you are not in a multisite environment.

= What other shortcode attributes can be used? =

* **title** - Use a boolean (true/false) to specify whether to display the title of the source content on the target post/pages. The default is 'false'.
* **titletag** - Use h1 through h6 to define the tag to wrap around the title. The default is 'h2'.

= So what if I want to show the title of the source content (blog 2, post 500) wrapped in a h3? =

You would use the shortcode like so: [rps-include blog=2 post=500 title=true titletag=h3]

= How can I find the blog and post IDs? =

To easily obtain the blog ID and post ID, install the free [RPS Blog Info](http://wordpress.org/extend/plugins/rps-blog-info/) plugin, which places that information (and much more) on your WordPress 3.3 Toolbar.

= Can I include pages or posts that already have includes within them? =

Yes. RPS Include Content supports "nested" includes. In addition, it protects you by preventing infinite loops and duplicate calls to the same content.

= What happens if I include a post that does not exist? =

If you are logged in, you will see an error message appear in place of the shortcode when viewing the public site. Users that are not logged in, or do not have post/page editing permissions will not see the error message.

= How do I easily access the source content to edit it? =

The best way is to view the page on the public site while logged in. Each piece of source content will be marked with  an "i" symbol and a vertical line appearing in theright margin. Hovering over the included content will display "View" and "Edit" buttons.  Clicking Edit will take you to the source post/page.

= What if I don't want the source content to be displayed on its own? =

All you would need to do is to set the source post/page publish status to "Private". The content will still show where it is included on other posts/pages.

= Is it possible to include content into different web sites? =

You can include content across different Web sites as long as they are in the same network. A multisite network is a collection of sites that all share the same WordPress installation.

== Screenshots ==

1. The source content can be a page or a post.
2. The shortcode can be inserted anywhere within another page or post.
3. The source content is flagged to the right when viewing the public site while logged in as a user with page/post editing permissions.
4. The source content is highlighted on hover. Clicking the Edit or View tab displays the source post/page in the appropriate mode.

== Changelog ==

= 1.0.7 =
First official release version.