| @@ -1,5 +1,8 @@ | ||
| 1 | 1 | <?php |
| 2 | +/** | |
| 3 | + * @package Polylang | |
| 4 | + */ | |
| 2 | 5 | |
| 3 | 6 | /** |
| 4 | 7 | * A fully static class to manage strings translations on admin side |
| 5 | 8 | * |
| @@ -5,15 +8,33 @@ | ||
| 5 | 8 | * |
| 6 | 9 | * @since 1.6 |
| 7 | 10 | */ |
| 8 | 11 | class PLL_Admin_Strings { |
| 9 | - protected static $strings = array(); // strings to translate | |
| 10 | - protected static $default_strings; // default strings to register | |
| 12 | + /** | |
| 13 | + * Stores the strings to translate. | |
| 14 | + * | |
| 15 | + * @var array { | |
| 16 | + * @type string $name A unique name for the string. | |
| 17 | + * @type string $string The actual string to translate. | |
| 18 | + * @type string $context The group in which the string is registered. | |
| 19 | + * @type bool $multiline Whether the string table should display a multiline textarea or a single line input. | |
| 20 | + * } | |
| 21 | + */ | |
| 22 | + protected static $strings = array(); | |
| 11 | 23 | |
| 12 | 24 | /** |
| 25 | + * The strings to register by default. | |
| 26 | + * | |
| 27 | + * @var string[]|null | |
| 28 | + */ | |
| 29 | + protected static $default_strings; | |
| 30 | + | |
| 31 | + /** | |
| 13 | 32 | * Add filters |
| 14 | 33 | * |
| 15 | 34 | * @since 1.6 |
| 35 | + * | |
| 36 | + * @return void | |
| 16 | 37 | */ |
| 17 | 38 | public static function init() { |
| 18 | 39 | // default strings translations sanitization |
| 19 | 40 | add_filter( 'pll_sanitize_string_translation', array( __CLASS__, 'sanitize_string_translation' ), 10, 2 ); |
| @@ -27,16 +48,11 @@ | ||
| 27 | 48 | * @param string $name A unique name for the string |
| 28 | 49 | * @param string $string The string to register |
| 29 | 50 | * @param string $context Optional, the group in which the string is registered, defaults to 'polylang' |
| 30 | 51 | * @param bool $multiline Optional, whether the string table should display a multiline textarea or a single line input, defaults to single line |
| 52 | + * @return void | |
| 31 | 53 | */ |
| 32 | 54 | public static function register_string( $name, $string, $context = 'Polylang', $multiline = false ) { |
| 33 | - // Backward compatibility with Polylang older than 1.1 | |
| 34 | - if ( is_bool( $context ) ) { | |
| 35 | - $multiline = $context; | |
| 36 | - $context = 'Polylang'; | |
| 37 | - } | |
| 38 | - | |
| 39 | 55 | if ( $string && is_scalar( $string ) ) { |
| 40 | 56 | self::$strings[ md5( $string ) ] = compact( 'name', 'string', 'context', 'multiline' ); |
| 41 | 57 | } |
| 42 | 58 | } |
| @@ -49,23 +65,12 @@ | ||
| 49 | 65 | * @return array list of all registered strings |
| 50 | 66 | */ |
| 51 | 67 | public static function &get_strings() { |
| 52 | 68 | self::$default_strings = array( |
| 53 | - 'options' => array( | |
| 54 | - 'blogname' => __( 'Site Title', 'polylang' ), | |
| 55 | - 'blogdescription' => __( 'Tagline', 'polylang' ), | |
| 56 | - 'date_format' => __( 'Date Format', 'polylang' ), | |
| 57 | - 'time_format' => __( 'Time Format', 'polylang' ), | |
| 58 | - ), | |
| 59 | 69 | 'widget_title' => __( 'Widget title', 'polylang' ), |
| 60 | 70 | 'widget_text' => __( 'Widget text', 'polylang' ), |
| 61 | 71 | ); |
| 62 | 72 | |
| 63 | - // WP strings | |
| 64 | - foreach ( self::$default_strings['options'] as $option => $string ) { | |
| 65 | - self::register_string( $string, get_option( $option ), 'WordPress' ); | |
| 66 | - } | |
| 67 | - | |
| 68 | 73 | // Widgets titles |
| 69 | 74 | global $wp_registered_widgets; |
| 70 | 75 | $sidebars = wp_get_sidebars_widgets(); |
| 71 | 76 | foreach ( $sidebars as $sidebar => $widgets ) { |
| @@ -117,13 +122,8 @@ | ||
| 117 | 122 | * @param string $name unique name for the string |
| 118 | 123 | * @return string |
| 119 | 124 | */ |
| 120 | 125 | public static function sanitize_string_translation( $translation, $name ) { |
| 121 | - | |
| 122 | - if ( false !== ( $option = array_search( $name, self::$default_strings['options'], true ) ) ) { | |
| 123 | - $translation = sanitize_option( $option, $translation ); | |
| 124 | - } | |
| 125 | - | |
| 126 | 126 | if ( $name == self::$default_strings['widget_title'] ) { |
| 127 | 127 | $translation = sanitize_text_field( $translation ); |
| 128 | 128 | } |
| 129 | 129 | |