README

This Roundcube plugin displays the SPF (Sender Policy Framework) status of incoming messages.
It checks for the Received-SPF header in emails and shows a small status icon next to the message headers:

✅ Pass (valid sender)
❌ Fail / Softfail (invalid sender)
❓ Unknown (missing or neutral header)

Features

Automatically inspects Received-SPF headers.
Displays clear visual indicators (pass.png, fail.png, unknown.png).
Integrates seamlessly with the Roundcube mail view (show and preview actions).

Installation

1. Install via Composer (recommended)

In your Roundcube installation directory, run:

composer require texxasrulez/spfstatus

Thanks to composer/installers and the "type": "roundcube-plugin" declaration, the plugin will be installed into:

plugins/spfstatus/

2. Manual installation (fallback)

Download the plugin archive.
Extract into your Roundcube plugins/ directory so it looks like:

roundcubemail/
└── plugins/
    └── spfstatus/
        ├── spfstatus.php
        └── images/
            ├── pass.png
            ├── fail.png
            └── unknown.png

Enabling the Plugin

Edit config/config.inc.php and add spfstatus to the plugins array:

$config['plugins'][] = 'spfstatus';

Clear Roundcube cache if necessary:

bin/cleancache.sh

Requirements

PHP >= 7.4
Roundcube Mail >= 1.4 (tested)
Composer (if installing via Composer)

Uninstallation

If installed via Composer:

composer remove texxasrulez/spfstatus

If installed manually, just remove the plugins/spfstatus directory.

License

MIT License

Credits

Author: Gene Hawkins
Original Plugin URL: GitHub Repository
Original Author: Nathan Osman
Original Plugin URL: GitHub Repository

Troubleshooting

Make sure plugins/spfstatus/spfstatus.php is present and readable.
Ensure the plugin directory name is exactly spfstatus (case-sensitive).
Check Roundcube logs (logs/errors.log) for plugin loading errors.

texxasrulez / spfstatus

Maintainers

Details