Here are some frequently asked questions about the GatherContent WordPress integration. If you have any other questions please get in touch.
Is there metadata support?
The plugin comes with built-in support for mapping your GatherContent fields to WordPress Custom Fields, and Yoast SEO fields. There are also many hooks and filters for developers to hook and map their own meta fields.
Is hierarchy supported?
Yes! You can map GatherContent hierarchy to WordPress hierarchy for hierarchical post-types (like pages). Default behaviours can be overridden with the gc_map_hierarchy filter as well.
Is there Multisite support?
GatherContent can work with Multisite. For this to work you’ll need to configure the settings on each site and do the imports per-site.
Does GatherContent work with WPML?
For translations the integration creates an entirely new post (page, custom post-type, etc). Right now, you could feasibly create your WordPress content, including translations, then push to GatherContent and continue managing that way, but there is no way to do an initial GatherContent import in a way that would connect the translations.
Also, this means you would need a 1-1 relationship with the WordPress posts with GatherContent items, so one GatherContent item per translation. We will explore a more elegant way of supporting this in the future.
Do you support inline images?
We do have a workaround for supporting ‘Content Images’ mapping in GatherContent. For this you will need to use short codes referencing the images saved in your attachment field. These will need to be placed where you will be wanting to paste your images.
Here are some example short codes you could include in your GatherContent text editor:
[media-1 align=right linkto=attachment-page]
The media number references the order in which the files have been uploaded to your Attachment field.
The shortcode syntax is:
[media-$position align=left|right|center|none linkto=file|attachment-page size=thumbnail|medium|large|etc]
- the minimum required is [media-$position] where $position is the number of the image.
- align defaults to nothing, so the default image output. See here: https://codex.wordpress.org/Inserting_Images_into_Posts_and_Pages#Image_Alignment
- linkto defaults to no media link. You can wrap your shortcode in a link if you want to link externally, e.g. <a href="google.com">[media-1]</a>. The other options are “file”, which links to the full image file, and “attachment-page”, which is a WordPress specific attachment page. See here: https://codex.wordpress.org/Inserting_Images_into_Posts_and_Pages#Image_Link
- size defaults to “full” which means the uncompressed, non-cropped version of the image, but you can use any registered media size, including the default WordPress sizes. See: https://codex.wordpress.org/Inserting_Images_into_Posts_and_Pages#Image_Size However, you’re not limited to the WordPress default sizes.. If you know the other registered sizes, you can use those. See: https://developer.wordpress.org/reference/functions/add_image_size/
What are the reasons a push or pull of content can fail and what are the error messages?
- WordPress has most recent changes for $item_name (Item ID:$item_id)
- Cannot override post IDs (happens if you try to map ID. Only possible if using the WordPress filters in code)
- $field_type field requires a numeric timestamp, or date string. (where $field_type represents 'post_date','post_date_gmt', 'post_modified', or'post_modified_gmt')
- The $post_type post-type does not support post-formats. (happens if you try to map a post format to an incompatible post-type.. only possible if using the WordPress filters in code)
- GatherContent could not get an item for that item id: $item_id(catchall if we could not fetch an item from the GC API)
- No mapping data found for: $mapping_id (should never happen since we require them to save at least one field when creating a mapping)
- No update data found for that post ID: $post_id (happens when you try to push a WP item that is current with GC)
- No item found or created for that post ID: $post_id (would only happen if there was an issue in the GC API when creating a new item)
Is there a way to export your mapping settings so you can import them from your local computer to your development server?
The WordPress import/export tool will work as mappings are simply a post-type. But you will need to enter their GC connection credentials manually. If you go to Tools > Export, then select “Template Mappings” in the export radio options, it will export all your mappings, then you can re-import on the other side (Tools -> Import -> WordPress Run Importer).
What is the Support page?
Under the GatherContent menu item, you will see a Support page. On this page, you’ll find a large text area filled with technical information about your server, browser, plugin, etc. This information is very useful when debugging, and the GatherContent support team may ask you for it at some point.
Below the text box is a button that will allow you to simply save all of that information to a .txt file. This allows you to easily deliver it to anyone who needs it.
Note: This information contains potentially senstive data. Please be careful with where you post it. Do not post it in the WordPress support forums.