# gamipress/7.9.8/includes/functions.php

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

- Page: https://pluginprobe.com/plugins/gamipress/7.9.8/code/includes/functions.php
- Raw: https://pluginprobe.com/plugins/gamipress/7.9.8/raw/includes/functions.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/functions.php#L10-L20`.

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

// Functions includes
require_once GAMIPRESS_DIR . 'includes/functions/achievement-types.php';
require_once GAMIPRESS_DIR . 'includes/functions/points-types.php';
require_once GAMIPRESS_DIR . 'includes/functions/rank-types.php';
require_once GAMIPRESS_DIR . 'includes/functions/achievements.php';
require_once GAMIPRESS_DIR . 'includes/functions/points.php';
require_once GAMIPRESS_DIR . 'includes/functions/ranks.php';
require_once GAMIPRESS_DIR . 'includes/functions/requirements.php';
require_once GAMIPRESS_DIR . 'includes/functions/logs.php';
require_once GAMIPRESS_DIR . 'includes/functions/user-earnings.php';
require_once GAMIPRESS_DIR . 'includes/functions/attachments.php';
require_once GAMIPRESS_DIR . 'includes/functions/date.php';
require_once GAMIPRESS_DIR . 'includes/functions/html.php';
require_once GAMIPRESS_DIR . 'includes/functions/helpers.php';

/**
 * Helper function to get an option value.
 *
 * @since  1.0.1
 *
 * @param string    $option_name
 * @param bool      $default
 *
 * @return mixed Option value or default parameter value if not exists.
 */
function gamipress_get_option( $option_name, $default = false ) {

    if( GamiPress()->settings === null ) {

        // If GamiPress is installed network wide, get settings from network options
        if( gamipress_is_network_wide_active() ) {
            GamiPress()->settings = get_site_option( 'gamipress_settings' );
        } else {
            GamiPress()->settings = get_option( 'gamipress_settings' );
        }

    }

    return isset( GamiPress()->settings[ $option_name ] ) ? GamiPress()->settings[ $option_name ] : $default;

}

/**
 * Helper function to get a transient value.
 *
 * @since  1.4.0
 *
 * @param string    $transient
 *
 * @return mixed Value of transient.
 */
function gamipress_get_transient( $transient ) {

    // If GamiPress is installed network wide, get transient from network
    if( gamipress_is_network_wide_active() ) {
        return get_site_transient( $transient );
    } else {
       return get_transient( $transient );
    }

}

/**
 * Helper function to set a transient value.
 *
 * @since  1.4.0
 *
 * @param string    $transient
 * @param mixed     $value
 * @param integer   $expiration
 */
function gamipress_set_transient( $transient, $value, $expiration = 0 ) {

    // If GamiPress is installed network wide, get transient from network
    if( gamipress_is_network_wide_active() ) {
        set_site_transient( $transient, $value, $expiration );
    } else {
        set_transient( $transient, $value, $expiration );
    }

}

/**
 * Helper function to delete a transient value.
 *
 * @since  1.4.0
 *
 * @param string    $transient
 *
 * @return bool True if successful, false otherwise.
 */
function gamipress_delete_transient( $transient ) {

    // If GamiPress is installed network wide, get transient from network
    if( gamipress_is_network_wide_active() ) {
        return delete_site_transient( $transient );
    } else {
        return delete_transient( $transient );
    }

}

/**
 * Helper function to get a list of users based in the current site if multisite is active.
 *
 * @since  2.1.5
 *
 * @param array         $query_args     Query parameters.
 * @param string        $output         Optional. Any of ARRAY_A | ARRAY_N | OBJECT | OBJECT_K constants.
 *
 * @return array|null                   An array of users.
 */
