namespace Yoast\WP\SEO\Helpers;
use WPSEO_Language_Utils;
use Yoast\WP\SEO\Conditionals\Greek_Support_Conditional;
use Yoast\WP\SEO\Conditionals\Japanese_Support_Conditional;
use Yoast\WP\SEO\Config\Researcher_Languages;
* A helper object for language features.
* Represents the Japanese support conditional.
* @var Japanese_Support_Conditional
protected $japanese_conditional;
* Represents the Greek support conditional.
* @var Greek_Support_Conditional
protected $greek_conditional;
* Language_Helper constructor.
* @param Japanese_Support_Conditional $japanese_conditional The Japanese support conditional.
* @param Greek_Support_Conditional $greek_conditional The Greek support conditional.
public function __construct( Japanese_Support_Conditional $japanese_conditional, Greek_Support_Conditional $greek_conditional ) {
$this->japanese_conditional = $japanese_conditional;
$this->greek_conditional = $greek_conditional;
* Checks whether word form recognition is active for the used language.
* @param string $language The used language.
* @return bool Whether word form recognition is active for the used language.
public function is_word_form_recognition_active( $language ) {
$supported_languages = [ 'de', 'en', 'es', 'fr', 'it', 'nl', 'ru', 'id', 'pt', 'pl', 'ar', 'sv', 'he', 'hu', 'nb', 'tr', 'cs', 'sk', 'fa' ];
// If JAPANESE_SUPPORT feature is enabled, push Japanese to the array of the supported languages.
if ( $this->japanese_conditional->is_met() ) {
\array_push( $supported_languages, 'ja' );
// If GREEK_SUPPORT feature is enabled, push Greek to the array of the supported languages.
if ( $this->greek_conditional->is_met() ) {
\array_push( $supported_languages, 'el' );
return \in_array( $language, $supported_languages, true );
* Checks whether the given language has function word support.
* (E.g. function words are used or filtered out for this language when doing some SEO and readability assessments).
* @param string $language The language to check.
* @return bool Whether the language has function word support.
public function has_function_word_support( $language ) {
$supported_languages = [ 'en', 'de', 'nl', 'fr', 'es', 'it', 'pt', 'ru', 'pl', 'sv', 'id', 'he', 'ar', 'hu', 'nb', 'tr', 'cs', 'sk', 'fa' ];
// If JAPANESE_SUPPORT feature is enabled, push Japanese to the array of the supported languages.
if ( $this->japanese_conditional->is_met() ) {
\array_push( $supported_languages, 'ja' );
// If GREEK_SUPPORT feature is enabled, push Greek to the array of the supported languages.
if ( $this->greek_conditional->is_met() ) {
\array_push( $supported_languages, 'el' );
return \in_array( $language, $supported_languages, true );
* Checks whether we have a specific researcher for the current locale and returns that language.
* If there is no researcher for the current locale, returns default as the researcher.
* @return string The language to use to select a researcher.
public function get_researcher_language() {
$researcher_language = WPSEO_Language_Utils::get_language( \get_locale() );
$supported_languages = Researcher_Languages::SUPPORTED_LANGUAGES;
// If JAPANESE_SUPPORT feature is enabled, push Japanese to the array of the supported languages.
if ( $this->japanese_conditional->is_met() ) {
\array_push( $supported_languages, 'ja' );
// If GREEK_SUPPORT feature is enabled, push Greek to the array of the supported languages.
if ( $this->greek_conditional->is_met() ) {
\array_push( $supported_languages, 'el' );
if ( ! \in_array( $researcher_language, $supported_languages, true ) ) {
$researcher_language = 'default';
return $researcher_language;