Introduction to Template Mappings
Template Mappings enable you to push and pull content using the Wordpress Integration. A Template Mapping defines how the fields in your GatherContent Templates should import into WordPress, and that mapping is then used to push and pull content from GatherContent to WordPress.
Tip: You will not be able to push or pull content between GatherContent and Wordpress until a Template Mapping is created and at least one field has been mapped.
Each GatherContent Template field type is able to be mapped to a large number of WordPress fields. These include: title, content, excerpt, post status, post author, default and custom taxonomies, custom post types, custom fields, featured image, content images, WordPress SEO, etc.
The Template Mapping also allows you to define the GatherContent Item status once the Item has been imported. So, for example, you could set the GatherContent status to "Published" once you have pulled that content into WordPress.
Setting up a Template Mapping
- Click 'New Mapping' in the GatherContent menu.
2. Select account, project and template to map.
When creating a new mapping, you will be required to first select an account and project, and finally the template. While selecting the template, you will be provided with a sample of Items within that template, as well as the template's description.
3. Select Post Type and map fields.
Once you've selected a template, you're ready to create your first Template Mapping. To get started, select your default Post Type for the mapping. You will not be able to save the mapping until the post-type is selected and at least one field has been mapped. Once a post-type is selected, you can begin mapping all your template fields.
Then head to the Content tab, located to the left of the mapping tab to map the fields. You will only see the field types you can map to in the mapping options. Here are the mapping options for each GatherContent field:
4. Select GatherContent Template tabs.
You'll find the tabs from the GatherContent Template here. Select a tab to start mapping the Template fields.
Now you're able to press 'Save Mapping', and your Template Mapping is complete 🎉
The next step is to migrate your content from GatherContent to Wordpress using this Template Mapping.
You can set up additional actions as part of the mapping (see 5. below).
5. Map GatherContent status to WordPress status (optional).
Here you'll be able to map each individual GatherContent status to a WordPress status, and optionally, change the GatherContent status when your Items are imported to WordPress.
Tip: You can map multiple GatherContent text fields to a single WP field. However to be able to push your WordPress content back to GatherContent, fields need to be mapped one to one.
To migrate your content, check out Step 3: Migrating, updating content and importing content from Wordpress to see how that's done.