first
This commit is contained in:
338
wp-content/plugins/wordpress-seo/inc/class-wpseo-rank.php
Normal file
338
wp-content/plugins/wordpress-seo/inc/class-wpseo-rank.php
Normal file
@ -0,0 +1,338 @@
|
||||
<?php
|
||||
/**
|
||||
* WPSEO plugin file.
|
||||
*
|
||||
* @package WPSEO\Internals
|
||||
*/
|
||||
|
||||
/**
|
||||
* Holder for SEO Rank information.
|
||||
*/
|
||||
class WPSEO_Rank {
|
||||
|
||||
/**
|
||||
* Constant used for determining a bad SEO rating.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const BAD = 'bad';
|
||||
|
||||
/**
|
||||
* Constant used for determining an OK SEO rating.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const OK = 'ok';
|
||||
|
||||
/**
|
||||
* Constant used for determining a good SEO rating.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const GOOD = 'good';
|
||||
|
||||
/**
|
||||
* Constant used for determining that no focus keyphrase is set.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const NO_FOCUS = 'na';
|
||||
|
||||
/**
|
||||
* Constant used for determining that this content is not indexed.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
const NO_INDEX = 'noindex';
|
||||
|
||||
/**
|
||||
* All possible ranks.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected static $ranks = [
|
||||
self::BAD,
|
||||
self::OK,
|
||||
self::GOOD,
|
||||
self::NO_FOCUS,
|
||||
self::NO_INDEX,
|
||||
];
|
||||
|
||||
/**
|
||||
* Holds the translation from seo score slug to actual score range.
|
||||
*
|
||||
* @var array
|
||||
*/
|
||||
protected static $ranges = [
|
||||
self::NO_FOCUS => [
|
||||
'start' => 0,
|
||||
'end' => 0,
|
||||
],
|
||||
self::BAD => [
|
||||
'start' => 1,
|
||||
'end' => 40,
|
||||
],
|
||||
self::OK => [
|
||||
'start' => 41,
|
||||
'end' => 70,
|
||||
],
|
||||
self::GOOD => [
|
||||
'start' => 71,
|
||||
'end' => 100,
|
||||
],
|
||||
];
|
||||
|
||||
/**
|
||||
* The current rank.
|
||||
*
|
||||
* @var int
|
||||
*/
|
||||
protected $rank;
|
||||
|
||||
/**
|
||||
* WPSEO_Rank constructor.
|
||||
*
|
||||
* @param int $rank The actual rank.
|
||||
*/
|
||||
public function __construct( $rank ) {
|
||||
if ( ! in_array( $rank, self::$ranks, true ) ) {
|
||||
$rank = self::BAD;
|
||||
}
|
||||
|
||||
$this->rank = $rank;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the saved rank for this rank.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_rank() {
|
||||
return $this->rank;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a CSS class for this rank.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_css_class() {
|
||||
$labels = [
|
||||
self::NO_FOCUS => 'na',
|
||||
self::NO_INDEX => 'noindex',
|
||||
self::BAD => 'bad',
|
||||
self::OK => 'ok',
|
||||
self::GOOD => 'good',
|
||||
];
|
||||
|
||||
return $labels[ $this->rank ];
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a label for this rank.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_label() {
|
||||
$labels = [
|
||||
self::NO_FOCUS => __( 'Not available', 'wordpress-seo' ),
|
||||
self::NO_INDEX => __( 'No index', 'wordpress-seo' ),
|
||||
self::BAD => __( 'Needs improvement', 'wordpress-seo' ),
|
||||
self::OK => __( 'OK', 'wordpress-seo' ),
|
||||
self::GOOD => __( 'Good', 'wordpress-seo' ),
|
||||
];
|
||||
|
||||
return $labels[ $this->rank ];
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns an inclusive language label for this rank.
|
||||
* The only difference with get_label above is that we return "Potentially non-inclusive" for an OK rank.
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_inclusive_language_label() {
|
||||
if ( $this->rank === self::OK ) {
|
||||
return __( 'Potentially non-inclusive', 'wordpress-seo' );
|
||||
}
|
||||
return $this->get_label();
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a label for use in a drop down.
|
||||
*
|
||||
* @return mixed
|
||||
*/
|
||||
public function get_drop_down_label() {
|
||||
$labels = [
|
||||
self::NO_FOCUS => sprintf(
|
||||
/* translators: %s expands to the SEO score */
|
||||
__( 'SEO: %s', 'wordpress-seo' ),
|
||||
__( 'No Focus Keyphrase', 'wordpress-seo' )
|
||||
),
|
||||
self::BAD => sprintf(
|
||||
/* translators: %s expands to the SEO score */
|
||||
__( 'SEO: %s', 'wordpress-seo' ),
|
||||
__( 'Needs improvement', 'wordpress-seo' )
|
||||
),
|
||||
self::OK => sprintf(
|
||||
/* translators: %s expands to the SEO score */
|
||||
__( 'SEO: %s', 'wordpress-seo' ),
|
||||
__( 'OK', 'wordpress-seo' )
|
||||
),
|
||||
self::GOOD => sprintf(
|
||||
/* translators: %s expands to the SEO score */
|
||||
__( 'SEO: %s', 'wordpress-seo' ),
|
||||
__( 'Good', 'wordpress-seo' )
|
||||
),
|
||||
self::NO_INDEX => sprintf(
|
||||
/* translators: %s expands to the SEO score */
|
||||
__( 'SEO: %s', 'wordpress-seo' ),
|
||||
__( 'Post Noindexed', 'wordpress-seo' )
|
||||
),
|
||||
];
|
||||
|
||||
return $labels[ $this->rank ];
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the drop down labels for the readability score.
|
||||
*
|
||||
* @return string The readability rank label.
|
||||
*/
|
||||
public function get_drop_down_readability_labels() {
|
||||
$labels = [
|
||||
self::BAD => sprintf(
|
||||
/* translators: %s expands to the readability score */
|
||||
__( 'Readability: %s', 'wordpress-seo' ),
|
||||
__( 'Needs improvement', 'wordpress-seo' )
|
||||
),
|
||||
self::OK => sprintf(
|
||||
/* translators: %s expands to the readability score */
|
||||
__( 'Readability: %s', 'wordpress-seo' ),
|
||||
__( 'OK', 'wordpress-seo' )
|
||||
),
|
||||
self::GOOD => sprintf(
|
||||
/* translators: %s expands to the readability score */
|
||||
__( 'Readability: %s', 'wordpress-seo' ),
|
||||
__( 'Good', 'wordpress-seo' )
|
||||
),
|
||||
];
|
||||
|
||||
return $labels[ $this->rank ];
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets the drop down labels for the inclusive language score.
|
||||
*
|
||||
* @return string The inclusive language rank label.
|
||||
*/
|
||||
public function get_drop_down_inclusive_language_labels() {
|
||||
$labels = [
|
||||
self::BAD => sprintf(
|
||||
/* translators: %s expands to the inclusive language score */
|
||||
__( 'Inclusive language: %s', 'wordpress-seo' ),
|
||||
__( 'Needs improvement', 'wordpress-seo' )
|
||||
),
|
||||
self::OK => sprintf(
|
||||
/* translators: %s expands to the inclusive language score */
|
||||
__( 'Inclusive language: %s', 'wordpress-seo' ),
|
||||
__( 'Potentially non-inclusive', 'wordpress-seo' )
|
||||
),
|
||||
self::GOOD => sprintf(
|
||||
/* translators: %s expands to the inclusive language score */
|
||||
__( 'Inclusive language: %s', 'wordpress-seo' ),
|
||||
__( 'Good', 'wordpress-seo' )
|
||||
),
|
||||
];
|
||||
|
||||
return $labels[ $this->rank ];
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the starting score for this rank.
|
||||
*
|
||||
* @return int The start score.
|
||||
*/
|
||||
public function get_starting_score() {
|
||||
// No index does not have a starting score.
|
||||
if ( $this->rank === self::NO_INDEX ) {
|
||||
return -1;
|
||||
}
|
||||
|
||||
return self::$ranges[ $this->rank ]['start'];
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the ending score for this rank.
|
||||
*
|
||||
* @return int The end score.
|
||||
*/
|
||||
public function get_end_score() {
|
||||
// No index does not have an end score.
|
||||
if ( $this->rank === self::NO_INDEX ) {
|
||||
return -1;
|
||||
}
|
||||
|
||||
return self::$ranges[ $this->rank ]['end'];
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a rank for a specific numeric score.
|
||||
*
|
||||
* @param int $score The score to determine a rank for.
|
||||
*
|
||||
* @return self
|
||||
*/
|
||||
public static function from_numeric_score( $score ) {
|
||||
// Set up the default value.
|
||||
$rank = new self( self::BAD );
|
||||
|
||||
foreach ( self::$ranges as $rank_index => $range ) {
|
||||
if ( $range['start'] <= $score && $score <= $range['end'] ) {
|
||||
$rank = new self( $rank_index );
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
return $rank;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a list of all possible SEO Ranks.
|
||||
*
|
||||
* @return WPSEO_Rank[]
|
||||
*/
|
||||
public static function get_all_ranks() {
|
||||
return array_map( [ 'WPSEO_Rank', 'create_rank' ], self::$ranks );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a list of all possible Readability Ranks.
|
||||
*
|
||||
* @return WPSEO_Rank[]
|
||||
*/
|
||||
public static function get_all_readability_ranks() {
|
||||
return array_map( [ 'WPSEO_Rank', 'create_rank' ], [ self::BAD, self::OK, self::GOOD ] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a list of all possible Inclusive Language Ranks.
|
||||
*
|
||||
* @return WPSEO_Rank[]
|
||||
*/
|
||||
public static function get_all_inclusive_language_ranks() {
|
||||
return array_map( [ 'WPSEO_Rank', 'create_rank' ], [ self::BAD, self::OK, self::GOOD ] );
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts a numeric rank into a WPSEO_Rank object, for use in functional array_* functions.
|
||||
*
|
||||
* @param string $rank SEO Rank.
|
||||
*
|
||||
* @return WPSEO_Rank
|
||||
*/
|
||||
private static function create_rank( $rank ) {
|
||||
return new self( $rank );
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user