FunCaptcha Setup

Standard Setup

Add this between your <head> tags:

Add this between your <form> tags:

Replace _YOUR_PUBLIC_KEY_ with your public key from your Site Settings.

 

Validate FunCaptcha from your server using one of the methods below:

PHP

In your PHP code where you are validating your form, you will need to pass your private key and the value of “fc-token” to the FunCaptcha API server either via POST or GET:

Then, replace the commented out sections with the code you want to execute on FunCaptcha being correctly solved — Done!

View Example

CURL Alternative

Java

In your Java code where you are validating your form, you will need to pass your private key and the value of “fc-token” to the FunCaptcha API server either via POST or GET:

You will need to import the following Java libraries for the above example:

  • java.net.URL
  • java.io.BufferedReader
  • java.io.InputStreamReader

Then, replace the commented out sections with the code you want to execute on FunCaptcha being correctly solved — Done!

View Example

.NET

In your .Net code where you are validating your form (most likely within your controller), you will need to pass your private key and the value of “fc-token” to the FunCaptcha API server either via POST or GET:

Then, replace the commented out sections with the code you want to execute on FunCaptcha being correctly solved — Done!

View Example

You can also download a sample full project that demonstrates FunCaptcha validation using the Razor markup language.

Download Sample Project

Other

In your server code, after the user has submitted the form, do a GET request with the fc-token response (which is embedded within the form) while passing up your private key (also from your account dashboard) to check if the user solved correctly.

Using simple_mode=1 makes the response only return 1 if solved correctly, otherwise false. Without this set, you will get more information, such as the users IP address and other details from the FunCaptcha game session.

 

Refreshing FunCaptcha Sessions

You can also recreate a new FunCaptcha session using Javascript if the old session is invalid, such as if you are using AJAX to submit your form, but the server response was incorrect. FunCaptcha sessions can only be checked to the API server once. To do this, run the following:

This will regenerate the session and reload the FunCaptcha.

 

Manually Setting Language

FunCaptcha by default will automatic show language based on the users browser prefrences. If you would like to manually force a language to show, you can pass it in as part of the script URL in the HTML ISO format:

This example will show FunCaptcha in the Arabic language. FunCaptcha supports a growing number of languages. If we do not support a language it will display in English. If there is a language you need supported please contact us and we can add it.

WordPress Setup

Video Guide:

OR-Spacer

Step-by-step Guide:

 

Select “Add New” from the Plugins sub-menu on the WordPress sidebar.

wp_1

 

Search for “FunCaptcha”

wp_4

Select “Install Now”

 

Once installed, select “Activate”

wp_3

 

Select FunCaptcha from the Plugins sub-menu on the WordPress sidebar.

wp_2

 

Enter your Private and Public keys. These can be found in your FunCaptcha account under ‘Setup’ by clicking the relevant cog icon.

wp_5

Choose where you would like FunCaptcha to appear.

wp_6

Click Save — FunCaptcha is now installed.

Congratulations!

Frequently Asked Questions

Can I use FunCaptcha with Gravity Forms, Contact Form 7 or Ninja Forms?

Yes! FunCaptcha supports these three ‘out of the box’ – once you have installed FunCaptcha you will be able to select it as an option when creating your form.

Can I use FunCaptcha with Buddypress registration pages?

Yes! FunCaptcha supports Buddypress. Once installed you will get more Buddypress related options (such as registration) in your FunCaptcha plugin dashboard in WordPress.

Can I use FunCaptcha with bbPress forums?

Yes! FunCaptcha supports bbPress. Once installed you will get more bbPress related options (such as topics, new comments) in your FunCaptcha plugin dashboard in WordPress.

vBulletin Setup

Before you start

You’ll need to create a FunCaptcha account and add your sites. This will generate a Private and Public key, which FunCaptcha uses to authenticate your website with our servers.

Download the plugin files:

Download

 

Unzip the plugin archive and upload/FTP the files from the /upload/ folder to your vBulletin websites /includes/ folder.

 

In your vBulletin Administrator Control Panel, click “Plugins & Products” in the left sidebar on the left. Then, click “Manage Products”

step_1

 

Click “Add/Import Product”

step_2

 

