WordPress.org

Ready to get started?Download WordPress

Plugin Directory

insert

Insert posts, hooks, or templates.

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

Github

Tags: ,

Requires: 2.7.0 or higher
Compatible up to: 3.8.0
Last Updated: 2014-1-30
Downloads: 73

Ratings

0 stars
0 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.