PHPackages                             stklcode/statify-blacklist - 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. [Search & Filtering](/categories/search)
4. /
5. stklcode/statify-blacklist

ActiveWordpress-plugin[Search & Filtering](/categories/search)

stklcode/statify-blacklist
==========================

A filter extension for the famous Statify WordPress plugin

1.7.2(1y ago)2102[4 issues](https://github.com/stklcode/statify-blacklist/issues)GPL-2.0-or-laterPHPPHP >=5.5CI passing

Since Jul 16Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/stklcode/statify-blacklist)[ Packagist](https://packagist.org/packages/stklcode/statify-blacklist)[ RSS](/packages/stklcode-statify-blacklist/feed)WikiDiscussions develop Synced 3d ago

READMEChangelog (10)Dependencies (8)Versions (16)Used By (0)

[![CI](https://github.com/stklcode/statify-blacklist/actions/workflows/test.yml/badge.svg?branch=stable)](https://github.com/stklcode/statify-blacklist/actions/workflows/test.yml)[![Quality Gate Status](https://camo.githubusercontent.com/b1f7813ec25af6c2274f96c5971a26aeadaa9fc6b6d4617076c71d9125c188bb/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d73746b6c636f6465253341737461746966792d626c61636b6c697374266d65747269633d616c6572745f737461747573)](https://sonarcloud.io/summary/new_code?id=stklcode%3Astatify-blacklist)[![Packagist Version](https://camo.githubusercontent.com/2f4268eb94ded671fdb379a9685fdfaebbb8180b71e0ec523ced872969a6d5cd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73746b6c636f64652f737461746966792d626c61636b6c697374)](https://packagist.org/packages/stklcode/statify-blacklist)[![License](https://camo.githubusercontent.com/96d15d321494cdc76604587048f657acb4acf33ce7b6b0621085f33bdfebde26/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c25323076322d626c75652e737667)](https://github.com/stklcode/statify-blacklist/blob/stable/LICENSE.md)

Statify Filter
==============

[](#statify-filter)

- Contributors: stklcode
- Requires at least: 5.1
- Tested up to: 6.9
- Requires PHP: 7.4
- Stable tag: 1.7.2
- License: GPLv2 or later
- License URI:

Filter extension for the famous Statify WordPress plugin.

Description
-----------

[](#description)

A filter extension for the famous [Statify](https://wordpress.org/plugins/statify/) WordPress plugin.

This plugin adds customizable filters to Statify to allow blocking of referer spam or internal interactions.

### Features

[](#features)

#### Referer Filter

[](#referer-filter)

Add a list of domains (for simplicity only second-level, e.g. *example.com* which blocks *everything.example.com*).

#### Target Filter

[](#target-filter)

Add a list of target pages (e.g. */test/page/*, */?page\_id=123*) that will be excluded from tracking.

#### IP Filter

[](#ip-filter)

Add a list of IP addresses or subnets (e.g. *192.0.2.123*, *198.51.100.0/24*, *2001:db8:a0b:12f0::/64*).

#### User Agent Filter

[](#user-agent-filter)

Add a list of (partial) user agent strings to exclude (e.g. *curl*, *my/bot*, *Firefox*).

#### CleanUp Database

[](#cleanup-database)

Filters can be applied to data stored in database after modifying filter rules or for one-time clean-up.

#### Compatibility

[](#compatibility)

This plugin requires Statify to be installed. The extension has been tested with Statify up to version 1.8 The plugin is capable of handling multisite installations.

### Support & Contributions

[](#support--contributions)

- If you experience any issues, use the [support forums](https://wordpress.org/support/plugin/statify-blacklist).
- Latest sources and development are handled on [GitHub](https://github.com/stklcode/statify-blacklist). You might contribute there or file an issue for code related bugs.
- If you want to translate this plugin you can do this on [WordPress Translate](https://translate.wordpress.org/projects/wp-plugins/statify-blacklist).

### Credits

[](#credits)

- Author: Stefan Kalscheuer
- Special Thanks to [pluginkollektiv](https://pluginkollektiv.org/) for maintaining *Statify*

Installation
------------

[](#installation)

- If you don’t know how to install a plugin for WordPress, [here’s how](https://wordpress.org/support/article/managing-plugins/#installing-plugins).
- Make sure *Statify* plugin is installed and active
- Goto *Settings* -> *Statify Filter* to configure the plugin

### Requirements

[](#requirements)

- PHP 7.4 or above
- WordPress 5.1 or above
- *Statify* plugin installed and activated (1.5 or above)

Frequently Asked Questions
--------------------------

[](#frequently-asked-questions)

### What is blocked by default?

[](#what-is-blocked-by-default)

Nothing. By default, all filters are empty and disabled. They can and have to be filled by the blog administrator.

A default filter is not provided, as the plugin itself is totally neutral. If you want to filter out referer spam, visitors from search engines, just "false" referrers from 301 redirects or you own IP address used for testing only depends on you.

### Does the filter effect user experience?

[](#does-the-filter-effect-user-experience)

No. It only prevents *Statify* from tracking, nothing more or less.

### Does live filtering impact performance?

[](#does-live-filtering-impact-performance)

Yes, but probably not noticeable. Checking a single referer string against a (usually small) list should be negligible compared to the total loading procedure. If this still is an issue for you, consider deactivating the filter and only run the one-time-cleanup or activate the cron job.

### Is any personal data collected?

[](#is-any-personal-data-collected)

No. The privacy policy of *Statify* is untouched. Data is only processed, not stored or exposed to anyone.

### Are regular expression filters possible?

[](#are-regular-expression-filters-possible)

Yes, it is. Just select regular expressions (case-sensitive or insensitive) as matching method instead of exact or keyword match.

### Why is IP and User Agent filtering only available as live filter?

[](#why-is-ip-and-user-agent-filtering-only-available-as-live-filter)

As you might know, *Statify* does not store any personal information, including IP addresses in the database. Because of this, these filters can only be applied while processing the request and not afterwards.

### Can whole IP subnet be blocked?

[](#can-whole-ip-subnet-be-blocked)

Yes. The plugin features subnet filters using CIDR notation. For example *198.51.100.0/24* filters all sources from *198.51.100.1* to *198.51.100.254*. Same for IPv6 prefixes like *2001:db8:a0b:12f0::/64*.

Screenshots
-----------

[](#screenshots)

1. Statify Filter settings page

Upgrade Notice
--------------

[](#upgrade-notice)

### 1.7.2

[](#172)

This is a bugfix release to restore the manual cleanup function that was broken since 1.7.0.

### 1.7.1

[](#171)

This is a service release with minor corrections. Recommended for all users. Tested up to 6.5.

### 1.7.0

[](#170)

This is a service release with primarily internal rework. Tested up to 6.4 and PHP 8.3.

Changelog
---------

[](#changelog)

### 1.7.2 / 06.06.2024

[](#172--06062024)

- Restore manual database cleanup functionality

### 1.7.1 / 24.03.2024

[](#171--24032024)

- Fix HTML syntax for checkboxes on settings page
- Simplify some internal control structures
- Add plugin dependency to Statify
- Declared compatibility with WordPress 6.5

### 1.7.0 / 11.03.2024

[](#170--11032024)

- Internal rework of plugin settings
- Make the IP filter list unique
- Fix options upgrade routine
- Declared compatibility with WordPress 6.4

### 1.6.3 / 14.08.2023

[](#163--14082023)

- Minor internal code cleanup
- Declared compatibility with WordPress 6.3

### 1.6.2 / 25.02.2023

[](#162--25022023)

- Always process IPv6 addresses lowercase
- Optimize internally used regular expression
- Minor adjustments to prevent warnings during user agent filtering with PHP 8.2

### 1.6.1 / 28.05.2021

[](#161--28052021)

- Fix storage of user agent filter list (#28, props @BananaSquishee)

### 1.6.0 / 09.12.2020

[](#160--09122020)

Plugin renamed to *Statify Filter*.

- Minor accessibility fixes on settings page
- Introduced new user agent filter (#20)
- Declared compatibility with WordPress 5.6

### 1.5.2 / 03.09.2020

[](#152--03092020)

- Minor translation updates
- Declared compatibility with WordPress 5.5

### 1.5.1 / 20.05.2020

[](#151--20052020)

- Fix initialization on AJAX calls for *Statify* 1.7 compatibility (#22)

### 1.5.0 / 13.05.2020

[](#150--13052020)

- Minimum required WordPress version is 4.7
- Removed `load_plugin_textdomain()` and `Domain Path` header
- Added automatic compatibility check for WP and PHP version (#17)
- Added keyword filter mode for referer blacklist (#15)
- Layout adjustments on settings page
- Regular expression filters are validated before saving (#13)

### 1.4.4 / 19.05.2018

[](#144--19052018)

- Fix live filter chain when regular expressions are active (#12)

### 1.4.3 / 09.01.2018

[](#143--09012018)

- Fix issues with multisite installation (#11)

### 1.4.2 / 12.11.2017

[](#142--12112017)

- Minor code fixes

### 1.4.1 / 16.07.2017

[](#141--16072017)

- Relicensed to GPLv2 or later
- Fix filter hook if referer is disabled (#9)
- Fix problem with faulty IPv6 netmask in IP blacklist
- Minor changes for WP Coding Standard
- Minimum required WordPress version is 4.4 (#10)

### 1.4.0 / 10.06.2017

[](#140--10062017)

- IP blacklist implemented (#7)
- Target page blacklist implemented (#8)
- Internal configuration restructured (upgrade on plugin activation)
- Statify hook name changed to `statify__skip_tracking` (as of Statify 1.5.0)

### 1.3.1 / 09.12.2016

[](#131--09122016)

- Continue filtering if no filter applies (#6)

### 1.3.0 / 17.10.2016

[](#130--17102016)

- Regular expressions filtering implemented

### 1.2.1 / 10.10.2016

[](#121--10102016)

- Fix live filter configuration check

### 1.2.0 / 29.08.2016

[](#120--29082016)

- Switched from `in_array()` to faster `isset()` for referer checking
- Optional cron execution implemented

### 1.1.2 / 17.08.2016

[](#112--17082016)

- Prepared for localization

### 1.1.1 / 16.08.2016

[](#111--16082016)

- Some security fixes

### 1.1.0 / 15.08.2016

[](#110--15082016)

- One-time execution on database

### 1.0.0 / 14.08.2016

[](#100--14082016)

- First release

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance45

Moderate activity, may be stable

Popularity9

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 99.1% 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

Every ~193 days

Recently: every ~117 days

Total

14

Last Release

708d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c478b1fbd4d0b7091bc822fab04fdc7749103ffba8eceb8a4b16d26c97f05cfb?d=identicon)[stklcode](/maintainers/stklcode)

---

Top Contributors

[![stklcode](https://avatars.githubusercontent.com/u/12963621?v=4)](https://github.com/stklcode "stklcode (216 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![rodrigoprimo](https://avatars.githubusercontent.com/u/77215?v=4)](https://github.com/rodrigoprimo "rodrigoprimo (1 commits)")

---

Tags

blacklist-extensionfilterreferrer-spamstatifywordpress-pluginpluginwordpressfilterstatistics

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/stklcode-statify-blacklist/health.svg)

```
[![Health](https://phpackages.com/badges/stklcode-statify-blacklist/health.svg)](https://phpackages.com/packages/stklcode-statify-blacklist)
```

###  Alternatives

[10up/elasticpress

Supercharge WordPress with Elasticsearch.

1.3k374.3k6](/packages/10up-elasticpress)[webdevstudios/cmb2-post-search-field

Custom field for CMB2 which adds a post-search dialog for searching/attaching other post IDs.

6647.7k2](/packages/webdevstudios-cmb2-post-search-field)[millat/laravel-hooks

The WordPress filter, action system in Laravel

5715.1k](/packages/millat-laravel-hooks)[10up/debug-bar-elasticpress

Extends the Debug Bar plugin for usage with ElasticPress

2917.0k](/packages/10up-debug-bar-elasticpress)[mitogh/katana

Filters to control where the size of images are generated.

204.4k](/packages/mitogh-katana)[codewithdennis/filament-price-filter

A simple and customizable price filter for FilamentPHP, allowing users to easily refine results based on specified price ranges.

163.2k](/packages/codewithdennis-filament-price-filter)

PHPackages © 2026

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