Documentation

OCMOD Instructions

Fresh installation

The extension does not overwrite any files of your Opencart installation. However, it is a good idea to make a backup of files and databases before installing any extension. This makes it easier to restore the site in case of problems.

1. Log in to your site's administration panel;

2. Go to Extensions > Installer and upload the file antispam_shield.ocmod.zip as shown in the picture:

   

3. Refresh the cache of the modification system from Extensions > Modifications:

   

If the installation was successful, you should see the extension in the page Extensions -> Extensions -> Modules of the Admin panel. Now you can start configuring the extension.

Update from a previous version

If you are updating the extension from a previous version, uninstall the old version first.

Uninstallation

To uninstall the extension:

1. Log in to your site's administration panel;

2. Go to Extensions > Modifications;

3. Find the extension in the Modification List and click on the red button Disable (3);

4. Refresh the modification cache (4).

VQMOD Instructions

Smart Antispam Shield is also available as a vqmod extension.

Fresh installation

To install Smart Antispam Shield as vqmod extension:

1. Unzip the file antispam_shield.vqmod.zip

2. From the file manager of your hosting control panel (or from any FTP client), copy the content of the folder upload in the root folder of your site (the content of that folder, not the folder itself).

Update of a previous version

If you are updating the extension from a previous version:

1. Uninstall the old version first;

2. Follow the same installation instructions as in the Fresh Installation section;

3. During the installation process you will be prompted to overwrite the old extension files with the new ones.

Now that the installation is complete we can configure the extension.

To open the extension control panel, from the left menu of the Admin panel go to Extensions > Extensions > Modules > Smart Antispam Shield.

The page has five sections:

• Basic Protection
• Slider Captcha
• Google Invisible Captcha
• Test Mode
• Remove Opencart Captchas

Let's examine them one by one.

Basic Protection

Basic protection provides all the necessary protection from spam attacks. It is invisible to users and provides an effective barrier against automated web form submissions.

Slider Captcha

Slider captcha adds an extra protection to forms. It adds a slider button that unlocks the form's submit button. You just need to enable the checkbox and set a text to display next to the captcha (e.g. : "slide the button"), to help users understand how to solve the captcha.

Google Invisible Captcha

An additional protection you can use is Google Invisible Recaptcha. It is a service offered by Google and is also invisible to users. (Or rather, it is most of the time. If Google suspects that the form submission is made by a spambot, a window will be displayed prompting the user to click on a series of images such as traffic lights, cars, stairs, etc.).

To use this feature you will need a Google account to access the page https://www.google.com/recaptcha/admin#list to register your site and get two keys (site key and secret key) that you will then need to enter in the control panel of Smart Antispam Shield.

NOTE: If you want to use this feature and you already have another version of Google Recaptcha (V3 or V2) installed on your site, you will first need to disable the one already installed.

Test Mode

Test mode simulates a spam attempt. This feature is useful for verifying that the antispam has been installed correctly. When this mode is active, the pages with the forms to be protected will display a yellow box with a checkbox. When the checkbox is enabled, if you try to submit the form, the request will be blocked, just as it would during a spam attack.

Disabling Opencart Captchas

If you have other captcha systems installed on your site, it would be recommended to disable them. The way they can be disabled depends on your Opencart version.

On Opencart v2.1.0.1 and later, captchas can be disabled from the admin panel, (Extensions > Captcha).

In older Opencart versions (Oc 1.5, and from Oc v2.0.0 to v2.0.3.1) , the control panel of Smart Antispam Shield shows a checkbox called Remove Captchas. When it's enabled, automatically disables all Opencart captchas, replacing them with Smart Antispam Shield protection.