| 1 | <?PHP |
|---|
| 2 | |
|---|
| 3 | /** |
|---|
| 4 | * Native GetText-Support for WordPress |
|---|
| 5 | * ------------------------------------ |
|---|
| 6 | * The Patch enhanced WordPress with native support for gettext. |
|---|
| 7 | * Actually WP is shipped with an own implementation called "PoMo" |
|---|
| 8 | * that uses a lot of resources like CPU-Time and Memory. |
|---|
| 9 | * Using gettext turned out to be much faster and efficient. |
|---|
| 10 | * |
|---|
| 11 | * @revision 02 |
|---|
| 12 | * @author Bernd Holzmueller <bernd@tiggerswelt.net> |
|---|
| 13 | * @url http://oss.tiggerswelt.net/wordpress/3.3.0/ |
|---|
| 14 | * @license http://creativecommons.org/licenses/by-sa/3.0/de/ Creative Commons Attribution-Share Alike 3.0 Germany |
|---|
| 15 | **/ |
|---|
| 16 | |
|---|
| 17 | // Check if gettext-support is available |
|---|
| 18 | if (!extension_loaded ('gettext')) |
|---|
| 19 | return; |
|---|
| 20 | |
|---|
| 21 | class Translate_GetText_Native { |
|---|
| 22 | // Our default domain |
|---|
| 23 | private $Domain = null; |
|---|
| 24 | |
|---|
| 25 | // Merged domains |
|---|
| 26 | private $pOthers = array (); |
|---|
| 27 | private $sOthers = array (); |
|---|
| 28 | |
|---|
| 29 | // Some Dummy-Function just to be API-compatible |
|---|
| 30 | function add_entry ($entry) { return false; } |
|---|
| 31 | function add_entry_or_merge ($entry) { return false; } |
|---|
| 32 | function set_header ($header, $value) { return false; } |
|---|
| 33 | function set_headers (&$headers) { return false; } |
|---|
| 34 | function get_header ($header) { return false; } |
|---|
| 35 | function translate_entry (&$entry) { return false; } |
|---|
| 36 | |
|---|
| 37 | // {{{ select_plural_form |
|---|
| 38 | /** |
|---|
| 39 | * Given the number of items, returns the 0-based index of the plural form to use |
|---|
| 40 | * |
|---|
| 41 | * Here, in the base Translations class, the common logic for English is implemented: |
|---|
| 42 | * 0 if there is one element, 1 otherwise |
|---|
| 43 | * |
|---|
| 44 | * This function should be overrided by the sub-classes. For example MO/PO can derive the logic |
|---|
| 45 | * from their headers. |
|---|
| 46 | * |
|---|
| 47 | * @param integer $count number of items |
|---|
| 48 | **/ |
|---|
| 49 | function select_plural_form ($count) { |
|---|
| 50 | return (1 == $count? 0 : 1); |
|---|
| 51 | } |
|---|
| 52 | // }}} |
|---|
| 53 | |
|---|
| 54 | function get_plural_forms_count () { return 2; } |
|---|
| 55 | |
|---|
| 56 | // {{{ merge_with |
|---|
| 57 | /** |
|---|
| 58 | * Merge this translation with another one, the other one takes precedence |
|---|
| 59 | * |
|---|
| 60 | * @param object $other |
|---|
| 61 | * |
|---|
| 62 | * @access public |
|---|
| 63 | * @return void |
|---|
| 64 | **/ |
|---|
| 65 | function merge_with (&$other) { |
|---|
| 66 | $this->pOthers [] = $other; |
|---|
| 67 | } |
|---|
| 68 | // }}} |
|---|
| 69 | |
|---|
| 70 | // {{{ merge_originals_with |
|---|
| 71 | /** |
|---|
| 72 | * Merge this translation with another one, this one takes precedence |
|---|
| 73 | * |
|---|
| 74 | * @param object $other |
|---|
| 75 | * |
|---|
| 76 | * @access public |
|---|
| 77 | * @return void |
|---|
| 78 | **/ |
|---|
| 79 | function merge_originals_with (&$other) { |
|---|
| 80 | $this->sOthers [] = $Other; |
|---|
| 81 | } |
|---|
| 82 | // }}} |
|---|
| 83 | |
|---|
| 84 | // {{{ translate |
|---|
| 85 | /** |
|---|
| 86 | * Try to translate a given string |
|---|
| 87 | * |
|---|
| 88 | * @param string $singular |
|---|
| 89 | * @param string $context (optional) |
|---|
| 90 | * |
|---|
| 91 | * @access public |
|---|
| 92 | * @return string |
|---|
| 93 | **/ |
|---|
| 94 | function translate ($singular, $context = null) { |
|---|
| 95 | // Check for an empty string |
|---|
| 96 | if (strlen ($singular) == 0) |
|---|
| 97 | return $singular; |
|---|
| 98 | |
|---|
| 99 | // Check other domains that take precedence |
|---|
| 100 | foreach ($this->pOthers as $o) |
|---|
| 101 | if (($t = $o->translate ($singular, $context)) != $singular) |
|---|
| 102 | return $t; |
|---|
| 103 | |
|---|
| 104 | // Make sure we have a domain assigned |
|---|
| 105 | if ($this->Domain === null) |
|---|
| 106 | return $singular; |
|---|
| 107 | |
|---|
| 108 | // Translate without a context |
|---|
| 109 | if ($context === null) { |
|---|
| 110 | if (($t = dgettext ($this->Domain, $singular)) != $singular) |
|---|
| 111 | return $t; |
|---|
| 112 | |
|---|
| 113 | // Translate with a given context |
|---|
| 114 | } else { |
|---|
| 115 | $T = $context . "\x04" . $singular; |
|---|
| 116 | $t = dgettext ($this->Domain, $T); |
|---|
| 117 | |
|---|
| 118 | if ($T != $t) |
|---|
| 119 | return $t; |
|---|
| 120 | } |
|---|
| 121 | |
|---|
| 122 | // Check for other domains |
|---|
| 123 | foreach ($this->sOthers as $o) |
|---|
| 124 | if (($t = $o->translate ($singular, $context)) != $singular) |
|---|
| 125 | return $t; |
|---|
| 126 | |
|---|
| 127 | return $singular; |
|---|
| 128 | } |
|---|
| 129 | // }}} |
|---|
| 130 | |
|---|
| 131 | // {{{ translate_plural |
|---|
| 132 | /** |
|---|
| 133 | * Try to translate a plural string |
|---|
| 134 | * |
|---|
| 135 | * @param string $singular Singular version |
|---|
| 136 | * @param string $plural Plural version |
|---|
| 137 | * @param int $count Number of "items" |
|---|
| 138 | * @param string $context (optional) |
|---|
| 139 | * |
|---|
| 140 | * @access public |
|---|
| 141 | * @return string |
|---|
| 142 | **/ |
|---|
| 143 | function translate_plural ($singular, $plural, $count, $context = null) { |
|---|
| 144 | // Check for an empty string |
|---|
| 145 | if (strlen ($singular) == 0) |
|---|
| 146 | return $singular; |
|---|
| 147 | |
|---|
| 148 | // Get the "default" return-value |
|---|
| 149 | $default = ($count == 1 ? $singular : $plural); |
|---|
| 150 | |
|---|
| 151 | // Check other domains that take precedence |
|---|
| 152 | foreach ($this->pOthers as $o) |
|---|
| 153 | if (($t = $o->translate_plural ($singular, $plural, $count, $context)) != $default) |
|---|
| 154 | return $t; |
|---|
| 155 | |
|---|
| 156 | // Make sure we have a domain assigned |
|---|
| 157 | if ($this->Domain === null) |
|---|
| 158 | return $default; |
|---|
| 159 | |
|---|
| 160 | // Translate without context |
|---|
| 161 | if ($context === null) { |
|---|
| 162 | $t = dngettext ($this->Domain, $singular, $plural, $count); |
|---|
| 163 | |
|---|
| 164 | if (($t != $singular) && ($t != $plural)) |
|---|
| 165 | return $t; |
|---|
| 166 | |
|---|
| 167 | // Translate using a given context |
|---|
| 168 | } else { |
|---|
| 169 | $T = $context . "\x04" . $singular; |
|---|
| 170 | $t = dngettext ($this->Domain, $T, $plural, $count); |
|---|
| 171 | |
|---|
| 172 | if (($T != $t) && ($t != $plural)) |
|---|
| 173 | return $t; |
|---|
| 174 | } |
|---|
| 175 | |
|---|
| 176 | // Check other domains |
|---|
| 177 | foreach ($this->sOthers as $o) |
|---|
| 178 | if (($t = $o->translate_plural ($singular, $plural, $count, $context)) != $default) |
|---|
| 179 | return $t; |
|---|
| 180 | |
|---|
| 181 | return $default; |
|---|
| 182 | } |
|---|
| 183 | // }}} |
|---|
| 184 | |
|---|
| 185 | // {{{ import_from_file |
|---|
| 186 | /** |
|---|
| 187 | * Fills up with the entries from MO file $filename |
|---|
| 188 | * |
|---|
| 189 | * @param string $filename MO file to load |
|---|
| 190 | **/ |
|---|
| 191 | function import_from_file ($filename) { |
|---|
| 192 | // Make sure that the locale is set correctly in environment |
|---|
| 193 | global $locale; |
|---|
| 194 | |
|---|
| 195 | putenv ('LC_ALL=' . $locale); |
|---|
| 196 | setlocale (LC_ALL, $locale); |
|---|
| 197 | |
|---|
| 198 | // Retrive MD5-hash of the file |
|---|
| 199 | # DIRTY! But there is no other way at the moment to make this work |
|---|
| 200 | if (!($Domain = md5_file ($filename))) |
|---|
| 201 | return false; |
|---|
| 202 | |
|---|
| 203 | // Make sure that the language-directory exists |
|---|
| 204 | $Path = './wp-lang/' . $locale . '/LC_MESSAGES'; |
|---|
| 205 | |
|---|
| 206 | if (!wp_mkdir_p ($Path)) |
|---|
| 207 | return false; |
|---|
| 208 | |
|---|
| 209 | // Make sure that the MO-File is existant at the destination |
|---|
| 210 | $fn = $Path . '/' . $Domain . '.mo'; |
|---|
| 211 | |
|---|
| 212 | if (!is_file ($fn) && !@copy ($filename, $fn)) |
|---|
| 213 | return false; |
|---|
| 214 | |
|---|
| 215 | // Setup the "domain" for gettext |
|---|
| 216 | bindtextdomain ($Domain, './wp-lang/'); |
|---|
| 217 | bind_textdomain_codeset ($domain, 'UTF-8'); |
|---|
| 218 | |
|---|
| 219 | // Do the final stuff and return success |
|---|
| 220 | $this->Domain = $Domain; |
|---|
| 221 | |
|---|
| 222 | return true; |
|---|
| 223 | } |
|---|
| 224 | // }}} |
|---|
| 225 | } |
|---|
| 226 | |
|---|
| 227 | if (function_exists ('class_alias')) |
|---|
| 228 | class_alias ('Translate_GetText_Native', 'MO'); |
|---|
| 229 | else { |
|---|
| 230 | class MO extends Translate_GetText_Native { } |
|---|
| 231 | } |
|---|
| 232 | |
|---|
| 233 | ?> |
|---|