FunCaptcha Setup

Standard

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:

And that’s all you need — you can replace the commented out sections with the code you want to execute on FunCaptcha being correctly solved.

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

And that’s all you need — you can replace the commented out sections with the code you want to execute on FunCaptcha being correctly solved.

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:

And that’s all you need — you can replace the commented out sections with the code you want to execute on FunCaptcha being correctly solved.

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.

wordpress-logo-hoz-rgb

You can follow watch the video or follow the guide below to install FunCaptcha on your WordPress site.

Video guide:

Manual guide:

1. Select “Add new” from the WordPress admin plugin dashboard.

wp_1

2. Search for “FunCaptcha”.

wp_4

3. Select “Install now”.

4. Select “Activate” once installation has finished.

wp_3

5. FunCaptcha will appear as a new sub-menu under Plugins. Select it.

wp_2

6. Enter your private and public keys. You get these on this site under your “Account” menu option when you are signed in.

wp_5

7. Choose where you would like FunCaptcha to appear.

wp_6

8. Save. You’re done!

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-Logo

Registration

You’ll need to register on this site and add your domains. Once you have registered, you can add your website URL which will generate a private and public key. These keys are used in the plugin to authenticate your website with our servers.

Download the plugin

Download

Install the plugin

  • Unzip the plugin archive
  • FTP the files from the upload folder to your vBulletin /includes/ directory

Upload the XML and setup the plugin

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

step_1

Click “Add/Import Product”.

step_2

Click “Choose File” and select the xml file.

Click “Import” button.

step_3

In your vBulletin Administrator Control Panel, click on “Settings” in the sidebar on the left. Then click “Human Verification Manager”.

step_4

Select “FunCaptcha”.

Click “Save” button.

step_5

You can get your public and private keys from your account dashboard. Copy those keys into your plugin settings where required.

Click save.

step_7

FunCaptcha is now ready to go!

step_8

Phpbb3-ccw-logo

Registration

You’ll need to register on this site and add your domains. Once you have registered, you can add your website URL which will generate a private and public key. These keys are used in the plugin to authenticate your website with our servers.

Download the plugin

Download

Install the plugin

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

You will need to upload the contents of the funcaptcha_uploadme into the phpBB directory.

After the upload is complete, log into the Administration Control Panel and go to the General Tab. Click the Spambot countermeasures link in the sidebar, under Board Configuration.

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

spambot

You’ll now be at the FunCaptcha configuration page. You can change the theme or other settings here if you would like to.

settings

Finally, you will need to register for FunCaptcha to get your keys. You can do that at the end of the settings section. After you have registered for your account, enter the FunCaptcha Public and Private keys into the settings.

keys

Now that you’ve finished setting up FunCaptcha, click save at the bottom of the page. FunCaptcha will now replace all the standard captchas on the site.

finished

Congratulations, you now have FunCaptcha set up!

wix-musa-2

FunCaptcha is also available on the Wix platform as a Contact Form with FunCaptcha integrated.

You can add the Wix contact form and set it up through the Wix Market from your Wix website dashboard.

Install FunCaptcha

ss_1

Logo_de_Simple_Machines_Forum

Registration

You’ll need to register on this site and add your domains. Once you have registered, you can add your website URL which will generate a private and public key. These keys are used in the plugin to authenticate your website with our servers.

Download the plugin

Download

Install the plugin

Login to your admin account and access the Package Manager by going to the Admin then selecting Package Manger from the dropdown menu.

Next select Download Packages from the Package Manager menu.

Near the bottom, you will find the Upload a Package section.

upload

Find where you downloaded this plugin, then select “funcaptcha-simple-machine-forum.zip” from the file selector. Now press Upload.

After the plugin has been uploaded, you will now be able to enable it. Select Install Mod, on the right hand side.

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.

Next, click Install Now.

changes

After the plugin has successfully installed, you will be taken to the Anti-Spam page.

