Insert posts, hooks, or templates.
Author: | Ryan Van Etten (profile at wordpress.org) |
WordPress version required: | 2.7.0 |
WordPress version tested: | 3.8.0 |
Plugin version: | 0.1.0 |
Added to WordPress repository: | 30-01-2014 |
Last updated: | 30-01-2014
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
|
Rating, %: | 0 |
Rated by: | 0 |
Plugin URI: | http://github.com/ryanve/insert |
Total downloads: | 1 154 |
Active installs: | 10+ |
Click to start download |
Usage
Use the [insert]
shortcode inside posts or anywhere else that processes shortcodes.
[insert]
shortcode attributes
- query - sets up a new
WP_Query
viaget_posts()
- data - data to pass to actions
- action - action to run, runs for each post if applicable
- filter - filter to run, runs for each post if applicable
- template - template to load via
locate_template()
All attributes are optional and can be used in combination to yield powerful abilities.
Abilities
Possibilities with [insert]
are endless. Practical uses include:
- Insert posts into posts
- Insert hooks into posts
- Insert posts into widgets
- Run action hooks via widgets
- Load templates via widgets
Examples
Insert a template
[insert template="branding.php"]<pre><code></code></pre>
Insert an action
[insert action="dostuff"]<pre><code></code></pre>
Pass data to an action
[insert data="field=slug&value=example&tax=category" action="dostuff"]<pre><code></code></pre>
The action receives data as an array.
add_action('dostuff', 'print_r');<pre><code></code></pre>
Insert a page via template
[insert query="name=about&post_type=page" template="entry.php"]<pre><code></code></pre>
Insert a page via action
This sets up the query and triggers the action.
[insert query="name=about&post_type=page" action="dostuff"]<pre><code></code></pre>
WP template tags are available inside the action.
add_action('dostuff', 'the_title');<pre><code></code></pre>