Usage
Use the
[insert]
shortcode inside posts or anywhere else that processes
shortcodes.
[insert]
shortcode attributes
- query - sets up a new
WP_Query
via get_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"]
Insert an action
[insert action="dostuff"]
Pass data to an action
[insert data="field=slug&value=example&tax=category" action="dostuff"]
The action receives data as an array.
add_action('dostuff', 'print_r');
Insert a page via template
[insert query="name=about&post_type=page" template="entry.php"]
Insert a page via action
This sets up the query and triggers the action.
[insert query="name=about&post_type=page" action="dostuff"]
WP template tags are available inside the action.
add_action('dostuff', 'the_title');
Github