Skip to main content

StopForumSpam

StopForumSpam integration for FlaskBB. Checks new registrations against StopForumSpam's database of known spammer usernames, email addresses and IP addresses, and lets moderators report new spammers back to it.

See flaskbb/flaskbb#391.

Installation

Install flaskbb-plugin-stopforumspam with pip install flaskbb-plugin-stopforumspam

For local development against a FlaskBB checkout, from FlaskBB's root folder:

uv pip install -e ../flaskbb-plugin-stopforumspam

Then install the plugin from the admin panel and run the migrations (flaskbb db upgrade).

Usage

Every registration is looked up on StopForumSpam. If the username, email address or IP address is listed with at least the configured confidence score, the registration is rejected with a generic message and the attempt is logged. Admins can review and clear that log from the admin panel's "StopForumSpam" page.

Users who can ban a member also get a "Report spammer" button on that member's profile. It submits the username, email address and the IP the member registered from to StopForumSpam, optionally with evidence, and can ban the member at the same time. Reporting needs an API key. FlaskBB doesn't store registration IPs itself, so only members who registered while this plugin was installed can be reported.

If FlaskBB runs behind a reverse proxy, configure it to pass on the client's address (for example with Werkzeug's ProxyFix), otherwise every registration is checked against the proxy's IP. Private and loopback addresses are never sent.

Settings

StopForumSpam Settings, under the admin panel's Plugin Settings:

  • Check registrations - master toggle for the lookup (default: on).
  • Check username / email address / IP address - which fields are looked up (default: all).
  • Minimum confidence (%) - reject a registration if any checked field is listed with at least this confidence (default: 50, 0 rejects any listing).
  • Send email addresses hashed - send an MD5 hash instead of the plain address. StopForumSpam skips its domain blacklists and address normalisation for hashed lookups (default: off).
  • Reject registrations when StopForumSpam is unreachable - fail closed instead of open (default: off).
  • Request timeout (seconds) - default: 5.
  • API key - only needed for reporting spammers.

The blueprint is mounted at /stopforumspam; override it with PLUGIN_STOPFORUMSPAM_URL_PREFIX in your FlaskBB config.

License

This project is licensed under the terms of the BSD License.

Metadata

Release files for flaskbb-plugin-stopforumspam 1.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for flaskbb-plugin-stopforumspam 1.0.3
File Size Uploaded Provenance Actions
flaskbb_plugin_stopforumspam-1.0.3.tar.gz 16.2 kB With provenance Details for flaskbb_plugin_stopforumspam-1.0.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for flaskbb-plugin-stopforumspam 1.0.3
File Interpreter ABI Platform Actions
flaskbb_plugin_stopforumspam-1.0.3-py3-none-any.whl Python 3 none any Details for flaskbb_plugin_stopforumspam-1.0.3-py3-none-any.whl

Total release size: 32.7 kB

Release files / flaskbb_plugin_stopforumspam-1.0.3.tar.gz

Download URL flaskbb_plugin_stopforumspam-1.0.3.tar.gz
Size 16.2 kB
Tags Source
SHA-256 checksum
How to use checksums
c7aaed861ba6efd113d611be03230508c51b3a2cb99f7a3b4e4d1eb4623738c7
BLAKE2b-256 checksum
How to use checksums
8c645574414858a3748a4c7188676cf31dd9e7e151e6670bf1c1f14eba8f7a11
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

Release files / flaskbb_plugin_stopforumspam-1.0.3-py3-none-any.whl

Download URL flaskbb_plugin_stopforumspam-1.0.3-py3-none-any.whl
Size 16.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e079549ad06893dd28666223fdad9158e6889834c5bfc14dd333f2d71a438d5c
BLAKE2b-256 checksum
How to use checksums
88b5d378ae5b9b756e0c9e022aeb627b93fe0e9e7a6d5d125d77765406486ae6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

Security for flaskbb-plugin-stopforumspam 1.0.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for flaskbb_plugin_stopforumspam-1.0.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 28, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page