function gamipress_get_users( $query_args = array(), $output = OBJECT ) {

    global $wpdb;

    $query_args = wp_parse_args( $query_args, array(
        'orderby'   => 'u.ID ASC',
        'offset'    => 0,
        'limit'     => -1,
    ) );

    // FROM
    $from = "FROM {$wpdb->users} AS u ";

    // WHERE
    $where = '';

    // ORDER BY
    $orderby = $query_args['orderby'];

    if( ! empty( $orderby ) ) {
        $orderby = "ORDER BY {$orderby}";
    } else {
        $orderby = '';
    }

    // LIMIT
    $offset = $query_args['offset'];
    $limit = $query_args['limit'];

    if( $limit != -1 ) {
        $limit = "LIMIT {$offset}, {$limit}";
    } else {
        $limit = '';
    }

    // Multisite check
    if( is_multisite() ) {
        $from .= "LEFT JOIN {$wpdb->usermeta} AS umcap ON ( umcap.user_id = u.ID ) ";

        // Check if where have been initialized or not
        if( empty( $where ) ) {
            $where = "WHERE ";
        } else {
            $where .= "AND ";
        }

        $where .= "umcap.meta_key = '" . $wpdb->get_blog_prefix() . "capabilities' ";
    }

    // Get the stored users
    $users = $wpdb->get_results(
        "SELECT * 
        {$from} 
        {$where}
        {$orderby}
        {$limit}",
        $output
    );

    return $users;

}

/**
 * Helper function to get a count of users based in the current site if multisite is active.
 *
 * @since  2.1.5
 *
 * @param array         $query_args     Query parameters.
 *
 * @return int                          The number of users.
 */
function gamipress_get_users_count( $query_args = array() ) {

    global $wpdb;

    // FROM
    $from = "FROM {$wpdb->users} AS u ";

    // WHERE
    $where = '';

    // Multisite check
    if( is_multisite() ) {
        $from .= "LEFT JOIN {$wpdb->usermeta} AS umcap ON ( umcap.user_id = u.ID ) ";

        // Check if where have been initialized or not
        if( empty( $where ) ) {
            $where = "WHERE ";
        } else {
            $where .= "AND ";
        }

        $where .= "umcap.meta_key = '" . $wpdb->get_blog_prefix() . "capabilities' ";
    }

    // Get the users count
    $users_count = absint( $wpdb->get_var(
        "SELECT COUNT(*) 
        {$from} 
        {$where}"
    ) );

    return $users_count;

}

/**
 * Helper function to get a user meta.
 *
 * @since  1.4.0
 *
 * @param int    $user_id   User ID.
 * @param string $meta_key  Optional. The meta key to retrieve. By default, returns data for all keys.
 * @param bool   $single    Whether to return a single value.
 *
 * @return mixed            Will be an array if $single is false. Will be value of meta data field if $single is true.
 */
function gamipress_get_user_meta( $user_id, $meta_key = '', $single = true ) {

    if( is_multisite() ) {
        $global = gamipress_is_network_wide_active();
        return gamipress_get_user_option( $meta_key, $user_id, $global );
    } else {
        return get_user_meta( $user_id, $meta_key, $single );
    }

}

/**
 * Helper function to update a user meta.
 *
 * @since  1.4.0
 *
 * @param int    $user_id       User ID.
 * @param string $meta_key      Metadata key.
 * @param mixed  $meta_value    Metadata value.
 * @param mixed  $prev_value    Optional. Previous value to check before removing.
 *
 * @return integer|bool         Meta ID if the key didn't exist, true on successful update, false on failure.
 */
function gamipress_update_user_meta( $user_id, $meta_key, $meta_value, $prev_value = '' ) {

    if( is_multisite() ) {
        $global = gamipress_is_network_wide_active();
        return update_user_option( $user_id, $meta_key, $meta_value, $global );
    } else {
        return update_user_meta( $user_id, $meta_key, $meta_value, $prev_value );
    }

}

/**
 * Helper function to delete a user meta.
 *
 * @since  1.4.0
 *
 * @param int    $user_id       User ID.
 * @param string $meta_key      Metadata key.
 * @param mixed  $meta_value    Metadata value.
 *
 * @return bool                 True on success, false on failure.
 */
function gamipress_delete_user_meta( $user_id, $meta_key, $meta_value = '' ) {

    if( is_multisite() ) {
        $global = gamipress_is_network_wide_active();
        return delete_user_option( $user_id, $meta_key, $global );
    } else {
        return delete_user_meta( $user_id, $meta_key, $meta_value );
    }

}

