xliff_version = $xliff_version; } /** * Generate a XLIFF file for a given job. * * @param int $job_id * * @return resource XLIFF representation of the job */ public function get_job_xliff_file( $job_id ) { return $this->generate_xliff_file( $this->generate_job_xliff( $job_id ) ); } /** * Generate a XLIFF string for a given post or external type (e.g. package) job. * * @param int $job_id * * @return string XLIFF representation of the job */ public function generate_job_xliff( $job_id ) { /** @var TranslationManagement $iclTranslationManagement */ global $iclTranslationManagement; // don't include not-translatable and don't auto-assign $job = $iclTranslationManagement->get_translation_job( (int) $job_id, false, false, 1 ); $translation_units = $this->get_job_translation_units( $job ); $original = $job_id . '-' . md5( $job_id . $job->original_doc_id ); $external_file_url = $this->get_external_url( $job ); $xliff = $this->generate_xliff( $original, $job->source_language_code, $job->language_code, $translation_units, $external_file_url ); return $xliff; } /** * Generate a XLIFF file for a given set of strings. * * @param array $strings * @param string $source_language * @param string $target_language * * @return resource XLIFF file */ public function get_strings_xliff_file( $strings, $source_language, $target_language ) { return $this->generate_xliff_file( $this->generate_xliff( uniqid(), $source_language, $target_language, $this->generate_strings_translation_units( $strings ) ) ); } private function generate_xliff( $original_id, $source_language, $target_language, $translation_units, $external_file_url = null ) { // Keep unindented to generate a pretty printed xml $xliff = ""; $xliff .= ''; $xliff .= $this->get_xliff_opening( $this->xliff_version ); $xliff .= $this->get_file_element( $original_id, $source_language, $target_language, $translation_units, $external_file_url );; $xliff .= "" . "\n"; return $xliff; } private function get_xliff_opening( $xliff_version ) { switch ( $xliff_version ) { case '10': $xliff = '' . PHP_EOL; $xliff .= '' . "\n"; break; case '11': $xliff = '' . "\n"; break; case '12': default: $xliff = '' . "\n"; break; } return $xliff; } /** * Generate translation units for a given set of strings. * * The units are the actual content to be translated * Represented as a source and a target * * @param array $strings * * @return string The translation units representation */ private function generate_strings_translation_units( $strings ) { $translation_units = ''; foreach ( $strings as $string ) { $id = 'string-' . $string->id; $translation_units .= $this->get_translation_unit( $id, "string", $string->value, $string->value ); } return $translation_units; } /** * Generate translation units. * * The units are the actual content to be translated * Represented as a source and a target * * @param object $job * * @return string The translation units representation */ private function get_job_translation_units( $job ) { $translation_units = ''; foreach ( $job->elements as $element ) { if ( $element->field_translate == '1' ) { $field_data_translated = base64_decode( $element->field_data_translated ); $field_data = base64_decode( $element->field_data ); if ( substr( $element->field_type, 0, 6 ) === 'field-' ) { $field_data_translated = apply_filters( 'wpml_tm_xliff_export_translated_cf', $field_data_translated, $element ); $field_data = apply_filters( 'wpml_tm_xliff_export_original_cf', $field_data, $element ); } // check for untranslated fields and copy the original if required. if ( ! isset( $field_data_translated ) || $field_data_translated == '' ) { $field_data_translated = $this->remove_etx_char( $field_data ); } if ( $this->is_valid_unit_content( $field_data ) ) { $translation_units .= $this->get_translation_unit( $element->field_type, $element->field_type, $field_data, $field_data_translated ); } } } return $translation_units; } private function get_translation_unit( $field_id, $field_name, $field_data, $field_data_translated ) { global $sitepress; $field_data = $this->remove_etx_char( $field_data ); $translation_unit = ""; if ( $sitepress->get_setting( 'xliff_newlines' ) == WPML_XLIFF_TM_NEWLINES_REPLACE ) { $field_data = str_replace( "\n", '
', $field_data ); $field_data_translated = str_replace( "\n", '
', $field_data_translated ); } $translation_unit .= ' ' . "\n"; $translation_unit .= ' ' . "\n"; $translation_unit .= ' ' . "\n"; $translation_unit .= ' ' . "\n"; return $translation_unit; } /** * @param string $string * * @return string */ private function remove_etx_char( $string ) { return preg_replace('/\x03/', '', $string); } /** * Save a xliff string to a temporary file and return the file ressource * handle * * @param string $xliff_content * * @return resource XLIFF */ private function generate_xliff_file( $xliff_content ) { $file = fopen( 'php://temp', 'r+' ); fwrite( $file, $xliff_content ); rewind( $file ); return $file; } /** * @param $job * * @return false|null|string */ private function get_external_url( $job ) { $external_file_url = null; if ( isset( $job->original_doc_id ) && 'post' === $job->element_type_prefix ) { $external_file_url = get_permalink( $job->original_doc_id ); return $external_file_url; } return $external_file_url; } /** * The

element contains metadata relating to the element. * @link http://docs.oasis-open.org/xliff/v1.2/os/xliff-core.html#header * * @param array $args * * @return string */ private function get_file_element_header( $args ) { $file_element_header = '

'; if ( $args ) { $file_element_header = '

'; if ( array_key_exists( 'reference', $args ) ) { $file_element_header .= $this->get_file_element_header_reference( $args['reference'] ); } $file_element_header .= '

'; } return $file_element_header; } /** * A description of the reference material and either exactly one or one element. * @link http://docs.oasis-open.org/xliff/v1.2/os/xliff-core.html#reference * * @param $reference * * @return string */ private function get_file_element_header_reference( $reference ) { $file_element_header_reference = ''; if ( array_key_exists( 'external-file', $reference ) ) { $file_element_header_reference .= ''; } elseif ( array_key_exists( 'internal-file', $reference ) ) { $file_element_header_reference .= ''; } $file_element_header_reference .= ''; return $file_element_header_reference; } /** * The element corresponds to a single extracted original document. * @link http://docs.oasis-open.org/xliff/v1.2/os/xliff-core.html#file * * @param $original_id * @param $source_language * @param $target_language * @param $translation_units * @param $external_file_url * * @return string */ private function get_file_element( $original_id, $source_language, $target_language, $translation_units, $external_file_url ) { $header_args = array( 'reference' => array( 'external-file' => $external_file_url, ), ); $xliff_file = "\t" . ''; $xliff_file .= "\t" . "\t" . $this->get_file_element_header( $header_args ) . "\n"; $xliff_file .= "\t" . "\t" . '' . "\n"; $xliff_file .= "\t" . "\t" . "\t" . $translation_units . "\n"; $xliff_file .= "\t" . "\t" . '' . "\n"; $xliff_file .= "\t" . '' . "\n"; return $xliff_file; } }