PHPackages                             mauricerenck/darkvisitors - 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. [Security](/categories/security)
4. /
5. mauricerenck/darkvisitors

ActiveKirby-plugin[Security](/categories/security)

mauricerenck/darkvisitors
=========================

Kirby robots.txt plugin for blocking AI Crawlers and Bots

1.2.0(3mo ago)18351MITPHPPHP >=8.0.0CI passing

Since Apr 18Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/mauricerenck/dark-visitors)[ Packagist](https://packagist.org/packages/mauricerenck/darkvisitors)[ Docs](https://github.com/mauricerenck/dark-visitors)[ RSS](/packages/mauricerenck-darkvisitors/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (4)Versions (8)Used By (0)

Dark Visitors
=============

[](#dark-visitors)

Dark Visitors is a plugin for Kirby that blocks unwanted AI Crawlers from your website using robots.txt. It uses the Dark Visitors API to identify and block unwanted visitors.

It also allows you to add custom rules and your sitemaps to your robots.txt file.

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

[](#installation)

```
composer require mauricerenck/darkvisitors
```

Or download the [latest release](https://github.com/mauricerenck/dark-visitors/releases) unzip it, copy it to `site/plugins/dark-visitors`

Get the access token
--------------------

[](#get-the-access-token)

You need a Dark Visitors access token to use this plugin. Go to  create an account and your own Project. Open your project and get your access token under settings.

Usage
-----

[](#usage)

Edit your `config.php` and add the following line:

```
'mauricerenck.dark-visitors.token' => 'YOUR TOKEN'
```

### AI crawlers

[](#ai-crawlers)

Set which types of AI crawlers you want to block:

```
'mauricerenck.dark-visitors.aiTypes' => ['AI Assistant', 'AI Data Scraper', 'AI Search Crawler'],
```

### Your custom rules

[](#your-custom-rules)

Add your custom rules to the robots.txt file:

```
'mauricerenck.dark-visitors.agents' => [
    [
        'userAgents' => ['Googlebot', 'Bingbot'],
        'disallow' => ['/admin'],
    ],
    [
        'userAgents' => ['Bingbot'],
        'allow' => ['/microsoft'],
    ],
],
```

Setting your custom rules will overwrite the default rules, which are:

```
[
    'userAgents' => ['*'],
    'disallow' => ['/kirby', '/site'],
];
```

### Sitemaps

[](#sitemaps)

Add your sitemaps to the robots.txt file:

```
'mauricerenck.dark-visitors.sitemaps' => [
    'Sitemap: https://your-site.tld/sitemap.xml',
    'Sitemap: https://your-site.tld/sitemap2.xml',
],
```

### Tracking/Analytics

[](#trackinganalytics)

Darkvisitors offers a tracking feature. If you want to use it, you can enable it in the config:

```
'mauricerenck.dark-visitors.analytics' => true,
```

Learn more about robots.txt and AI crawlers
-------------------------------------------

[](#learn-more-about-robotstxt-and-ai-crawlers)

- [Google: Robots.txt specifications](https://developers.google.com/search/docs/advanced/robots/robots_txt)
- [Dark Visitors](https://darkvisitors.com/)

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance82

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% 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 ~110 days

Recently: every ~151 days

Total

7

Last Release

90d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8c32f99b4b10b42606a03bbba5c823565b96a6a580a527bb9a6a1fc27aa8bda1?d=identicon)[mauricerenck](/maintainers/mauricerenck)

---

Top Contributors

[![mauricerenck](https://avatars.githubusercontent.com/u/964547?v=4)](https://github.com/mauricerenck "mauricerenck (14 commits)")[![semantic-release-bot](https://avatars.githubusercontent.com/u/32174276?v=4)](https://github.com/semantic-release-bot "semantic-release-bot (7 commits)")

---

Tags

aikirbykirby-5kirby-cmskirby4kirby5privacy

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mauricerenck-darkvisitors/health.svg)

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

###  Alternatives

[defuse/php-encryption

Secure PHP Encryption Library

3.9k162.4M212](/packages/defuse-php-encryption)[roave/security-advisories

Prevents installation of composer packages with known security vulnerabilities: no API, simply require it

2.9k97.3M6.4k](/packages/roave-security-advisories)[mews/purifier

Laravel 5/6/7/8/9/10 HtmlPurifier Package

2.0k16.7M112](/packages/mews-purifier)[robrichards/xmlseclibs

A PHP library for XML Security

41278.1M118](/packages/robrichards-xmlseclibs)[bjeavons/zxcvbn-php

Realistic password strength estimation PHP library based on Zxcvbn JS

86917.5M63](/packages/bjeavons-zxcvbn-php)[illuminate/encryption

The Illuminate Encryption package.

9229.7M278](/packages/illuminate-encryption)

PHPackages © 2026

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