Usage
Use the [insert] shortcode inside posts or anywhere else that processes shortcodes.
[insert] shortcode attributes
- query – sets up a new
WP_Queryviaget_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’);
`