/**
 * Retrieves user option that can be either per Site or per Network.
 *
 * @since 2.0.0
 *
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param string $option        User option name.
 * @param int    $user_id       Optional. User ID.
 * @param bool   $global        Optional. Whether option name is global or blog specific. Default false (blog specific).
 *
 * @return mixed User option value on success, false on failure.
 */
function gamipress_get_user_option( $option, $user_id = 0, $global = false ) {
    global $wpdb;

    if ( empty( $user_id ) ) {
        return false;
    }

    $user = get_userdata( $user_id );
    if ( ! $user ) {
        return false;
    }

    $result = false;

    if( $global ) {
        if ( $user->has_prop( $option ) ) { // User-specific and cross-blog.
            $result = $user->get( $option );
        }
    } else {
        $prefix = $wpdb->get_blog_prefix();

        if ( $user->has_prop( $prefix . $option ) ) { // Blog-specific.
            $result = $user->get( $prefix . $option );
        }
    }

    /**
     * Filters a specific user option value.
     *
     * The dynamic portion of the hook name, `$option`, refers to the user option name.
     *
     * @since 2.5.0
     *
     * @param mixed   $result Value for the user's option.
     * @param string  $option Name of the option being retrieved.
     * @param WP_User $user   WP_User object of the user whose option is being retrieved.
     */
    return apply_filters( "get_user_option_{$option}", $result, $option, $user );
}

/**
 * Helper function to get a post meta.
 *
 * Important: On network wide installs, this function will return the post meta from main site, so use only for points, achievements and ranks metas
 *
 * @since  1.4.0
 *
 * @param int    $post_id   Post ID.
 * @param string $meta_key  Optional. The meta key to retrieve. By default, returns data for all keys.
 * @param bool   $single    Whether to return a single value.
 *
 * @return mixed            Will be an array if $single is false. Will be value of meta data field if $single is true.
 */
function gamipress_get_post_meta( $post_id, $meta_key = '', $single = true ) {

    if( gamipress_is_network_wide_active() && ! is_main_site() ) {

        // Switch to main site
        switch_to_blog( get_main_site_id() );

        // Get the post meta
        $value = get_post_meta( $post_id, $meta_key, $single );

        // Restore current site
        restore_current_blog();

        return $value;

    } else {

        return get_post_meta( $post_id, $meta_key, $single );

    }

}

/**
 * Helper function to update a post meta.
 *
 * Important: On network wide installs, this function will update the post meta from main site, so use only for points, achievements and ranks metas
 *
 * @since  1.4.0
 *
 * @param int    $post_id       Post ID.
 * @param string $meta_key      Metadata key.
 * @param mixed  $meta_value    Metadata value.
 * @param mixed  $prev_value    Optional. Previous value to check before removing.
 *
 * @return integer|bool         Meta ID if the key didn't exist, true on successful update, false on failure.
 */
function gamipress_update_post_meta( $post_id, $meta_key, $meta_value, $prev_value = '' ) {

    if( gamipress_is_network_wide_active() && ! is_main_site() ) {

        // Switch to main site
        switch_to_blog( get_main_site_id() );

        $result = update_post_meta( $post_id, $meta_key, $meta_value, $prev_value );

        // Restore current site
        restore_current_blog();

        return $result;

    } else {

        return update_post_meta( $post_id, $meta_key, $meta_value, $prev_value );

    }

}

/**
 * Helper function to delete a post meta.
 *
 * Important: On network wide installs, this function will delete the post meta from main site, so use only for points, achievements and ranks metas
 *
 * @since  1.4.0
 *
 * @param int    $post_id       Post ID.
 * @param string $meta_key      Metadata key.
 * @param mixed  $meta_value    Metadata value.
 *
 * @return bool                 True on success, false on failure.
 */
function gamipress_delete_post_meta( $post_id, $meta_key, $meta_value = '' ) {

    if( gamipress_is_network_wide_active() && ! is_main_site() ) {

        // Switch to main site
        switch_to_blog( get_main_site_id() );

        $result = delete_post_meta( $post_id, $meta_key, $meta_value );

        // Restore current site
        restore_current_blog();

        return $result;

    } else {
        return delete_post_meta( $post_id, $meta_key, $meta_value );
    }

}

