{"id":250566,"date":"2025-09-04T20:24:24","date_gmt":"2025-09-04T20:24:24","guid":{"rendered":"https:\/\/en-gb.wordpress.org\/plugins\/fullworks-active-users-monitor\/"},"modified":"2025-09-17T20:12:25","modified_gmt":"2025-09-17T20:12:25","slug":"fullworks-active-users-monitor","status":"publish","type":"plugin","link":"https:\/\/hy.wordpress.org\/plugins\/fullworks-active-users-monitor\/","author":14422525,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.1.0","stable_tag":"1.1.0","tested":"6.8.5","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"Fullworks Active Users Monitor","header_author":"Fullworks","header_description":"Provides real-time visibility of logged-in users for administrators with visual indicators and filtering capabilities.","assets_banners_color":"2c73a1","last_updated":"2025-09-17 20:12:25","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/ko-fi.com\/wpalan","header_plugin_uri":"https:\/\/fullworks.net\/products\/active-users-monitor\/","header_author_uri":"https:\/\/fullworks.net\/","rating":2,"author_block_rating":0,"active_installs":40,"downloads":494,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"fullworks","date":"2025-09-04 20:23:55"},"1.0.1":{"tag":"1.0.1","author":"fullworks","date":"2025-09-04 20:58:03"},"1.1.0":{"tag":"1.1.0","author":"fullworks","date":"2025-09-17 20:12:25"}},"upgrade_notice":{"1.1.0":"<p>Major update: Adds comprehensive audit trail functionality to track all user login\/logout events with export capabilities. Requires WordPress 6.2 or higher.<\/p>","1.0.0":"<p>Initial release of Fullworks Active Users Monitor. Install to start monitoring your logged-in users in real-time.<\/p>"},"ratings":{"1":0,"2":1,"3":0,"4":0,"5":0},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3356322,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3356322,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3356322,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3356322,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3363510,"resolution":false,"location":"assets","locale":"","contents":"{\"landingPage\":\"\\\/wp-admin\\\/users.php\",\"preferredVersions\":{\"php\":\"7.4\",\"wp\":\"5.9\"},\"phpExtensionBundles\":[\"kitchen-sink\"],\"steps\":[{\"step\":\"login\",\"username\":\"admin\",\"password\":\"password\"},{\"step\":\"installPlugin\",\"pluginZipFile\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"fullworks-active-users-monitor\"},\"options\":{\"activate\":true}}]}"}},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3356333,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3356333,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3356333,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3356333,"resolution":"4","location":"assets","locale":""}},"screenshots":{"1":"Users list page showing highlighted online users with visual indicators","2":"Settings page giving control over who sees online status","3":"Dashboard widget displaying online users summary","4":"Admin bar dropdown showing online users count and role breakdown"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[178191,39231,5603,6229,1917],"plugin_category":[54],"plugin_contributors":[196325,79438],"plugin_business_model":[],"class_list":["post-250566","plugin","type-plugin","status-publish","hentry","plugin_tags-active-users","plugin_tags-admin-tools","plugin_tags-monitoring","plugin_tags-online-users","plugin_tags-users","plugin_category-security-and-spam-protection","plugin_contributors-alanfuller","plugin_contributors-fullworks","plugin_committers-alanfuller","plugin_committers-fullworks"],"banners":{"banner":"https:\/\/ps.w.org\/fullworks-active-users-monitor\/assets\/banner-772x250.png?rev=3356322","banner_2x":"https:\/\/ps.w.org\/fullworks-active-users-monitor\/assets\/banner-1544x500.png?rev=3356322","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/fullworks-active-users-monitor\/assets\/icon-128x128.png?rev=3356322","icon_2x":"https:\/\/ps.w.org\/fullworks-active-users-monitor\/assets\/icon-256x256.png?rev=3356322","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/fullworks-active-users-monitor\/assets\/screenshot-1.png?rev=3356333","caption":"Users list page showing highlighted online users with visual indicators"},{"src":"https:\/\/ps.w.org\/fullworks-active-users-monitor\/assets\/screenshot-2.png?rev=3356333","caption":"Settings page giving control over who sees online status"},{"src":"https:\/\/ps.w.org\/fullworks-active-users-monitor\/assets\/screenshot-3.png?rev=3356333","caption":"Dashboard widget displaying online users summary"},{"src":"https:\/\/ps.w.org\/fullworks-active-users-monitor\/assets\/screenshot-4.png?rev=3356333","caption":"Admin bar dropdown showing online users count and role breakdown"}],"raw_content":"<!--section=description-->\n<p><strong>Fullworks Active Users Monitor<\/strong> provides administrators with real-time visibility of logged-in users on your WordPress site. Using WordPress's native session tokens system, this plugin accurately tracks user login states and provides powerful monitoring tools.<\/p>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li><strong>Real-Time Tracking<\/strong> - Uses WordPress session tokens for accurate online\/offline status<\/li>\n<li><strong>Comprehensive Audit Trail<\/strong> - Track all login\/logout events with detailed logging<\/li>\n<li><strong>Admin Bar Widget<\/strong> - Quick overview of online users with role breakdown<\/li>\n<li><strong>Enhanced Users List<\/strong> - Visual indicators, status columns, and filtering options<\/li>\n<li><strong>Dashboard Widget<\/strong> - At-a-glance view of active users on your dashboard<\/li>\n<li><strong>Audit Log Export<\/strong> - Export user activity to CSV, JSON, or Excel formats<\/li>\n<li><strong>Auto-Refresh<\/strong> - Configurable automatic updates without page reload<\/li>\n<li><strong>Role-Based Display<\/strong> - Color-coded indicators for different user roles<\/li>\n<li><strong>WP-CLI Support<\/strong> - Command line tools for monitoring and management<\/li>\n<li><strong>Performance Optimized<\/strong> - Smart caching and efficient queries<\/li>\n<li><strong>Fully Translatable<\/strong> - Ready for localization<\/li>\n<\/ul>\n\n<h4>Visual Indicators<\/h4>\n\n<p>The plugin provides clear visual feedback for online users:<\/p>\n\n<ul>\n<li>Green status dots for online users<\/li>\n<li>Gold\/orange borders for administrators<\/li>\n<li>Color-coded role indicators<\/li>\n<li>Animated pulse effects (optional)<\/li>\n<li>\"ONLINE\" badges in user lists<\/li>\n<li>Last seen timestamps for offline users<\/li>\n<\/ul>\n\n<h4>Perfect For<\/h4>\n\n<ul>\n<li>Membership sites monitoring user activity<\/li>\n<li>Educational platforms tracking student engagement<\/li>\n<li>Multi-author blogs coordinating content creation<\/li>\n<li>Support teams managing customer interactions<\/li>\n<li>Any site requiring user activity insights<\/li>\n<\/ul>\n\n<h4>Developer Friendly<\/h4>\n\n<ul>\n<li>Clean, well-documented code<\/li>\n<li>Action and filter hooks for customization<\/li>\n<li>WP-CLI commands for automation<\/li>\n<li>Follows WordPress coding standards<\/li>\n<li>Compatible with multisite installations<\/li>\n<\/ul>\n\n<h3>WP-CLI Commands<\/h3>\n\n<p>The plugin provides powerful WP-CLI commands for monitoring and automation:<\/p>\n\n<h4>Basic Commands<\/h4>\n\n<ul>\n<li><code>wp active-users list<\/code> - List all online users<\/li>\n<li><code>wp active-users stats<\/code> - Display online user statistics<\/li>\n<li><code>wp active-users check &lt;user&gt;<\/code> - Check if a specific user is online<\/li>\n<li><code>wp active-users monitor<\/code> - Real-time monitoring in terminal<\/li>\n<li><code>wp active-users clear-cache<\/code> - Clear the online users cache<\/li>\n<\/ul>\n\n<h4>Automation Commands<\/h4>\n\n<p><strong>Check if any users are online (for scripting):<\/strong><\/p>\n\n<pre><code>wp active-users any [--quiet] [--count] [--json]\n<\/code><\/pre>\n\n<ul>\n<li><code>--quiet<\/code> - Returns exit code only (0 = users online, 1 = no users online)<\/li>\n<li><code>--count<\/code> - Returns just the number of online users<\/li>\n<li><code>--json<\/code> - Returns detailed JSON output<\/li>\n<\/ul>\n\n<p><strong>Wait until no users are online:<\/strong><\/p>\n\n<pre><code>wp active-users wait-clear [--timeout=&lt;seconds&gt;] [--check-interval=&lt;seconds&gt;] [--quiet]\n<\/code><\/pre>\n\n<ul>\n<li><code>--timeout<\/code> - Maximum time to wait (default: 300 seconds)<\/li>\n<li><code>--check-interval<\/code> - How often to check (default: 30 seconds)<\/li>\n<li><code>--quiet<\/code> - Suppress progress messages<\/li>\n<\/ul>\n\n<h4>Example Automation Scripts<\/h4>\n\n<p><strong>Safe upgrade script:<\/strong>\n    `bash<\/p>\n\n!\/bin\/bash\n\nOnly upgrade when no users are online\n\n<p>if wp active-users any --quiet; then\n    echo \"Users are online, postponing upgrade\"\nelse\n    echo \"No users online, safe to upgrade\"\n    wp core update\n    wp plugin update --all\nfi\n    `<\/p>\n\n<p><strong>Maintenance with user wait:<\/strong>\n    `bash<\/p>\n\nWait for users to go offline, then perform maintenance\n\n<p>wp active-users wait-clear --timeout=600 &amp;&amp; {\n    wp maintenance-mode activate\n    wp db optimize\n    wp cache flush\n    wp maintenance-mode deactivate\n}\n    `<\/p>\n\n<p><strong>Monitoring script:<\/strong>\n    `bash<\/p>\n\nGet online user count for monitoring dashboard\n\n<p>ONLINE_COUNT=$(wp active-users any --count)\nif [ \"$ONLINE_COUNT\" -gt \"100\" ]; then\n    # Send alert about high user activity\n    echo \"High activity: $ONLINE_COUNT users online\"\nfi\n    `<\/p>\n\n<p>These commands make it easy to create maintenance scripts that respect user activity, ensuring updates and maintenance tasks only run when appropriate.<\/p>\n\n<h3>Privacy Policy<\/h3>\n\n<p>This plugin does not collect or store any personal data beyond what WordPress already tracks for logged-in users. It only reads existing session data to determine online status. No data is sent to external services.<\/p>\n\n<h3>Credits<\/h3>\n\n<p>Developed by <a href=\"https:\/\/fullworks.net\/\">Fullworks<\/a><\/p>\n\n<p>Icons and visual elements use WordPress core styles for consistency.<\/p>\n\n<!--section=installation-->\n<h4>Automatic Installation<\/h4>\n\n<ol>\n<li>Go to Plugins &gt; Add New in your WordPress admin<\/li>\n<li>Search for \"Fullworks Active Users Monitor\"<\/li>\n<li>Click \"Install Now\" and then \"Activate\"<\/li>\n<li>Configure settings under Settings &gt; Active Users Monitor<\/li>\n<\/ol>\n\n<h4>Manual Installation<\/h4>\n\n<ol>\n<li>Download the plugin ZIP file<\/li>\n<li>Upload to <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Extract the ZIP file<\/li>\n<li>Activate through the Plugins menu in WordPress<\/li>\n<li>Configure under Settings &gt; Active Users Monitor<\/li>\n<\/ol>\n\n<h4>After Activation<\/h4>\n\n<ol>\n<li>Visit Settings &gt; Active Users Monitor to configure options<\/li>\n<li>Check the admin bar for the online users counter<\/li>\n<li>View the Users page to see enhanced status indicators<\/li>\n<li>Optional: Add the dashboard widget for quick monitoring<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='how%20does%20the%20plugin%20determine%20if%20a%20user%20is%20online%3F'><h3>How does the plugin determine if a user is online?<\/h3><\/dt>\n<dd><p>The plugin uses WordPress's built-in WP_Session_Tokens class to check for active session tokens. This ensures accurate detection regardless of the authentication method used (standard login, SSO, 2FA, etc.).<\/p><\/dd>\n<dt id='does%20this%20plugin%20create%20custom%20database%20tables%3F'><h3>Does this plugin create custom database tables?<\/h3><\/dt>\n<dd><p>Yes, but only if you enable the audit trail feature. The plugin creates one table (wp_fwaum_audit_log) to store login\/logout event history. The core monitoring functionality uses WordPress's existing session management system without any custom tables.<\/p><\/dd>\n<dt id='can%20i%20customize%20which%20roles%20can%20see%20online%20status%3F'><h3>Can I customize which roles can see online status?<\/h3><\/dt>\n<dd><p>Yes. In the plugin settings, you can configure which user roles have permission to view online user status. By default, only administrators can see this information.<\/p><\/dd>\n<dt id='how%20often%20does%20the%20plugin%20update%20the%20online%20status%3F'><h3>How often does the plugin update the online status?<\/h3><\/dt>\n<dd><p>The refresh interval is configurable from 15 to 300 seconds. The default is 30 seconds. You can adjust this in Settings &gt; Active Users Monitor.<\/p><\/dd>\n<dt id='is%20this%20plugin%20compatible%20with%20caching%20plugins%3F'><h3>Is this plugin compatible with caching plugins?<\/h3><\/dt>\n<dd><p>Yes. The plugin uses AJAX for real-time updates, which works independently of page caching. The plugin also implements its own transient caching for optimal performance.<\/p><\/dd>\n<dt id='can%20i%20use%20this%20with%20multisite%3F'><h3>Can I use this with multisite?<\/h3><\/dt>\n<dd><p>Yes. The plugin is fully compatible with WordPress multisite installations. Super Admins can monitor users across the network.<\/p><\/dd>\n<dt id='does%20it%20work%20with%20custom%20user%20roles%3F'><h3>Does it work with custom user roles?<\/h3><\/dt>\n<dd><p>Yes. The plugin automatically detects and supports all custom user roles in addition to WordPress default roles.<\/p><\/dd>\n<dt id='how%20can%20i%20style%20the%20online%20indicators%20differently%3F'><h3>How can I style the online indicators differently?<\/h3><\/dt>\n<dd><p>The plugin provides CSS classes for all elements and includes filter hooks for developers to customize the output. You can override styles in your theme's CSS.<\/p><\/dd>\n<dt id='is%20wp-cli%20support%20included%3F'><h3>Is WP-CLI support included?<\/h3><\/dt>\n<dd><p>Yes. The plugin includes comprehensive WP-CLI support with commands for monitoring, automation, and scripting. See the WP-CLI Commands section below for details.<\/p><\/dd>\n<dt id='will%20this%20slow%20down%20my%20site%3F'><h3>Will this slow down my site?<\/h3><\/dt>\n<dd><p>No. The plugin is optimized for performance with smart caching, efficient queries, and optional features you can disable if needed.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Added comprehensive audit trail functionality to track user login\/logout events<\/li>\n<li>New audit log table under Users menu with advanced filtering and search<\/li>\n<li>Export audit logs to CSV, JSON, or Excel formats<\/li>\n<li>Track login methods (standard, social, two-factor, API, etc.)<\/li>\n<li>Monitor session durations and failed login attempts<\/li>\n<li>Configurable retention periods and privacy settings<\/li>\n<li>Database migration support for existing user data<\/li>\n<li>Updated minimum WordPress version to 6.2 for enhanced security features<\/li>\n<li>Fully compliant with WordPress Coding Standards<\/li>\n<li>Integration with Fullworks Free Plugin Library for promotional features<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Fixed contributor name and donation link<\/li>\n<li>Added WordPress Playground blueprint for easy preview<\/li>\n<li>Added plugin assets to readme<\/li>\n<li>Minor documentation improvements<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Real-time user monitoring using session tokens<\/li>\n<li>Admin bar counter with role breakdown<\/li>\n<li>Enhanced users list with visual indicators<\/li>\n<li>Dashboard widget for quick overview<\/li>\n<li>Configurable auto-refresh intervals<\/li>\n<li>WP-CLI command support<\/li>\n<li>Comprehensive settings page<\/li>\n<li>Full internationalization support<\/li>\n<\/ul>","raw_excerpt":"Real-time monitoring of logged-in WordPress users with visual indicators, filtering, and comprehensive admin tools.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/hy.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/250566","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hy.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/hy.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/hy.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=250566"}],"author":[{"embeddable":true,"href":"https:\/\/hy.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/fullworks"}],"wp:attachment":[{"href":"https:\/\/hy.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=250566"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/hy.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=250566"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/hy.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=250566"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/hy.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=250566"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/hy.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=250566"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/hy.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=250566"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}