WordPress Plugin Integration Guide

humanID's Plugin is two products in one: A protection for your site's contact form, and a bot- & spam-protection for your blog's comment and discussion forum.

humanID’s WordPress Plugin allows users to permanently block users and bots from commenting on their WordPress-based website, or from sending you contact requests through your contact form (requires 'Contact Form 7'). Safe your time from having to go through emails and comments manually, and safe your users' time from having to solve ineffective CAPTCHAs.

Overview

Requirements

  • A humanID Developers account (humanID is free up to several hundred monthly requests).

  • humanID Server Credentials. Server Credentials consist of

    • Server Client ID

    • Server Client Secret.

  • A website utilizing WordPress. You must be site admin or site creator.

Create your humanID Developer Account

Plugin Setup in WordPress

  • In the WordPress dashboard, find “plugins” and click “add new”.

  • Search for “humanID”. Install and activate the plugin.

  • In WordPress, go to “humanID Setup”

  • In the “Update Permalinks” panel, click “Go to permalinks”.

  • Set your “Common Settings” to anything other than type “Plain”. Do NOT set your common setting to be “Plain” and save changes.

  • Back on the “humanID Setup” page, click “Yes, I have updated the permalinks”. This panel should appear.

Developer Console Setup

  • Below the “humanID Redirect Urls” panel, right-click on “here” and click “Open link in new tab”. Click on the new tab to go to the “humanID Developers” page.

  • Log into your humanID Developers account. If you don’t have one, create one and log in.

  • In the “humanID Developers” dashboard, click “Register New Project”

  • Click “Create New Credentials”. Name your credentials, and set the type and environment (usually to 'Production' and 'Server'). Leave "Package ID" empty. After this step, you will receive server credentials on the dashboard.

  • Copy your Client ID and on the “humanID Setup” page paste it into the textbox labeled “Client ID”.

  • Copy your Client secret and on the “humanID Setup” page paste it into the textbox labeled “Client Secret ”. Save changes.

Success/Failure Links

  • In the “humanID Setup” page, find the redirect URLs you received after you updated your permalinks.

  • Open the “humanID Developers” dashboard. Scroll down until you see the panel labeled “Redirect URLs”.

  • Click the arrow on the right of “Edit Redirect URLs” to expand. Find “Successful URL” and “Failed URL”.

  • Copy your success link from “humanID Setup” and paste it into their respective textbox on the “humanID developers” page.

  • Repeat the step above with the failed link.

  • Click “Update Project Redirect URLs”.


humanID Contact Form Protection

If you're using the 'Contact Form 7' plugin, Wordpress' most popular Contact Form, you can upgrade it with humanID.

  1. Click on 'Add New' on top to add a new Contact Form

  2. A menu will pop up to create a tag that will look something like [humanid humanid-123]. Move this tag to the end of the form template.

  3. You have now successfully added humanID to your Contact Form. Follow 'Contact Form 7's' guidelines to implement the Contact Form at the desired page on your website

humanID Comment Form Protection

humanID's Comment form allows your website to host real debates between real humans – and allows you to block spam and harassment. You can blacklist offenders effectively, all without undermining your users' privacy. humanID's awardwinning technology blocks bots without saving any personally identifiable information.

To do so, no further work is needed. humanID is automatically added to Wordpress' in-house comment solution. After adding the plugin, you can permanently block users, or whitelist users. By default, comments will wait for your approval unless a user has been previously whitelisted.

Last updated