ryanve

<h3>Usage</h3>
<p>Use the <code>[insert]</code> shortcode inside posts or anywhere else that processes <a href="https://codex.wordpress.org/Shortcode_API" rel="nofollow ugc">shortcodes</a>.</p>
<h4><code>[insert]</code> shortcode attributes</h4>
<ul>
<li>query – sets up a new <a href="https://codex.wordpress.org/Class_Reference/WP_Query" rel="nofollow ugc"><code>WP_Query</code></a> via <a href="https://codex.wordpress.org/Template_Tags/get_posts" rel="nofollow ugc"><code>get_posts()</code></a></li>
<li>data – data to pass to actions</li>
<li>action – action to run, runs for each post if applicable</li>
<li>filter – filter to run, runs for each post if applicable</li>
<li>template – template to load via <a href="https://codex.wordpress.org/Function_Reference/locate_template" rel="nofollow ugc"><code>locate_template()</code></a></li>
</ul>
<p>All attributes are optional and can be used in combination to yield powerful abilities.</p>
<h3>Abilities</h3>
<p>Possibilities with <code>[insert]</code> are endless. Practical uses include:</p>
<ul>
<li>Insert posts into posts</li>
<li>Insert hooks into posts</li>
<li>Insert posts into widgets</li>
<li>Run action hooks via widgets</li>
<li>Load templates via widgets</li>
</ul>
<h3>Examples</h3>
<h4>Insert a template</h4>
<pre><code>`
</code></pre>
<p>[insert template=”branding.php”]<br />
    `</p>
<h4>Insert an action</h4>
<pre><code>`
</code></pre>
<p>[insert action=”dostuff”]<br />
    `</p>
<h4>Pass data to an action</h4>
<pre><code>`
</code></pre>
<p>[insert data=”field=slug&value=example&tax=category” action=”dostuff”]<br />
    `</p>
<p>The action receives data as an array.</p>
<pre><code>`
</code></pre>
<p>add_action(‘dostuff’, ‘print_r’);<br />
    `</p>
<h4>Insert a page via template</h4>
<pre><code>`
</code></pre>
<p>[insert query=”name=about&post_type=page” template=”entry.php”]<br />
    `</p>
<h4>Insert a page via action</h4>
<p>This sets up the query and triggers the action.</p>
<pre><code>`
</code></pre>
<p>[insert query=”name=about&post_type=page” action=”dostuff”]<br />
    `</p>
<p>WP template tags are available inside the action.</p>
<pre><code>`
</code></pre>
<p>add_action(‘dostuff’, ‘the_title’);<br />
    `</p>
<h3>Github</h3>
<ul>
<li><a href="https://github.com/ryanve/insert" rel="nofollow ugc">github.com/ryanve/insert</a></li>
</ul>


insert vs Embeds for YouTube