Every PageForge campaign has three parts: the data, the template and the pages it creates. Knowing how they connect makes it easier to plan columns, write templates and fix problems.
The data
Your data is a table. The first row names the columns. Each later row describes one page. Any column name can be used as a placeholder, so a column called Phone gives you {Phone}.
In the free plugin the data is a CSV file uploaded on the Data Sources screen. PageForge Pro also reads XLSX and TSV files and, on the Professional and Enterprise plans, Google Sheets.
The template
A template is a WordPress entry with two parts:
- Content, written in the template editor or cloned from an existing page through Base Layout to Clone
- PageForge Template Settings: the Title, Meta Description and Slug patterns, the target post type, the parent page and the status for new pages
Placeholders can go anywhere in the content and the patterns. Spintax such as {Fast|Quick} can vary the wording from page to page.
From row to page
Here is what happens to one row of a plumbing campaign:
Service,City,State,Phone
Drain Cleaning,Austin,TX,512-555-0110
| Step | Result for this row |
|---|---|
Build the URL from the Slug Pattern {service}-{city}-{state} | /drain-cleaning-austin-tx/ |
| Look for an existing page at that URL | None found, so the row will create a page |
Fill the Title Pattern {Service} in {City}, {State} | Drain Cleaning in Austin, TX |
| Pick spintax options, then fill placeholders in the content | One finished page body |
| Fill the Meta Description Pattern | A description that names Austin and the phone number |
| Create the page with the chosen status | A draft or published Page |
| Save SEO fields and the row values on the page | Ready for your SEO plugin and for later updates |
If an existing page already has that URL, PageForge either skips the row or updates the page, depending on the option you pick under When a page already exists.
What PageForge keeps on each page
Each generated page remembers which template made it, the row values it was built from, and a fingerprint of its title, content and SEO fields. That record is what makes two things possible:
- Placeholders in layouts and themes keep working. When a generated page is displayed, any placeholder still left in a builder widget, theme title or widget is filled from the stored row values.
- Safe updates. When you change the CSV or template and run again in update mode, PageForge refreshes only pages this template generated, and skips pages someone edited by hand.
The run itself
A run always starts with Check and preview. It reads the data and template, writes nothing, and reports how many pages will be created, updated or skipped, with the first page’s title and URL. Problems that would publish broken pages, such as a title placeholder with no matching column, stop the run until fixed.
When you start the run, rows are processed a few at a time with a progress bar. If the server stops responding, the pages created so far are kept and you can resume from the row where it stopped.
Note Generated Pages and Posts are ordinary WordPress content and stay in place if you deactivate PageForge. Pages in the PageForge content type, and placeholders that are filled while a page is displayed, need the plugin to be active.
Next: Prepare your CSV or Create a template.
