Overview
Your defined Keywords can be used in any editable text field or Page Builder on a Content Group or Term Group.
When generating content, Page Generator Pro will replace these keywords with actual terms specified in the keywords. For example, if our {service} keyword comprises of Web Design and Web Development, the Plugin would generate at least two Pages:
- Web Design in…
- Web Development in…
Depending on the field you’re editing, and the editor experience you’re using, you can add keywords to your content in a number of ways:
Insert Keyword Dropdown
The Insert Keyword dropdown option is displayed on some fields in the Classic Editor, such as the Title and Excerpt:
Autocomplete
For most fields, you can start typing in a field. A list of matching keywords will be displayed.
Continue to type until you see the keyword you want to insert, and click the keyword.
For example, to add a defined Keyword called service, we can start typing ser, and then click the resulting keyword in the list:
To hide or cancel autocompletion, either press the escape key, or click outside of the list of suggested keywords.
Gutenberg Title
You’ll need to manually add the Keyword. For example, a defined Keyword called service would be added by entering {service}
Gutenberg Blocks
Start typing in any block by entering {, and a list of matching keywords will be displayed. Continue to type until you see the keyword you want to insert, and click the keyword.
For example, to add a defined Keyword called service, we can start typing {ser, and then click the resulting keyword in the list:
To hide or cancel autocompletion, either press the escape key, or click outside of the list of suggested keywords.
Classic / Visual / TinyMCE Editor
Start typing in any TinyMCE Editor instance by entering {, and a list of matching keywords will be displayed. Continue to type until you see the keyword you want to insert, and click the keyword.
For example, to add a defined Keyword called service, we can start typing {ser, and then click the resulting keyword in the list:
To hide or cancel autocompletion, either press the escape key, or click outside of the list of suggested keywords.
Transforming Keywords
Assuming you have the following example Keyword configured:
Setting | Value |
---|---|
Keyword | location |
Terms | Birmingham, West Midlands Harborne, West Midlands Selly Oak, West Midlands |
Delimiter | , |
Columns | city, county |
The output of keyword terms can be transformed, by using a flag after the keyword. In the above example, this means that we could use the following keywords in our Content Group:
Transformation | Syntax | Output |
---|---|---|
Uppercase | {location:uppercase_all} | BIRMINGHAM, WEST MIDLANDS |
Lowercase | {location:lowercase_all} | birmingham, west midlands |
Capitalise first letter | {location:uppercase_first_character} | Birmingham, west midlands |
Capitalise first letter of each word | {location:uppercase_first_character_words} | Birmingham, West Midlands |
First word | {location:first_word} | Birmingham |
Last word | {location:last_word} | Midlands |
Convert to Permalink style slug | {location:url} | birmingham-west-midlands |
Convert to Permalink style slug, underscores | {location:url_underscore} | birmingham_west_midlands |
Apply Multiple Keyword Transformations
Up to 2 keyword transformations can be applied to a keyword.
Transformations are applied in the order they are written, from left to right. Taking the below example, where the URL transformation will lowercase the string:
Transformation | Syntax | Output |
---|---|---|
Uppercase and Convert to Permalink style slug | {location:uppercase_all:url} | birmingham-west-midlands |
Convert to Permalink style slug and Uppercase | {location:url:uppercase_all} | BIRMINGHAM-WEST-MIDLANDS |
Extracting Term Subsets (Columns)
We can output a subset of each Term’s data by using the keyword’s defined columns. In the above example, this means that we could use the following keywords in our Content Group:
Keyword | Example Value |
---|---|
{location(city)} | Birmingham |
{location(county)} | West Midlands |
Keyword Transformations can also be applied to Keyword Columns. Taking {location(city)} as an example:
Transformation | Syntax | Output |
---|---|---|
Uppercase | {location(city):uppercase_all} | BIRMINGHAM |
Lowercase | {location(city):lowercase_all} | birmingham |
Capitalise first letter | {location(city):uppercase_first_character} | Birmingham |
Capitalise first letter of each word | {location(city):uppercase_first_character_words} | Birmingham |
Convert to Permalink style slug | {location(city):url} | birmingham |
Force Keyword Term
The output of the keyword can be forced to always output a specific term. In the above example, this means that we could use the following keywords in our Content Group:
Transformation | Syntax | Output |
---|---|---|
Force Specific Term | {location:3} | Selly Oak, West Midlands |
Force Specific Term, City Column | {location(city):3} | Selly Oak |
Output All Terms
The output of the keyword can be forced to always output all terms, in a comma separated list. In the above example, this means that we could use the following keywords in our Content Group:
Transformation | Syntax | Output |
---|---|---|
Output All Terms | {location:all} | Birmingham, West Midlands, Harborne, West Midlands, Selly Oak, West Midlands |
Output All Terms, City Column | {location(city):all} | Birmingham, Harborne, Selly Oak |
Output Same Random Term
The output of the keyword can be set to output the same term, chosen at random. In the above example, this means that we could use the following keywords in our Content Group:
Transformation | Syntax | Output |
---|---|---|
Output Random Term | {location:random} | Selly Oak, West Midlands |
Output Random Term, City Column | {location(city):random} | Birmingham |
Output Different Random Term
The output of the keyword can be set to output a different term, chosen at random for each occurrence of the Keyword. In the above example, this means that we could use the following keywords in our Content Group:
Transformation | Syntax | Output |
---|---|---|
Output Random Term | {location:random_different} | Selly Oak, West Midlands |
Output Random Term, City Column | {location(city):random_different} | Birmingham |
Combining Column Names, Transformations and Forcing Term
Any combination of the above Using Keywords sections can be used. For example:
Transformation | Syntax | Output |
---|---|---|
Output City Name, Uppercase | {location(city):uppercase_all} | BIRMINGHAM |
Output 3rd City Name, Lowercase | {location(city):3:lowercase_all} | selly oak |
Using Taxonomy Keywords in Groups
Any Taxonomy can also be used as a Keyword, by inserting the {taxonomy_name} tag into your content (where name is replaced by the name of your Taxonomy). For example, if you have Categories defined on your WordPress web site (typically found at Posts > Categories), you’d use :
You can insert Taxonomy Keywords manually into any content-based text field, even if the Insert Keyword dropdown isn’t present. For example:
- Title
- Permalink
- Content
- Excerpt
- Custom Fields
- Meta Key
- Meta Value