Standard WordPress websites | TourCMS Plugin Configuration

Where do I find it?

WordPress backend > TourCMS Shop

What does it mean?

This plugin is exclusive for Gray Line and other TourCMS customers using our WordPress template. The plugis is already installed and activated on your site, so you don’t need to worry about downloading and installation.

This article will guide you through the process of configuring the TourCMS Shop WordPress plugin, formerly known as the Gray Line Licensee TourCMS Plugin.

This plugin allows you to seamlessly connect your WordPress website to your TourCMS account, enabling you to display and sell your tours online.

The settings for the TourCMS Shop plugin are organised into the following sections for a more streamlined user experience:

• TourCMS Connection
• Payment Gateway
• Business Details
• Analytics
• Reviews
• Email
• Customisations

We will now explain each of these sections in detail.

What should I do?

TourCMS Connection

This section is where you will configure the connection between your WordPress site and your TourCMS account.

API Status

This tab provides an overview of your current API connection status. A green light indicates a successful connection, while a red light indicates an issue.

API Connection

To establish the connection, you will need to enter your TourCMS Channel ID and API key. These can be found within your TourCMS account under Configuration > System & setup > API.

Tour Search

Here you can configure how tours are displayed on your website. Options include setting up categories, keywords, and customising the order in which tours appear.

Here’s how it appears on your homepage:

For more information about this section, visit this support article.

Tour Sync

This tab allows you to manage the synchronisation of your tour data between TourCMS and your WordPress site. You can manually trigger a sync or set up an automatic schedule.

Cache

To improve your website's performance, the plugin caches tour information. This section allows you to control the cache behaviour, including the duration for which data is stored before it is refreshed.

For more information about this section, visit this support article.

Currency

Here, define the default currency, description, and symbol.

Language

Define here your language settings.

• Translate Language

This section controls how your website's language is translated. You have three options for the "Translate Language" setting:

• None: Select this option if you don't want to use any automated translation. Your website will remain in its original language.
• Google Translate: This option uses Google's translation service to automatically translate your website's content. You need to enter the Google Translate languages in this field.
• Normal Translate: Choose this if you are managing the translations manually. This requires you to provide the URL of your English-language website. This is particularly useful if you have a multi-language website with separate URLs for each language.

• Other Language Website Details

This is where you define the details for your other language websites. You must enter this information in a valid JSON format. This is a standardised way of organising data, making it easy for the system to understand.

Here is an example of the correct format:

[{"image":"br.png","lang_url":"https://grayline-licensee.com/pt","image_alt":"br"}]

In this example:

• "image":"br.png": Specifies the filename of the flag or icon for the language.
• "lang_url":"https://grayline-licensee.com/pt": Provides the full URL of the website in that specific language.
• "image_alt":"br": Sets the alternative text for the image, which is important for accessibility.

You can add multiple entries to this list for each language you support. For example, to add a Spanish website, you would add another object to the array, separated by a comma:

[{"image":"br.png","lang_url":"https://grayline-licensee.com/pt","image_alt":"br"}, {"image":"es.png","lang_url":"https://grayline-licensee.com/es","image_alt":"es"}]

Config Settings

This tab allows you to configure essential technical parameters for your plugin, including the TourCMS environment, payment gateway settings, and URL updates.

• TourCMS Production API

Enabling this field will set the TourCMS API to production.

• TMT Environment

Enabling this field will set the TMT payment gateway to live mode, allowing you to process real-time payments from your customers. When this is disabled, the payment gateway will remain in test mode.

• GLWW Channel

In this field, you will enter your Gray Line World Wide (GLWW) channel number to ensure your products are correctly linked and displayed.

• Google Map API Key

To display tour locations on an interactive map, you will need to enter a valid Google Maps API Key here. This key is essential for enabling the map functionality on your website.

To obtain a Google Maps API Key, you need to use the Google Cloud Platform.

Go to the Google Cloud Console.

Select an existing project or create a new one.

Navigate to APIs & Services > Credentials.

Click + CREATE CREDENTIALS and select API key.

Your new API key will be generated. Remember to restrict the key to your domain to prevent unauthorised use.

