Videos are not designed to be a substitute for instructions. Please refer to the detailed Documentation below.
Once you have defined your Group’s content, the Groups Table provides an overview of your Content Groups, as well as specific Actions that can be run to test, generate, manage generation and delete generated content:
Status Column
The Status column displays either:
- Actions that can be performed on the Group, such as:
- Testing Content Generation,
- Generating Content,
- Generating Content via WordPress’ CRON
- The current status of an action that is being performed, such as content generation.
These actions are also available when editing a Content Group:
Test
The Test method generates a single, draft Page, Post or Custom Post Type, with verbose error output if elements fail (for example, a shortcode).
When clicking this action, a message is displayed on screen confirming you want to generate a Test Page:
Once confirmed, an on screen notification will confirm whether the Test succeeded, with a link to the draft Page / Post / Custom Post Type:
Click the preview link to view the test content, where you can confirm correct working functionality, and make changes to your Group as necessary.
If error(s) occurred with the test, they will be displayed on the content. For example, if a Wikipedia shortcode results in no content being found, you might see the following error:
Generate
To generate content based on the Group, click the Generate action. A message is displayed on screen confirming you want to generate Pages:
Once confirmed, a screen will display showing the progress as each Page is generated, along with the time it took and the server memory usage:
Generate via CRON
The Generate via CRON action works in a similar way to the Generate action above, except it asynchronously generates content by using WordPress’ CRON system. This means that you do not need to keep your browser screen open, as the generation processes is triggered and monitored on the server side by WordPress’ CRON system.
To generate content based on the Group, click the Generate via CRON action. A message is displayed on screen confirming you want to generate Pages:
Generate via WP-CLI
If your server / web host provides WP-CLI, you can Test and Generate Content through WP-CLI.
Refer to the separate Documentation covering how to use WP-CLI.
Understanding the Output Log
When generating via the web browser or WP-CLI, verbose logging is output for each generated item:
Depending on the Overwrite setting used on a Content Group, the first line of each log entry will vary:
Message | Description | Overwrite Setting that may produce this Message |
---|---|---|
Created [Permalink] | A new Page has been created at the given Permalink. | (any) |
Created, as [Post Type] with Permalink has not yet been generated by this Group [Permalink] | A new Page has been created, as no existing Page generated by this Group was found for the given Permalink. |
|
Updated, as [Post Type] with Permalink already generated by this Group [Permalink] | An existing Page has been updated, as an existing Page generated by this Group was found for the given Permalink. |
|
Created, as [Post Type] with Permalink does not exist in WordPress [Permalink] | A new Page has been created, as no existing Page was found for the given Permalink. |
|
Updated, as [Post Type] with Permalink already exists in WordPress [Permalink] | An existing Page has been updated, as an existing Page was found for the given Permalink. |
|
Skipped, as [Post Type] with Permalink already generated by this Group [Permalink] | Generation of this Page has been skipped, as an existing Page generated by this Group was found for the given Permalink. | No, skip if existing Page generated by this Group |
Updated, as [Post Type] with Permalink already exists in WordPress [Permalink] | Generation of this Page has been skipped, as an existing Page was found for the given Permalink. | No, skip if existing Page exists |
Cancel Generation
Once Generation has started, it can be stopped in one of two ways:
- Generate via CRON: In the Groups Table, click the Cancel action:
- Generate: Either:
- Click the Stop Generation button on the Generate screen:
- In the Groups Table, click the Cancel action:
- Click the Stop Generation button on the Generate screen:
This will not delete any existing Generated Content. To do this, refer to the rest of the Documentation below.
Generated Items
The Generated Items column displays the number of Posts / Pages / CPT’s generated by each Group.
Where content has been generated, two actions are available:
Trash Generated Content
This allows you to trash all existing Page(s) that were generated by this Group.
Delete Generated Content
This allows you to permanently delete all existing Page(s) that were generated by this Group. This is useful if you made an error, and need to replace your existing Pages with revised content.