The Insertr

Description

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.

Shortcode not working? We’ve also created a plugin called “Shortcode Enablr” to enable shortcodes in common places that WordPress doesn’t display them by default – including ACF fields and YoastSEO titles.

Usage

Add the following shortcode where you wish to insert a dynamic word or phrase:

[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”.

herdl.com?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”]

herdl.com?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”]

herdl.com?keyword=digital%20agency

This would display the inserted words in uppercase:
“DIGITAL AGENCY”

[insertr key=”keyword” fallback=”PPC Agency” case=”lower”]

herdl.com?keyword=digital%20agency

This would display the inserted words in lowercase:
“digital agency”

[insertr key=”keyword” fallback=”PPC Agency” case=”title”]

herdl.com?keyword=digital%20agency

This would display the inserted words in title case:

“Digital Agency”

Installation

You can download the latest release as a .zip then head over to your site to install this manually.

Once this plugin has been approved on the WordPress marketplace we will update the repository with a link.

FAQ

There are currently no frequently asked questions for this project.

Reviews

December 12, 2019
Highly recommended, and well-built plugin. A must for any Google Ads manager!
Read all 2 reviews

Contributors & Developers

“The Insertr” is open source software. The following people have contributed to this plugin.

Contributors

Translate “The Insertr” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.2.0

  • Add ability to use shortcodes on ACF and Yoast SEO

1.1.0

  • Use the correct WordPress escaping and sanitisation functions.

1.0.0

  • Initial release.