Skip to content

Silently filter spam messages based on a custom keyword/keyphrase blacklist.

License

Notifications You must be signed in to change notification settings

breadthe/laravel-silent-spam-filter

Repository files navigation

Laravel Silent Spam Filter

license packagist build code quality downloads

A simple way to filter a message for spam in a Laravel project, based on your own custom keyword and phrase blacklist. It is useful in silently ignoring messages submitted via contact forms, without alerting the spammer that the message went through.

By default it comes with virtually zero configuration, which means you'll have to add your own keywords and phrases to the blacklist.

Installation

You can install the package via composer:

composer require breadthe/laravel-silent-spam-filter

Optionally publish the configuration file config/silentspam.php:

php artisan vendor:publish --provider="Breadthe\SilentSpam\SilentSpamServiceProvider" --tag="silentspam-config"

Configuration

If you published the configuration file config/silentspam.php you can add additional entries to the blacklist key, or overwrite the sample entries.

At runtime you can use SilentSpam::blacklist([]) to add additional keywords, that will get merged with the list in the configuration. This can be useful if you want to keep a global blacklist in the config, but also add custom lists depending on the context when checking for spam.

Usage

$spamMessage = 'This message contains spam';
$normalMessage = 'This is a normal message';

SilentSpam::blacklist([
    'contains spam',
]);

SilentSpam::isSpam($spamMessage); // true
SilentSpam::notSpam($spamMessage); // false

SilentSpam::isSpam($spamMessage); // false
SilentSpam::notSpam($spamMessage); // true

Testing

composer test

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 [email protected] instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.

Laravel Package Boilerplate

This package was generated using the Laravel Package Boilerplate.

About

Silently filter spam messages based on a custom keyword/keyphrase blacklist.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages