# gamipress/7.9.8/includes/shortcodes/gamipress_logs.php

GamiPress – Gamification plugin to reward points, badges & ranks in WordPress, now with AI, version 7.9.8. 398 lines.

- Page: https://pluginprobe.com/plugins/gamipress/7.9.8/code/includes/shortcodes/gamipress_logs.php
- Raw: https://pluginprobe.com/plugins/gamipress/7.9.8/raw/includes/shortcodes/gamipress_logs.php
- Modified: 2026-07-13T13:39:46+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/gamipress/7.9.8/code/includes/shortcodes/gamipress_logs.php#L10-L20`.

```php
<?php
/**
 * GamiPress Logs Shortcode
 *
 * @package     GamiPress\Shortcodes\Shortcode\GamiPress_Logs
 * @author      GamiPress <contact@gamipress.com>, Ruben Garcia <rubengcdev@gmail.com>
 * @since       1.0.0
 */
// Exit if accessed directly
if( !defined( 'ABSPATH' ) ) exit;

/**
 * Register [gamipress_logs] shortcode
 *
 * @since 1.0.0
 */
function gamipress_register_logs_shortcode() {

    gamipress_register_shortcode( 'gamipress_logs', array(
        'name'              => __( 'Logs', 'gamipress' ),
        'description'       => __( 'Display a list of logs.', 'gamipress' ),
        'icon' 	            => 'editor-ul',
        'group' 	        => 'gamipress',
        'output_callback'   => 'gamipress_logs_shortcode',
        'fields'      => array(
            'type' => array(
                'name'              => __( 'Log Type(s)', 'gamipress' ),
                'tooltip'           => __( 'Log type(s) to display.', 'gamipress' ),
                'label_cb'          => 'cmb_tooltip_label_cb',
                'shortcode_desc'    => __( 'Single or comma-separated list of log type(s) to display.', 'gamipress' ),
                'type'              => 'advanced_select',
                'multiple'          => true,
                'classes' 	        => 'gamipress-selector',
                'attributes' 	    => array(
                    'data-placeholder' => __( 'Default: All', 'gamipress' ),
                ),
                'options_cb'        => 'gamipress_options_cb_log_types',
                'default'           => 'all',
            ),
            'current_user' => array(
                'name'      => __( 'Current User', 'gamipress' ),
                'tooltip'   => __( 'Show logs of the current logged in user.', 'gamipress' ),
                'label_cb'  => 'cmb_tooltip_label_cb',
                'type'      => 'checkbox',
                'classes'   => 'gamipress-switch',
            ),
            'user_id' => array(
                'name'      => __( 'User', 'gamipress' ),
                'tooltip'   => __( 'Show logs by a specific user. Leave blank to show logs of all users.', 'gamipress' ),
                'label_cb'  => 'cmb_tooltip_label_cb',
                'type'      => 'select',
                'default'   => '',
                'options_cb'  => 'gamipress_options_cb_users'
            ),
            'access' => array(
                'name'      => __( 'Log Access', 'gamipress' ),
                'tooltip'   => __( 'Set the access type of logs to display. Some logs has a private access like event trigger logs.', 'gamipress' ),
                'label_cb'  => 'cmb_tooltip_label_cb',
                'type'      => 'select',
                'options'   => array(
                    'any'       => __( 'Any', 'gamipress' ),
                    'public'    => __( 'Public', 'gamipress' ),
                    'private'   => __( 'Private', 'gamipress' ),
                ),
                'default'     => 'any',
            ),
            'limit' => array(
                'name'      => __( 'Limit', 'gamipress' ),
                'tooltip'   => __( 'Number of log entries to display.', 'gamipress' ),
                'label_cb'  => 'cmb_tooltip_label_cb',
                'type'      => 'text',
                'default'   => 10,
            ),
            'pagination' => array(
                'name'      => __( 'Enable Pagination', 'gamipress' ),
                'tooltip'   => __( 'Show pagination links to navigate through all logs.', 'gamipress' ),
                'label_cb'  => 'cmb_tooltip_label_cb',
                'type'      => 'checkbox',
                'classes'   => 'gamipress-switch',
                'default'   => 'yes',
            ),
            'orderby' => array(
                'name'      => __( 'Order By', 'gamipress' ),
                'tooltip'   => __( 'Parameter to use for sorting.', 'gamipress' ),
                'label_cb'  => 'cmb_tooltip_label_cb',
                'type'      => 'select',
                'options'   => array(
                    'date'       => __( 'Date', 'gamipress' ),
                    'log_id'     => __( 'Log ID', 'gamipress' ),
                    'title'      => __( 'Log Title', 'gamipress' ),
                    'user_id'    => __( 'Log Author', 'gamipress' ),
                    'rand'       => __( 'Random', 'gamipress' ),
                ),
                'default_cb'     => 'gamipress_logs_order_by_default_cb', // Added this callback to avoid CMB2 warning about 'date' function
            ),
            'order' => array(
                'name'      => __( 'Order', 'gamipress' ),
                'tooltip'   => __( 'Sort order.', 'gamipress' ),
                'label_cb'  => 'cmb_tooltip_label_cb',
                'type'      => 'select',
                'options'   => array( 'DESC' => __( 'Descending', 'gamipress' ), 'ASC' => __( 'Ascending', 'gamipress' ) ),
                'default'   => 'DESC',
            ),
            'include' => array(
                'name'      => __( 'Include', 'gamipress' ),
                'tooltip'   => __( 'Comma-separated list of specific log entries IDs to include.', 'gamipress' ),
                'label_cb'  => 'cmb_tooltip_label_cb',
                'type'      => 'text',
            ),
            'exclude' => array(
                'name'      => __( 'Exclude', 'gamipress' ),
                'tooltip'   => __( 'Comma-separated list of specific log entries IDs to exclude.', 'gamipress' ),
                'label_cb'  => 'cmb_tooltip_label_cb',
                'type'      => 'text',
            ),
        ),
    ) );

}
add_action( 'init', 'gamipress_register_logs_shortcode' );

/**
 * Logs List Shortcode
 *
 * @since  1.0.0
 *
 * @param  array    $atts       Shortcode attributes
 * @param  string   $content    Shortcode content
 *
 * @return string 	   HTML markup
 */
function gamipress_logs_shortcode( $atts = array(), $content = '' ) {

    // If not properly upgrade to required version fallback to compatibility function
    if( ! is_gamipress_upgraded_to( '1.2.8' ) ) {
        return gamipress_logs_shortcode_old( $atts );
    }

    global $gamipress_template_args;

    // Initialize GamiPress template args global
    $gamipress_template_args = array();

    $shortcode = 'gamipress_logs';

    $atts = shortcode_atts( gamipress_logs_shortcode_defaults(), $atts, $shortcode );

    // Turn old orderby values into new ones
    switch( $atts['orderby'] ) {
        case 'ID':
            $atts['orderby'] = 'log_id';
            break;
        case 'menu_order':
        case 'modified':
            $atts['orderby'] = 'date';
            break;
        case 'author':
            $atts['orderby'] = 'user_id';
            break;
    }

    // Single type check
    $is_single_type = false;
    $types = explode( ',', $atts['type'] );
    if( $atts['type'] !== 'all' && count( $types ) === 1 ) {
        $is_single_type = true;
        
        // Check if achievement type is valid
        if ( ! in_array( $atts['type'], array_keys( gamipress_get_log_types() ) ) ) {
            return gamipress_shortcode_error( __( 'The type provided isn\'t a valid registered log type.', 'gamipress' ), $shortcode );
        }
    }

    // Enqueue assets
    gamipress_enqueue_scripts();

    // Force to set current user as user ID
    if( $atts['current_user'] === 'yes' ) {

        /**
         * Filter to override shortcode workflow with not logged in users when current user is set to yes
         *
         * @since 1.7.4.2
         *
         * @param bool      $empty_if_not_logged_in     Final workflow to follow
         * @param array     $atts                       Shortcode attributes
         * @param string    $content                    Shortcode content
         */
        $empty_if_not_logged_in = apply_filters( 'gamipress_logs_shortcode_empty_if_not_logged_in', true, $atts, $content );

        // Return if current_user is set to yes and current user is a guest
        if( get_current_user_id() === 0 && $empty_if_not_logged_in )
            return '';

        $atts['user_id'] = get_current_user_id();

    }

    // Change the atribute to display only public logs if current user is different
    if( in_array( $atts['access'], array( 'private', 'both' ) ) ) {
        if ( get_current_user_id() !== absint( $atts['user_id'] ) )
            $atts['access'] = 'public';
    }

    // GamiPress template args global
    $gamipress_template_args = $atts;

    // On network wide active installs, we need to switch to main blog mostly for posts permalinks and thumbnails
    $blog_id = gamipress_switch_to_main_site_if_network_wide_active();

    // Get the logs query
    $gamipress_template_args['query'] = gamipress_logs_shortcode_query( $atts );

    if( ! $gamipress_template_args['query'] ) {
        return '';
    }

    ob_start();
        if( $is_single_type ) {
            gamipress_get_template_part( 'logs', $atts['type'] );
        } else {
            gamipress_get_template_part( 'logs' );
        }
    $output = ob_get_clean();

    // If switched to blog, return back to que current blog
    if( $blog_id !== get_current_blog_id() && is_multisite() ) {
        restore_current_blog();
    }

    /**
     * Filter to override shortcode output
     *
     * @since 1.6.5
     *
     * @param string    $output     Final output
     * @param array     $atts       Shortcode attributes
     * @param string    $content    Shortcode content
     */
    return apply_filters( 'gamipress_logs_shortcode_output', $output, $atts, $content );

}

/**
 * Logs List Shortcode Query
 *
 * @since  1.4.9
 *
 * @param  array $args Query arguments
 *
 * @return CT_Query
 */
function gamipress_logs_shortcode_query( $args ) {

    // Type check
    $types = explode( ',', $args['type'] );

    if( $args['type'] === 'all') {
        $types = array_keys( gamipress_get_log_types() );
    }

    // Logs query args
    $query_args = array(
        'type'              => $types,
        'orderby'           => $args['orderby'],
        'order'             => $args['order'],
        'items_per_page'    => $args['limit'],
        'paged'             => max( 1, get_query_var( 'paged' ) ),
    );

    // Access
    if( $args['access'] !== 'any' ) {
        $query_args['access'] = $args['access'];
    }

    // User
    if( absint( $args['user_id'] ) !== 0 ) {
        $query_args['user_id'] = $args['user_id'];
    }

    // Build $include array
    if ( ! is_array( $args['include'] ) && ! empty( $args['include'] ) ) {
        $include = explode( ',', $args['include'] );
    }

    // Build $exclude array
    if ( ! is_array( $args['exclude'] ) && ! empty( $args['exclude'] ) ) {
        $exclude = explode( ',', $args['exclude'] );
    }

    // Include certain logs
    if ( isset( $include ) && ! empty( $include ) ) {
        $query_args[ 'log__in' ] = $include;
    }

    // Exclude certain logs
    if ( isset( $exclude ) && ! empty( $exclude ) ) {
        $query_args[ 'log__not_in' ] = $exclude;
    }

    // Setup table
    $ct_table = ct_setup_table( 'gamipress_logs' );

    // Sanitize query args
    $query_args = gamipress_sanitize_query_args( $query_args, gamipress_logs_query_vars_rules() );

    return new CT_Query( $query_args );

}

// CMB2 detects 'default' => 'date' as invalid callback because php has the date() function
function gamipress_logs_order_by_default_cb() {
    return 'date';
}

/**
 * Logs shortcode defaults attributes values
 *
 * @since 7.1.6
 *
 * @return array
 */
function gamipress_logs_shortcode_defaults() {

	return apply_filters( 'gamipress_logs_shortcode_defaults', array(
		'type'          => 'all',
        'current_user'  => 'no',
        'user_id'       => '0',
        'access'        => 'any',
        'limit'         => '10',
        'pagination'    => 'yes',
        'orderby'       => 'date',
        'order'         => 'ASC',
        'include'       => '',
        'exclude'       => '',
	) );

}

/**
 * Logs query vars rules
 *
 * @since 7.8.8
 *
 * @return array
 */
function gamipress_logs_query_vars_rules() {

    // Setup table
    $ct_table = ct_setup_table( 'gamipress_logs' );

    $rules = apply_filters( 'gamipress_logs_query_vars_rules', array(
        // Query fields
        'orderby' => array(
            'type' => 'string',
            'sanitize' => 'text',
            'allowed_values' => array_keys( $ct_table->db->schema->fields ),
        ),
        'order' => array(
            'type' => 'string',
            'sanitize' => 'uppercase',
            'allowed_values' => array( 'ASC', 'DESC' ),
        ),
        'items_per_page' => array(
            'type' => 'integer',
        ),
        'paged' => array(
            'type' => 'integer',
        ),
        // Log fields
        'type' => array(
            'type' => 'array',
            'sanitize' => 'text',
            'allowed_values' => array_keys( gamipress_get_log_types() ),
        ),
        'access' => array(
            'type' => 'string',
            'sanitize' => 'lowercase',
            'allowed_values' => array( 'public', 'private' ),
        ),
        'user_id' => array(
            'type' => 'integer',
        ),
        'log__in' => array(
            'type' => 'array',
            'sanitize' => 'integer',
        ),
        'log__not_in' => array(
            'type' => 'array',
            'sanitize' => 'integer',
        ),
    ) );

    ct_reset_setup_table();

    return $rules;

}
```