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.
Page Generator Pro: Keywords Menu


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:
    Page Generator Pro: Import CSV
  2. The Keywords form will then be displayed, where you can define the following options:
    Page Generator Pro: Keyword Form

    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.
    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.
Page Generator Pro: Keywords: Success Notification

If you try to create / change a keyword to one that already exists, you’ll receive a warning telling you that the keyword has already been specified. Each keyword must be unique.

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:
    Page Generator Pro: Import CSV
  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:
Page Generator Pro: Keywords: Automatic Terms


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:

Setting Value
Keyword location
Terms Birmingham, West Midlands
Harborne, West Midlands
Selly Oak, West Midlands

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:

Keyword Example Value
{location(city_name)} Birmingham
{location(county_name)} West Midlands
There should be no spaces in the columns field.

Edit a Keyword

To edit an existing Keyword, click the Keyword name in the Keyword table.
Page Generator Pro: Keywords: Edit

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

If you try to change a keyword to one that already exists, you’ll receive a warning telling you that the keyword has already been specified. Each keyword must be unique.

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
    Page Generator Pro: Keywords: Duplicate

The Keyword will then appear within your list of Keywords, with _copy appended to it:
Page Generator Pro: Keywords: Duplication Result

If you try to change a keyword to one that already exists, you’ll receive a warning telling you that the keyword has already been specified. Each keyword must be unique.

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
    Page Generator Pro: Keywords: Bulk Delete
  • Hover the mouse cursor over the keyword, and then click the Delete link:
    Page Generator Pro: Keywords: Delete
Once a Keyword is deleted, it cannot be restored.  Any Content Groups that use this Keyword will need to also be updated.