A non-invasive, lightweight WordPress plugin adding user activity monitoring support. User-Activity-Monitoring is a plug-and-play plugin with no required configuration.
| Version | |
|---|---|
| Requires at least WordPress: | 3.0.0 |
| Requires PHP: | 4.0 |
| Tested up to WordPress: | 5.7.1 |
- Get a specific user activity status from it's ID
- Example: Display the currently viewed user (
author.php) activity status - Get an array of all users currently online
- Example: Display all users currently online
- Example: Display the total count of users currently online
- Get an array of all users recently offline
- Example: Display all users recently offline
- While in a template-part
- Bugs and feature requests
- Copyright and license
- Installation
<?php
/**
* Get a specific user activity status from it's ID.
*
* @since 1.0.0
*
* @param Integer $user_id The user ID.
*
* @return Bool True for online.
*/
$user_activity_monitoring->is_user_currently_online( $user_id );<?php
if ( get_queried_object() instanceof \WP_User && is_author() ) {
if ( $user_activity_monitoring->is_user_currently_online( get_queried_object_id() ) ) {
echo '🟢 Online';
} else {
echo '🔴 Offline';
};
};<?php
/**
* Get an array of all users currently online.
*
* @since 1.0.0
*
* @return Array An array of currently online users ID.
*/
$user_activity_monitoring->get_currently_online_users();<?php
$currently_online_users = $user_activity_monitoring->get_currently_online_users();
echo '<ul>';
foreach( $currently_online_users as $user_id ) {
if ( get_current_user_id() !== $user_id ) {
echo '<li><a href="' . esc_url( get_author_posts_url( $user_id ) ) . '">
@' . get_userdata( $user_id )->display_name . '🟢 Online
</a></li>';
};
};
echo '</ul>';<?php
$currently_online_users_count = $user_activity_monitoring->get_currently_online_users();
echo sizeof( $currently_online_users_count );<?php
/**
* Get an array of all users recently offline.
*
* @since 1.0.0
*
* @return Array An array of recently offline users ID.
*/
$user_activity_monitoring->get_recently_offline_users();<?php
$recently_offline_users = $user_activity_monitoring->get_recently_offline_users();
echo '<ul>';
foreach( $recently_offline_users as $user_id ) {
if ( get_current_user_id() !== $user_id ) {
echo '<li><a href="' . esc_url( get_author_posts_url( $user_id ) ) . '">
@' . get_userdata( $user_id )->display_name . '🔴 Offline
</a></li>';
};
};
echo '</ul>';To be abble to use a method from a template-part, it is required to pass the class variable to that template-part.
You can pass additional arguments to a template-part via the $args parameter.
<?php
get_template_part( 'templates', 'my-awesome-template-part',
array(
'user_activity_monitoring' => $user_activity_monitoring,
)
);Then you can call the argument from the template-part via $args['my_argument_handle'].
<?php
$user_activity_monitoring = $args['user_activity_monitoring'];
// ...A problem ? An idea ? Please Open a new issue on GitHub or Ask a question on Wordpress User-Activity-Monitoring support.
Released under CC0 1.0 Universal (CC0 1.0) Public Domain Dedication.
If you have a copy of the plugin as a zip file, you can manually upload it and install it through the Plugins admin screen.
- Navigate to Plugins
→Add New. - Click the Upload Plugin button at the top of the screen.
- Download the plugin as a zip file, Select it from your local filesystem.
- Click the Install Now button.
- When installation is complete, you’ll see “Plugin installed successfully.” Click the Activate Plugin button at the bottom of the page.