• TourCMS URL Update Switch

This switch is used to enable or disable the Tour URL Update cron job, which is a scheduled task that keeps your tour URLs synchronised with TourCMS.

You have three options:

• None: The cron job is not set.
• On: The cron job is enabled and will run automatically to update your tour URLs.
• Off: The cron job is disabled, and URLs will not be automatically updated.

• TourCMS URL Update Parameter Value

This setting works in conjunction with the TourCMS URL Update Switch and determines which URLs the cron job will update. You can choose between:

• All: The cron job will update all tour URLs.
• Error: The cron job will only update URLs that have previously encountered an error during a sync.

Payment Gateway

This section is where you configure your payment settings and ensure they are compliant with security standards. It's crucial to review these settings carefully before accepting payments.

TourCMS API >> PRODUCTION MODE ON

This indicates that your TourCMS API is in production mode, which allows you to process live payments.

• Payment Gateway & 3D Secure

The payment gateway name displayed here is TMTP USD for Trust My Travel in US Dollars. Here you can also select your payment gateway and enable 3D Secure Payments. 3D Secure is an EU directive that adds an extra layer of security for online payments. Enabling it shifts the liability for fraudulent transactions from you, the merchant, to the customer's bank.

Important Note: If you enable 3D Secure here, you must also ensure it is enabled within your payment gateway provider's account (e.g., Trust My Travel). Failure to do so may result in transaction issues.

You will see the following fields:

• Name: The name of your payment gateway.
• Enable 3D Secure: A checkbox to turn on 3D Secure for your transactions.

Business Details

The Business Details section is where you can enter and manage your company's essential information and social media links. It is divided into two tabs: Business Info and Social Links.

Business Info

This tab allows you to input your company's core contact and legal details.

• Contact No: Your primary business contact number.
• Email Address: Your main business email address.
• Licensee: Your licensee name, if applicable.
• Sub Logo Icon: An icon representing your sub-brand or logo.
• Company Number: Your official company registration number.
• Registered Address: Your company's registered address.
• Address: Your main business address.

Social Links

This tab is for linking your company's various social media profiles. Adding these links here will allow the plugin to display social media icons on your website, providing an easy way for customers to connect with you.

• Facebook Link: Your Facebook page URL.
• Twitter Link: Your Twitter profile URL.
• Pinterest Link: Your Pinterest profile URL.
• Instagram Link: Your Instagram profile URL.
• YouTube Link: Your YouTube channel URL.

Analytics

The Analytics section allows you to integrate various tracking and advertising platforms to monitor website performance and customer behaviour. This information is crucial for optimising your marketing efforts.

• GA4

This tab is for configuring Google Analytics 4 (GA4) to track e-commerce data. You have three options for e-commerce tracking:

• GA4 (data layer): This is the recommended option for a modern setup. It works with the Google Tag Manager data layer, providing more detailed and flexible tracking. You must have Google Tag Manager configured for this to work.
• Standard Tracking: This is a more traditional method for e-commerce tracking.
• None: Select this if you do not wish to track e-commerce data.

For adding the main GA4 tracking code to your site, please refer to the provided guide on adding tracking codes.

For more information, please visit this support article.

• Facebook Pixel

This tab allows you to enable the Facebook Pixel, which tracks user actions across your website.

• Facebook Pixel Tracking: Use this switch to enable or disable the Facebook Pixel code, which will fire on all pages of your site.
• Facebook Pixel ID: Enter your unique Facebook Pixel ID here. You can find this ID in your Facebook Business Manager by following the provided Facebook Pixel Manual Integration Guide.

For more information, please visit this support article.

• Bing Ads

Here you can configure Bing Ads Universal Event Tracking (UET) to track conversions.

• Bing Ads UET Revenue: Enabling this switch will fire a dynamic revenue price on the checkout complete page, sending a conversion value to your Bing Ads account.

Important: You must add your UET code to your website's header via Google Tag Manager or another method for this to function correctly.

• Google Adwords

This tab is for integrating with Google Adwords to track conversions from your advertising campaigns.