/**
 * Helper function to get a post.
 *
 * Important: On network wide installs, this function will return the post from main site, so use only for points, achievements and ranks posts
 *
 * @since   1.4.0
 * @updated 1.7.7 Make use of GamiPress cache feature to get network posts from cache
 *
 * @param int    $post_id       Post ID.
 *
 * @return false|WP_Post        Post object on success, false on failure.
 */
function gamipress_get_post( $post_id ) {

    // if we got a post object, then return their field
    if ( $post_id instanceof WP_Post ) {
        return $post_id;
    }

    global $wpdb;

    if( gamipress_is_network_wide_active() && ! is_main_site() ) {

        $cache = gamipress_get_cache( 'posts', array(), false );

        // If result already cached, return it
        if( isset( $cache[absint( $post_id )] ) ) {
            return $cache[absint( $post_id )];
        }

        // GamiPress post are stored on main site, so if we are not on main site, then we need to get their fields from global table
        $posts = GamiPress()->db->posts;

        $post = $wpdb->get_row( $wpdb->prepare(
            "SELECT * FROM {$posts} WHERE ID = %d",
            absint( $post_id )
        ) );

        // Cache network posts
        $cache[absint( $post_id )] = $post;
        gamipress_set_cache( 'posts', $cache );

        return $post;

    } else {
        return get_post( $post_id );
    }

}

/**
 * Helper function to get a post status.
 *
 * Important: On network wide installs, this function will return the post status from main site, so use only for points, achievements and ranks post status
 *
 * @since  1.4.0
 *
 * @param int    $post_id       Post ID.
 *
 * @return false|string         Post status on success, false on failure.
 */
function gamipress_get_post_status( $post_id = null ) {
    return gamipress_get_post_field( 'post_status', $post_id );
}

/**
 * Helper function to get a post type.
 *
 * Important: On network wide installs, this function will return the post type from main site, so use only for points, achievements and ranks post type
 *
 * @since  1.4.0
 *
 * @param int    $post_id       Post ID.
 *
 * @return false|string         Post status on success, false on failure.
 */
function gamipress_get_post_type( $post_id = null ) {
    return gamipress_get_post_field( 'post_type', $post_id );
}

/**
 * Helper function to get a post date.
 *
 * Important: On network wide installs, this function will return the post date from main site, so use only for points, achievements and ranks post date
 *
 * @since  1.4.0
 *
 * @param int    $post_id       Post ID.
 *
 * @return false|string         Post status on success, false on failure.
 */
function gamipress_get_post_date( $post_id = null ) {
    return gamipress_get_post_field( 'post_date', $post_id );
}

/**
 * Helper function to get a post field.
 *
 * Important: On network wide installs, this function will return the post field from main site, so use only for points, achievements and ranks posts fields
 *
 * @since   1.4.0
 * @updated 1.7.7 Make use of gamipress_get_post() function to get network posts fields from cache
 *
 * @param string                $field      The post field.
 * @param integer|WP_Post|null  $post_id    Post ID.
 *
 * @return false|string                     Post field on success, false on failure.
 */
function gamipress_get_post_field( $field, $post_id = null  ) {

    if ( empty( $post_id ) && isset( $GLOBALS['post'] ) )
        $post_id = $GLOBALS['post'];

    // if we got a post object, then return their field
    if ( $post_id instanceof WP_Post ) {
        return $post_id->$field;
    } else if( is_object( $post_id ) ) {
        return $post_id->$field;
    }

    if( gamipress_is_network_wide_active() && ! is_main_site() ) {

        $post = gamipress_get_post( $post_id );

        return ( $post ? $post->$field : null );
    } else {
        return get_post_field( $field, $post_id );
    }

}

/**
 * Helper function to check if a post exists.
 *
 * Important: On network wide installs, this function will check the post from main site, so use only for points, achievements and ranks posts
 *
 * @since  1.4.2
 *
 * @param integer  $post_id     Post ID.
 *
 * @return bool                 True if exists, false if not.
 */
