Title: The Insertr
Author: garethmorgans
Published: <strong>2019 年 12 月 12 日</strong>
Last modified: 2026 年 3 月 5 日

---

搜尋外掛

![](https://ps.w.org/the-insertr/assets/banner-772x250.png?rev=2211464)

![](https://ps.w.org/the-insertr/assets/icon-256x256.png?rev=2210871)

# The Insertr

 由 [garethmorgans](https://profiles.wordpress.org/garethmorgans/) 開發

[下載](https://downloads.wordpress.org/plugin/the-insertr.1.6.0.zip)

 * [詳細資料](https://tw.wordpress.org/plugins/the-insertr/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/the-insertr/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/the-insertr/#installation)
 * [開發資訊](https://tw.wordpress.org/plugins/the-insertr/#developers)

 [技術支援](https://wordpress.org/support/plugin/the-insertr/)

## 外掛說明

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

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”

## 安裝方式

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.

## 常見問題集

There are currently no frequently asked questions for this project.

## 使用者評論

![](https://secure.gravatar.com/avatar/14eca0efbbced170321e24b4aa19e62f620e5b9b85e5c7eb03aa27c3fed4ae1c?
s=60&d=retro&r=g)

### 󠀁[Great for Dynamic Ads](https://wordpress.org/support/topic/great-for-dynamic-ads/)󠁿

 [garethmorgans](https://profiles.wordpress.org/garethmorgans/) 2020 年 2 月 6 日

Using this on sites where I am running PPC campaigns to improve landing page experience

![](https://secure.gravatar.com/avatar/81fd927937835614bee3f2cda42e1b61c659986e75114d14b242c8945cf1aa63?
s=60&d=retro&r=g)

### 󠀁[Amazing Plugin!](https://wordpress.org/support/topic/amazing-plugin-1340/)󠁿

 [matmoses](https://profiles.wordpress.org/matmoses/) 2019 年 12 月 12 日

Highly recommended, and well-built plugin. A must for any Google Ads manager!

 [ 閱讀全部 2 則使用者評論 ](https://wordpress.org/support/plugin/the-insertr/reviews/)

## 參與者及開發者

以下人員參與了開源軟體〈The Insertr〉的開發相關工作。

參與者

 *   [ garethmorgans ](https://profiles.wordpress.org/garethmorgans/)
 *   [ Alex Blackham ](https://profiles.wordpress.org/b3none/)

[將〈The Insertr〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/the-insertr)

### 對開發相關資訊感興趣？

任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/the-insertr/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/the-insertr/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/the-insertr/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/the-insertr/)。

## 變更記錄

#### 1.6.0

 * Added: Gutenberg (Insertr) block for the block editor.
 * Added: Frontend-safe plugin detection for ACF and SEO integrations.
 * Changed: Plugin now works correctly when used on the frontend (shortcode and 
   block).
 * Compatibility: Shortcode and ACF support unchanged; block is additive for WordPress
   5.0+.

#### 1.5.2 – 2025-09-22

 * Changed: Updated plugin docs

#### 1.5.1 – 2025-09-01

 * Changed: Ensured compatibility checks for both free and pro versions of ACF and
   SEO plugins.
 * Changed: Removed nonce implementation as it was not needed.
 * Changed: Updated plugin documentation.
 * Changed: Organised code for better readability and maintainability.

#### 1.5.0 – 2025-08-29

 * Added: Enhanced security by validating and sanitising all user inputs.
 * Added: Implemented robust error handling and logging mechanisms.
 * Changed: Refactored code for improved readability and maintainability.
 * Added: Ensured compatibility with ACF.
 * Added: Support for shortcodes in SEO plugins like Yoast, Rank Math, AIOSEO, and
   SEOPress.
 * Changed: Updated documentation.

#### 1.4.0 – 2020-01-23

 * Added ability to specify fallback case with a default of lowercase.

#### 1.3.0 – 2019-12-19

 * Added ability to use shortcodes on ACF and Yoast SEO.

#### 1.2.0 – 2019-12-13

 * Removed redundant comments.

#### 1.1.0

 * Use the correct WordPress escaping and sanitisation functions.

#### 1.0.0 – 2019-12-09

 * Initial release.

## 中繼資料

 *  版本 **1.6.0**
 *  最後更新 **2 個月前**
 *  啟用安裝數 **20+**
 *  WordPress 版本需求 ** 6.3 或更新版本 **
 *  已測試相容的 WordPress 版本 **6.8.5**
 *  PHP 版本需求 ** 8.2.0 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/the-insertr/)
 * 標籤:
 * [ad manager](https://tw.wordpress.org/plugins/tags/ad-manager/)[ads](https://tw.wordpress.org/plugins/tags/ads/)
   [keyword](https://tw.wordpress.org/plugins/tags/keyword/)
 *  [進階檢視](https://tw.wordpress.org/plugins/the-insertr/advanced/)

## 評分

 5 星，滿分為 5 星

 *  [  2 個 5 星使用者評論     ](https://wordpress.org/support/plugin/the-insertr/reviews/?filter=5)
 *  [  0 個 4 星使用者評論     ](https://wordpress.org/support/plugin/the-insertr/reviews/?filter=4)
 *  [  0 個 3 星使用者評論     ](https://wordpress.org/support/plugin/the-insertr/reviews/?filter=3)
 *  [  0 個 2 星使用者評論     ](https://wordpress.org/support/plugin/the-insertr/reviews/?filter=2)
 *  [  0 個 1 星使用者評論     ](https://wordpress.org/support/plugin/the-insertr/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/the-insertr/reviews/#new-post)

[查看全部使用者評論](https://wordpress.org/support/plugin/the-insertr/reviews/)

## 參與者

 *   [ garethmorgans ](https://profiles.wordpress.org/garethmorgans/)
 *   [ Alex Blackham ](https://profiles.wordpress.org/b3none/)

## 技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

 [檢視技術支援論壇](https://wordpress.org/support/plugin/the-insertr/)

## 贊助

想要支援這個外掛的發展嗎？

 [ 贊助這個外掛 ](https://herdl.com/)