PHPackages thedigitalembassy/adeptus - 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. [Utility & Helpers](/categories/utility) 4. / 5. thedigitalembassy/adeptus ActiveWordpress-plugin[Utility & Helpers](/categories/utility) thedigitalembassy/adeptus ========================= Wordpress activity log plugin v1.1.5(5y ago)105.2k4GPL-3.0-onlyPHPPHP >=5.3.0 Since Feb 6Pushed 5y ago3 watchersCompare [ Source](https://github.com/thedigitalembassy/adeptus)[ Packagist](https://packagist.org/packages/thedigitalembassy/adeptus)[ Docs](https://www.thedigitalembassy.co/)[ RSS](/packages/thedigitalembassy-adeptus/feed)WikiDiscussions master Synced 2w ago READMEChangelog (3)Dependencies (2)Versions (9)Used By (0) [![Adeptus Banner](https://github.com/thedigitalembassy/adeptus/raw/master/assets/banner-772x250.png)](https://github.com/thedigitalembassy/adeptus/raw/master/assets/banner-772x250.png) Introduction ------------ [](#introduction) Adeptus is a lightweight plugin that allows you to send WordPress website logs to syslog, logstash, debug.log and error\_log for you to collect, store, process and monitor your logs seamlessly. With Adeptus you have the ability to: - Monitor all website and CMS activity in real time - Audit stored logs information for security and debuggin purposes - Visualize log data in 3rd party apps (Grafana, Kibana, etc..) - Quickly generate reports in 3rd party apps Built-In Events --------------- [](#built-in-events) Attachments ``` Created Updated Deleted/Trashed ``` Core ``` Wordpress updated ``` Menus ``` Created Deleted Menu item added/update/moved/deleted ``` Options ``` Option changes ``` Plugins ``` Installed (covered by plugin activation) Activated/Deactivated Updated Deleted (covered by plugin deactivation) ``` Themes ``` Activated/Deactivated Updated ``` Posts (inc. all custom post types) ``` Created Updated Deleted/Trashed Published ``` Taxonomies ``` Category created Category moved Category updated Category deleted ``` Users ``` Login Logout Profile updated Password changed Password reset Role updated Created Deleted/Trashed ``` Fatal PHP Errors/Exceptions ``` Ability to disable logging per request (e.g. during imports) ``` Comments ``` Created Change Status (Spam/Deleted/Trashed) ``` Widgets (Options) ``` Added Updated Removed ``` WooCommerce ``` Woocommerce Options Add / Edit / Delete Product Update Product Variation Ppdate Product Attribute ``` Other Options ``` ACF options page(s) (i.e. global content) Yoast (settings changes) ``` Custom Events ------------- [](#custom-events) Sometimes we need to run some custom events (i.e. running cronjobs or importing some data) which contains thousand of events or db updates. To prevent storing to many logs on the server, it's better to ignore the events caused by the custom script. Enable/Disable Logging in Custom Events --------------------------------------- [](#enabledisable-logging-in-custom-events) To disable and enable logging in custom events such as importing scripts wrap the script you don't want to be logged between following function calls: ``` \Adeptus::disableLogging(); // your code here... \Adeptus::enableLogging(); ``` In this case the events between these 2 lines won't be logged. ### Example [](#example) ``` function do_import() { \Adeptus::logEvent([ 'alert_code' => 20080, 'alert_level' => \Psr\Log\LogLevel::INFO, 'alert_title' => 'Import Started', 'alert_description' => 'Import Started', 'sensor' => 'ImportExample' ]); \Adeptus::disableLogging(); // Perform import update_option('blogname',rand()); \Adeptus::enableLogging(); \Adeptus::logEvent([ 'alert_code' => 20080, 'alert_level' => \Psr\Log\LogLevel::INFO, 'alert_title' => 'Import Finished', 'alert_description' => 'Imported 100 items successfully', 'sensor' => 'ImportExample' ]); } ``` Hooks ----- [](#hooks) adeptus/activate \[Action\] ``` Trigger when plugin activates. ``` adeptus/loggers \[Action\] ``` Allows registration of custom loggers. ``` ``` class MyLogger implements \Psr\Log\LoggerInterface { //... } add_action('adeptus/loggers', function($alert_manager) { $logger = new MyLogger(); $alert_manager->setLogger($logger); }); ``` adeptus/sensors \[Filter\] ``` Allows filtering of sensors and/or registration of additional sensors which provide loggable events. ``` adeptus/alert\_manager/alert\_title \[Filter\] ``` Allows filtering of the alert title. ``` adeptus/alert\_manager/alert\_level \[Filter\] ``` Allows filtering of the alert level. ``` adeptus/alert\_manager/context \[Filter\] ``` Allows filtering of the alert context. ``` adeptus/alert\_manager/loggers \[Filter\] ``` Allows filtering of the loggers when an event is triggered. ``` adeptus/sensors/options/whitelist \[Filter\] ``` This filter is in OptionsSensor and includes a list of most important options to log. ``` adeptus/sensors/options/woocommerce\_blacklist \[Filter\] ``` Blacklisted WooCommerce options to be ignored. ``` Enable/Disable Logging Globally ------------------------------- [](#enabledisable-logging-globally) To enable logging across entire website add the following line in .env file: `define('WP_ADEPTUS_LOGGING_DISABLED', true);` ### Health Score 34 — LowBetter than 75% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity27 Limited adoption so far Community14 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 50% 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 ~106 days Recently: every ~185 days Total 8 Last Release 1954d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/47308327?v=4)[The Digital Embassy](/maintainers/thedigitalembassy)[@thedigitalembassy](https://github.com/thedigitalembassy) --- Top Contributors [![killgallic](https://avatars.githubusercontent.com/u/532955?v=4)](https://github.com/killgallic "killgallic (2 commits)")[![aslakr](https://avatars.githubusercontent.com/u/80737?v=4)](https://github.com/aslakr "aslakr (1 commits)")[![Chaddles23](https://avatars.githubusercontent.com/u/9097402?v=4)](https://github.com/Chaddles23 "Chaddles23 (1 commits)") --- Tags audit-loglogstashwordpress-pluginwordpress ### Embed Badge ![Health badge](/badges/thedigitalembassy-adeptus/health.svg) ``` [![Health](https://phpackages.com/badges/thedigitalembassy-adeptus/health.svg)](https://phpackages.com/packages/thedigitalembassy-adeptus) ``` ### Alternatives [roots/bedrock WordPress boilerplate with Composer, easier configuration, and an improved folder structure 6.5k456.5k2](/packages/roots-bedrock)[helsingborg-stad/municipio A bootstrap theme for creating municipality sites. 4028.3k10](/packages/helsingborg-stad-municipio)[ecotone/ecotone Enterprise architecture layer for Laravel and Symfony — CQRS, Event Sourcing, Durable Workflows (Sagas, Orchestrators), Projections, and Outbox messaging via PHP attributes. 562565.8k42](/packages/ecotone-ecotone)[roots/wp-stage-switcher WordPress plugin that allows you to switch between different environments from the admin bar 374458.3k3](/packages/roots-wp-stage-switcher)[vinkla/wordplate The WordPlate boilerplate 2.2k5.3k](/packages/vinkla-wordplate) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)