Welcome to the comprehensive guide on integrating Sequel CMS with your WordPress site using the Sequel CMS 1-Click plugin.
This plugin not only facilitates seamless integration but also offers advanced field mapping features to customize how Sequel.io's event data is displayed on your WordPress site.
Follow this step-by-step guide to install the plugin, configure webhook settings, and understand field mapping for a tailored content synchronization. By the way, all these instructions are provided step-by-step in the Wordpress option in Sequel Marketplace!
Installation and Initial Setup
Install the Plugin: Begin by installing the Sequel CMS 1-Click plugin. You can download the plugin here.
Access Plugin Settings: Once installed, navigate to your WordPress dashboard admin menu. Look for the "Sequel 1-Click" menu item and click on it to access the plugin's settings page.
Understanding Field Mapping
Field mapping is the process of linking specific data points from Sequel.io events (like titles and descriptions) to WordPress post attributes (such as content type) and custom fields.
Fields you'd like to map to Sequel like event ID, dates, etc. need to be created in WP in order to show up for mapping in the drop-down of 1-click settings.
Configuring Field Mappings
Navigate to the field mapping settings in the Sequel 1-Click plugin settings page to set up your mappings.
Post Type Mapping: is a crucial step in the integration process, as it allows you to determine the type of content you want Sequel to create on your website. The most common option is a post, but you also have the flexibility to create custom types such as live events or webinars. We support two types of posts per each space. This can be changed inside the Sequel dashboard to decide what type of posts you are creating
Post Status Mapping: This setting allows you to choose whether you want the event created in Sequel to be published automatically on your WordPress site or if you prefer to review it as a draft before publishing it.
Sequel Event Id Mapping: The event ID from Sequel will be used in your template to generate a unique URL for the Sequel embed code. This feature enables the automatic creation of the appropriate Sequel embed code on your website, ensuring a seamless integration experience.
Custom Field Mappings: For additional event details (start/end dates, time zones), use the custom field mappings to align this data with corresponding custom fields in WordPress.
NOTE: Unless specified here in the "Custom Domain" field, the domain for your post URL and any structure can be setup with WordPress "Settings" area > "Permalinks."
The default selection here is what will be used to insert the embed URL from WP into Sequel settings for you.
Replacing Static Event ID with Dynamic Field
Once you've completed the setup above, it's now time to make your WP template dynamic. The recommended method is to let Sequel fill in the field for you by adding the below snippet to your WordPress post template.
[IntrovokeEvent]<?php echo esc_attr( get_post_meta( get_the_ID(), 'sequel_event_id', true ) ); ?>[/IntrovokeEvent]
This is also available in the "Marketplace" area under "Wordpress" configuration settings for ease of access to other team members involved in implementation.
You can also simply substitute the event ID in the embed code with the dynamic event ID field. To do that,
Navigate to the template being used for your 1-click integration and enter in the "Any page" embed code from the "Embed" tab of any event.
Replace the event ID string after the "e" with your WP Sequel Event ID field (the one you created and mapped above). This allows Sequel, through this integration, to inject each event's unique ID into the draft page for you!
For example:<div id="sequel_root"></div>
<script src="https://prod-assets.sequelvideo.com/uploads/toolkit/sequel.js"></script>
<script>
document.addEventListener("DOMContentLoaded", (event) => {
Sequel.renderEvent({
eventId: Sequel_EventID
});
});
</script>
Configuring Webhook URLs
Webhook URLs are provided by the plugin for creating, updating, and deleting posts. These URLs need to be set up in Sequel.io dashboard to enable real-time content synchronization.
Copy Webhook URLs: In the plugin settings, locate the Webhook URLs section and copy the URLs for creating, updating, and deleting events.
Set Up Webhooks in Sequel.io: Paste these URLs into the appropriate fields in the Sequel.io dashboard "Marketplace" > Wordpress settings area and save your changes to put into effect.
This step is what allows Sequel to make the changes in the connected WordPress instance.
Final Steps
Once you have completed setting up the field mappings and webhook URLs, your WordPress site and Sequel.io will be seamlessly integrated.
To ensure the integration is successful, try creating an event in Sequel and then check if it appears on your WordPress site. This will confirm that the synchronization is working effectively.
If you encounter any issues or have any questions during the integration process, don't hesitate to reach out to our team. We are here to assist you with any problems you may encounter.