Firstly, make sure that the Visual verification is turned on. This enables capchas across the site.

verification

Next, scroll down the the FunCaptcha Settings and Activate FunCaptcha. You can change the theme if you would like to.

fcsettings

Finally, you will need to register for FunCaptcha to get your keys. You can do that at the end of the settings section. After you have registered for your account, enter the FunCaptcha Public and Private keys into the settings.

keys

Now that you’ve finished setting up FunCaptcha, click save at the bottom of the page. FunCaptcha will now replace all the standard captchas on the site.

Congratulations, you now have FunCaptcha set up!

drupal_logo-blue_rgb

Registration

You’ll need to register on this site and add your domains. Once you have registered, you can add your website URL which will generate a private and public key. These keys are used in the plugin to authenticate your website with our servers.

Install the plugin

  1. Login to the admin area in your Drupal site, then select Modules from the top menu.
  2. Select “Install new module”
  3. Put in “https://github.com/FunCaptcha/funcaptcha-drupal/archive/master.zip” into the “Install from a URL” field and click “Install”.

Setup the plugin

Once uploaded, FunCaptcha will now appear under Spam Control. Tick “ENABLED” and click “Save configuration”.

drupal1

Select Configuration from the top Menu or click on Configure in the Operations section.

drupal2

To complete the setup public and private keys need to be added. You can get your public and private keys from your account dashboard. Copy those keys into your plugin settings.

drupal4

Click save.

In the Drupal Dashboard, select the “CAPTCHA” tab top right hand side of screen.

drupal5

 

In the “Default challenge type” dropdown select “FunCaptcha”. Setup ‘FORM_ID’ and set ‘CHALLENGE TYPE’ to FunCaptcha.

drupal7

 

 

FunCaptcha is now ready to go!

joomla_logo

Registration

You’ll need to register on this site and add your domains. Once you have registered, you can add your website URL which will generate a private and public key. These keys are used in the plugin to authenticate your website with our servers.

Install the plugin

  1. Login to the admin area in your Joomla site, then go to Extensions-> Extension Manager.
  2. Select ‘Install’ on your left menu then select ‘Install from URL’ tab.
  3. Put in “https://github.com/FunCaptcha/funcaptcha-joomla/archive/master.zip” and click ‘Install’.

Setup the plugin

Once installation is successful, it will show message ‘Installation of the plugin was successful’. Within this text click ‘Joomla Plugin Manager’.

joomla3

This will take you to the Plugin Manager screen as below. Search for FunCaptcha. Click ‘System – FunCaptcha’ to setup FunCaptcha plugin.

joomla4

From the top menu select the FunCaptcha Settings tab.

To complete the process, copy and paste the public and private keys from your account settings into the plugin.

joomla5

Click ‘Plugin’ tab. On the right hand side of screen ensure the ‘Status’ dropdown selected is ‘Enabled’. Also confirm Ordering is ‘0. System – FunCaptcha’.

joomla9

FunCaptcha is now ready to go!

200px-XenForo

Registration

You’ll need to register on this site and add your domains. Once you have registered, you can add your website URL which will generate a private and public key. These keys are used in the plugin to authenticate your website with our servers.

Download the plugin

Download

Install the plugin

  1. FTP to your Xenforo site and copy the contents of the Upload folder into /Library folder.
  2. Log into AdminCP then ‘Home’ TAB then ‘install Add-on’.
  3. Click to ‘Install from uploaded file’ and browse here to select ‘addon-FunCaptcha.xml’.

Setup the plugin

To configure in AdminCP click ‘Home’ TAB then ‘Options’ menu then click ‘FunCaptcha Options’.

Copy and paste the public and private keys from your account settings into the plugin and click save.

FunCaptcha is now ready to go!

Advanced setup options

You can optionally take more control over how FunCaptcha by manually setting up FunCaptcha 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:

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

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.

 

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: