webadmin.php

/var/www/hkosl.com/aga/wp-content/plugins/wordpress-seo/inc/class-wpseo-utils.php

<?php
/**
 * WPSEO plugin file.
 *
 * @package WPSEO\Internals
 * @since   1.8.0
 */

/**
 * Group of utility methods for use by WPSEO.
 * All methods are static, this is just a sort of namespacing class wrapper.
 */
class WPSEO_Utils {

    /**
     * Whether the PHP filter extension is enabled.
     *
     * @since 1.8.0
     *
     * @var bool $has_filters
     */
    public static $has_filters;

    /**
     * Notifications to be shown in the JavaScript console.
     *
     * @since 3.3.2
     *
     * @var array
     */
    protected static $console_notifications = array();

    /**
     * Check whether the current user is allowed to access the configuration.
     *
     * @since 1.8.0
     *
     * @return boolean
     */
    public static function grant_access() {
        // @todo Add deprecation warning.
        if ( ! is_multisite() ) {
            return true;
        }

        $options = get_site_option( 'wpseo_ms' );

        if ( empty( $options['access'] ) || $options['access'] === 'admin' ) {
            return current_user_can( 'wpseo_manage_options' );
        }

        return is_super_admin();
    }

    /**
     * Check whether file editing is allowed for the .htaccess and robots.txt files.
     *
     * {@internal current_user_can() checks internally whether a user is on wp-ms and adjusts accordingly.}}
     *
     * @since 1.8.0
     *
     * @return bool
     */
    public static function allow_system_file_edit() {
        $allowed = true;

        if ( current_user_can( 'edit_files' ) === false ) {
            $allowed = false;
        }

        /**
         * Filter: 'wpseo_allow_system_file_edit' - Allow developers to change whether the editing of
         * .htaccess and robots.txt is allowed.
         *
         * @api bool $allowed Whether file editing is allowed.
         */

        return apply_filters( 'wpseo_allow_system_file_edit', $allowed );
    }

    /**
     * Check if the web server is running on Apache.
     *
     * @since 1.8.0
     *
     * @return bool
     */
    public static function is_apache() {
        if ( ! isset( $_SERVER['SERVER_SOFTWARE'] ) ) {
            return false;
        }

        $software = sanitize_text_field( wp_unslash( $_SERVER['SERVER_SOFTWARE'] ) );

        return stripos( $software, 'apache' ) !== false;
    }

    /**
     * Check if the web server is running on Nginx.
     *
     * @since 1.8.0
     *
     * @return bool
     */
    public static function is_nginx() {
        if ( ! isset( $_SERVER['SERVER_SOFTWARE'] ) ) {
            return false;
        }

        $software = sanitize_text_field( wp_unslash( $_SERVER['SERVER_SOFTWARE'] ) );

        return stripos( $software, 'nginx' ) !== false;
    }

    /**
     * Register a notification to be shown in the JavaScript console.
     *
     * @since 3.3.2
     *
     * @param string $identifier    Notification identifier.
     * @param string $message       Message to be shown.
     * @param bool   $one_time_only Only show once (if added multiple times).
     */
    public static function javascript_console_notification( $identifier, $message, $one_time_only = false ) {
        static $registered_hook;

        if ( is_null( $registered_hook ) ) {
            add_action( 'admin_footer', array( __CLASS__, 'localize_console_notices' ), 999 );
            $registered_hook = true;
        }

        $prefix = 'Yoast SEO: ';
        if ( substr( $message, 0, strlen( $prefix ) ) !== $prefix ) {
            $message = $prefix . $message;
        }

        if ( $one_time_only ) {
            self::$console_notifications[ $identifier ] = $message;
        }
        else {
            self::$console_notifications[] = $message;
        }
    }

    /**
     * Localize the console notifications to JavaScript.
     *
     * @since 3.3.2
     */
    public static function localize_console_notices() {
        if ( empty( self::$console_notifications ) ) {
            return;
        }

        wp_localize_script( WPSEO_Admin_Asset_Manager::PREFIX . 'admin-global-script', 'wpseoConsoleNotifications', array_values( self::$console_notifications ) );
    }

    /**
     * Check whether a url is relative.
     *
     * @since 1.8.0
     *
     * @param string $url URL string to check.
     *
     * @return bool
     */
    public static function is_url_relative( $url ) {
        return ( strpos( $url, 'http' ) !== 0 && strpos( $url, '//' ) !== 0 );
    }

    /**
     * List all the available user roles.
     *
     * @since 1.8.0
     *
     * @return array $roles
     */
    public static function get_roles() {
        global $wp_roles;

        if ( ! isset( $wp_roles ) ) {
            $wp_roles = new WP_Roles();
        }

        $roles = $wp_roles->get_names();

        return $roles;
    }

