Description
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»]
`
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
Installation
Requires: PHP 5.3+
- Upload to the
/wp-content/plugins/
directory - Activate through the Plugins menu in WordPress
Reviews
There are no reviews for this plugin.
Contributors & Developers
“insert” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “insert” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.