PHPackages                             texxasrulez/spfstatus - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail &amp; Notifications](/categories/mail)
4. /
5. texxasrulez/spfstatus

ActiveRoundcube-plugin[Mail &amp; Notifications](/categories/mail)

texxasrulez/spfstatus
=====================

Roundcube plugin that displays SPF status for messages

1.0(10mo ago)298↓12.5%MITPHPPHP &gt;=7.4

Since Aug 21Pushed 10mo agoCompare

[ Source](https://github.com/texxasrulez/spfstatus)[ Packagist](https://packagist.org/packages/texxasrulez/spfstatus)[ Docs](https://github.com/texxasrulez/spfstatus)[ RSS](/packages/texxasrulez-spfstatus/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

Roundcube SPF Status Plugin
===========================

[](#roundcube-spf-status-plugin)

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
--------

[](#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
------------

[](#installation)

### 1. Install via Composer (recommended)

[](#1-install-via-composer-recommended)

In your Roundcube installation directory, run:

```
composer require texxasrulez/spfstatus
```

Thanks to [`composer/installers`](https://github.com/composer/installers) and the `"type": "roundcube-plugin"` declaration, the plugin will be installed into:

```
plugins/spfstatus/

```

### 2. Manual installation (fallback)

[](#2-manual-installation-fallback)

1. Download the plugin archive.
2. 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
-------------------

[](#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
------------

[](#requirements)

- PHP &gt;= 7.4
- Roundcube Mail &gt;= 1.4 (tested)
- Composer (if installing via Composer)

---

Uninstallation
--------------

[](#uninstallation)

If installed via Composer:

```
composer remove texxasrulez/spfstatus
```

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

---

License
-------

[](#license)

MIT License

---

Credits
-------

[](#credits)

- **Author:** Gene Hawkins
- **Original Plugin URL:** [GitHub Repository](https://github.com/texxasrulez/spfstatus)
- **Original Author:** Nathan Osman
- **Original Plugin URL:** [GitHub Repository](https://github.com/texxasrulez/spfstatus)

---

Troubleshooting
---------------

[](#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.

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance55

Moderate activity, may be stable

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

317d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/95c3af6e41a9786e8be2edb48176e43a7d1ddef429793a312168450ff4269deb?d=identicon)[texxasrulez](/maintainers/texxasrulez)

---

Top Contributors

[![texxasrulez](https://avatars.githubusercontent.com/u/10519182?v=4)](https://github.com/texxasrulez "texxasrulez (2 commits)")

---

Tags

pluginemailroundcubestatusspf

### Embed Badge

![Health badge](/badges/texxasrulez-spfstatus/health.svg)

```
[![Health](https://phpackages.com/badges/texxasrulez-spfstatus/health.svg)](https://phpackages.com/packages/texxasrulez-spfstatus)
```

###  Alternatives

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.5k10](/packages/helsingborg-stad-municipio)[mlocati/spf-lib

Parse, build and validate SPF (Sender Policy Framework) DNS records

68955.6k5](/packages/mlocati-spf-lib)[railsware/mailtrap-php

The Mailtrap SDK provides methods for all API functions.

60929.1k](/packages/railsware-mailtrap-php)[mika56/spfcheck

Checks an IP address against a domain's SPF record

451.1M7](/packages/mika56-spfcheck)[etailors/mautic-amazon-ses

Amazon SES Mailer Plugin for Mautic

574.2k](/packages/etailors-mautic-amazon-ses)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