    /**
     * Standardize whitespace in a string.
     *
     * Replace line breaks, carriage returns, tabs with a space, then remove double spaces.
     *
     * @since 1.8.0
     *
     * @param string $string String input to standardize.
     *
     * @return string
     */
    public static function standardize_whitespace( $string ) {
        return trim( str_replace( '  ', ' ', str_replace( array( "\t", "\n", "\r", "\f" ), ' ', $string ) ) );
    }

    /**
     * First strip out registered and enclosing shortcodes using native WordPress strip_shortcodes function.
     * Then strip out the shortcodes with a filthy regex, because people don't properly register their shortcodes.
     *
     * @since 1.8.0
     *
     * @param string $text Input string that might contain shortcodes.
     *
     * @return string $text String without shortcodes.
     */
    public static function strip_shortcode( $text ) {
        return preg_replace( '`\[[^\]]+\]`s', '', strip_shortcodes( $text ) );
    }

    /**
     * Recursively trim whitespace round a string value or of string values within an array.
     * Only trims strings to avoid typecasting a variable (to string).
     *
     * @since 1.8.0
     *
     * @param mixed $value Value to trim or array of values to trim.
     *
     * @return mixed Trimmed value or array of trimmed values.
     */
    public static function trim_recursive( $value ) {
        if ( is_string( $value ) ) {
            $value = trim( $value );
        }
        elseif ( is_array( $value ) ) {
            $value = array_map( array( __CLASS__, 'trim_recursive' ), $value );
        }

        return $value;
    }

    /**
     * Translates a decimal analysis score into a textual one.
     *
     * @since 1.8.0
     *
     * @param int  $val       The decimal score to translate.
     * @param bool $css_value Whether to return the i18n translated score or the CSS class value.
     *
     * @return string
     */
    public static function translate_score( $val, $css_value = true ) {
        $seo_rank = WPSEO_Rank::from_numeric_score( $val );

        if ( $css_value ) {
            return $seo_rank->get_css_class();
        }

        return $seo_rank->get_label();
    }

    /**
     * Emulate the WP native sanitize_text_field function in a %%variable%% safe way.
     *
     * @link https://core.trac.wordpress.org/browser/trunk/src/wp-includes/formatting.php for the original.
     *
     * Sanitize a string from user input or from the db.
     *
     * - Check for invalid UTF-8;
     * - Convert single < characters to entity;
     * - Strip all tags;
     * - Remove line breaks, tabs and extra white space;
     * - Strip octets - BUT DO NOT REMOVE (part of) VARIABLES WHICH WILL BE REPLACED.
     *
     * @since 1.8.0
     *
     * @param string $value String value to sanitize.
     *
     * @return string
     */
    public static function sanitize_text_field( $value ) {
        $filtered = wp_check_invalid_utf8( $value );

        if ( strpos( $filtered, '<' ) !== false ) {
            $filtered = wp_pre_kses_less_than( $filtered );
            // This will strip extra whitespace for us.
            $filtered = wp_strip_all_tags( $filtered, true );
        }
        else {
            $filtered = trim( preg_replace( '`[\r\n\t ]+`', ' ', $filtered ) );
        }

        $found = false;
        while ( preg_match( '`[^%](%[a-f0-9]{2})`i', $filtered, $match ) ) {
            $filtered = str_replace( $match[1], '', $filtered );
            $found    = true;
        }
        unset( $match );

        if ( $found ) {
            // Strip out the whitespace that may now exist after removing the octets.
            $filtered = trim( preg_replace( '` +`', ' ', $filtered ) );
        }

        /**
         * Filter a sanitized text field string.
         *
         * @since WP 2.9.0
         *
         * @param string $filtered The sanitized string.
         * @param string $str      The string prior to being sanitized.
         */

        return apply_filters( 'sanitize_text_field', $filtered, $value );
    }

    /**
     * Sanitize a url for saving to the database.
     * Not to be confused with the old native WP function.
     *
     * @todo [JRF => whomever] Check/improve url verification.
     *
     * @since 1.8.0
     *
     * @param string $value             String URL value to sanitize.
     * @param array  $allowed_protocols Optional set of allowed protocols.
     *
     * @return string
     */
    public static function sanitize_url( $value, $allowed_protocols = array( 'http', 'https' ) ) {
        return esc_url_raw( sanitize_text_field( rawurldecode( $value ) ), $allowed_protocols );
    }

    /**
     * Validate a value as boolean.
     *
     * @since 1.8.0
     *
     * @param mixed $value Value to validate.
     *
     * @return bool
     */
    public static function validate_bool( $value ) {
        if ( ! isset( self::$has_filters ) ) {
            self::$has_filters = extension_loaded( 'filter' );
        }

        if ( self::$has_filters ) {
            return filter_var( $value, FILTER_VALIDATE_BOOLEAN );
        }
        else {
            return self::emulate_filter_bool( $value );
        }
    }

    /**
     * Cast a value to bool.
     *
     * @since 1.8.0
     *
     * @param mixed $value Value to cast.
     *
     * @return bool
     */
    public static function emulate_filter_bool( $value ) {
        $true  = array(
            '1',
            'true',
            'True',
            'TRUE',
            'y',
            'Y',
            'yes',
            'Yes',
            'YES',
            'on',
            'On',
            'ON',
        );
        $false = array(
            '0',
            'false',
            'False',
            'FALSE',
            'n',
            'N',
            'no',
            'No',
            'NO',
            'off',
            'Off',
            'OFF',
        );

        if ( is_bool( $value ) ) {
            return $value;
        }
        elseif ( is_int( $value ) && ( $value === 0 || $value === 1 ) ) {
            return (bool) $value;
        }
        elseif ( ( is_float( $value ) && ! is_nan( $value ) ) && ( $value === (float) 0 || $value === (float) 1 ) ) {
            return (bool) $value;
        }
        elseif ( is_string( $value ) ) {
            $value = trim( $value );
            if ( in_array( $value, $true, true ) ) {
                return true;
            }
            elseif ( in_array( $value, $false, true ) ) {
                return false;
            }
            else {
                return false;
            }
        }

        return false;
    }

    /**
     * Validate a value as integer.
     *
     * @since 1.8.0
     *
     * @param mixed $value Value to validate.
     *
     * @return int|bool Int or false in case of failure to convert to int.
     */
    public static function validate_int( $value ) {
        if ( ! isset( self::$has_filters ) ) {
            self::$has_filters = extension_loaded( 'filter' );
        }

        if ( self::$has_filters ) {
            return filter_var( $value, FILTER_VALIDATE_INT );
        }
        else {
            return self::emulate_filter_int( $value );
        }
    }

    /**
     * Cast a value to integer.
     *
     * @since 1.8.0
     *
     * @param mixed $value Value to cast.
     *
     * @return int|bool
     */
    public static function emulate_filter_int( $value ) {
        if ( is_int( $value ) ) {
            return $value;
        }
        elseif ( is_float( $value ) ) {
            if ( (int) $value == $value && ! is_nan( $value ) ) {
                return (int) $value;
            }
            else {
                return false;
            }
        }
        elseif ( is_string( $value ) ) {
            $value = trim( $value );
            if ( $value === '' ) {
                return false;
            }
            elseif ( ctype_digit( $value ) ) {
                return (int) $value;
            }
            elseif ( strpos( $value, '-' ) === 0 && ctype_digit( substr( $value, 1 ) ) ) {
                return (int) $value;
            }
            else {
                return false;
            }
        }

        return false;
    }

    /**
     * Clears the WP or W3TC cache depending on which is used.
     *
     * @since 1.8.0
     */
    public static function clear_cache() {
        if ( function_exists( 'w3tc_pgcache_flush' ) ) {
            w3tc_pgcache_flush();
        }
        elseif ( function_exists( 'wp_cache_clear_cache' ) ) {
            wp_cache_clear_cache();
        }
    }

    /**
     * Flush W3TC cache after succesfull update/add of taxonomy meta option.
     *
     * @since 1.8.0
     */
    public static function flush_w3tc_cache() {
        if ( defined( 'W3TC_DIR' ) && function_exists( 'w3tc_objectcache_flush' ) ) {
            w3tc_objectcache_flush();
        }
    }

    /**
     * Clear rewrite rules.
     *
     * @since 1.8.0
     */
    public static function clear_rewrites() {
        delete_option( 'rewrite_rules' );
    }

    /**
     * Do simple reliable math calculations without the risk of wrong results.
     *
     * @link http://floating-point-gui.de/
     * @link http://php.net/language.types.float.php See the big red warning.
     *
     * In the rare case that the bcmath extension would not be loaded, it will return the normal calculation results.
     *
     * @since 1.5.0
     * @since 1.8.0 Moved from stand-alone function to this class.
     *
     * @param mixed  $number1   Scalar (string/int/float/bool).
     * @param string $action    Calculation action to execute. Valid input:
     *                          '+' or 'add' or 'addition',
     *                          '-' or 'sub' or 'subtract',
     *                          '*' or 'mul' or 'multiply',
     *                          '/' or 'div' or 'divide',
     *                          '%' or 'mod' or 'modulus'
     *                          '=' or 'comp' or 'compare'.
     * @param mixed  $number2   Scalar (string/int/float/bool).
     * @param bool   $round     Whether or not to round the result. Defaults to false.
     *                          Will be disregarded for a compare operation.
     * @param int    $decimals  Decimals for rounding operation. Defaults to 0.
     * @param int    $precision Calculation precision. Defaults to 10.
     *
     * @return mixed Calculation Result or false if either or the numbers isn't scalar or
     *               an invalid operation was passed.
     *               - For compare the result will always be an integer.
     *               - For all other operations, the result will either be an integer (preferred)
     *                 or a float.
     */
    public static function calc( $number1, $action, $number2, $round = false, $decimals = 0, $precision = 10 ) {
        static $bc;

        if ( ! is_scalar( $number1 ) || ! is_scalar( $number2 ) ) {
            return false;
        }

        if ( ! isset( $bc ) ) {
            $bc = extension_loaded( 'bcmath' );
        }

        if ( $bc ) {
            $number1 = number_format( $number1, 10, '.', '' );
            $number2 = number_format( $number2, 10, '.', '' );
        }

        $result  = null;
        $compare = false;

        switch ( $action ) {
            case '+':
            case 'add':
            case 'addition':
                $result = ( $bc ) ? bcadd( $number1, $number2, $precision ) /* string */ : ( $number1 + $number2 );
                break;

            case '-':
            case 'sub':
            case 'subtract':
                $result = ( $bc ) ? bcsub( $number1, $number2, $precision ) /* string */ : ( $number1 - $number2 );
                break;

            case '*':
            case 'mul':
            case 'multiply':
                $result = ( $bc ) ? bcmul( $number1, $number2, $precision ) /* string */ : ( $number1 * $number2 );
                break;

            case '/':
            case 'div':
            case 'divide':
                if ( $bc ) {
                    $result = bcdiv( $number1, $number2, $precision ); // String, or NULL if right_operand is 0.
                }
                elseif ( $number2 != 0 ) {
                    $result = ( $number1 / $number2 );
                }

                if ( ! isset( $result ) ) {
                    $result = 0;
                }
                break;

            case '%':
            case 'mod':
            case 'modulus':
                if ( $bc ) {
                    $result = bcmod( $number1, $number2 ); // String, or NULL if modulus is 0.
                }
                elseif ( $number2 != 0 ) {
                    $result = ( $number1 % $number2 );
                }

                if ( ! isset( $result ) ) {
                    $result = 0;
                }
                break;

            case '=':
            case 'comp':
            case 'compare':
                $compare = true;
                if ( $bc ) {
                    $result = bccomp( $number1, $number2, $precision ); // Returns int 0, 1 or -1.
                }
                else {
                    $result = ( $number1 == $number2 ) ? 0 : ( ( $number1 > $number2 ) ? 1 : - 1 );
                }
                break;
        }

        if ( isset( $result ) ) {
            if ( $compare === false ) {
                if ( $round === true ) {
                    $result = round( floatval( $result ), $decimals );
                    if ( $decimals === 0 ) {
                        $result = (int) $result;
                    }
                }
                else {
                    $result = ( intval( $result ) == $result ) ? intval( $result ) : floatval( $result );
                }
            }

            return $result;
        }

        return false;
    }

    /**
     * Trim whitespace and NBSP (Non-breaking space) from string.
     *
     * @since 2.0.0
     *
     * @param string $string String input to trim.
     *
     * @return string
     */
    public static function trim_nbsp_from_string( $string ) {
        $find   = array( '&nbsp;', chr( 0xC2 ) . chr( 0xA0 ) );
        $string = str_replace( $find, ' ', $string );
        $string = trim( $string );

        return $string;
    }

    /**
     * Check if a string is a valid datetime.
     *
     * @since 2.0.0
     *
     * @param string $datetime String input to check as valid input for DateTime class.
     *
     * @return bool
     */
    public static function is_valid_datetime( $datetime ) {

        if ( substr( $datetime, 0, 1 ) === '-' ) {
            return false;
        }

        try {
            return new DateTime( $datetime ) !== false;
        } catch ( Exception $exc ) {
            return false;
        }
    }

    /**
     * Format the URL to be sure it is okay for using as a redirect url.
     *
     * This method will parse the URL and combine them in one string.
     *
     * @since 2.3.0
     *
     * @param string $url URL string.
     *
     * @return mixed
     */
    public static function format_url( $url ) {
        $parsed_url = wp_parse_url( $url );

        $formatted_url = '';
        if ( ! empty( $parsed_url['path'] ) ) {
            $formatted_url = $parsed_url['path'];
        }

        // Prepend a slash if first char != slash.
        if ( stripos( $formatted_url, '/' ) !== 0 ) {
            $formatted_url = '/' . $formatted_url;
        }

        // Append 'query' string if it exists.
        if ( ! empty( $parsed_url['query'] ) ) {
            $formatted_url .= '?' . $parsed_url['query'];
        }

        return apply_filters( 'wpseo_format_admin_url', $formatted_url );
    }

    /**
     * Get plugin name from file.
     *
     * @since 2.3.3
     *
     * @param string $plugin Plugin path relative to plugins directory.
     *
     * @return string|bool
     */
    public static function get_plugin_name( $plugin ) {
        $plugin_details = get_plugin_data( WP_PLUGIN_DIR . '/' . $plugin );

        if ( $plugin_details['Name'] !== '' ) {
            return $plugin_details['Name'];
        }

        return false;
    }

