About this plugin
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.
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.
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.
Usage
Block editor (Gutenberg): Add the “Insertr” block from the block inserter (Text category). Set the URL parameter (key), fallback text, and case in the block sidebar.
Shortcode: Add the following shortcode where you wish to insert a dynamic word or phrase (classic editor, Shortcode block, or ACF shortcode fields):
[insertr key=”{urlParameter}” fallback=”{fallbackWord}”]
In the shortcode, the “key” option contains the URL parameter you’d like to use.
The “fallback” option contains the fallback word to be displayed if the URL does not contain a query string using the URL parameter you’ve defined.
For example:
We’ll set the URL parameter to be “keyword” which we’ll assign a value for in the URL. Our fallback word will be “PPC Agency” if the correct query string isn’t used.
[insertr key=”keyword” fallback=”PPC Agency”]
Our link for the page will use a query string with the parameter set above, “keyword”, and the value we’d like to use – in this case we want to dynamically insert “digital agency”.
keyword=digital%20agency
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”.
For reference, “%20” is the URL encoded value for a space.
Advanced Usage
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, “&”, as shown below.
For example:
[insertr key=”keyword” fallback=”PPC Agency”]
[insertr key=”other” fallback=”PPC Management”]
keyword=digital%20agency&other=digital%20experts
In the example above, the first shortcode will display “digital agency” and the second shortcode will display “digital experts”.
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.
For example:
[insertr key=”keyword” fallback=”PPC Agency” case=”upper”]
keyword=digital%20agency
This would display the inserted words in uppercase:
“DIGITAL AGENCY”
[insertr key=”keyword” fallback=”PPC Agency” case=”lower”]
keyword=digital%20agency
This would display the inserted words in lowercase:
“digital agency”
[insertr key=”keyword” fallback=”PPC Agency” case=”title”]
keyword=digital%20agency
This would display the inserted words in title case:
“Digital Agency”