Click “Choose File” and select the product-funcaptcha.xml file.

 

Click “Import”

step_3

 

Under “Settings” in the Administrator Control Panel sidebar, click on “Settings.” Then, click “Human Verification Manager”

step_4

 

Select FunCaptcha.

 

Click Save.

step_5

 

Enter your Private and Public keys into the plugin settings where required. These can be found in your FunCaptcha account under ‘Setup’.

Click Save — FunCaptcha is now installed.

step_8

Congratulations!

phpBB Setup

Before you start

You’ll need to create a FunCaptcha account and add your sites. This will generate a Private and Public key, which FunCaptcha uses to authenticate your website with our servers.

Download the plugin files:

Download

Install the plugin:

To start, FTP into your site and find your phpBB directory – it will be called phpBB3 by default.

If you are running phpBB 3.0.x, you will need to upload the contents of the phpBB_3.0.x/funcaptcha_uploadme into the phpBB directory.

For phpBB 3.1.x, upload the contents of phpBB_3.1.x/swipeads to your phpBB3/ext on the server.

 

After the upload is complete, log into the Administration Control Panel and navigate to the General Tab.

 

Under Board Configuration, click the Spambot countermeasures link in the sidebar.

 

In the Available Plugins section, select FUNCAPTCHA from the dropdown and click Configure.

spambot

 

You’ll now be at the FunCaptcha configuration page – this is where you can change your FunCaptcha theme and personalize other settings.

settings

 

Enter your Private and Public keys into the plugin settings where required. These can be found in your FunCaptcha account under ‘Setup’ by clicking the relevant cog icon.

keys

 

Click Save — FunCaptcha is now installed.

finished

Congratulations!

Wix Setup

FunCaptcha is available on Wix as a Contact Form that is secured by our verification technology.

Install FunCaptcha

 

ss_1

Simple Machines Forum
Setup

Before you start

You’ll need to create a FunCaptcha account and add your sites. This will generate a Private and Public key, which FunCaptcha uses to authenticate your website with our servers.

Download the plugin files:

Download

Log in to your account and click ‘Package Manager’ from the admin dropdown menu.

 

Click ‘Download Packages’ from the Package Manager menu. Near the bottom, you will find the ‘Upload a Package’ section.

upload

 

Click ‘Choose file’ and navigate to the plugin files you downloaded.

 

Select ‘funcaptcha-simple-machine-forum.zip’ and click Upload.

 

Once uploaded, select ‘Install Mod’ to enable FunCaptcha.

installed

 

You’ll now see a list of changes that this plugin will make. If you notice any tests are not successful, please contact us.

 

Click ‘Install Now’

changes

 

Once the plugin has been successfully installed, you will be taken to the Anti-Spam page. Make sure that visual verification is turned on – this enables CAPTCHAs across the site.

verification

 

Scroll down to ‘FunCaptcha Settings’ and check ‘Activate FunCaptcha’

fcsettings

 

Enter your Private and Public keys into the plugin settings where required. These can be found in your FunCaptcha account under ‘Setup’ by clicking the relevant cog icon.

keys

 

Click Save — FunCaptcha is now installed.

Congratulations!

Drupal Setup

Before you start

You’ll need to create a FunCaptcha account and add your sites. This will generate a Private and Public key, which FunCaptcha uses to authenticate your website with our servers.

Log in to the admin area of your Drupal site and select ‘Modules’ from the top menu.

 

Select ‘Install new module’

 

In the ‘Install from a URL’ field, enter ‘https://github.com/FunCaptcha/funcaptcha-drupal/archive/master.zip’

 

Click ‘Install’

 

Once uploaded, FunCaptcha will now appear under Spam Control. Check ‘ENABLED’ and click ‘Save configuration’

drupal1

 

Select ‘Configuration’ from the top menu or click ‘Configure’ in the Operations column.

drupal2

 

Enter your Private and Public keys into the plugin settings where required. These can be found in your FunCaptcha account under ‘Setup’ by clicking the relevant cog icon.

drupal4

 

Click Save.

 

In the Drupal Dashboard, click the “CAPTCHA” tab from the top right.

drupal5

 