• Google Adwords Switch: Set this to "True" to enable Google Adwords tracking.
• Google Conversion ID: Enter the unique ID for your Google Ads conversion action.
• Google Conversion Label: Enter the label for your conversion action.
• Google Conversion currency: Specify the currency for your conversions (e.g., EUR, USD).

Note: If you have a marketing package, you should get the necessary codes from your marketing department.

Reviews

The Reviews section allows you to integrate customer reviews from Feefo onto your website. This helps build trust and credibility with potential customers.

Feefo Setting

• TourCMS API >> PRODUCTION MODE ON: This indicates that your TourCMS API is in production mode, which is necessary for the Feefo integration to function correctly.
• Enable Feefo Reviews: Use this switch to enable or disable the display of Feefo reviews on your product pages.
• Enable Feefo Reviews On Home Page: Use this switch to enable or disable the display of Feefo reviews on your website's homepage.
• Feefo Parent Merchant ID: Enter your Feefo Parent Merchant ID here. This is a unique identifier provided by Feefo for your main account.
• Feefo Merchant ID: Enter your specific Feefo Merchant ID, which may differ from the parent ID if you have multiple brands or channels.
• Feefo Product Brand: Enter the brand name for your products as it is configured in Feefo. This ensures that the correct reviews are displayed for your tours.

For more information, please visit this support article.

Email

The Email section allows you to manage your email marketing and mail delivery settings. It is divided into two tabs: MailChimp and Mail Settings.

• MailChimp

This tab is for integrating with your Mailchimp account to build your email marketing lists.

• Common Mailchimp Shortcode: You can use this shortcode to embed Mailchimp sign-up forms directly into your website's pages or posts, allowing visitors to subscribe to your mailing list.

For more information, please visit this support article.

• Mail Settings

This tab controls how emails are sent from your website, such as booking confirmations and notifications.

• Send Mail Method: You have two options for sending emails:
  • Default WordPress Mail Function: This uses WordPress's built-in mail function. It is a simple method but may sometimes face deliverability issues, as emails can be flagged as spam by some providers.
  • External SMTP Server: This is the recommended option for better reliability and deliverability. It allows you to send emails through a dedicated SMTP (Simple Mail Transfer Protocol) server, which is typically provided by your hosting company or a third-party service. Using an external SMTP server can significantly improve the chances of your emails reaching their intended recipients' inboxes.

Customisations

The Customisations section provides advanced options for tailoring your website's functionality and appearance. It is divided into two tabs: Custom Scripts and Other Customisations.

• Custom Scripts

This tab is for advanced users who want to add custom code to their website, including Google Tag Manager code. You can inject scripts into different parts of your site's HTML to add specific features or integrations.

• Header Script: Code placed here will appear within the <head> tag of your website, making it suitable for scripts that need to load before the page content, such as analytics or API scripts.
• Body Script: Code placed here will appear within the <body> tag, typically used for scripts that interact with the page content.
• Footer Script: Code placed here will appear just before the closing </body> tag, which is ideal for scripts that should load last to avoid slowing down your page.

• Other Customisations

This tab contains various settings for fine-tuning your website's display and behaviour.

• Footer Badge Details:
  • Badge Image: Upload an image for a badge that will be displayed in the footer of your website.
  • Badge URL: The URL where the badge will link to.
• Home page SEO keywords limit:
  • Limit: Set a limit on the number of SEO keywords displayed on your homepage.
• Customer Name Collection (Required):
  • List of Tour IDs: Enter a comma-separated list of TourCMS tour IDs for which the collection of the customer's first name and surname will be mandatory on the checkout page.
• Show Last Spots Left:
  • Threshold: Set a number for the threshold at which a "Last spots left" message will appear on a tour. For example, if you set the threshold to 5, a message will be displayed when there are five or fewer spots remaining for a tour.
• Destination X Config Setting:

This section allows you to configure specific settings for the Destination X feature. You can enable or disable different sections of your website, such as:

• Essentials Section: Enable or disable the essentials section.
• Articles Section: Enable or disable the articles section.
• Map Section: Enable or disable the map section.
• Videos Section: Enable or disable the videos section.