The WP-Members User Tracking Extension is a site usage tracking and statistics plugin that allows you to view site usage of registered (logged in) users.
This extension is available with the WP-Members Pro Bundle, WP-Members Lifetime Support, or is also available individually.
Installation
This extension installs as a plugin. You can download the installation package as a zip file. Then use the new plugin uploader or unzip the package and FTP transfer to your plugin’s folder.
Once the extension is installed, you can go to Plugins > Installed Plugins to activate.
IMPORTANT: If you are upgrading from a pre-1.0 version of the extension, please make sure to follow these steps to upgrade:
- Deactivate the existing version of the extension.
- Delete the existing version’s files via FTP, NOT using the delete option in the plugin panel (which will remove settings).
- Upload, install, and activate the new version as normal.
Using the Extension
Once the tracking extension is installed, it will begin collecting data when logged in users visit the site.
Site usage data can be viewed in two places:
- At the bottom of the User Profile
- In the Dashboard > User Tracking Page
When viewing data in the user profile, the stats will show the time stamp of the user’s last login as well as the last 5 pages visited (this can be increased or decreased with the wpmemstat_max_per_user filter). Fields displayed can be changed with the wpmemstat_display_fields filter. The bottom of the list will include a link to the dashboard to view the full list of stats for that particular user.
When viewing stats in the dashboard, you will see the same fields that are displayed in the user profile. These can be filtered with wpmemstat_display_fields. The number of stats per page can be filtered with wpmemstat_max_per_page. You can view all stats of select a specific user from the dropdown list. The wpmemstat_user_droplist filter allows you to display the values in the dropdown by either user_login (the username) or displayname (if you are using a different value for displayname than username).
You can exclude a user from stat collection (such as any admins) with the wpmemstat_user_exclude filter.
The extension adds a tab to the WP-Members plugin options called “Tracking”. Under this tab you can set what happens when you either delete a user or delete (not just deactivate) the extension. On user delete, you can select to delete any stats related to that user. You can also set the extension to remove the database table in which stats are stored if you delete the extension. Please note that using either of these two options deletes that data – there is no way to get it back, so keep a database backup if you think you will need it.
Shortcodes
The [wpmem_ut_recent_pages] shortcode allows you to display a user’s most recently visited pages. This shortcode can be used to display recent page visits for the current user or for a specific user. The default display is the most recent 5 unique pages for the currently logged in user. (Requires version 1.0.3)
The shortcode accepts the following attributes:
- id – Display the page visits by a specific user by ID.
Example [wpmem_ut_recent_pages id=123] - show – Number of recent pages to display in the list.
Example [wpmem_ut_recent_pages show=10]
Filter Hooks
The following filter hooks are available for the extension:
- wpmemstat_user_exclude
- wpmemstat_user_droplist
- wpmemstat_display_fields
- wpmemstat_max_per_user
- wpmemstat_max_per_page
- wpmemstat_date_format