Akismet

Akismet is a Spam filtering platform commonly known from the WordPress universe (and operated by its parent company). Its API can be easily integrated in third party platforms like Kirby and is also used in other apps such as Discourse (the Kirby forum software).

Keep in mind that you need an active Akismet subscription to use it. Akismet is free for personal, non-commercial sites.

A spam submission marked by Akismet will not stop the submission. Instead, it will be stored as Spam submission and actions can be run later.

Adding Akismet

Get started by copying your API key from the Akismet account page. Proceed by adding the guard as well as the API key to the config:

// site/config/config.php

return [
  'tobimori.dreamform' => [
    'guards' => [
      'available' => ['akismet', /* other guards here */ ],
      'akismet' => [
        'apiKey' => fn () => env('AKISMET_API_KEY')
      ]
    ],
  ],
];

Ideally, you should not commit these keys to your repository, but instead load it from an environment variable, e.g. using the kirby-dotenv plugin by Bruno Meilick, as shown in the example above.

Since Akismet requires the IP address and user agent of the sender, we have to configure the plugin to collect the data as well.

// site/config/config.php

return [
  'tobimori.dreamform' => [
    'guards' => [ /* [...] */ ],
    'metadata' => [
        'collect' => [
            'ip', 
            'userAgent'
        ]
    ],
  ],
];

Try testing the guard by sending a submission to a form with an email field and the email akismet-guaranteed-spam@example.com.

Options