{"id":114730,"date":"2019-12-12T10:24:07","date_gmt":"2019-12-12T10:24:07","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/the-insertr\/"},"modified":"2026-03-05T17:38:07","modified_gmt":"2026-03-05T17:38:07","slug":"the-insertr","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/the-insertr\/","author":17785326,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.6.0","stable_tag":"1.6.0","tested":"6.8.5","requires":"6.3","requires_php":"8.2.0","requires_plugins":null,"header_name":"The Insertr","header_author":"Herdl","header_description":"Wordpress dynamic keyword insertion plugin.","assets_banners_color":"665f33","last_updated":"2026-03-05 17:38:07","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/herdl.com\/","header_plugin_uri":"https:\/\/github.com\/herdl\/the-insertr","header_author_uri":"https:\/\/herdl.com","rating":5,"author_block_rating":0,"active_installs":20,"downloads":1522,"num_ratings":2,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.4.0":{"tag":"1.4.0","author":"b3none","date":"2020-01-24 14:37:39"},"1.4.1":{"tag":"1.4.1","author":"garethmorgans","date":"2021-03-18 22:18:04"},"1.5.1":{"tag":"1.5.1","author":"garethmorgans","date":"2025-09-19 16:03:32"},"1.6.0":{"tag":"1.6.0","author":"garethmorgans","date":"2026-03-05 17:38:07"}},"upgrade_notice":{"":"<p>There are currently no upgrade notices for this project.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"2"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2210871,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2210871,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":2211464,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":2211464,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.4.0","1.4.1","1.5.1","1.6.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"There are no screenshots available for this project."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2533,321,197480,197479,2208],"plugin_category":[57],"plugin_contributors":[179643,197476],"plugin_business_model":[],"class_list":["post-114730","plugin","type-plugin","status-publish","hentry","plugin_tags-ad-manager","plugin_tags-ads","plugin_tags-dynamic-insertion","plugin_tags-dynamic-keyword-insertion","plugin_tags-keyword","plugin_category-taxonomy","plugin_contributors-b3none","plugin_contributors-garethmorgans","plugin_committers-b3none","plugin_committers-garethmorgans"],"banners":{"banner":"https:\/\/ps.w.org\/the-insertr\/assets\/banner-772x250.png?rev=2211464","banner_2x":"https:\/\/ps.w.org\/the-insertr\/assets\/banner-1544x500.png?rev=2211464","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/the-insertr\/assets\/icon-128x128.png?rev=2210871","icon_2x":"https:\/\/ps.w.org\/the-insertr\/assets\/icon-256x256.png?rev=2210871","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>The Insertr allows marketers and site owners to dynamically insert words and phrases into landing pages. Control your parameters using a shortcode and simple query string in the page URL.<\/p>\n\n<p>A fallback can be entered for cases where the URL does not contain the expected query string. Options are available for uppercase, lowercase and title case text.<\/p>\n\n<p>Works with the block editor (Gutenberg), classic editor, and ACF shortcode fields. Use the Insertr block in Gutenberg or the [insertr] shortcode anywhere shortcodes are processed.<\/p>\n\n<h3>Usage<\/h3>\n\n<p><strong>Block editor (Gutenberg):<\/strong> Add the \"Insertr\" block from the block inserter (Text category). Set the URL parameter (key), fallback text, and case in the block sidebar.<\/p>\n\n<p><strong>Shortcode:<\/strong> Add the following shortcode where you wish to insert a dynamic word or phrase (classic editor, Shortcode block, or ACF shortcode fields):<\/p>\n\n<p>[insertr key=\"{urlParameter}\" fallback=\"{fallbackWord}\"]<\/p>\n\n<p>In the shortcode, the \"key\" option contains the URL parameter you\u2019d like to use.<\/p>\n\n<p>The \"fallback\" option contains the fallback word to be displayed if the URL does not contain a query string using the URL parameter you\u2019ve defined.<\/p>\n\n<p>For example:<\/p>\n\n<p>We\u2019ll set the URL parameter to be \"keyword\" which we\u2019ll assign a value for in the URL. Our fallback word will be \"PPC Agency\" if the correct query string isn\u2019t used.<\/p>\n\n<p>[insertr key=\"keyword\" fallback=\"PPC Agency\"]<\/p>\n\n<p>Our link for the page will use a query string with the parameter set above, \"keyword\", and the value we\u2019d like to use - in this case we want to dynamically insert \"digital agency\".<\/p>\n\n<p>herdl.com?keyword=digital%20agency<\/p>\n\n<p>When this URL is used to visit our landing page, all instances of the shortcode will display \"digital agency\". If the query string is not used, all instances of the shortcode will display \"ppc agency\".<\/p>\n\n<p>For reference, \"%20\" is the URL encoded value for a space.<\/p>\n\n<h3>Advanced Usage<\/h3>\n\n<p>You can use multiple shortcodes on the page to dynamically insert different words and phrases. This will require you to use multiple query parameters that are separated by an ampersand, \"&amp;\", as shown below.<\/p>\n\n<p>For example:<\/p>\n\n<p>[insertr key=\"keyword\" fallback=\"PPC Agency\"]<\/p>\n\n<p>[insertr key=\"other\" fallback=\"PPC Management\"]<\/p>\n\n<p>herdl.com?keyword=digital%20agency&amp;other=digital%20experts<\/p>\n\n<p>In the example above, the first shortcode will display \"digital agency\" and the second shortcode will display \"digital experts\".<\/p>\n\n<p>You can also set the letter case using an additional option in the shortcode for uppercase, lowercase and title case. This will determine the letter case of the dynamically inserted words and also the fallback words.<\/p>\n\n<p>For example:<\/p>\n\n<p>[insertr key=\"keyword\" fallback=\"PPC Agency\" case=\"upper\"]<\/p>\n\n<p>herdl.com?keyword=digital%20agency<\/p>\n\n<p>This would display the inserted words in uppercase:\n\"DIGITAL AGENCY\"<\/p>\n\n<p>[insertr key=\"keyword\" fallback=\"PPC Agency\" case=\"lower\"]<\/p>\n\n<p>herdl.com?keyword=digital%20agency<\/p>\n\n<p>This would display the inserted words in lowercase:\n\"digital agency\"<\/p>\n\n<p>[insertr key=\"keyword\" fallback=\"PPC Agency\" case=\"title\"]<\/p>\n\n<p>herdl.com?keyword=digital%20agency<\/p>\n\n<p>This would display the inserted words in title case:<\/p>\n\n<p>\"Digital Agency\"<\/p>\n\n<!--section=installation-->\n<p>You can download the latest release as a <code>.zip<\/code> then head over to your site to install this manually.<\/p>\n\n<p>Once this plugin has been approved on the WordPress marketplace we will update the repository with a link.<\/p>\n\n<!--section=faq-->\n<p>There are currently no frequently asked questions for this project.<\/p>\n\n<!--section=changelog-->\n<h4>1.6.0<\/h4>\n\n<ul>\n<li>Added: Gutenberg (Insertr) block for the block editor.<\/li>\n<li>Added: Frontend-safe plugin detection for ACF and SEO integrations.<\/li>\n<li>Changed: Plugin now works correctly when used on the frontend (shortcode and block).<\/li>\n<li>Compatibility: Shortcode and ACF support unchanged; block is additive for WordPress 5.0+.<\/li>\n<\/ul>\n\n<h4>1.5.2 - 2025-09-22<\/h4>\n\n<ul>\n<li>Changed: Updated plugin docs<\/li>\n<\/ul>\n\n<h4>1.5.1 - 2025-09-01<\/h4>\n\n<ul>\n<li>Changed: Ensured compatibility checks for both free and pro versions of ACF and SEO plugins.<\/li>\n<li>Changed: Removed nonce implementation as it was not needed.<\/li>\n<li>Changed: Updated plugin documentation.<\/li>\n<li>Changed: Organised code for better readability and maintainability.<\/li>\n<\/ul>\n\n<h4>1.5.0 - 2025-08-29<\/h4>\n\n<ul>\n<li>Added: Enhanced security by validating and sanitising all user inputs.<\/li>\n<li>Added: Implemented robust error handling and logging mechanisms.<\/li>\n<li>Changed: Refactored code for improved readability and maintainability.<\/li>\n<li>Added: Ensured compatibility with ACF.<\/li>\n<li>Added: Support for shortcodes in SEO plugins like Yoast, Rank Math, AIOSEO, and SEOPress.<\/li>\n<li>Changed: Updated documentation.<\/li>\n<\/ul>\n\n<h4>1.4.0 - 2020-01-23<\/h4>\n\n<ul>\n<li>Added ability to specify fallback case with a default of lowercase.<\/li>\n<\/ul>\n\n<h4>1.3.0 - 2019-12-19<\/h4>\n\n<ul>\n<li>Added ability to use shortcodes on ACF and Yoast SEO.<\/li>\n<\/ul>\n\n<h4>1.2.0 - 2019-12-13<\/h4>\n\n<ul>\n<li>Removed redundant comments.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Use the correct WordPress escaping and sanitisation functions.<\/li>\n<\/ul>\n\n<h4>1.0.0 - 2019-12-09<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"WordPress dynamic keyword insertion plugin.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/114730","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=114730"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/garethmorgans"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=114730"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=114730"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=114730"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=114730"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=114730"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=114730"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}