    /**
     * Retrieves the sitename.
     *
     * @since 3.0.0
     *
     * @return string
     */
    public static function get_site_name() {
        return wp_strip_all_tags( get_bloginfo( 'name' ), true );
    }

    /**
     * Retrieves the title separator.
     *
     * @since 3.0.0
     *
     * @return string
     */
    public static function get_title_separator() {
        $replacement = WPSEO_Options::get_default( 'wpseo_titles', 'separator' );

        // Get the titles option and the separator options.
        $separator         = WPSEO_Options::get( 'separator' );
        $seperator_options = WPSEO_Option_Titles::get_instance()->get_separator_options();

        // This should always be set, but just to be sure.
        if ( isset( $seperator_options[ $separator ] ) ) {
            // Set the new replacement.
            $replacement = $seperator_options[ $separator ];
        }

        /**
         * Filter: 'wpseo_replacements_filter_sep' - Allow customization of the separator character(s).
         *
         * @api string $replacement The current separator.
         */
        return apply_filters( 'wpseo_replacements_filter_sep', $replacement );
    }

    /**
     * Check if the current opened page is a Yoast SEO page.
     *
     * @since 3.0.0
     *
     * @return bool
     */
    public static function is_yoast_seo_page() {
        static $is_yoast_seo;

        if ( $is_yoast_seo === null ) {
            $current_page = filter_input( INPUT_GET, 'page' );
            $is_yoast_seo = ( substr( $current_page, 0, 6 ) === 'wpseo_' );
        }

        return $is_yoast_seo;
    }

    /**
     * Check if the current opened page belongs to Yoast SEO Free.
     *
     * @since 3.3.0
     *
     * @param string $current_page The current page the user is on.
     *
     * @return bool
     */
    public static function is_yoast_seo_free_page( $current_page ) {
        $yoast_seo_free_pages = array(
            'wpseo_dashboard',
            'wpseo_titles',
            'wpseo_social',
            'wpseo_advanced',
            'wpseo_tools',
            'wpseo_search_console',
            'wpseo_licenses',
            'wpseo_courses',
        );

        return in_array( $current_page, $yoast_seo_free_pages, true );
    }

    /**
     * Checks if we are in the premium or free plugin.
     *
     * @return bool True when we are in the premium plugin.
     */
    public static function is_yoast_seo_premium() {
        return defined( 'WPSEO_PREMIUM_PLUGIN_FILE' );
    }

    /**
     * Determine if Yoast SEO is in development mode?
     *
     * Inspired by JetPack (https://github.com/Automattic/jetpack/blob/master/class.jetpack.php#L1383-L1406).
     *
     * @since 3.0.0
     *
     * @return bool
     */
    public static function is_development_mode() {
        $development_mode = false;

        if ( defined( 'WPSEO_DEBUG' ) ) {
            $development_mode = WPSEO_DEBUG;
        }
        elseif ( site_url() && false === strpos( site_url(), '.' ) ) {
            $development_mode = true;
        }

        /**
         * Filter the Yoast SEO development mode.
         *
         * @since 3.0
         *
         * @param bool $development_mode Is Yoast SEOs development mode active.
         */
        return apply_filters( 'yoast_seo_development_mode', $development_mode );
    }

    /**
     * Retrieve home URL with proper trailing slash.
     *
     * @since 3.3.0
     *
     * @param string      $path   Path relative to home URL.
     * @param string|null $scheme Scheme to apply.
     *
     * @return string Home URL with optional path, appropriately slashed if not.
     */
    public static function home_url( $path = '', $scheme = null ) {

        $home_url = home_url( $path, $scheme );

        if ( ! empty( $path ) ) {
            return $home_url;
        }

        $home_path = wp_parse_url( $home_url, PHP_URL_PATH );

        if ( '/' === $home_path ) { // Home at site root, already slashed.
            return $home_url;
        }

        if ( is_null( $home_path ) ) { // Home at site root, always slash.
            return trailingslashit( $home_url );
        }

        if ( is_string( $home_path ) ) { // Home in subdirectory, slash if permalink structure has slash.
            return user_trailingslashit( $home_url );
        }

        return $home_url;
    }

