WordPress.org

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'.
• shortcodes - Specify whether shortcodes should be allowed to remain in included posts. The default is 'true'.

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".

What if I have shortcodes in my included content that I don't want to display?

Add the "sortcode" attribute and set it to "false". Keep in mind that using this method will remove all shortcodes from the included content, including any rps-include shortcodes that are designed to call included content that is nested inside other included content. However, this should not affect most users.

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 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.

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.