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

Paul Ryan

the_elusive

<p>Insert Pages lets you embed any WordPress content (e.g., pages, posts, custom post types) into other WordPress content using the Shortcode API. It also includes a widget for inserting pages into any widget area.</p>
<p>The real power of Insert Pages comes when you start creating custom post types, either <a href="https://codex.wordpress.org/Post_Types" rel="nofollow ugc">programmatically in your theme</a>, or using another plugin like <a href="https://wordpress.org/plugins/custom-post-type-ui/" rel="ugc">Custom Post Type UI</a>. You can then abstract away common data types (like videos, quizzes, due dates) into their own custom post types, and then show those pieces of content within your normal pages and posts by Inserting them as a shortcode.</p>
<h3>Advanced Tutorial</h3>
<p>Contributor Wes Modes has graciously written an updated tutorial for the Gutenberg era, focused on creating a custom post type with custom fields and a custom template for rendering content. Read it here: <a href="https://medium.com/@wesmodes/using-wordpress-insert-pages-plugin-with-your-custom-post-types-and-custom-templates-535c141f9635" rel="nofollow ugc">https://medium.com/@wesmodes/using-wordpress-insert-pages-plugin-with-your-custom-post-types-and-custom-templates-535c141f9635</a></p>
<h3>Example: Normal Use Case</h3>
<p>Say you teach a course and you’re constantly referring to an assignment due date in your course website. The next semester the due date changes, and you have to go change all of the locations you referred to it. Instead, you’d rather just change the date once! With Insert Pages, you can do the following:</p>
<ol>
<li>Create a custom post type called <strong>Due Date</strong>.</li>
<li>Create a new <em>Due Date</em> called <strong>Assignment 1 Due Date</strong> with <strong>Fri Nov 22, 2013</strong> as its content.</li>
<li>Edit all the pages where the due date occurs and use the <em>Insert Pages</em> toolbar button to insert a reference to the <em>Due Date</em> you just created. Be sure to set the <em>Display</em> to <strong>Content</strong> so <em>Fri Nov 22, 2013</em> shows wherever you insert it. The shortcode you just created should look something like this: <code>[insert page='assignment-1-due-date' display='content']</code></li>
<li>That’s it! Now, when you want to change the due date, just edit the <em>Assignment 1 Due Date</em> custom post you created, and it will automatically be updated on all the pages you inserted it on.</li>
</ol>
<h3>Example: Advanced Use Case</h3>
<p>Say your site has a lot of video content, and you want to include video transcripts and video lengths along with the videos wherever you show them. You could just paste the transcripts into the page content under the video, but then you’d have to do this on every page the video showed on. (It’s also just a bad idea, architecturally!) With Insert Pages, you can use a custom post type and create a custom theme template to display your videos+transcripts+lengths just the way you want!</p>
<ol>
<li>Create a custom post type called <strong>Video</strong>.</li>
<li>Use a plugin like <a href="https://wordpress.org/plugins/advanced-custom-fields/" rel="ugc">Advanced Custom Fields</a> to add extra fields to your new <em>Video</em> custom post type. Add a <strong>Video URL</strong> field, a <strong>Transcript</strong> field, and a <strong>Video Length</strong> field.</li>
<li>Create a new <em>Video</em> called <strong>My Awesome Video</strong> with the following values in its fields:
<ul>
<li><em>Video URL</em>: <strong>http://www.youtube.com/watch?v=oHg5SJYRHA0</strong></li>
<li><em>Transcript</em>: <strong>We’re no strangers to love, You know the rules and so do I…</strong></li>
<li><em>Video Length</em>: <strong>3:34</strong></li>
</ul>
</li>
<li>Create a template in your theme so we can display the video content as we want. I won’t cover this step here since it’s pretty involved, but you can find more help in the <a href="https://codex.wordpress.org/Theme_Development#Custom_Page_Templates" rel="nofollow ugc">WordPress Codex</a>. Let’s assume you created a template called <strong>Video with transcript</strong> (video-with-transcript.php) that shows the youtube video in a <a href="http://fancybox.net/" rel="nofollow ugc">fancybox</a>, and includes a button that shows the text transcript when a user clicks on it.</li>
<li>Edit the pages where you want the video to show up and use the <em>Insert Pages</em> toolbar button to insert a reference to the <em>Video</em> you just created. Be sure to set the <em>Display</em> to <strong>Use a custom template</strong>, and select your new template <strong>Video with transcript</strong>. The shortcode you just created should look something like this: <code>[insert page='my-awesome-video' display='video-with-transcript.php']</code></li>
<li>That’s it! Now you can create all sorts of video content and know that it’s being tracked cleanly in the database as its own custom post type, and you can place videos all over your site and not worry about lots of duplicate content.</li>
</ol>
<p>The possibilities are endless!</p>


Insert Pages

I love these kind of single purpose plugins just solving a specific issue. Great plugin, works as intended.

Perfect

Insert Pages lets you embed any WordPress content (e.g., pages, posts, custom post types) into other WordPress content using the Shortcode API.

insert vs Insert Pages