    /**
     * Returns a base64 URL for the svg for use in the menu.
     *
     * @since 3.3.0
     *
     * @param bool $base64 Whether or not to return base64'd output.
     *
     * @return string
     */
    public static function get_icon_svg( $base64 = true ) {
        $svg = '<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="100%" height="100%" style="fill:#82878c" viewBox="0 0 512 512" role="img" aria-hidden="true" focusable="false"><g><g><g><g><path d="M203.6,395c6.8-17.4,6.8-36.6,0-54l-79.4-204h70.9l47.7,149.4l74.8-207.6H116.4c-41.8,0-76,34.2-76,76V357c0,41.8,34.2,76,76,76H173C189,424.1,197.6,410.3,203.6,395z"/></g><g><path d="M471.6,154.8c0-41.8-34.2-76-76-76h-3L285.7,365c-9.6,26.7-19.4,49.3-30.3,68h216.2V154.8z"/></g></g><path stroke-width="2.974" stroke-miterlimit="10" d="M338,1.3l-93.3,259.1l-42.1-131.9h-89.1l83.8,215.2c6,15.5,6,32.5,0,48c-7.4,19-19,37.3-53,41.9l-7.2,1v76h8.3c81.7,0,118.9-57.2,149.6-142.9L431.6,1.3H338z M279.4,362c-32.9,92-67.6,128.7-125.7,131.8v-45c37.5-7.5,51.3-31,59.1-51.1c7.5-19.3,7.5-40.7,0-60l-75-192.7h52.8l53.3,166.8l105.9-294h58.1L279.4,362z"/></g></g></svg>';

        if ( $base64 ) {
            return 'data:image/svg+xml;base64,' . base64_encode( $svg );
        }

        return $svg;
    }

    /**
     * Returns the SVG for the traffic light in the metabox.
     *
     * @return string
     */
    public static function traffic_light_svg() {
        return <<<SVG
<svg class="yst-traffic-light init" version="1.1" xmlns="http://www.w3.org/2000/svg"
     role="img" aria-hidden="true" focusable="false"
     x="0px" y="0px" viewBox="0 0 30 47" enable-background="new 0 0 30 47" xml:space="preserve">
<g id="BG_1_">
</g>
<g id="traffic_light">
    <g>
        <g>
            <g>
                <path fill="#5B2942" d="M22,0H8C3.6,0,0,3.6,0,7.9v31.1C0,43.4,3.6,47,8,47h14c4.4,0,8-3.6,8-7.9V7.9C30,3.6,26.4,0,22,0z
                     M27.5,38.8c0,3.1-2.6,5.7-5.8,5.7H8.3c-3.2,0-5.8-2.5-5.8-5.7V8.3c0-1.5,0.6-2.9,1.7-4c1.1-1,2.5-1.6,4.1-1.6h13.4
                    c1.5,0,3,0.6,4.1,1.6c1.1,1.1,1.7,2.5,1.7,4V38.8z"/>
            </g>
            <g class="traffic-light-color traffic-light-red">
                <ellipse fill="#C8C8C8" cx="15" cy="23.5" rx="5.7" ry="5.6"/>
                <ellipse fill="#DC3232" cx="15" cy="10.9" rx="5.7" ry="5.6"/>
                <ellipse fill="#C8C8C8" cx="15" cy="36.1" rx="5.7" ry="5.6"/>
            </g>
            <g class="traffic-light-color traffic-light-orange">
                <ellipse fill="#F49A00" cx="15" cy="23.5" rx="5.7" ry="5.6"/>
                <ellipse fill="#C8C8C8" cx="15" cy="10.9" rx="5.7" ry="5.6"/>
                <ellipse fill="#C8C8C8" cx="15" cy="36.1" rx="5.7" ry="5.6"/>
            </g>
            <g class="traffic-light-color traffic-light-green">
                <ellipse fill="#C8C8C8" cx="15" cy="23.5" rx="5.7" ry="5.6"/>
                <ellipse fill="#C8C8C8" cx="15" cy="10.9" rx="5.7" ry="5.6"/>
                <ellipse fill="#63B22B" cx="15" cy="36.1" rx="5.7" ry="5.6"/>
            </g>
            <g class="traffic-light-color traffic-light-empty">
                <ellipse fill="#C8C8C8" cx="15" cy="23.5" rx="5.7" ry="5.6"/>
                <ellipse fill="#C8C8C8" cx="15" cy="10.9" rx="5.7" ry="5.6"/>
                <ellipse fill="#C8C8C8" cx="15" cy="36.1" rx="5.7" ry="5.6"/>
            </g>
            <g class="traffic-light-color traffic-light-init">
                <ellipse fill="#C8C8C8" cx="15" cy="23.5" rx="5.7" ry="5.6"/>
                <ellipse fill="#C8C8C8" cx="15" cy="10.9" rx="5.7" ry="5.6"/>
                <ellipse fill="#C8C8C8" cx="15" cy="36.1" rx="5.7" ry="5.6"/>
            </g>
        </g>
    </g>
</g>
</svg>
SVG;
    }

    /**
     * Checks if the WP-REST-API is available.
     *
     * @since 3.6
     * @since 3.7 Introduced the $minimum_version parameter.
     *
     * @param string $minimum_version The minimum version the API should be.
     *
     * @return bool Returns true if the API is available.
     */
    public static function is_api_available( $minimum_version = '2.0' ) {
        return ( defined( 'REST_API_VERSION' )
            && version_compare( REST_API_VERSION, $minimum_version, '>=' ) );
    }

