Anura Docs

Plugins & Extensions - Anura for WordPress

With the Anura for WordPress plugin, you can easily set up a real-time visitor firewall to keep the fraud off of your site.

Installation

Before you can set this up, be sure to reach out to sales@anura.io to get your account set up first.

Requirements

• WordPress version 5.3 or higher
• PHP version 7.4 or higher
• An active Anura account and Instance ID

• Download at WordPress.org
• View Source on GitHub

Settings

Instance ID

Enter your assigned Anura Instance ID in the field provided. This is a required field.

Source Method

The Anura for WordPress plugin currently provides four methods of passing Source information to Anura. Choose a method that best works for your application.

• None

  A value for Source will not be submitted, with (undefined) instead being shown in the Anura dashboard interface.

• GET Method

  Passes a Source value sent within the query string of the URL. i.e. https://yourwebsite.com/landing-page?utm_source=optionalSourceTrackingId. Be sure to enter the GET parameter name into the corresponding Source Parameter field.

• POST Method

  Passes a Source value that is sent to the server stored in the body of an HTTP request. Be sure to enter the POST parameter name into the corresponding Source Parameter field.

• Hard Coded Source Value

  A hard coded Source value will pass the value exactly as it is entered in the Source Value field. If no value is entered into the Source Value field, (undefined) will instead be shown in the Anura dashboard interface.

Campaign Method

The Anura for WordPress plugin currently provides four methods of passing Campaign information to Anura. Choose a method that best works for your application.

• None

  A value for Campaign will not be submitted, with (undefined) instead being shown in the Anura dashboard interface.

• GET Method

  Passes a Campaign value sent within the query string of the URL. i.e. https://yourwebsite.com/landing-page?utm_campaign=optionalCampaignTrackingId. Be sure to enter the GET parameter name into the corresponding Campaign Parameter field.

• POST Method

  Passes a Campaign value that is sent to the server stored in the body of an HTTP request.
  Be sure to enter the POST parameter name into the corresponding Campaign Parameter field.

• Hard Coded Campaign Value

  A hard coded Campaign value will pass the value exactly as it is entered in the Campaign Value field. If no value is entered into the Campaign Value field, (undefined) will instead be shown in the Anura dashboard interface.

Optional Callback Function

Anura can initialize a custom JavaScript callback function once a response has been returned. Please note: Callback functions are allowed to start with: "$", "_", or "a-z" characters, followed by "a-z" and "0-9" characters.

Additional Data

If you'd like, you have the ability to pass select points of data with your requests. You can read more about additional data here.

Fallback Source and Campaign Variables

Fallback variables are used in the scenario where your source/campaign variables are empty when using the GET or POST method. In those situations, your fallbacks will be used instead.

Real-Time Actions

If desired, you have the option to take real-time action against traffic. These actions are performed immediately after a visitor has been assessed. Here are the following actions we have available:

• Redirect Visitor

  The visitor will be redirected to a URL of your choice. You also have the option to allow webcrawlers to stay on your page and not be redirected.

• Disable Forms

  All elements within a form will be disabled. This will prevent any and all interaction with any forms you have on your web page.

• Disable Comment Submit Buttons

  Any button(s) used for submitting comments will be disabled. This will prevent the visitor from submitting comments on your web page.

• Disable Links

  All links that are on your web page will be disabled. This means that the visitor will not be able to click on any links you may have.

• Disable All Forms Buttons, and Inputs

  This is the most powerful real-time action we have. Any and all forms, buttons, and inputs will be disabled.

For each real-time action we have available, you can assign a custom condition for that action to occur. Here are the conditions we have:

We understand that some elements such as forms, buttons, etc. might not load on your web page right away. To help with that, we also have retry settings you can optionally configure as well:

• Retry Duration

  Real-time actions are retried every 200 milliseconds. However, you can set when we stop retrying (4 seconds, 30 seconds, or 2 minutes after page load.)

• Stop searching after first element

  If this is activated, the plugin will only take action against the first element it finds that you have told it to take action against (a form, button, input, etc.) After that, it will stop searching.

Server Actions

CAUTION: We only recommend using server actions if you feel comfortable making adjustments to your actual WordPress server.

Server Actions are tweaks the plugin can make to your WordPress server.

• Add server-side headers for Anura Script

  Activating this will have the plugin tell WordPress to add extra server-side headers that will allow Anura Script to perform at its full capacity.

• Header Priority

  Header Priority determines how likely our extra server-side headers will be used if another plugin you have also sends HTTP headers. A higher priority means our headers will be more likely to be listened to instead.

Before using server actions, we recommend you either reach out to support, or consult with your own technical engineering team or IT administrator.