function gamipress_post_exists( $post_id  ) {

    $post_id = absint( $post_id );

    if( $post_id === 0 )
        return false;

    $blog_id = get_current_blog_id();

    $cache = gamipress_get_cache( 'posts_exists_' . $blog_id, array(), false );

    // If result already cached, return it
    if( isset( $cache[$post_id] ) ) {
        return $cache[$post_id];
    }

    global $wpdb;

    // GamiPress post are stored on main site, so if we are not on main site, then we need to get their fields from global table
    $posts = GamiPress()->db->posts;

    $found = $wpdb->get_var( $wpdb->prepare(
        "SELECT ID FROM {$posts} WHERE ID = %d",
        $post_id
    ) );

    // Cache function result
    $cache[$post_id] = absint( $found ) === $post_id;

    gamipress_set_cache( 'posts_exists_' . $blog_id, $cache );

    return absint( $found ) === $post_id;
}

/**
 * Register GamiPress types and flush rewrite rules.
 *
 * @since 1.0.0
 */
function gamipress_flush_rewrite_rules() {
    gamipress_register_post_types();
    gamipress_register_points_types();
    gamipress_register_achievement_types();
    gamipress_register_rank_types();

    flush_rewrite_rules();
}

/**
 * Utility to execute a shortcode passing an array of args
 *
 * @since   1.0.0
 * @updated 1.4.6 Added $content parameter
 * @updated 1.6.2 Sanitize attribute's value to avoid double quotes
 *
 * @param string    $shortcode The shortcode to execute
 * @param array     $args      The args to pass to the shortcode
 * @param string    $content   Content to pass to the shortcode (optional)
 *
 * @return string   $output    Output from the shortcode execution with the given args
 */
function gamipress_do_shortcode( $shortcode, $args, $content = '' ) {

    $shortcode_args = '';

    foreach( $args as $arg => $value ) {

        if( is_array( $value ) ) {

            if( array_keys( $value ) !== range( 0, count($value) - 1 ) ) {

                // Turn associative arrays into json to keep keys
                $value = str_replace( '"', '\'', json_encode( $value ) );
                $value = str_replace( '[', '{', $value );
                $value = str_replace( ']', '}', $value );

            } else {

                $is_multidimensional = false;

                foreach ($value as $value_items) {
                    if ( is_array($value_items) ) {
                        $is_multidimensional = true;
                        break;
                    }
                }

                if( $is_multidimensional ) {
                    // Turn multidimensional arrays into json to keep inherit arrays
                    $value = str_replace( '"', '\'', json_encode( $value ) );
                    $value = str_replace( '[', '{', $value );
                    $value = str_replace( ']', '}', $value );
                } else {
                    // non associative and non multidimensional arrays, set a string of comma separated values
                    $value = implode( ',', $value );
                }

            }
        }

        // Prevent attribute's value to have double quotes
        $value = str_replace( '"', '\'', $value );

        $shortcode_args .= sprintf( ' %s="%s"', $arg, $value);
    }

    if( ! empty( $content ) ) {

        // If content passed, then execute shortcode as [shortcode]content[/shortcode]
        return do_shortcode( sprintf( '[%s %s]%s[/%s]',
            $shortcode,
            $shortcode_args,
            $content,
            $shortcode
        ) );

    }

    return do_shortcode( sprintf( '[%s %s]', $shortcode, $shortcode_args ) );

}

/**
 * Sanitize given slug.
 *
 * @since 1.3.9.8
 *
 * @param string $slug  Slug to sanitize.
 *
 * @return string       Sanitized slug.
 */
function gamipress_sanitize_slug( $slug ) {

    // Sanitize slug
    $slug = sanitize_key( $slug );

    // Check slug length
    if( strlen( $slug ) > 20 ) {
        $slug = substr( $slug, 0, 20 );
    }

    return $slug;

}

/**
 * Check if a specific action or filter has been hooked
 *
 * @since 1.4.3
 *
 * @param string $filter
 *
 * @return bool
 */
function gamipress_has_filters( $filter ) {

    global $wp_filter;

    return (bool) ( isset( $wp_filter[$filter] ) && count( $wp_filter[$filter] ) > 0 );

}

/**
 * Sum all user meta values of a given meta key
 *
 * @since 1.5.9
 *
 * @param string $meta_key
 *
 * @return integer
 */
function gamipress_get_user_meta_sum( $meta_key ) {

    global $wpdb;

    $sum = $wpdb->get_var( $wpdb->prepare(
        "SELECT SUM( meta_value )
         FROM {$wpdb->usermeta}
         WHERE meta_key = %s",
        $meta_key
    ) );

    return absint( $sum );

}

/**
 * Gets registered time periods
 *
 * @since 1.6.9
 *
 * @return array
 */
function gamipress_get_time_periods() {

    /**
     * Filter registered time periods
     *
     * @since 1.6.9
     *
     * @param array $time_periods
     *
     * @return array
     */
    return apply_filters( 'gamipress_get_time_periods', array(
        ''              => __( 'None', 'gamipress' ),
        'today'         => __( 'Today', 'gamipress' ),
        'yesterday'     => __( 'Yesterday', 'gamipress' ),
        'this-week'     => __( 'Current Week', 'gamipress' ),
        'past-week'     => __( 'Past Week', 'gamipress' ),
        'this-month'    => __( 'Current Month', 'gamipress' ),
        'past-month'    => __( 'Past Month', 'gamipress' ),
        'this-year'     => __( 'Current Year', 'gamipress' ),
        'past-year'     => __( 'Past Year', 'gamipress' ),
        'custom'        => __( 'Custom', 'gamipress' ),
    ) );

}

/**
 * Gets reserved terms
 *
 * @see https://codex.wordpress.org/Reserved_Terms
 *
 * @since 1.7.4
 *
 * @return array
 */
function gamipress_get_reserved_terms() {

    $reserved_terms = array(
        'attachment',
        'attachment_id',
        'author',
        'author_name',
        'calendar',
        'cat',
        'category',
        'category__and',
        'category__in',
        'category__not_in',
        'category_name',
        'comments_per_page',
        'comments_popup',
        'cpage',
        'day',
        'debug',
        'error',
        'exact',
        'feed',
        'hour',
        'link_category',
        'm',
        'minute',
        'monthnum',
        'more',
        'name',
        'nav_menu',
        'nopaging',
        'offset',
        'order',
        'orderby',
        'p',
        'page',
        'page_id',
        'paged',
        'pagename',
        'pb',
        'perm',
        'post',
        'post__in',
        'post__not_in',
        'post_format',
        'post_mime_type',
        'post_status',
        'post_tag',
        'post_type',
        'posts',
        'posts_per_archive_page',
        'posts_per_page',
        'preview',
        'robots',
        's',
        'search',
        'second',
        'sentence',
        'showposts',
        'static',
        'subpost',
        'subpost_id',
        'tag',
        'tag__and',
        'tag__in',
        'tag__not_in',
        'tag_id',
        'tag_slug__and',
        'tag_slug__in',
        'taxonomy',
        'tb',
        'term',
        'type',
        'w',
        'withcomments',
        'withoutcomments',
        'year',
    );

    /**
     * Filter reserved terms
     *
     * @since 1.7.4
     *
     * @param array $reserved_terms
     *
     * @return array
     */
    return apply_filters( 'gamipress_get_reserved_terms', $reserved_terms );

}

/**
 * Get registered layout options
 *
 * @since 2.0.0
 *
 * @return array
 */
function gamipress_get_layout_options() {

    /**
     * Filter registered layout options
     *
     * @since 2.0.0
     *
     * @param array $layout_options
     *
     * @return array
     */
    return apply_filters( 'gamipress_layout_options', array(
        'left' 		=> '<img src="' . GAMIPRESS_URL . 'assets/img/layout-left.svg">' . __( 'Left', 'gamipress' ),
        'top' 		=> '<img src="' . GAMIPRESS_URL . 'assets/img/layout-top.svg">' . __( 'Top', 'gamipress' ),
        'right' 	=> '<img src="' . GAMIPRESS_URL . 'assets/img/layout-right.svg">' . __( 'Right', 'gamipress' ),
        'bottom' 	=> '<img src="' . GAMIPRESS_URL . 'assets/img/layout-bottom.svg">' . __( 'Bottom', 'gamipress' ),
        'none' 		=> '<img src="' . GAMIPRESS_URL . 'assets/img/layout-none.svg">' . __( 'None', 'gamipress' ),
    ) );

}

/**
 * Get registered alignment options
 *
 * @since 2.0.0
 *
 * @return array
 */
function gamipress_get_alignment_options() {

    /**
     * Filter registered layout options
     *
     * @since 2.0.0
     *
     * @param array $layout_options
     *
     * @return array
     */
    return apply_filters( 'gamipress_alignment_options', array(
        'none' 		=> '<img src="' . GAMIPRESS_URL . 'assets/img/align-' . ( is_rtl() ? 'right' : 'left' ) . '.svg">' . __( 'None', 'gamipress' ),
        'left' 		=> '<img src="' . GAMIPRESS_URL . 'assets/img/align-left.svg">' . __( 'Left', 'gamipress' ),
        'center'    => '<img src="' . GAMIPRESS_URL . 'assets/img/align-center.svg">' . __( 'Center', 'gamipress' ),
        'right' 	=> '<img src="' . GAMIPRESS_URL . 'assets/img/align-right.svg">' . __( 'Right', 'gamipress' ),
        'justify' 	=> '<img src="' . GAMIPRESS_URL . 'assets/img/align-justify.svg">' . __( 'Justify', 'gamipress' ),

    ) );

}

/**
 * Sanitize achievement types for shortcodes
 *
 * @since 6.0.0
 *
 * @param array $achievement_types
 *
 * @return array
 */
function gamipress_sanitize_achievement_types_slugs_array( $achievement_types ) {
    
    $sanitize_achievement_types = array();
    
    foreach ( $achievement_types as $index => $achievement_type ){
        
        if ( !in_array( $achievement_type, gamipress_get_achievement_types_slugs(), true ) ){      
            unset( $achievement_types[$index] );
        }
    }
    $sanitize_achievement_types = array_merge( $sanitize_achievement_types, $achievement_types );

    return $sanitize_achievement_types;
    
}

/**
 * Sanitize rank types for shortcodes
 *
 * @since 6.0.0
 *
 * @param array $rank_types
 *
 * @return array
 */
function gamipress_sanitize_rank_types_slugs_array( $rank_types ) {
    
    $sanitize_rank_types = array();
    
    foreach ( $rank_types as $index => $rank_type ){
        
        if ( !in_array( $rank_type, gamipress_get_rank_types_slugs(), true ) ){      
            unset( $rank_types[$index] );
        }
    }
    $sanitize_rank_types = array_merge( $sanitize_rank_types, $rank_types );

    return $sanitize_rank_types;
    
}

/**
 * Sanitize point types for shortcodes
 *
 * @since 6.0.0
 *
 * @param array $point_types
 *
 * @return array
 */
function gamipress_sanitize_point_types_slugs_array( $point_types ) {
    
    $sanitize_point_types = array();
   
    foreach ( $point_types as $index => $point_type ){
        
        if ( !in_array( $point_type, gamipress_get_points_types_slugs(), true ) ){      
            unset( $point_types[$index] );
        }
    }
    $sanitize_point_types = array_merge( $sanitize_point_types, $point_types );

    return $sanitize_point_types;
    
}

/**
 * Registered title sizes for shortcodes
 *
 * @since 6.0.0
 *
 * @param array $point_types
 *
 * @return array
 */
function gamipress_title_size_options() {

    $options = array(
        'h1'    => __( 'Heading 1', 'gamipress' ),
        'h2'    => __( 'Heading 2', 'gamipress' ),
        'h3'    => __( 'Heading 3', 'gamipress' ),
        'h4'    => __( 'Heading 4', 'gamipress' ),
        'h5'    => __( 'Heading 5', 'gamipress' ),
        'h6'    => __( 'Heading 6', 'gamipress' ),
        'p'     => __( 'Paragraph', 'gamipress' ),
    );

    return apply_filters( 'gamipress_title_size_options', $options );

}

/**
 * Sanitize title size for shortcodes
 *
 * @since 6.0.0
 *
 * @param array $point_types
 *
 * @return array
 */
function gamipress_sanitize_title_size_option( $option ) {

    $options = gamipress_title_size_options();

    if( ! isset( $options[$option] ) ) {
        return 'h2';
    }

    return $option;

}
```