PHPackages digitalist-open-cloud/matomo-bot-tracker - 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. digitalist-open-cloud/matomo-bot-tracker ActiveMatomo-plugin digitalist-open-cloud/matomo-bot-tracker ======================================== Bot Tracker for Matomo 5.2.18(1y ago)091[1 issues](https://github.com/Digitalist-Open-Cloud/Matomo-Plugin-BotTracker/issues)[1 PRs](https://github.com/Digitalist-Open-Cloud/Matomo-Plugin-BotTracker/pulls)LGPL-3.0-or-laterPHPCI failing Since Nov 28Pushed 1y ago2 watchersCompare [ Source](https://github.com/Digitalist-Open-Cloud/Matomo-Plugin-BotTracker)[ Packagist](https://packagist.org/packages/digitalist-open-cloud/matomo-bot-tracker)[ RSS](/packages/digitalist-open-cloud-matomo-bot-tracker/feed)WikiDiscussions 5.x-dev Synced 1mo ago READMEChangelog (8)Dependencies (11)Versions (27)Used By (0) Matomo Bot Tracker Plugin ========================= [](#matomo-bot-tracker-plugin) Are you tracking data full of bots? That traffic is normally not useful for you, it is just clutter. Bot Tracker removes those visits from your normal data, and also provide separate reports so you could see which bots are visiting your site. With Matomo and Bot Tracker you have insight in Bot Traffic on your site. Description ----------- [](#description) Bot Tracker is a plugin to *exclude* and separately *track* the visits of Bots, Spiders and Web Crawlers, that hit your site. Because Matomo doesn't store the user agent, Bot Tracker will only be able to track new bots from the moment you add them to its list forward (retroactive tracking isn't possible). Many web crawlers, spiders and bots don't load the images in a page and don't execute JavaScript. So you cannot track them with Matomo if you don't use the PHP-API. The Bot Tracker can only track those that were caught by Matomo itself. With that said, many crawlers today are using headless browsers, and they do execute JavaScript. ### How it works [](#how-it-works) The plugin scans the user agent of any incoming visit for specific keywords. If the keyword is found, the visit is excluded from the normal log and logged separately in Bot Tracker reports. If you enable the "extra stats" for a bot entry, you will get more in depth data about the Bots visit, and you will get this in the widget Bot Tracker: Extra stats. You can add/delete/modify the keywords in Administration -> Bot Tracker -> Configuration. ### Track bots identified with Device Detector [](#track-bots-identified-with-device-detector) As additional tracking of bots, you can collect the bots identified with Matomos Device Detector, either with activating the setting in Administration -> General settings -> Bot Tracker, or with setting this in `config.ini.php`: ``` [BotTracker] track_device_detector_bots = 1 ``` This is for collecting data for identified bots user agents, which you could use for setting up more in detail tracking with Bot Tracker. ### Installation / Update [](#installation--update) See [https://matomo.org/faq/plugins/faq\_21/](https://matomo.org/faq/plugins/faq_21/) ### Sources of information for Bots, Crawlers, Scrapers etc [](#sources-of-information-for-bots-crawlers-scrapers-etc) - - - - - Import logs with Log Analytics ------------------------------ [](#import-logs-with-log-analytics) Matomo normally ships with a python scripts for importing server logs when you can't track visitors with injecting javascript on a website, `import_logs.py`. With the patch shipped with this plugin in the folder `patches` you can use Bot Tracker as normal also with imported logs. Just copy the patch to `misc/log-analytics` and run `patch -p1 < import_logs.patch` and bots are handled with the Bot Tracker plugin. Then you can run copy the logs to your Matomo instance and run something like: ``` python misc/log-analytics/import_logs.py --url=https://my-matomo-instance.org --idsite=1 --recorders=8 --enable-http-errors --enable-http-redirects --enable-static --enable-bots localhost.access_log ``` For documentation for Log Analytics, see the [documentation page](https://matomo.org/guide/tracking-data/import-server-logs/). License ------- [](#license) GPL v3 / fair use Matomo Plugins by Digitalist Open Tech -------------------------------------- [](#matomo-plugins-by-digitalist-open-tech) This plugin was created by [Thomas--F](https://github.com/Thomas--F) and was taken over by Digitalist as part of contributing back with Matomo 5 upgrades. For more information about plugins provided by Digitalist, see [our plugin page](https://github.com/digitalist-se/MatomoPlugins). ### Health Score 30 — LowBetter than 64% of packages Maintenance40 Moderate activity, may be stable Popularity5 Limited adoption so far Community19 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 55% 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 ~15 days Recently: every ~33 days Total 22 Last Release 579d ago Major Versions v3.00 → 5.0.02023-12-07 ### Community Maintainers ![](https://www.gravatar.com/avatar/ab5d6537b6884dea5af31eebe7d0a19554b2810a2f1e0034ba2f6349182152b8?d=identicon)[se.support](/maintainers/se.support) --- Top Contributors [![Thomas--F](https://avatars.githubusercontent.com/u/3939601?v=4)](https://github.com/Thomas--F "Thomas--F (221 commits)")[![mikkeschiren](https://avatars.githubusercontent.com/u/712838?v=4)](https://github.com/mikkeschiren "mikkeschiren (83 commits)")[![weblate](https://avatars.githubusercontent.com/u/1607653?v=4)](https://github.com/weblate "weblate (74 commits)")[![dandv](https://avatars.githubusercontent.com/u/33569?v=4)](https://github.com/dandv "dandv (6 commits)")[![tsteur](https://avatars.githubusercontent.com/u/273120?v=4)](https://github.com/tsteur "tsteur (4 commits)")[![ghveem](https://avatars.githubusercontent.com/u/370678?v=4)](https://github.com/ghveem "ghveem (3 commits)")[![sgiehl](https://avatars.githubusercontent.com/u/1579355?v=4)](https://github.com/sgiehl "sgiehl (2 commits)")[![Findus23](https://avatars.githubusercontent.com/u/6266037?v=4)](https://github.com/Findus23 "Findus23 (2 commits)")[![fratac](https://avatars.githubusercontent.com/u/1576690?v=4)](https://github.com/fratac "fratac (2 commits)")[![ercpe](https://avatars.githubusercontent.com/u/1290183?v=4)](https://github.com/ercpe "ercpe (1 commits)")[![halfdan](https://avatars.githubusercontent.com/u/176576?v=4)](https://github.com/halfdan "halfdan (1 commits)")[![MichaIng](https://avatars.githubusercontent.com/u/28480705?v=4)](https://github.com/MichaIng "MichaIng (1 commits)")[![Firesphere](https://avatars.githubusercontent.com/u/680570?v=4)](https://github.com/Firesphere "Firesphere (1 commits)")[![reclaimingmytime](https://avatars.githubusercontent.com/u/35609464?v=4)](https://github.com/reclaimingmytime "reclaimingmytime (1 commits)") --- Tags botsmatomomatomo-pluginmatomo-tracking ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP\_CodeSniffer Type Coverage Yes ### Embed Badge ![Health badge](/badges/digitalist-open-cloud-matomo-bot-tracker/health.svg) ``` [![Health](https://phpackages.com/badges/digitalist-open-cloud-matomo-bot-tracker/health.svg)](https://phpackages.com/packages/digitalist-open-cloud-matomo-bot-tracker) ``` ### Alternatives [elgg/elgg Elgg is an award-winning social networking engine, delivering the building blocks that enable businesses, schools, universities and associations to create their own fully-featured social networks and applications. 1.7k15.7k4](/packages/elgg-elgg)[pressbooks/pressbooks Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS. 44643.1k1](/packages/pressbooks-pressbooks)[johnbillion/user-switching Instant switching between user accounts in WordPress and WooCommerce. 19768.3k2](/packages/johnbillion-user-switching)[rainlab/blog-plugin Blog plugin for October CMS 17257.7k](/packages/rainlab-blog-plugin)[rainlab/user-plugin User plugin for October CMS 11954.3k13](/packages/rainlab-user-plugin)[starcitizentools/citizen-skin A beautiful, usable, responsive MediaWiki skin with in-depth extension support. Originally developed for the Star Citizen Wiki. 3164.5k](/packages/starcitizentools-citizen-skin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)