array( 'us', 'ca' ), 'fr' => array( 'ca-qc' ), 'pt' => array( 'br' ), 'es' => array( 'mx', 'ar', 'co' ), ); /** @var array|null */ private static $catalog = null; /** * All languages keyed by code. * * @return array */ public static function all() { if ( null === self::$catalog ) { self::$catalog = array(); $raw = file_get_contents( LANGFERRY_DIR . 'data/languages.json' ); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents foreach ( (array) json_decode( (string) $raw, true ) as $lang ) { self::$catalog[ $lang['code'] ] = $lang; } } return self::$catalog; } public static function exists( $code ) { return is_string( $code ) && isset( self::all()[ $code ] ); } public static function get( $code ) { $all = self::all(); return isset( $all[ $code ] ) ? $all[ $code ] : null; } public static function name( $code, $native = false ) { $lang = self::get( $code ); if ( ! $lang ) { return (string) $code; } return $native ? $lang['native'] : $lang['name']; } public static function hreflang( $code ) { $lang = self::get( $code ); return $lang ? $lang['hreflang'] : (string) $code; } public static function locale( $code ) { $lang = self::get( $code ); return $lang ? $lang['locale'] : (string) $code; } public static function is_rtl( $code ) { $lang = self::get( $code ); return $lang ? (bool) $lang['rtl'] : false; } /** * The place a flag stands for, to label the flag choices in the settings. */ public static function flag_place( $flag ) { $places = array( 'gb' => __( 'United Kingdom', 'langferry' ), 'us' => __( 'United States', 'langferry' ), 'ca' => __( 'Canada', 'langferry' ), 'fr' => __( 'France', 'langferry' ), 'ca-qc' => __( 'Quebec', 'langferry' ), 'pt' => __( 'Portugal', 'langferry' ), 'br' => __( 'Brazil', 'langferry' ), 'es' => __( 'Spain', 'langferry' ), 'mx' => __( 'Mexico', 'langferry' ), 'ar' => __( 'Argentina', 'langferry' ), 'co' => __( 'Colombia', 'langferry' ), ); return $places[ $flag ] ?? $flag; } public static function flag_url( $code ) { $lang = self::get( $code ); $flag = $lang ? $lang['flag'] : 'un'; // The flag chosen for this language in the settings, if it has choices. $chosen = Settings::effective()['switcher']['flags'][ $code ] ?? ''; if ( in_array( $chosen, self::ALT_FLAGS[ $code ] ?? array(), true ) ) { $flag = $chosen; } /** * Filters the flag image used for a language, e.g. to show the US flag for English. * * @param string $flag flag-icons id (ISO 3166 code or region id like "gb-sct"). * @param string $code Language code. */ $flag = apply_filters( 'langferry_flag', $flag, $code ); return self::flag_file_url( $flag ); } /** * URL of a flag image that ships with the plugin, by its flag-icons id (us, ca-qc). * * @param string $flag Flag id. */ public static function flag_file_url( $flag ) { return LANGFERRY_URL . 'assets/flags/' . rawurlencode( (string) $flag ) . '.svg'; } /** * URL slug for a language ("zh-CN" → "zh-cn"). */ public static function url_slug( $code ) { return strtolower( $code ); } /** * Language code for a URL slug, or null. */ public static function from_url_slug( $slug, array $allowed ) { $slug = strtolower( (string) $slug ); foreach ( $allowed as $code ) { if ( strtolower( $code ) === $slug ) { return $code; } } return null; } }