| @@ -1,48 +1,27 @@ | ||
| 1 | 1 | <?php |
| 2 | -/** | |
| 3 | - * @package Polylang | |
| 4 | - */ | |
| 5 | 2 | |
| 6 | 3 | /** |
| 7 | - * A fully static class to manage strings translations on admin side | |
| 4 | + * a fully static class to manage strings translations on admin side | |
| 8 | 5 | * |
| 9 | 6 | * @since 1.6 |
| 10 | 7 | */ |
| 11 | 8 | class PLL_Admin_Strings { |
| 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(); | |
| 9 | + static protected $strings = array(); // strings to translate | |
| 10 | + static protected $default_strings; // default strings to register | |
| 23 | 11 | |
| 24 | 12 | /** |
| 25 | - * The strings to register by default. | |
| 13 | + * init: add filters | |
| 26 | 14 | * |
| 27 | - * @var string[] | |
| 28 | - */ | |
| 29 | - protected static $default_strings; | |
| 30 | - | |
| 31 | - /** | |
| 32 | - * Add filters | |
| 33 | - * | |
| 34 | 15 | * @since 1.6 |
| 35 | - * | |
| 36 | - * @return void | |
| 37 | 16 | */ |
| 38 | - public static function init() { | |
| 17 | + static public function init() { | |
| 39 | 18 | // default strings translations sanitization |
| 40 | 19 | add_filter( 'pll_sanitize_string_translation', array( __CLASS__, 'sanitize_string_translation' ), 10, 2 ); |
| 41 | 20 | } |
| 42 | 21 | |
| 43 | 22 | /** |
| 44 | - * Register strings for translation making sure it is not duplicate or empty | |
| 23 | + * register strings for translation making sure it is not duplicate or empty | |
| 45 | 24 | * |
| 46 | 25 | * @since 0.6 |
| 47 | 26 | * |
| 48 | 27 | * @param string $name A unique name for the string |
| @@ -48,11 +27,16 @@ | ||
| 48 | 27 | * @param string $name A unique name for the string |
| 49 | 28 | * @param string $string The string to register |
| 50 | 29 | * @param string $context Optional, the group in which the string is registered, defaults to 'polylang' |
| 51 | 30 | * @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 | |
| 53 | 31 | */ |
| 54 | - public static function register_string( $name, $string, $context = 'Polylang', $multiline = false ) { | |
| 32 | + static public 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 | + | |
| 55 | 39 | if ( $string && is_scalar( $string ) ) { |
| 56 | 40 | self::$strings[ md5( $string ) ] = compact( 'name', 'string', 'context', 'multiline' ); |
| 57 | 41 | } |
| 58 | 42 | } |
| @@ -57,21 +41,32 @@ | ||
| 57 | 41 | } |
| 58 | 42 | } |
| 59 | 43 | |
| 60 | 44 | /** |
| 61 | - * Get registered strings | |
| 45 | + * get registered strings | |
| 62 | 46 | * |
| 63 | 47 | * @since 0.6.1 |
| 64 | 48 | * |
| 65 | 49 | * @return array list of all registered strings |
| 66 | 50 | */ |
| 67 | - public static function &get_strings() { | |
| 51 | + static public function &get_strings() { | |
| 68 | 52 | self::$default_strings = array( |
| 53 | + 'options' => array( | |
| 54 | + 'blogname' => __( 'Site Title' ), | |
| 55 | + 'blogdescription' => __( 'Tagline' ), | |
| 56 | + 'date_format' => __( 'Date Format' ), | |
| 57 | + 'time_format' => __( 'Time Format' ), | |
| 58 | + ), | |
| 69 | 59 | 'widget_title' => __( 'Widget title', 'polylang' ), |
| 70 | 60 | 'widget_text' => __( 'Widget text', 'polylang' ), |
| 71 | 61 | ); |
| 72 | 62 | |
| 73 | - // Widgets titles | |
| 63 | + // WP strings | |
| 64 | + foreach ( self::$default_strings['options'] as $option => $string ) { | |
| 65 | + self::register_string( $string, get_option( $option ), 'WordPress' ); | |
| 66 | + } | |
| 67 | + | |
| 68 | + // widgets titles | |
| 74 | 69 | global $wp_registered_widgets; |
| 75 | 70 | $sidebars = wp_get_sidebars_widgets(); |
| 76 | 71 | foreach ( $sidebars as $sidebar => $widgets ) { |
| 77 | 72 | if ( 'wp_inactive_widgets' == $sidebar || empty( $widgets ) ) { |
| @@ -78,10 +73,10 @@ | ||
| 78 | 73 | continue; |
| 79 | 74 | } |
| 80 | 75 | |
| 81 | 76 | foreach ( $widgets as $widget ) { |
| 82 | - // Nothing can be done if the widget is created using pre WP2.8 API :( | |
| 83 | - // There is no object, so we can't access it to get the widget options | |
| 77 | + // nothing can be done if the widget is created using pre WP2.8 API :( | |
| 78 | + // there is no object, so we can't access it to get the widget options | |
| 84 | 79 | if ( ! isset( $wp_registered_widgets[ $widget ]['callback'][0] ) || ! is_object( $wp_registered_widgets[ $widget ]['callback'][0] ) || ! method_exists( $wp_registered_widgets[ $widget ]['callback'][0], 'get_settings' ) ) { |
| 85 | 80 | continue; |
| 86 | 81 | } |
| 87 | 82 | |
| @@ -87,9 +82,9 @@ | ||
| 87 | 82 | |
| 88 | 83 | $widget_settings = $wp_registered_widgets[ $widget ]['callback'][0]->get_settings(); |
| 89 | 84 | $number = $wp_registered_widgets[ $widget ]['params'][0]['number']; |
| 90 | 85 | |
| 91 | - // Don't enable widget translation if the widget is visible in only one language or if there is no title | |
| 86 | + // don't enable widget translation if the widget is visible in only one language or if there is no title | |
| 92 | 87 | if ( empty( $widget_settings[ $number ]['pll_lang'] ) ) { |
| 93 | 88 | if ( isset( $widget_settings[ $number ]['title'] ) && $title = $widget_settings[ $number ]['title'] ) { |
| 94 | 89 | self::register_string( self::$default_strings['widget_title'], $title, 'Widget' ); |
| 95 | 90 | } |
| @@ -113,9 +108,9 @@ | ||
| 113 | 108 | return self::$strings; |
| 114 | 109 | } |
| 115 | 110 | |
| 116 | 111 | /** |
| 117 | - * Performs the sanitization ( before saving in DB ) of default strings translations | |
| 112 | + * performs the sanitization ( before saving in DB ) of default strings translations | |
| 118 | 113 | * |
| 119 | 114 | * @since 1.6 |
| 120 | 115 | * |
| 121 | 116 | * @param string $translation translation to sanitize |
| @@ -121,15 +116,21 @@ | ||
| 121 | 116 | * @param string $translation translation to sanitize |
| 122 | 117 | * @param string $name unique name for the string |
| 123 | 118 | * @return string |
| 124 | 119 | */ |
| 125 | - public static function sanitize_string_translation( $translation, $name ) { | |
| 120 | + static public function sanitize_string_translation( $translation, $name ) { | |
| 121 | + $translation = wp_unslash( trim( $translation ) ); | |
| 122 | + | |
| 123 | + if ( false !== ( $option = array_search( $name, self::$default_strings['options'], true ) ) ) { | |
| 124 | + $translation = sanitize_option( $option, $translation ); | |
| 125 | + } | |
| 126 | + | |
| 126 | 127 | if ( $name == self::$default_strings['widget_title'] ) { |
| 127 | - $translation = sanitize_text_field( $translation ); | |
| 128 | + $translation = strip_tags( $translation ); | |
| 128 | 129 | } |
| 129 | 130 | |
| 130 | 131 | if ( $name == self::$default_strings['widget_text'] && ! current_user_can( 'unfiltered_html' ) ) { |
| 131 | - $translation = wp_kses_post( $translation ); | |
| 132 | + $translation = wp_unslash( wp_filter_post_kses( addslashes( $translation ) ) ); // wp_filter_post_kses() expects slashed | |
| 132 | 133 | } |
| 133 | 134 | |
| 134 | 135 | return $translation; |
| 135 | 136 | } |
