=== 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.5.1 Stable tag: 1.0.13 License: GPL3 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 = * Display the title of the included post without any content. * Include the title of the included post with or without a hyperlink. * Include a page or a post in another page or post. * Specify whether the content or the excerpt should be used. * 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. * Support for password protected posts. == Installation == 1. Upload the rps-include-content directory and its containing files to the /wp-content/plugins/ 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'. * **titlelink** - Specify whether the titletag should be a link to the included post. The default is 'false'. * **content** - Specify whether to use the included post's content, excerpt or none. The default is 'content'. * **filter** - Force the included content to be processed by "the_content" filter. The default is 'false'. = What if my included content loses its formatting? = It seems that there are cases where the default content filters are not applied before the content is displayed. If this is the case then you simply need to add the shortcode attribute "filter" and set it to "true". = So what if I want to show the title of the source content (blog 2, post 500) wrapped in a h3 with the title being a link? = You would use the shortcode like so: [rps-include blog=2 post=500 title=true titletag=h3 titlelink=true] = What if I only want to show the title of the source content? = You would specify the content attribute like so: [rps-include post=500 content=none]. Setting the content attribute to 'none' forces the title to show. = 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. = What if the included post is protected by a password? = The included post title will appear followed by the password form, just like the default WordPress behavior. = 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. 1. The shortcode can be inserted anywhere within another page or post. 1. The source content is flagged to the right when viewing the public site while logged in as a user with page/post editing permissions. 1. The source content is highlighted on hover. Clicking the Edit or View tab displays the source post/page in the appropriate mode. == Upgrade Notice == = 1.0.13 = * New option to force included content to be formatted. = 1.0.12 = * New option to set 'content=none' to hide the content and show the tite. = 1.0.11 = * New option to link title to the included post using the 'titlelink=true' shortcode attribute. = 1.0.10 = * Better compatibility when third-party plugin output exists within included content. = 1.0.9 = * Support for password protected posts. = 1.0.8 = * New option to use excerpts instead of main content. == Changelog == = 1.0.13 = * Added filter option to force content formatting. = 1.0.12 = * Added option to set the content to none. = 1.0.11 = * Added option to link the title to the included post. = 1.0.10 = * Removed filter that caused duplication of included content in some cases. * Toned down the souce content highlighting so it is not as bright. = 1.0.9 = * Added support for requiring authentication when password protected posts are included. = 1.0.8 = * Added option to override the content with the excerpt of the included post. = 1.0.7 = * First official release version.