Search Results for: short code

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:

1. Deactivate the existing version of the extension.
2. Delete the existing version’s files via FTP, NOT using the delete option in the plugin panel (which will remove settings).
3. 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:

1. At the bottom of the User Profile
2. 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

Description

Filters the auto generated post excerpt, if auto excerpts are being used.

Comes at the end of the process, after the $content variable has been truncated.  The auto excerpt will be the number of words specified in the plugin options plus the “more” link.

Parameters

$content
(string) (required) The autogenerated excerpt.

$post_id
(int) (optional) The post ID.

$post_type
(strong) (optional) The WordPress post type of the current post.

Return

$content
(string) (required) The excerpt.

Example

add_filter( 'wpmem_auto_excerpt', function( $content, $post_id, $post_type ) {
    
    global $post;
    return get_the_excerpt( $post );

    // Alternative method if $post is not the current post object.
    // return get_the_excerpt( get_post( $post_id ) );
}, 10, 3);

Changelog

• Introduced 2.8.1
• 3.0.9 Added post ID and post type parameters.
• 3.2.5 Post ID and post type may be false if there is no post object.

Source

wpmem_auto_excerpt is located in /includes/class-wp-members.php