$version, "client_token" => self::client_token(), "signature" => $signature, "uid" => self::server_uid($api_key))); if (!remote::success($response_status)) { return false; } return true; } /** * @return an array of messages that will be written to the task log */ static function fetch_updates() { $request->locales = array(); $request->messages = new stdClass(); $locales = locales::installed(); foreach ($locales as $locale => $locale_data) { $request->locales[] = $locale; } // @todo Batch requests (max request size) foreach (Database::instance() ->select("key", "locale", "revision", "translation") ->from("incoming_translations") ->get() ->as_array() as $row) { if (!isset($request->messages->{$row->key})) { $request->messages->{$row->key} = 1; } if (!empty($row->revision) && !empty($row->translation)) { if (!is_object($request->messages->{$row->key})) { $request->messages->{$row->key} = new stdClass(); } $request->messages->{$row->key}->{$row->locale} = $row->revision; } } // @todo Include messages from outgoing_translations? $request_data = json_encode($request); $url = self::_server_url() . "?q=translations/fetch"; list ($response_data, $response_status) = remote::post($url, array("data" => $request_data)); if (!remote::success($response_status)) { throw new Exception("@todo TRANSLATIONS_FETCH_REQUEST_FAILED " . $response_status); } if (empty($response_data)) { return array(t("Translations fetch request resulted in an empty response")); } $response = json_decode($response_data); // Response format (JSON payload): // [{key:, translation: , rev:, locale:}, // {key:, ...} // ] foreach ($response as $message_data) { // @todo Better input validation if (empty($message_data->key) || empty($message_data->translation) || empty($message_data->locale) || empty($message_data->rev)) { throw new Exception("@todo TRANSLATIONS_FETCH_REQUEST_FAILED: Invalid response data"); } $key = $message_data->key; $locale = $message_data->locale; $revision = $message_data->rev; $translation = json_decode($message_data->translation); if (!is_string($translation)) { // Normalize stdclass to array $translation = (array) $translation; } $translation = serialize($translation); // @todo Should we normalize the incoming_translations table into messages(id, key, message) // and incoming_translations(id, translation, locale, revision)? Or just allow // incoming_translations.message to be NULL? $locale = $message_data->locale; $entry = ORM::factory("incoming_translation") ->where(array("key" => $key, "locale" => $locale)) ->find(); if (!$entry->loaded) { // @todo Load a message key -> message (text) dict into memory outside of this loop $root_entry = ORM::factory("incoming_translation") ->where(array("key" => $key, "locale" => "root")) ->find(); $entry->key = $key; $entry->message = $root_entry->message; $entry->locale = $locale; } $entry->revision = $revision; $entry->translation = $translation; $entry->save(); } } static function submit_translations() { // Request format (HTTP POST): // client_token = // uid = // signature = md5(user_api_key($uid, $client_token) . $data . $client_token)) // data = // JSON payload // // {: {message: // translations: {: , // : ...}}, // : {...} // } // @todo Batch requests (max request size) // @todo include base_revision in submission / how to handle resubmissions / edit fights? foreach (Database::instance() ->select("key", "message", "locale", "base_revision", "translation") ->from("outgoing_translations") ->get() as $row) { $key = $row->key; if (!isset($request->{$key})) { $request->{$key}->message = json_encode(unserialize($row->message)); } $request->{$key}->translations->{$row->locale} = json_encode(unserialize($row->translation)); } // @todo reduce memory consumption, e.g. free $request $request_data = json_encode($request); $url = self::_server_url() . "?q=translations/submit"; $signature = self::_sign($request_data); list ($response_data, $response_status) = remote::post( $url, array("data" => $request_data, "client_token" => self::client_token(), "signature" => $signature, "uid" => self::server_uid())); if (!remote::success($response_status)) { throw new Exception("@todo TRANSLATIONS_SUBMISSION_FAILED " . $response_status); } if (empty($response_data)) { return; } $response = json_decode($response_data); // Response format (JSON payload): // [{key:, locale:, rev:, status:}, // {key:, ...} // ] // @todo Move messages out of outgoing into incoming, using new rev? // @todo show which messages have been rejected / are pending? } /** * Plural forms. */ static function plural_forms($locale) { $parts = explode('_', $locale); $language = $parts[0]; // Data from CLDR 1.6 (http://unicode.org/cldr/data/common/supplemental/plurals.xml). // Docs: http://www.unicode.org/cldr/data/charts/supplemental/language_plural_rules.html switch ($language) { case 'az': case 'fa': case 'hu': case 'ja': case 'ko': case 'my': case 'to': case 'tr': case 'vi': case 'yo': case 'zh': case 'bo': case 'dz': case 'id': case 'jv': case 'ka': case 'km': case 'kn': case 'ms': case 'th': return array('other'); case 'ar': return array('zero', 'one', 'two', 'few', 'many', 'other'); case 'lv': return array('zero', 'one', 'other'); case 'ga': case 'se': case 'sma': case 'smi': case 'smj': case 'smn': case 'sms': return array('one', 'two', 'other'); case 'ro': case 'mo': case 'lt': case 'cs': case 'sk': case 'pl': return array('one', 'few', 'other'); case 'hr': case 'ru': case 'sr': case 'uk': case 'be': case 'bs': case 'sh': case 'mt': return array('one', 'few', 'many', 'other'); case 'sl': return array('one', 'two', 'few', 'other'); case 'cy': return array('one', 'two', 'many', 'other'); default: // en, de, etc. return array('one', 'other'); } } }