WP plugin to insert posts, hooks, or templates
PHP
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
README.md
insert.php
readme.txt

README.md

insert

WP plugin to 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"]

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');

Fund

Fund development @ryanve =)

License

MIT