XliffParser.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Core\Localization\Parser;
 
class ‪XliffParser extends ‪AbstractXmlParser
{
    protected function ‪doParsingFromRoot(\SimpleXMLElement $root)
    {
        $parsedData = [];
        $bodyOfFileTag = $root->file->body;
        $requireApprovedLocalizations = (bool)(‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['lang']['requireApprovedLocalizations'] ?? true);
        if ($bodyOfFileTag instanceof \SimpleXMLElement) {
            foreach ($bodyOfFileTag->children() as $translationElement) {
                if ($translationElement->getName() === 'trans-unit' && !isset($translationElement['restype'])) {
                    // If restype would be set, it could be metadata from Gettext to XLIFF conversion (and we don't need this data)
                    if ($this->languageKey === 'default') {
                        // Default language coming from an XLIFF template (no target element)
                        $parsedData[(string)$translationElement['id']][0] = [
                            'source' => (string)$translationElement->source,
                            'target' => (string)$translationElement->source,
                        ];
                    } else {
                        $approved = (string)($translationElement['approved'] ?? 'yes');
                        if (!$requireApprovedLocalizations || $approved === 'yes') {
                            $parsedData[(string)$translationElement['id']][0] = [
                                'source' => (string)$translationElement->source,
                                'target' => (string)$translationElement->target,
                            ];
                        }
                    }
                } elseif ($translationElement->getName() === 'group' && isset($translationElement['restype']) && (string)$translationElement['restype'] === 'x-gettext-plurals') {
                    // This is a translation with plural forms
                    $parsedTranslationElement = [];
                    foreach ($translationElement->children() as $translationPluralForm) {
                        if ($translationPluralForm->getName() === 'trans-unit') {
                            // When using plural forms, ID looks like this: 1[0], 1[1] etc
                            $formIndex = substr((string)$translationPluralForm['id'], strpos((string)$translationPluralForm['id'], '[') + 1, -1);
                            if ($this->languageKey === 'default') {
                                // Default language come from XLIFF template (no target element)
                                $parsedTranslationElement[(int)$formIndex] = [
                                    'source' => (string)$translationPluralForm->source,
                                    'target' => (string)$translationPluralForm->source,
                                ];
                            } else {
                                $approved = (string)($translationPluralForm['approved'] ?? 'yes');
                                if (!$requireApprovedLocalizations || $approved === 'yes') {
                                    $parsedTranslationElement[(int)$formIndex] = [
                                        'source' => (string)$translationPluralForm->source,
                                        'target' => (string)$translationPluralForm->target,
                                    ];
                                }
                            }
                        }
                    }
                    if (!empty($parsedTranslationElement)) {
                        if (isset($translationElement['id'])) {
                            $id = (string)$translationElement['id'];
                        } else {
                            $id = (string)$translationElement->{'trans-unit'}[0]['id'];
                            $id = substr($id, 0, (int)strpos($id, '['));
                        }
                        $parsedData[$id] = $parsedTranslationElement;
                    }
                }
            }
        }
        return $parsedData;
    }
}