    /**
     * Determine whether or not the metabox should be displayed for a post type.
     *
     * @param string|null $post_type Optional. The post type to check the visibility of the metabox for.
     *
     * @return bool Whether or not the metabox should be displayed.
     */
    protected static function display_post_type_metabox( $post_type = null ) {
        if ( ! isset( $post_type ) ) {
            $post_type = get_post_type();
        }

        if ( ! isset( $post_type ) || ! WPSEO_Post_Type::is_post_type_accessible( $post_type ) ) {
            return false;
        }

        if ( $post_type === 'attachment' && WPSEO_Options::get( 'disable-attachment' ) ) {
            return false;
        }

        return WPSEO_Options::get( 'display-metabox-pt-' . $post_type );
    }

    /**
     * Determine whether or not the metabox should be displayed for a taxonomy.
     *
     * @param string|null $taxonomy Optional. The post type to check the visibility of the metabox for.
     *
     * @return bool Whether or not the metabox should be displayed.
     */
    protected static function display_taxonomy_metabox( $taxonomy = null ) {
        if ( ! isset( $taxonomy ) || ! in_array( $taxonomy, get_taxonomies( array( 'public' => true ), 'names' ), true ) ) {
            return false;
        }

        return WPSEO_Options::get( 'display-metabox-tax-' . $taxonomy );
    }

    /**
     * Determines whether the metabox is active for the given identifier and type.
     *
     * @param string $identifier The identifier to check for.
     * @param string $type       The type to check for.
     *
     * @return bool Whether or not the metabox is active.
     */
    public static function is_metabox_active( $identifier, $type ) {
        if ( $type === 'post_type' ) {
            return self::display_post_type_metabox( $identifier );
        }

        if ( $type === 'taxonomy' ) {
            return self::display_taxonomy_metabox( $identifier );
        }

        return false;
    }

    /**
     * Determines whether or not WooCommerce is active.
     *
     * @return bool Whether or not WooCommerce is active.
     */
    public static function is_woocommerce_active() {
        return class_exists( 'Woocommerce' );
    }

    /**
     * Determines whether the plugin is active for the entire network.
     *
     * @return bool Whether or not the plugin is network-active.
     */
    public static function is_plugin_network_active() {
        static $network_active = null;

        if ( ! is_multisite() ) {
            return false;
        }

        // If a cached result is available, bail early.
        if ( $network_active !== null ) {
            return $network_active;
        }

        $network_active_plugins = wp_get_active_network_plugins();

        // Consider MU plugins and network-activated plugins as network-active.
        $network_active = strpos( wp_normalize_path( WPSEO_FILE ), wp_normalize_path( WPMU_PLUGIN_DIR ) ) === 0
            || in_array( WP_PLUGIN_DIR . '/' . WPSEO_BASENAME, $network_active_plugins, true );

        return $network_active;
    }

    /**
     * Getter for the Adminl10n array. Applies the wpseo_admin_l10n filter.
     *
     * @return array The Adminl10n array.
     */
    public static function get_admin_l10n() {
        $wpseo_admin_l10n = array();

        $additional_entries = apply_filters( 'wpseo_admin_l10n', array() );
        if ( is_array( $additional_entries ) ) {
            $wpseo_admin_l10n = array_merge( $wpseo_admin_l10n, $additional_entries );
        }

        return $wpseo_admin_l10n;
    }

    /**
     * Retrieves the analysis worker log level. Defaults to errors only.
     *
     * Uses bool YOAST_SEO_DEBUG as flag to enable logging. Off equals ERROR.
     * Uses string YOAST_SEO_DEBUG_ANALYSIS_WORKER as log level for the Analysis
     * Worker. Defaults to INFO.
     * Can be: TRACE, DEBUG, INFO, WARN or ERROR.
     *
     * @return string The log level to use.
     */
    public static function get_analysis_worker_log_level() {
        if ( defined( 'YOAST_SEO_DEBUG' ) && YOAST_SEO_DEBUG ) {
            return defined( 'YOAST_SEO_DEBUG_ANALYSIS_WORKER' ) ? YOAST_SEO_DEBUG_ANALYSIS_WORKER : 'INFO';
        }

        return 'ERROR';
    }

    /**
     * Returns the home url with the following modifications:
     *
     * In case of a multisite setup we return the network_home_url.
     * In case of no multisite setup we return the home_url while overriding the WPML filter.
     *
     * @codeCoverageIgnore
     *
     * @return string The home url.
     */
    public static function get_home_url() {
        // Add a new filter to undo WPML's changing of home url.
        add_filter( 'wpml_get_home_url', array( 'WPSEO_Utils', 'wpml_get_home_url' ), 10, 2 );

        $url = home_url();

        // If the plugin is network activated, use the network home URL.
        if ( self::is_plugin_network_active() ) {
            $url = network_home_url();
        }

        remove_filter( 'wpml_get_home_url', array( 'WPSEO_Utils', 'wpml_get_home_url' ), 10 );

        return $url;
    }

