WordPress.org
Get WordPress

Plugin Directory

Changeset 2499019


Ignore:
Timestamp:
03/18/2021 10:15:55 PM (5 years ago)
Author:
garethmorgans
Message:

update readme

Location:
the-insertr
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • the-insertr/tags/1.4.1/readme.txt

    r2232829 r2499019  
    11=== The Insertr ===
    2 Contributors: b3none
     2Contributors: b3none, garethmorgans
    33Donate link: https://herdl.com/
    4 Tags: keyword, ppc, dynamic keyword inserter, herdl
     4Tags: keyword, dynamic keyword insertion, dynamic insertion, ads, ad manager, google ads, keyword insertion, DKI, PPC, SEO
    55Requires at least: 2.9
    6 Tested up to: 5.2
    7 Stable tag: 5.2
     6Tested up to: 5.7
     7Stable tag: 5.7
    88Requires PHP: 7.0.0
    99License: MIT
    1010License URI: https://github.com/herdl/the-insertr/blob/master/LICENSE.md
    1111
    12 Wordpress dynamic keyword insertion plugin.
     12WordPress dynamic keyword insertion plugin.
    1313
    1414== Description ==
    1515
    16 The Herdl dynamic keyword insertion plugin, The Insertr, dynamically inserts a keyword onto your page using a simple URL query string to determine the keyword and a shortcode for placement.
     16The 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.
    1717
    18 The placement of the word or phrase is determined by the location of the short code. In the case where a word is not specified a fallback Keyword or phrase is placed instead.
     18A 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.
     19
     20Shortcode 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.
    1921
    2022== Installation ==
    … …  
    2628== Usage ==
    2729
    28 Short code to be used: [insertr key=”{desiredword}” fallback=”{fallback}”] where ‘desiredword’ is the word to be placed, and ‘fallback’ is the word to appear if no keyword is specified.
     30Add the following shortcode where you wish to insert a dynamic word or phrase:
    2931
    30 For the Keyword to be placed on your page, you must also add the following parameter to your URL: ?keyword={example} Where ‘example’ is the word you want to placed.
     32[insertr key=”{urlParameter}” fallback=”{fallbackWord}”]
    3133
    32 If your URL already has parameters (E.g – there is already a ? in the URL) add &keyword={keyword} to the end of the string.
     34In the shortcode, the “key” option contains the URL parameter you’d like to use.
     35
     36The “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.
     37
     38For example:
     39
     40We’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.
     41
     42[insertr key=”keyword” fallback=”PPC Agency”]
     43
     44Our 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”.
     45
     46herdl.com?keyword=digital%20agency
     47
     48When 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”.
     49
     50For reference, “%20” is the URL encoded value for a space.
     51
     52== Usage ==
     53
     54You 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.
     55
     56For example:
     57
     58[insertr key=”keyword” fallback=”PPC Agency”]
     59
     60[insertr key=”other” fallback=”PPC Management”]
     61
     62herdl.com?keyword=digital%20agency&other=digital%20experts
     63
     64In the example above, the first shortcode will display “digital agency” and the second shortcode will display “digital experts”.
     65
     66You 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.
     67
     68For example:
     69
     70[insertr key=”keyword” fallback=”PPC Agency” case=”upper”]
     71
     72herdl.com?keyword=digital%20agency
     73
     74This would display the inserted words in uppercase:
     75“DIGITAL AGENCY”
     76
     77[insertr key=”keyword” fallback=”PPC Agency” case=”lower”]
     78
     79herdl.com?keyword=digital%20agency
     80
     81This would display the inserted words in lowercase:
     82“digital agency”
     83
     84[insertr key=”keyword” fallback=”PPC Agency” case=”title”]
     85
     86herdl.com?keyword=digital%20agency
     87
     88This would display the inserted words in title case:
     89
     90“Digital Agency”
    3391
    3492== Frequently Asked Questions ==
    … …  
    47105
    48106= 1.2.0 =
    49 * Add ability to use short codes on ACF and YoastSEO
     107* Add ability to use shortcodes on ACF and Yoast SEO
    50108
    51109= 1.1.0 =

  • the-insertr/trunk/readme.txt

    r2211672 r2499019  
    11=== The Insertr ===
    2 Contributors: b3none
     2Contributors: b3none, garethmorgans
    33Donate link: https://herdl.com/
    4 Tags: keyword, ppc, dynamic keyword inserter, herdl
     4Tags: keyword, dynamic keyword insertion, dynamic insertion, ads, ad manager, google ads, keyword insertion, DKI, PPC, SEO
    55Requires at least: 2.9
    6 Tested up to: 5.2
    7 Stable tag: 5.2
     6Tested up to: 5.7
     7Stable tag: 5.7
    88Requires PHP: 7.0.0
    99License: MIT
    1010License URI: https://github.com/herdl/the-insertr/blob/master/LICENSE.md
    1111
    12 Wordpress dynamic keyword insertion plugin.
     12WordPress dynamic keyword insertion plugin.
    1313
    1414== Description ==
    1515
    16 The Herdl dynamic keyword insertion plugin, The Insertr, dynamically inserts a keyword onto your page using a simple URL query string to determine the keyword and a shortcode for placement.
     16The 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.
    1717
    18 The placement of the word or phrase is determined by the location of the short code. In the case where a word is not specified a fallback Keyword or phrase is placed instead.
     18A 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.
     19
     20Shortcode 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.
    1921
    2022== Installation ==
    … …  
    2628== Usage ==
    2729
    28 Short code to be used: [insertr key=”{desiredword}” fallback=”{fallback}”] where ‘desiredword’ is the word to be placed, and ‘fallback’ is the word to appear if no keyword is specified.
     30Add the following shortcode where you wish to insert a dynamic word or phrase:
    2931
    30 For the Keyword to be placed on your page, you must also add the following parameter to your URL: ?keyword={example} Where ‘example’ is the word you want to placed.
     32[insertr key=”{urlParameter}” fallback=”{fallbackWord}”]
    3133
    32 If your URL already has parameters (E.g – there is already a ? in the URL) add &keyword={keyword} to the end of the string.
     34In the shortcode, the “key” option contains the URL parameter you’d like to use.
     35
     36The “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.
     37
     38For example:
     39
     40We’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.
     41
     42[insertr key=”keyword” fallback=”PPC Agency”]
     43
     44Our 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”.
     45
     46herdl.com?keyword=digital%20agency
     47
     48When 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”.
     49
     50For reference, “%20” is the URL encoded value for a space.
     51
     52== Usage ==
     53
     54You 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.
     55
     56For example:
     57
     58[insertr key=”keyword” fallback=”PPC Agency”]
     59
     60[insertr key=”other” fallback=”PPC Management”]
     61
     62herdl.com?keyword=digital%20agency&other=digital%20experts
     63
     64In the example above, the first shortcode will display “digital agency” and the second shortcode will display “digital experts”.
     65
     66You 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.
     67
     68For example:
     69
     70[insertr key=”keyword” fallback=”PPC Agency” case=”upper”]
     71
     72herdl.com?keyword=digital%20agency
     73
     74This would display the inserted words in uppercase:
     75“DIGITAL AGENCY”
     76
     77[insertr key=”keyword” fallback=”PPC Agency” case=”lower”]
     78
     79herdl.com?keyword=digital%20agency
     80
     81This would display the inserted words in lowercase:
     82“digital agency”
     83
     84[insertr key=”keyword” fallback=”PPC Agency” case=”title”]
     85
     86herdl.com?keyword=digital%20agency
     87
     88This would display the inserted words in title case:
     89
     90“Digital Agency”
    3391
    3492== Frequently Asked Questions ==
    … …  
    47105
    48106= 1.2.0 =
    49 * Add ability to use short codes on ACF and YoastSEO
     107* Add ability to use shortcodes on ACF and Yoast SEO
    50108
    51109= 1.1.0 =
Note: See TracChangeset for help on using the changeset viewer.