The key concept to the GatherContent WordPress plugin is the Template Mappings. A Template Mapping is simply a way to define how your fields from your GatherContent Templates should import to WordPress, and that mapping is then used to push and pull content from GatherContent to WordPress. You will not be able to push or pull content from GatherContent 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 and field types. These include: title, content, excerpt, post status, post author, tags, categories, 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.

1. 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. 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:

GatherContent Text field maps to Wordpress field type:
Author, Post Date, Post Date (GMT), Post Content, Post Title, Post Excerpt, Post Status, Comment Status, Ping Status, Post Password, Post Name (Slug), Post Modified Date, Post Modified Date (GMT), Post Parent, Menu Order, Custom Fields, Taxonomy Terms
For mapping to field Title, field in GatherContent should be plain text only. 

GatherContent Checkboxes field maps to Wordpress field type:
Custom Fields, Taxonomy Terms (Categories, Tags, etc)  

GatherContent Radio Buttons field maps to Wordpress field type:
Custom Fields, Taxonomy Terms (Categories, Tags, etc)  

GatherContent Attachment field maps to Wordpress field type:
Featured Image, Content Image(s), Excerpt Image(s), Gallery, Attachments, Custom Fields
We allow file fields to be mapped to custom fields. Will store an array of WordPress attachment ids, or a single attachment id if the file field from GatherContent only contains a single file. 

Select GatherContent Template tabs

You'll find the tabs from the GatherContent Template here. Select a tab to start mapping the Template fields.

Map GatherContent status to WordPress status

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.

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.

Next Steps

Once you've finished creating your first mapping, you'll then have the option to pull the GatherContent items assigned to that Template into WordPress, and vice-versa. You're also able to push your WordPress content back to GatherContent. This provides a seamless solution for keeping your content in sync as well as transferring your GatherContent items in bulk to WordPress.

You can also edit any mapping by clicking the 'edit' option for any mapping on the 'Template Mappings' page.

Did this answer your question?