    /**
     * Returns the original URL instead of the language-enriched URL.
     * This method gets automatically triggered by the wpml_get_home_url filter.
     *
     * @codeCoverageIgnore
     *
     * @param string $home_url The url altered by WPML. Unused.
     * @param string $url      The url that isn't altered by WPML.
     *
     * @return string The original url.
     */
    public static function wpml_get_home_url( $home_url, $url ) {
        return $url;
    }

    /**
     * Checks if the current installation supports MyYoast access tokens.
     *
     * @codeCoverageIgnore
     *
     * @return bool True if access_tokens are supported.
     */
    public static function has_access_token_support() {
        return class_exists( 'WPSEO_MyYoast_Client' );
    }

    /**
     * Prepares data for outputting as JSON.
     *
     * @param array $data The data to format.
     *
     * @return false|string The prepared JSON string.
     */
    public static function format_json_encode( $data ) {
        $flags = 0;
        if ( version_compare( PHP_VERSION, '5.4', '>=' ) ) {
            // @codingStandardsIgnoreLine This is used in the wp_json_encode call, which checks for this.
            $flags = ( $flags | JSON_UNESCAPED_SLASHES );
        }
        if ( self::is_development_mode() ) {
            $flags = ( $flags | JSON_PRETTY_PRINT );

            /**
             * Filter the Yoast SEO development mode.
             *
             * @api array $data Allows filtering of the JSON data for debug purposes.
             */
            $data = apply_filters( 'wpseo_debug_json_data', $data );
        }

        return wp_json_encode( $data, $flags );
    }

    /**
     * Output a Schema blob.
     *
     * @param array  $graph The Schema graph array to output.
     * @param string $class The (optional) class to add to the script tag.
     *
     * @return bool
     */
    public static function schema_output( $graph, $class = 'yoast-schema-graph' ) {
        if ( ! is_array( $graph ) || empty( $graph ) ) {
            return false;
        }

        echo self::schema_tag( $graph, $class );
        return true;
    }

    /**
     * Returns a script tag with Schema blob.
     *
     * @param array  $graph The Schema graph array to output.
     * @param string $class The (optional) class to add to the script tag.
     *
     * @return false|string A schema blob with script tags.
     */
    public static function schema_tag( $graph, $class = 'yoast-schema-graph' ) {
        if ( ! is_array( $graph ) || empty( $graph ) ) {
            return false;
        }

        $output = array(
            '@context' => 'https://schema.org',
            '@graph'   => $graph,
        );
        return "<script type='application/ld+json' class='" . esc_attr( $class ) . "'>" . self::format_json_encode( $output ) . '</script>' . "\n";
    }

    /* ********************* DEPRECATED METHODS ********************* */

    /**
     * Returns the language part of a given locale, defaults to english when the $locale is empty.
     *
     * @see WPSEO_Language_Utils::get_language()
     *
     * @deprecated 9.5
     * @codeCoverageIgnore
     *
     * @param string $locale The locale to get the language of.
     *
     * @return string The language part of the locale.
     */
    public static function get_language( $locale ) {
        _deprecated_function( __METHOD__, 'WPSEO 9.5', 'WPSEO_Language_Utils::get_language' );
        return WPSEO_Language_Utils::get_language( $locale );
    }

    /**
     * Returns the user locale for the language to be used in the admin.
     *
     * WordPress 4.7 introduced the ability for users to specify an Admin language
     * different from the language used on the front end. This checks if the feature
     * is available and returns the user's language, with a fallback to the site's language.
     * Can be removed when support for WordPress 4.6 will be dropped, in favor
     * of WordPress get_user_locale() that already fallbacks to the site's locale.
     *
     * @see WPSEO_Language_Utils::get_user_locale()
     *
     * @deprecated 9.5
     * @codeCoverageIgnore
     *
     * @return string The locale.
     */
    public static function get_user_locale() {
        _deprecated_function( __METHOD__, 'WPSEO 9.5', 'WPSEO_Language_Utils::get_user_locale' );

        return WPSEO_Language_Utils::get_user_locale();
    }

    /**
     * Gets an array of enabled features.
     *
     * @return string[] The array of enabled features.
     */
    public static function retrieve_enabled_features() {
        $enabled_features = array();
        if ( defined( 'YOAST_SEO_ENABLED_FEATURES' ) ) {
            $enabled_features = preg_split( '/,\W*/', YOAST_SEO_ENABLED_FEATURES );
        }
        // Make the array of enabled features filterable, so features can be enabled at will.
        $enabled_features = apply_filters( 'wpseo_enable_feature', $enabled_features );

        return $enabled_features;
    }
}