Keywords

Videos are not designed to be a substitute for instructions. Please refer to the detailed Documentation below.

Overview

Keywords can be seen as template tags, with each Keyword comprising of one or more Terms.

For example, we might have a keyword called service, describing the services that our plumbing business offers.  Its terms could be:

• bathroom installations
• fixing leaks
• central heating installation

There’s no limit to the number of terms a Keyword can have.

Keywords are then used throughout your Content Groups.  A Content Group defines a content template, from which Page Generator Pro will generate your Pages, Posts and/or Custom Post Types.

For each generated Page, Post or Custom Post Type, a different Term within each Keyword will be used.

Don’t worry if this conceptual structure doesn’t make sense immediately; working through the Documentation will join these concepts up, explaining them in more detail.

To access your Keywords, click on the Page Generator Pro menu entry in the WordPress Administration interface, and then click on Keywords.

Add a Keyword

To add a Keyword to Page Generator Pro:

1. Click the Add Keyword button below the Page Generator Pro: Keywords title, which can be found towards the top of the screen:
   
2. The Keywords form will then be displayed, where you can define the following options:
   
   1. Keyword: the unique template tag you’ll use when generating Pages / Posts / Custom Post Types.
      1. The Keyword must be unique from any other Keywords that you might have already defined.
      2. Make sure to only use letters, numbers and underscores.  Spaces and other characters will not work.
      3. The Keyword cannot just be numbers
   2. Terms: here, you’ll list the words or phrases that will be cycled through when generating content containing this Keyword.  Each word or phrase must be on its own line.

When you’re finished, click the Save button.

A notification will be displayed confirming that the Keyword saved successfully.

Add a Keyword from a Text File

If you already have a list of Terms that you want to use for a Keyword, the Data Import option on the Keywords Form can be used to quickly import your Terms.  This saves having to manually type, or copy and paste, your existing Terms into Page Generator Pro.

To import your text list of Terms:

1. Use the Add Keyword option within the Keywords section of the Plugin,
2. In the Data Import option, upload your text file.  This will append the data to the end of the Terms field – so any existing Terms that you might have specified will remain.
3. Click the Save button.

Add multiple Keywords and Terms from a CSV File

To add multiple Keywords and Terms from a CSV file, refer to the Import CSV documentation.

Generate Keyword Term Ideas

If you are creating a keyword, but cannot think of a list of Terms, similar words or synonyms to use, Page Generator Pro will attempt to automatically populate the list of Terms for you.

To do this:

1. Click the Add Keyword button below the Page Generator Pro: Keywords title, which can be found towards the top of the screen:
   
2. In the Keywords form that is then displayed:
   1. Enter a Keyword
   2. Click the Save button

The keyword will then be displayed, along with a list of Terms automatically generated by the plugin:

Understanding Delimiter and Columns

When adding or editing a Keyword, you’ll see options on the Keywords form to optionally define a Delimiter and Columns.

When specified, these provide greater control over which part of a Term to output when using the Keyword in our content.

Let’s assume that you have the following example Keyword configured:

We can define the Delimiter and Columns as:

• Delimiter: , (comma)
• Columns: city_name,county_name

This means that we could use the Keyword, with a Column Name, in our Content Groups to output a partial Term value:

Using the Delimiter Character within Terms

Let’s assume that you have the following example Keyword configured:

We can define the Delimiter and Columns as:

• Delimiter: , (comma)
• Columns: city_name,county_name,population

Saving this Keyword would result in the following error:
The number of column names detected does not match the number of deliniated items in the first term.

This is because the Delimiter (comma) is used for formatting the Population numbers (e.g. 100,000).

We can tell the Plugin to ignore the Population delimiter by wrapping the Population data in quotes:

Birmingham, West Midlands, "100,000"
Harborne, West Midlands, "10,000"
Selly Oak, West Midlands, "20,000"

Search Keywords

To search existing Keywords, enter part or all of the Keyword Name in the search box:

Click the Search button to see matching results.

Sort Keywords

To sort existing Keywords, click the Keyword column.  Repeating this will sort the Keywords in the opposite order.

Define Table Columns to Display

By default, all Keyword attributes are displayed on screen:

You can adjust which columns of data to display by:

• Clicking the Screen Options tab at the top right of the screen:
  
• Check or uncheck the relevant columns to display/hide:
  
• Click the Apply button

Define Number of Keywords Per Page

By default, up to 20 Keywords are displayed on screen before pagination is then output, allowing you to paginate through your Keywords:

You can adjust the number of Keywords per Page by:

• Clicking the Screen Options tab at the top right of the screen:
  
• Enter the number of Keywords to display per Page:
  
• Click the Apply button

Edit a Keyword

To edit an existing Keyword, click the Keyword name in the Keyword table.

In the Keywords form that is then displayed, change any options as necessary, clicking the Save button when done.

Duplicate a Keyword

To duplicate an existing Keyword:

1. Hover the mouse cursor over the Keyword that you want to duplicate.
2. Click on the Duplicate link which then appears below the Keyword
   

The Keyword will then appear within your list of Keywords, with _copy appended to it:

Export a Keyword to CSV

To export an existing Keyword to CSV

1. Hover the mouse cursor over the Keyword that you want to duplicate.
2. Click on the Export to CSV link which then appears below the Keyword
   

A CSV file will then be downloaded by your web browser, named as the Keyword

Delete a Keyword

To delete a Keyword, either:

• Use the checkboxes to the left of the keyword(s) you wish to delete, and then choose Delete from the Bulk Actions dropdown
  
• Hover the mouse cursor over the keyword, and then click the Delete link: