Overview

Namespaces

  • None
  • VSP
    • Core
      • Abstracts
      • Interfaces
      • Traits
        • WC_Compatibility
    • Deprecation
    • Helper
    • Modules
      • Addons
      • Logger

Classes

  • VSP\Ajax
  • VSP\Ajaxer
  • VSP\Base
  • VSP\Cache
  • VSP\Core\Abstracts\Addon
  • VSP\Core\Abstracts\Log_Handler
  • VSP\Core\Abstracts\Plugin_Settings
  • VSP\Core\Instance_Handler
  • VSP\Deprecation\Actions
  • VSP\Deprecation\Filters
  • VSP\Error
  • VSP\Framework
  • VSP\Framework_Admin
  • VSP\Framework_Base
  • VSP\Framework_Modules
  • VSP\Helper
  • VSP\Helper\Price_Calculation
  • VSP\Modules\Addons
  • VSP\Modules\Addons\Admin
  • VSP\Modules\Addons\Core
  • VSP\Modules\Logger
  • VSP\Modules\Logger\File_Handler
  • VSP\Modules\Logger\Levels
  • VSP\Modules\Shortcode
  • VSP\Modules\System_Logs
  • VSP\Modules\System_Tools
  • VSP\Modules\WPOnion
  • VSP\Setup
  • VSP\WC_Compatibility
  • VSP_Framework_Loader

Interfaces

  • VSP\Core\Interfaces\Log_Handler
  • VSP\Core\Interfaces\Logger

Traits

  • VSP\Core\Traits\Array_Helper
  • VSP\Core\Traits\Framework
  • VSP\Core\Traits\String_Helper
  • VSP\Core\Traits\URL
  • VSP\Core\Traits\WC_Compatibility\Product
  • VSP\Core\Traits\WC_Compatibility\Version
  • VSP\Core\Traits\WC_Helper
  • VSP\Core\Traits\WP

Functions

  • vsp_add_wc_required_notice
  • vsp_ajax_action
  • vsp_current_screen
  • vsp_date_format
  • vsp_delete_cache
  • vsp_doing_it_wrong
  • vsp_force_load
  • vsp_force_load_vendors
  • vsp_get_cache
  • vsp_get_cache_defaults
  • vsp_get_file_paths
  • vsp_get_logger
  • vsp_get_time_in_seconds
  • vsp_is_admin
  • vsp_is_ajax
  • vsp_is_cron
  • vsp_is_error
  • vsp_is_frontend
  • vsp_is_heartbeat
  • vsp_is_json
  • vsp_is_request
  • vsp_is_screen
  • vsp_json_last_error
  • vsp_list_files
  • vsp_list_log_files
  • vsp_load_core_assets
  • vsp_load_file
  • vsp_log_msg
  • vsp_logger
  • vsp_make_log_list_tree
  • vsp_maybe_load
  • vsp_placeholder_img
  • vsp_print_log_files_ui
  • vsp_register_assets
  • vsp_register_plugin
  • vsp_send_callback_error
  • vsp_send_callback_success
  • vsp_send_json_callback
  • vsp_set_cache
  • vsp_set_time_limit
  • vsp_slashit
  • vsp_time_format
  • vsp_unslashit
  • vsp_url
  • vsp_validate_required_plugin
  • Overview
  • Namespace
  • Class
  1:   2:   3:   4:   5:   6:   7:   8:   9:  10:  11:  12:  13:  14:  15:  16:  17:  18:  19:  20:  21:  22:  23:  24:  25:  26:  27:  28:  29:  30:  31:  32:  33:  34:  35:  36:  37:  38:  39:  40:  41:  42:  43:  44:  45:  46:  47:  48:  49:  50:  51:  52:  53:  54:  55:  56:  57:  58:  59:  60:  61:  62:  63:  64:  65:  66:  67:  68:  69:  70:  71:  72:  73:  74:  75:  76:  77:  78:  79:  80:  81:  82:  83:  84:  85:  86:  87:  88:  89:  90:  91:  92:  93:  94:  95:  96:  97:  98:  99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: 137: 138: 139: 140: 141: 142: 143: 144: 
