Title: insert
Author: ryanve
Published: <strong>January 30, 2014</strong>
Last modified: January 30, 2014

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/insert.svg)

# insert

 By [ryanve](https://profiles.wordpress.org/ryanve/)

[Download](https://downloads.wordpress.org/plugin/insert.zip)

 * [Details](https://pcd.wordpress.org/plugins/insert/#description)
 * [Reviews](https://pcd.wordpress.org/plugins/insert/#reviews)
 *  [Installation](https://pcd.wordpress.org/plugins/insert/#installation)
 * [Development](https://pcd.wordpress.org/plugins/insert/#developers)

 [Support](https://wordpress.org/support/plugin/insert/)

## Description

### Usage

Use the `[insert]` shortcode inside posts or anywhere else that processes [shortcodes](https://codex.wordpress.org/Shortcode_API).

#### `[insert]` shortcode attributes

 * query – sets up a new [`WP_Query`](https://codex.wordpress.org/Class_Reference/WP_Query)
   via [`get_posts()`](https://codex.wordpress.org/Template_Tags/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()`](https://codex.wordpress.org/Function_Reference/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

 * [github.com/ryanve/insert](https://github.com/ryanve/insert)

## Installation

Requires: PHP 5.3+

 1. Upload to the `/wp-content/plugins/` directory
 2. 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.

Contributors

 *   [ ryanve ](https://profiles.wordpress.org/ryanve/)

[Translate “insert” into your language.](https://translate.wordpress.org/projects/wp-plugins/insert)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/insert/), check out
the [SVN repository](https://plugins.svn.wordpress.org/insert/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/insert/) by [RSS](https://plugins.trac.wordpress.org/log/insert/?limit=100&mode=stop_on_copy&format=rss).

## Meta

 *  Version **0.1.0**
 *  Last updated **12 years ago**
 *  Active installations **10+**
 *  WordPress version ** 2.7.0 or higher **
 *  Tested up to **3.8.0**
 *  Language
 * [English (US)](https://wordpress.org/plugins/insert/)
 * Tags
 * [insert](https://pcd.wordpress.org/plugins/tags/insert/)[shortcode](https://pcd.wordpress.org/plugins/tags/shortcode/)
 *  [Advanced View](https://pcd.wordpress.org/plugins/insert/advanced/)

## Ratings

No reviews have been submitted yet.

[Add my review](https://wordpress.org/support/plugin/insert/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/insert/reviews/)

## Contributors

 *   [ ryanve ](https://profiles.wordpress.org/ryanve/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/insert/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](http://gittip.com/ryanve)