{"id":25140954,"url":"https://github.com/digitalist-open-cloud/matomo-plugin-bottracker","last_synced_at":"2026-02-17T03:08:21.038Z","repository":{"id":229183608,"uuid":"728139823","full_name":"Digitalist-Open-Cloud/Matomo-Plugin-BotTracker","owner":"Digitalist-Open-Cloud","description":"Matomo plugin for tracking bots","archived":false,"fork":false,"pushed_at":"2024-12-16T12:08:22.000Z","size":747,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"5.x-dev","last_synced_at":"2025-04-24T05:45:30.206Z","etag":null,"topics":["bots","matomo","matomo-plugin","matomo-tracking"],"latest_commit_sha":null,"homepage":"https://digitalist.cloud/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Digitalist-Open-Cloud.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-06T10:09:22.000Z","updated_at":"2024-12-16T12:08:05.000Z","dependencies_parsed_at":"2024-03-25T15:16:54.623Z","dependency_job_id":"d70d6980-e875-4525-bc0d-617494209b75","html_url":"https://github.com/Digitalist-Open-Cloud/Matomo-Plugin-BotTracker","commit_stats":null,"previous_names":["digitalist-se/bottracker","digitalist-open-cloud/matomo-plugin-bottracker"],"tags_count":54,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Digitalist-Open-Cloud%2FMatomo-Plugin-BotTracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Digitalist-Open-Cloud%2FMatomo-Plugin-BotTracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Digitalist-Open-Cloud%2FMatomo-Plugin-BotTracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Digitalist-Open-Cloud%2FMatomo-Plugin-BotTracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Digitalist-Open-Cloud","download_url":"https://codeload.github.com/Digitalist-Open-Cloud/Matomo-Plugin-BotTracker/tar.gz/refs/heads/5.x-dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250573301,"owners_count":21452343,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bots","matomo","matomo-plugin","matomo-tracking"],"created_at":"2025-02-08T18:16:05.249Z","updated_at":"2026-02-17T03:08:21.005Z","avatar_url":"https://github.com/Digitalist-Open-Cloud.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Matomo Bot Tracker Plugin\n\nAre 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.\n\n## Description\n\nBot 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).\n\nMany 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.\n\n### How it works\n\nThe 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.\n\nIf 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.\n\nYou can add/delete/modify the keywords in Administration -\u003e Bot Tracker -\u003e Configuration.\n\n### Track bots identified with Device Detector\n\nAs additional tracking of bots, you can collect the bots identified with Matomos Device Detector, either with activating the setting in Administration -\u003e General settings -\u003e Bot Tracker, or with setting this in `config.ini.php`:\n\n```php\n[BotTracker]\ntrack_device_detector_bots = 1\n```\n\nThis is for collecting data for identified bots user agents, which you could use for setting up more in detail tracking with Bot Tracker.\n\n### Installation / Update\n\nSee \u003chttps://matomo.org/faq/plugins/faq_21/\u003e\n\n### Sources of information for Bots, Crawlers, Scrapers etc\n\n* \u003chttps://raw.githubusercontent.com/monperrus/crawler-user-agents/master/crawler-user-agents.json\u003e\n* \u003chttps://radar.cloudflare.com/traffic/verified-bots\u003e\n* \u003chttps://darkvisitors.com/\u003e\n* \u003chttps://badbot.org/\u003e\n* \u003chttps://udger.com/resources/ua-list/crawlers\u003e\n\n## Import logs with Log Analytics\n\nMatomo 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 \u003c import_logs.patch` and bots are handled with the Bot Tracker plugin.\n\nThen you can run copy the logs to your Matomo instance and run something like:\n\n```bash\npython 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\n```\n\nFor documentation for Log Analytics, see the [documentation page](https://matomo.org/guide/tracking-data/import-server-logs/).\n\n## License\n\nGPL v3 / fair use\n\n## Matomo Plugins by Digitalist Open Tech\n\nThis 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.\n\nFor more information about plugins provided by Digitalist, see [our plugin page](https://github.com/digitalist-se/MatomoPlugins).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalist-open-cloud%2Fmatomo-plugin-bottracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdigitalist-open-cloud%2Fmatomo-plugin-bottracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdigitalist-open-cloud%2Fmatomo-plugin-bottracker/lists"}