In the ‘Default challenge type’ dropdown, select ‘FunCaptcha.’

 

Setup ‘FORM_ID’ and set ‘CHALLENGE TYPE’ to FunCaptcha — FunCaptcha is now installed.

drupal7

 

 

Congratulations!

Joomla Setup

Before you start

You’ll need to create a FunCaptcha account and add your sites. This will generate a Private and Public key, which FunCaptcha uses to authenticate your website with our servers.

Log in to the admin area in your Joomla site and go to Extensions → Extension Manager.

 

Click ‘Install’ on the left menu and then select ‘Install from URL’ tab.

 

Enter “https://github.com/FunCaptcha/funcaptcha-joomla/archive/master.zip” and click ‘Install.’

 

Once installed, the message ‘Installation of the plugin was successful’ will be shown — Click ‘Joomla Plugin Manager.’

joomla3

 

You will be taken to the Plugin Manager screen. Now, search for FunCaptcha and then click ‘System – FunCaptcha’ to setup the plugin.

joomla4

 

Select the FunCaptcha Settings tab from the top menu.

 

Enter your Private and Public keys into the plugin settings where required. These can be found in your FunCaptcha account under ‘Setup’ by clicking the relevant cog icon.

joomla5

 

Click the ‘Plugin’ tab and ensure that the selected ‘Status’ dropdown is enabled and that ‘Ordering’ is ‘0. System – FunCaptcha.’

joomla9

Click Save — FunCaptcha is now installed.

 

Congratulations!

XenForo Setup

Before you start

You’ll need to create a FunCaptcha account and add your sites. This will generate a Private and Public key, which FunCaptcha uses to authenticate your website with our servers.

Download the plugin files:

Download

 

FTP to your XenForo site and copy the contents of the ‘Upload’ folder into ‘/Library’ folder.

 

Log in to AdminCP, go to the ‘Home’ tab and click ‘Install Add-on.’

 

Click ‘Install from uploaded file’ and select ‘addon-FunCaptcha.xml’ from the downloaded plugin files.

 

From AdminCP, go to the ‘Home’ tab and click the ‘Options’ menu. Then, click ‘FunCaptcha Options.’

 

Enter your Private and Public keys into the plugin settings where required. These can be found in your FunCaptcha account under ‘Setup’ by clicking the relevant cog icon.

 

Click Save — FunCaptcha is now installed.

 

Congratulations!

Advanced Setup Options

You can take more control over FunCaptcha by setting it up manually in Javascript.

 

Add the following code within your <head> tag, with the onload variable being the name of the function you would like to call to setup FunCaptcha:

 

Add the following script into your page, we recommend just before the closing </body> tag:

 

Add the following to the form where you would like FunCaptcha to appear:

 

 Example

In this example the function called “loadFunCaptcha” is called, which creates a new FunCaptcha object with a range of custom values passed into it.

“target_html” is set to “CAPTCHA”, so the library will look for an element with a class or ID of “CAPTCHA“ to insert FunCaptcha into, for example your form may look like this:

The optional callback function is triggered when the user has completed FunCaptcha on the page, for example this could be used to enable a submit button.

These are all of the current FunCaptcha setup settings:

public_key – required – Your public key to authenticate with our server. Found in your FunCaptcha account settings.

target_html – optional – defaults to ‘funcaptcha’. This is an ID or class of where you want FunCaptcha to be loaded on the page.

callback – optional – A function that will be called when FunCaptcha has been solved by the user.

language – optional – The language to show FunCaptcha in. Format is HTML ISO. We support many languages.

 

Refreshing FunCaptcha Sessions

You can also re-create a new FunCaptcha session using Javascript if the old session is invalid, such as if you are using AJAX to submit your form, but the server response was incorrect. FunCaptcha sessions can only be checked to the API server once.

Save the FunCaptcha Javascript object as a variable so you can call it later like the following:

And then when you want to recreate the session, which will reload FunCaptcha on your page:

No Javascript Setup

FunCaptcha also provides a non-Javascript version for users which do not support modern features in their browsers or do not use Javascript.

Add this after the FunCaptcha div in your <form> tag:

 Replace _YOUR_PUBLIC_KEY_ with your public key from your Site Settings.