Cloudflare Turnstile Extension

This help document is about the Matador Jobs Pro Cloudflare Turnstile Extension. This document is updated for plugin version 1.1.0, which will be released side-by-side Matador Jobs Pro 4.0.0. Aspects of this document still apply for earlier versions.

About Cloudflare Turnstile Extension

The Matador Jobs Pro Cloudflare Turnstile Extension adds the powerful Cloudflare Turnstile anti-bot protections to your Matador Jobs Pro forms to reduce malicious traffic, form spam, and fraudulent behavior from your website.

This document has been updated to prepare for the pending release of Cloudflare Turnstile Extension 1.1.0, which requires Matador Jobs 4.0.0. Users of the Cloudflare Turnstile Extension 1.0.0 to 1.0.5 may see some features described which are not relevant to their versions.

Setup and Installation

Setup and installation is simple, but does require you to do setup and configuration on both your WordPress website powered by Matador Jobs and on Cloudflare.

Prerequisites

A Matador Jobs Pro All-Access subscription. Sign up or upgrade from your User Account.
A Cloudflare Turnstile widget id key and widget secret key. You can get this for free in the next step.
Matador Jobs Pro 3.9.0 or later for versions 1.0.0 – 1.0.5, or Matador Jobs Pro 4.0.0 or later for versions 1.1.0 or later.

Create a Turnstile Widget on Cloudflare

Getting your Turnstile widget credentials on Cloudflare is very easy!

Go to Cloudflare Dashboard

To get started you need to start by accessing a Cloudflare account. To create an account or access your existing Cloudflare account, go to https://dash.cloudflare.com/login.

It is highly recommended that you save login credentials for Cloudflare, as well as any other tools you use to create an configure your website, in a password manager or secure file accessible by your colleagues.

Access Turnstile Settings

Once logged into Cloudflare, access the Turnstile settings. At the time this help document was last modified, it was found under the Protect and Connect section > Application Security sub-menu > Turnstile.

Create Turnstile Widget

Now you need to create a Turnstile widget. Click Add Widget, which will direct you to a page to create and configure a Turnstile widget. On the page, do the following:

Name Your Turnstile Widget: You can name it something like “My Site Turnstile” or “Matador Turnstile”. Anything works, just use something that sufficiently explains your purpose for this Turnstile widget.
Add Hostnames: Add hostnames. This should include your URLs for “staging” and “production” sites.
Choose Widget Mode: The “widget mode” helps you decide how interactive (or not) your Turnstile should be. Matador recommends “Managed”, which automatically detects if a “I am not a Robot” challenge is issued.
Choose if Pre-Clearance Should Be Used: If a user previously passed a Cloudflare Turnstile challenge, a cookie can be installed on their machine, and you can choose whether this cookie, if present, can be used by Turnstile on your site. Matador recommends “No”.
Click “Create” to finish.

Your site may already have a Turnstile. If so, you can absolutely re-use existing Turnstile widgets in your Matador Jobs forms.

Save Turnstile Key and Secret

After creating the Turnstile widget, you will be shown your key and secret. Copy-and-paste these, but don’t worry, if you lose them, you can find them again from the Cloudflare Turnstile dashboard.

Installation and Activation

Installation

Install the Matador Jobs Pro Cloudflare Turnstile Extension by following our uniform All-Access Extension how-to guide.

Enable the Extension Integration

On Matador Jobs 3.9.x or earlier: Log into your WordPress Admin, go to Matador Jobs > Settings and then the Applications tab. Find the section with the heading “Cloudflare Turnstile”.

On Matador Jobs 4.0.0 or later: Log into your WordPress Admin, go to Matador Jobs > Settings and find the Integrations section. Locate the Cloudflare Turnstile integration and click Enable. You will re-load the page and a Settings button will be on the Integration card.

Input Cloudflare Turnstile Credentials

Access the Integration settings by clicking on the Settings button. You are redirected.

Input the Cloudflare Turnstile key and secret into the fields and then toggle-on the Enable Turnstile at the top. Congrats your site is now protected from malicious form inputs with Cloudflare Turnstile!

Configuration

There are a few ways to customize your experience, including through the use of settings and developer filters.

Security

The following Credentials Constants override their associated settings fields:

MATADOR_TURNSTILE_ENABLED overrides “Enable Turnstile”
MATADOR_TURNSTILE_KEY overrides “Turnstile Widget Key”
MATADOR_TURNSTILE_SECRET overrides “Turnstile Widget Secret”

For more information on migrating sensitive credentials to wp-config.php, see our guide on Credentials Constants.

This feature requires Matador Jobs Pro 4.0.0 or later and Cloudflare Turnstile Extension 1.1.0 or later.

Settings

The following style settings help you customize your Cloudflare Turnstile widget on your site.

This additional settings require Matador Jobs Pro 4.0.0 or later and Cloudflare Turnstile Extension 1.1.0 or later.

Widget Mode

The “widget mode” setting allows you to choose between having the Cloudflare Turnstile widget show only when a user interaction (checkbox) is required or have it always show.

Widget Theme

Choose “auto” to display a light or dark theme based on the users’ browser settings, or force the “light” or “dark” theme.

Widget Size

Choose to display a standard 300px wide widget, a responsive 100% width to 300px max-width widget, or the 150px wide compact widget.

Developer Filters

The following developer filters are available to further customize the output of the plugin.

Filter `matador_extension_turnstile_set_language`

By default, the Cloudflare Turnstile widget will display with the default language of the users’ browser, if available. If the site operator would like to control what language is used, a developer can use this filter.

<?php

add_filters( 'matador_extension_turnstile_set_language', 'example_turnstile_set_language' );
/**
 * Example Turnstile Set Language
 *
 * @since 2025-11-03
 *
 * @param string|false $locale
 *
 * @return string|false
 */
function example_turnstile_set_language( string|false $locale ): string|false {

	return 'es-MX'; // Spanish, Mexican
}

Return either a ISO 639-1 two-character language code, like en, fr, or de, or a regional variant like en-US, es-MX, or pt-BR to set the language. If Cloudflare Turnstile supports the language, the language will be used, otherwise the widget will be provided in English.