Use Akismet to stop spam

This package provides an easy way stop submission spam via Akismet.

Requirements

• PHP 7.4+
• Statamic v3
• Laravel 7+

Installation

You can install this package via composer using:

composer require silentz/akismet

The package will automatically register itself.

Configuration

.env

Set your Akismet API Key in your .env file. You can get it from: https://akismet.com/account/.

AKISMET_API_KEY=your-key-here

Permission

In order to manage your spam, you'll either have to be super user or have the manage spam permission:

[

Settings

To publish the config file to config/akismet.php run:

php artisan vendor:publish --tag="akismet-config"

This will publish a file akismet.php in your config directory with the following contents:

return [

    'api_key' => env('AKISMET_API_KEY'),

    // these are the form handles you'd like to check for spam
    'forms' => [

        // the handle of your form
        'contact_us' => [

            // use `name_field` if you store both first and last name
            'name_field' => 'name',   // `name` in this case is the field in your form

            // use `first_name_field` & `last_name_field` if you store them separately
            'first_name_field' => 'first_name',
            'last_name_field' => 'last_name',
            'email_field' => 'email',
            'content_field' => 'message',
        ],
        'other_form' => [],
    ],
];

Usage

Create your Statamic forms as usual. When a submission is created it is checked for spam.

If it is spam, it gets put into that form's spam queue.

From there you can discard (delete) it, or approve it. Approving it will put it back into the normal submissions and tell Akismet that it is not spam (to help with learning).

If you find a submission that is spam, you can mark it as spam (image). This will put it in the spam queue and tell Akismet it is spam.

Testing

Run the tests with:

vendor/bin/phpunit

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email addon-security@silentz.co instead of using the issue tracker.

License

This is commercial software. You may use the package for your sites. Each site requires it's own license.