<?php

namespace VSP\Core\Traits;

defined( 'ABSPATH' ) || exit;

use VSP\Helper;
use WPOnion\Exception\Cache_Not_Found;

/**
 * Trait VSP_Framework_WP_Trait
 *
 * @author Varun Sridharan <varunsridharan23@gmail.com>
 */
trait WP {
    /**
     * Checks if given user role is the same as current user role
     *
     * @param null $role
     * @param null $current_role
     *
     * @return bool
     */
    public static function is_user_role( $role = null, $current_role = null ) {
        if ( in_array( $role, array( 'logedout', 'loggedout', 'visitor' ), true ) ) {
            $role = 'visitor';
        }

        if ( null === $current_role ) {
            $current_role = Helper::current_user( true );
        }

        return ( $role === $current_role );
    }

    /**
     * Gets current user information.
     *
     * @param bool $user_role_only .
     *
     * @return mixed|string|\WP_User
     */
    public static function current_user( $user_role_only = true ) {
        $user_role = wp_get_current_user();
        if ( true === $user_role_only ) {
            $user_roles = $user_role->roles;
            $user_role  = array_shift( $user_roles );
            if ( null === $user_role ) {
                $user_role = 'visitor';
            }
        }
        return $user_role;
    }

    /**
     * Gets current wp user id.
     *
     * @return int
     */
    public static function current_user_id() {
        return get_current_user_id();
    }

    /**
     * This function will filter vsp_user_roles_as_options function and provide only the given user role slug values
     *
     * @param array $required .
     *
     * @return array
     */
    public static function filter_roles( $required = array() ) {
        return self::filter_array_data( $required, self::user_roles_lists( false ) );
    }

    /**
     * Returns only user roles as options or just a array of slug.
     *
     * @param bool $only_slug .
     *
     * @return array
     */
    public static function user_roles_lists( $only_slug = false ) {
        try {
            $user_roles = vsp_get_cache( 'vsp/user_roles/options' );
        } catch ( Cache_Not_Found $exception ) {
            $user_roles = array();
            foreach ( self::get_user_roles() as $slug => $data ) {
                $user_roles[ $slug ] = $data['name'];
            }
            vsp_set_cache( 'vsp/user_roles/options', $user_roles );
        }
        return ( true === $only_slug ) ? array_keys( $user_roles ) : $user_roles;
    }

    /**
     * Returns User Role's title for the given user slug.
     *
     * @param string|bool $slug
     * @param string|bool $default
     *
     * @return mixed
     */
    public static function user_role_title( $slug, $default = false ) {
        $roles = self::user_roles_lists();
        return ( isset( $roles[ $slug ] ) ) ? $roles[ $slug ] : $default;
    }

    /**
     * @param bool $only_wp
     *
     * @return array
     */
    public static function get_user_roles( $only_wp = false ) {
        try {
            $user_roles = vsp_get_cache( 'vsp/user_roles/list' );
        } catch ( Cache_Not_Found $exception ) {
            $user_roles = array();
            if ( function_exists( 'wp_roles' ) ) {
                $user_roles            = wp_roles()->roles;
                $user_roles['visitor'] = array( 'name' => esc_html__( 'Visitor / Logged-Out User', 'vsp-framework' ) );
            }
            vsp_set_cache( 'vsp/user_roles/list', $user_roles );
        }

        if ( true === $only_wp ) {
            unset( $user_roles['visitor'] );
            return $user_roles;
        }
        return $user_roles;
    }

    /**
     * Gets the current WordPress site name.
     *
     * This is helpful for retrieving the actual site name instead of the
     * network name on multisite installations.
     *
     * @return string
     */
    public static function get_site_name() {
        return ( is_multisite() ) ? get_blog_details()->blogname : get_bloginfo( 'name' );
    }
}
API documentation generated by ApiGen