This plugin hasn’t 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.

insert

Description

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

Installation

Requires: PHP 5.3+

  1. Upload to the /wp-content/plugins/ directory
  2. Activate through the Plugins menu in WordPress

Contributors & Developers

“insert” is open source software. The following people have contributed to this plugin.

Contributors

Translate “insert” into your language.

Interested in development?

Browse the code or subscribe to the development log by RSS.