{"id":27518,"date":"2014-01-30T19:43:58","date_gmt":"2014-01-30T19:43:58","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/insert\/"},"modified":"2014-01-30T19:43:58","modified_gmt":"2014-01-30T19:43:58","slug":"insert","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/insert\/","author":3371790,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"0.1.0","stable_tag":"trunk","tested":"3.8.0","requires":"2.7.0","requires_php":"","requires_plugins":"","header_name":"Insert","header_author":"Ryan Van Etten","header_description":"","assets_banners_color":"","last_updated":"2014-01-30 19:43:58","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/gittip.com\/ryanve","header_plugin_uri":"http:\/\/github.com\/ryanve\/insert","header_author_uri":"http:\/\/ryanve.com","rating":0,"author_block_rating":0,"active_installs":10,"downloads":1882,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2628,80],"plugin_category":[43],"plugin_contributors":[81584],"plugin_business_model":[],"class_list":["post-27518","plugin","type-plugin","status-publish","hentry","plugin_tags-insert","plugin_tags-shortcode","plugin_category-customization","plugin_contributors-ryanve","plugin_committers-ryanve"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/insert.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<h3>Usage<\/h3>\n\n<p>Use the <code>[insert]<\/code> shortcode inside posts or anywhere else that processes <a href=\"http:\/\/codex.wordpress.org\/Shortcode_API\">shortcodes<\/a>.<\/p>\n\n<h4><code>[insert]<\/code> shortcode attributes<\/h4>\n\n<ul>\n<li>query - sets up a new <a href=\"http:\/\/codex.wordpress.org\/Class_Reference\/WP_Query\"><code>WP_Query<\/code><\/a> via <a href=\"http:\/\/codex.wordpress.org\/Template_Tags\/get_posts\"><code>get_posts()<\/code><\/a><\/li>\n<li>data - data to pass to actions<\/li>\n<li>action - action to run, runs for each post if applicable<\/li>\n<li>filter - filter to run, runs for each post if applicable<\/li>\n<li>template - template to load via <a href=\"http:\/\/codex.wordpress.org\/Function_Reference\/locate_template\"><code>locate_template()<\/code><\/a><\/li>\n<\/ul>\n\n<p>All attributes are optional and can be used in combination to yield powerful abilities.<\/p>\n\n<h3>Abilities<\/h3>\n\n<p>Possibilities with <code>[insert]<\/code> are endless. Practical uses include:<\/p>\n\n<ul>\n<li>Insert posts into posts<\/li>\n<li>Insert hooks into posts<\/li>\n<li>Insert posts into widgets<\/li>\n<li>Run action hooks via widgets<\/li>\n<li>Load templates via widgets<\/li>\n<\/ul>\n\n<h3>Examples<\/h3>\n\n<h4>Insert a template<\/h4>\n\n<pre><code>`\n<\/code><\/pre>\n\n<p>[insert template=\"branding.php\"]\n    `<\/p>\n\n<h4>Insert an action<\/h4>\n\n<pre><code>`\n<\/code><\/pre>\n\n<p>[insert action=\"dostuff\"]\n    `<\/p>\n\n<h4>Pass data to an action<\/h4>\n\n<pre><code>`\n<\/code><\/pre>\n\n<p>[insert data=\"field=slug&amp;value=example&amp;tax=category\" action=\"dostuff\"]\n    `<\/p>\n\n<p>The action receives data as an array.<\/p>\n\n<pre><code>`\n<\/code><\/pre>\n\n<p>add_action('dostuff', 'print_r');\n    `<\/p>\n\n<h4>Insert a page via template<\/h4>\n\n<pre><code>`\n<\/code><\/pre>\n\n<p>[insert query=\"name=about&amp;post_type=page\" template=\"entry.php\"]\n    `<\/p>\n\n<h4>Insert a page via action<\/h4>\n\n<p>This sets up the query and triggers the action.<\/p>\n\n<pre><code>`\n<\/code><\/pre>\n\n<p>[insert query=\"name=about&amp;post_type=page\" action=\"dostuff\"]\n    `<\/p>\n\n<p>WP template tags are available inside the action.<\/p>\n\n<pre><code>`\n<\/code><\/pre>\n\n<p>add_action('dostuff', 'the_title');\n    `<\/p>\n\n<h3>Github<\/h3>\n\n<ul>\n<li><a href=\"https:\/\/github.com\/ryanve\/insert\">github.com\/ryanve\/insert<\/a><\/li>\n<\/ul>\n\n<!--section=installation-->\n<p>Requires: PHP 5.3+<\/p>\n\n<ol>\n<li>Upload to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate through the Plugins menu in WordPress<\/li>\n<\/ol>","raw_excerpt":"Insert posts, hooks, or templates.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/27518","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=27518"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ryanve"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=27518"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=27518"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=27518"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=27518"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=27518"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=27518"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}