Étiquette : traduction

[Magento 2] i18n, bonnes pratiques

20/01/2023 / admin

Insérer un ou plusieurs liens dans une même chaîne de caractères:

(Exemple pour dans un fichier PHTML)

<?= (string) __('Auch empfehlen wir Ihnen <a href="%1" class="pm-font-bold" target="_blank">unsere FAQs</a> und <a href="%2" class="pm-font-bold" target="_blank">das Glossar</a>.', $block->getUrl(null, ['_direct' => 'customer-service/faq']), $block->getUrl(null, ['_direct' => 'customer-service/glossary']));?>

<?= (string) __('Auch empfehlen wir Ihnen <a href="%1" class="pm-font-bold" target="_blank">unsere FAQs</a> und <a href="%2" class="pm-font-bold" target="_blank">das Glossar</a>.', $block->getUrl(null, ['_direct' => 'customer-service/faq']), $block->getUrl(null, ['_direct' => 'customer-service/glossary']));?>

Insérer un mail:

(Exemple pour dans un fichier PHTML)

<?= (string) __('unter: +00 0000 00 000 0000, oder schriftlich via: <a href="%1" class="pm-font-bold" target="_blank">john@doe.com</a>.', 'mailto:john@doe.com');?>

1	<?= (string) __('unter: +00 0000 00 000 0000, oder schriftlich via: <a href="%1" class="pm-font-bold" target="_blank">john@doe.com</a>.', 'mailto:john@doe.com');?>

Une locale contenant des balises HTML dans un fichier PHP:

Fichier PHP

/**
 * Get product count label
 *
 * @param int $count
 * @param string $productType
 *
 * @return string
 */
public function getProductCountLabel(int $count, string $productType): string
{
    $pluralForm = $this->getPluralForm($count);
    switch ($pluralForm) {
        case 1:
            if ($productType === 'watches') {
                $label = __('<span class="count">%1</span> watch', $count);
            } else {
                $label = __('<span class="count">%1</span> product', $count);
            }
            break;
        case 2:
            $label = sprintf('<span class="count">%d</span> модели', $count);
            break; // russian semi plural
        case 3:
            if ($productType === 'watches') {
                $label = __('test <span>toto</span>');
            } else {
                $label = __('<span class="count">%1</span> products', $count);
            }
            break;
        default:
            $label = '';
    }

    return (string) $label;
}

/**

* Get product count label

* @param int $count

* @param string $productType

* @return string

public function getProductCountLabel(int $count, string $productType): string

{

$pluralForm = $this->getPluralForm($count);

switch ($pluralForm) {

case 1:

if ($productType === 'watches') {

$label = __('<span class="count">%1</span> watch', $count);

} else {

$label = __('<span class="count">%1</span> product', $count);

}

break;

case 2:

$label = sprintf('<span class="count">%d</span> модели', $count);

break; // russian semi plural

case 3:

if ($productType === 'watches') {

$label = __('test <span>toto</span>');

} else {

$label = __('<span class="count">%1</span> products', $count);

}

break;

default:

$label = '';

}

return (string) $label;

}

Fichier PHTML

Ne pas utiliser $escaper->escapeHtml();:

<p><?= $escaper->escapeHtml($viewModel->getProductCountLabel($count, $productType)); ?></p>

1	<p><?= $escaper->escapeHtml($viewModel->getProductCountLabel($count, $productType)); ?></p>

Voici ce qu’il faut mettre:

<p><?= $viewModel->getProductCountLabel($count, $productType); ?></p>

1	<p><?= $viewModel->getProductCountLabel($count, $productType); ?></p>

Fichier CSV

"<span class=""count"">%1</span> watch","<span class=""count"">%1</span> watch"

1	"<span class=""count"">%1</span> watch","<span class=""count"">%1</span> watch"

[Magento 2] js-translation.json Localisation de chaînes de caractères récalcitrantes (qui restent en anglais) dans les notifications messages d’alerte

03/03/2020 / admin

Bug inhérent à Magento 2. Les chaînes non-traduites sont dasn des fichiers javaScript. Un fichier js-translation.json contenant les traductions nécessaires est généré en front au chargement de la page, mais il est incomplet!

The cause of issue is: Sometime file js-translation.json is loaded slower or later than other javascript file (I assume file a.js contain some texts need to translate) which contains some texts need to translate so at this time translated texts still not push to storage. Source: Magento 2 javascript translation sometime translate sometime not work – Why and how to fix?.

Voir ici:

[Ouvert][Remonté le 10 oct 2018] magento generate a broken js-translation.json file while deploying locale
[Ouvert][Remonté le 5 juil 2018] Problem with the translations from javascript in Magento 2.2.2
[Fermé][Remonté le 12 déc 2018] Strings not translated in all email templates, keep curly braces around string
- Proposition de solution – sezio commented on 21 Jan 2019
[Fermé][Remonté le 9 juil 2018] 2.2.4 to 2.2.5 js-translation.json gets messed up
[Fermé (non reproductible)][Remonté le 31 mar 2017] js-translation.json generation incomplete.

Attention: les solutions 1 à 4 ont été testées alors qu’aucun language pack pour le core de Magento 2 n’avait été installé. Il se trouve que les clés de traduction n’étaient présentes qu’en anglais dans le projet. Le front ne pouvait de ce fait pas afficher de libellés en français. Il est impératif d’avoir installé un language pack au préalable, avant de procéder à des tests sur les problèmes de build du fichier js-translation.json.

Solution #1 (testée Magento 2.3.4, non fonctionnelle)

Dans la DB, virer les rangées de inline translation qui sont importées dans la table core_config_data:

delete from core_config_data where path like 'dev/translate_inline/active';
delete from core_config_data where path like 'dev/translate_inline/active_admin';

1 2	delete from core_config_data where path like 'dev/translate_inline/active'; delete from core_config_data where path like 'dev/translate_inline/active_admin';

Puis:

disable the inline translation
rm your pub/static/frontend directory
redeploy the frontend

Solution #2 (non testée)

Il faut impérativement qu’on ait un environnement où les traductions fonctionnent pour mettre en place cette solution: Magento 2 – Translations : how does js-translation.json get populated? Mine is empty!

Solution #3 (testée Magento 2.3.4, non fonctionnelle)

Magento 2 Knockout Translation Bug

Solution #4 (non testée)

js-translation.json fails to generated

Solution #5 (testée non fonctionnelle Magento 2.3.3, 2.3.4)

Problème de traductions dans Magento 2: les traductions ne fonctionnent pas.

Packs de langues (traductions)

Installer mageplazza

Créer un token depuis Github

Vous logguer sur votre compte GitHub
Settings > Developer settings > Personal access tokens
Button « Generate new token »
Cocher la case read:packages
Copier-coller le token généré. Il vous sera demandé au composer require

$ composer require mageplaza/magento-2-french-language-pack
$ php -d memory_limit=-1 bin/magento setup:static-content:deploy -f fr_FR
$ n98-magerun2 indexer:reindex
$ n98-magerun2 cache:flush

$ composer require mageplaza/magento-2-french-language-pack

$ php -d memory_limit=-1 bin/magento setup:static-content:deploy -f fr_FR

$ n98-magerun2 indexer:reindex

$ n98-magerun2 cache:flush

Outils

AOEpeople/grunt-magento-translation-to-json – Parses magento translation csv files and builds json for required keys (including fallback if no translation file available).

ATTENTION: Magento 2 est très buggué au niveau des localisations traductions, notamment lorsque celles-ci reposent sur JavaScript. La solution ci-dessous permet de contourner le problème mais n’est pas propre. Dans le fichier app/design/frontend/MyVendor/myTheme/Magento_Theme/templates/messages.phtml, rajouter à la fin:

<script type="text/javascript">
    require([
        'jquery'
    ], function(jQuery){
        (function($) {
            (function(win) {
                'use strict';

                var listeners = [],
                    doc = win.document,
                    MutationObserver = win.MutationObserver || win.WebKitMutationObserver,
                    observer;

                function ready(selector, fn) {
                    // Store the selector and callback to be monitored
                    listeners.push({
                        selector: selector,
                        fn: fn
                    });
                    if (!observer) {
                        // Watch for changes in the document
                        observer = new MutationObserver(check);
                        observer.observe(doc.documentElement, {
                            childList: true,
                            subtree: true
                        });
                    }
                    // Check if the element is currently in the DOM
                    check();
                }

                function check() {
                    // Check the DOM for elements matching a stored selector
                    for (var i = 0, len = listeners.length, listener, elements; i < len; i++) {
                        listener = listeners[i];
                        // Query for elements matching the specified selector
                        elements = doc.querySelectorAll(listener.selector);
                        for (var j = 0, jLen = elements.length, element; j < jLen; j++) {
                            element = elements[j];
                            // Make sure the callback isn't invoked with the
                            // same element more than once
                            if (!element.ready) {
                                element.ready = true;
                                // Invoke the callback with the element
                                listener.fn.call(element, element);
                            }
                        }
                    }
                }

                // Expose `ready`
                win.ready = ready;

            })(this);

            // Select the node that will be observed for mutations and translate english text to page lang
            const htmlLang = $('html').attr('lang'),
                pageMainID = $('.page-main').attr('id'),
                targetNode = document.getElementById(pageMainID);

            ready('.text[data-bind="html: message.text"]', function(targetNode) {
                var thisObj = $(this),
                    alertText = thisObj.text();

                if (alertText === 'The account sign-in was incorrect or your account is disabled temporarily. Please wait and try again later.') {
                    if (htmlLang === 'fr') {
                        thisObj.text('La connexion au compte était incorrecte ou votre compte est temporairement désactivé. Veuillez patienter et réessayer plus tard.');
                    }
                }
            });
        })(jQuery);

    });
</script>

require([

'jquery'

], function(jQuery){

(function($) {

(function(win) {

'use strict';

var listeners = [],

doc = win.document,

MutationObserver = win.MutationObserver || win.WebKitMutationObserver,

observer;

function ready(selector, fn) {

// Store the selector and callback to be monitored

listeners.push({

selector: selector,

fn: fn

});

if (!observer) {

// Watch for changes in the document

observer = new MutationObserver(check);

observer.observe(doc.documentElement, {

childList: true,

subtree: true

});

}

// Check if the element is currently in the DOM

check();

}

function check() {

// Check the DOM for elements matching a stored selector

for (var i = 0, len = listeners.length, listener, elements; i < len; i++) {

listener = listeners[i];

// Query for elements matching the specified selector

elements = doc.querySelectorAll(listener.selector);

for (var j = 0, jLen = elements.length, element; j < jLen; j++) {

element = elements[j];

// Make sure the callback isn't invoked with the

// same element more than once

if (!element.ready) {

element.ready = true;

// Invoke the callback with the element

listener.fn.call(element, element);

}

// Expose `ready`

win.ready = ready;

})(this);

// Select the node that will be observed for mutations and translate english text to page lang

const htmlLang = $('html').attr('lang'),

pageMainID = $('.page-main').attr('id'),

targetNode = document.getElementById(pageMainID);

ready('.text[data-bind="html: message.text"]', function(targetNode) {

var thisObj = $(this),

alertText = thisObj.text();

if (alertText === 'The account sign-in was incorrect or your account is disabled temporarily. Please wait and try again later.') {

if (htmlLang === 'fr') {

thisObj.text('La connexion au compte était incorrecte ou votre compte est temporairement désactivé. Veuillez patienter et réessayer plus tard.');

}

});

})(jQuery);

});

</script>

Axes d’amélioration: améliorer le code en le séparant en 2 plugins. Les mutation observers et le traducteur.

[Magento 2] Corriger le bug de traduction du message d’ajout au panier

24/02/2020 / admin

Testé fonctionnel Magento 2.3.3. Source: Magento 2 translation issue: notification Added to shopping cart.

You’re CSV columns are enclosed in double quotes, but you don’t appear to be escaping the double quotes of the href attribute. Have you tried:

Ce n’est pas le fichier vendor/magento/module-checkout/view/frontend/templates/messages/addCartSuccessMessage.phtml qu’il faut surcharger, mais dans votre fichier CSV:

"You added %1 to your <a href=""%2"">shopping cart</a>.","Vous venez d'ajouter %1 à votre <a href=""%2"">panier</a>."

1	"You added %1 to your <a href=""%2"">shopping cart</a>.","Vous venez d'ajouter %1 à votre <a href=""%2"">panier</a>."

[Magento 2] Corriger les libellés non traduits ou localisés

17/01/2020 / admin

Magento 2.x DevDocs – Translate theme strings. This topic describes how to add theme strings so that the i18n tool can collect and add the strings to the dictionary.
- Strings added in .phtml templates.
- Strings added in email templates.
- Strings added in UI component templates.
- Strings added in UI components configuration files.
- Strings added in .js files.

Problème: Des libellés comme celui du bouton « Add to Cart/Ajouter au panier » dans la fiche produit et celui du placeholder « Start Searching…/Rechercher… » du champ de recherche dans le bandeau du site ne sont pas traduits/localisés lors du passage du site en français (ou dans une autre langue que l’anglais) et restent affichés en anglais!

En ligne de commande (à envisager, d’autres solutions existent)

Source: magento 2 translate shipping method title

php -dmemory_limit=6G bin/magento setup:static-content:deploy en_US nl_NL de_DE

1	php -dmemory_limit=6G bin/magento setup:static-content:deploy en_US nl_NL de_DE

[Méthode globale pour corriger les erreurs de localisation] Les traductions pour certains libellés de base sont déclarées dans un fichier `dictionary.csv`…

…mais restent pourtant affichées en anglais sur mes pages, alors même que la grande majorité des libellés sont traduits correctement.

De manière générale, un libellé déclaré dans le fichier vendor/imaginaerum/magento2-language-fr-fr/dictionary.csv, comme par exemple:

"Search entire store here...",Rechercher...

1	"Search entire store here...",Rechercher...

…peut être exploité dans un fichier PHTML en l’invoquant de la manière suivante:

<?= $block->escapeHtml(__('Search entire store here...')); ?>

1	<?= $block->escapeHtml(__('Search entire store here...')); ?>

Si vous avez repéré le fichier PHTML incriminé (celui qui ne traduit pas votre libellé), vous pouvez remplacer l’appel de traduction de la manière suivante: <?= $block->escapeHtml(__('Un libellé tel que déclaré dans le fichier: vendor/imaginaerum/magento2-language-fr-fr/dictionary.csv')); ?>.

Traduction/Localisation du libellé du bouton « Add to Cart/Ajouter au panier » dans la fiche produit

Note: cet exemple est propre au thème Supro pour Magento 2.

Surcharger le template app/design/frontend/Mgs/supro/Magento_Catalog/templates/product/view/addtocart.phtml dans votre thème enfant (si vous n’en avez pas, il faudra en créer un… Dans notre exemple: app/design/frontend/Sodifrance/pdv/Magento_Catalog/templates/product/view/addtocart.phtml) et remplacer les lignes suivantes:

<button type="submit"
        title="<?= __('Add To Cart') ?>"
        class="action primary tocart"
        id="product-addtocart-button">
    <?= __('Add To Cart') ?>
</button>

<button type="submit"

title="<?= __('Add To Cart') ?>"

class="action primary tocart"

id="product-addtocart-button">

<?= __('Add To Cart') ?>

</button>

…par:

<button type="submit"
        title="<?= $block->escapeHtml(__('Add to Cart')); ?>"
        class="action primary tocart"
        id="product-addtocart-button">
    <?php /* @escapeNotVerified */ echo __('Add to Cart') ?>
</button>

<button type="submit"

title="<?= $block->escapeHtml(__('Add to Cart')); ?>"

class="action primary tocart"

id="product-addtocart-button">

<?php /* @escapeNotVerified */ echo __('Add to Cart') ?>

</button>

Traduction/Localisation du libellé du placeholder « Start Searching…/Rechercher… » du champ de recherche dans le bandeau du site

Note: cet exemple est propre au thème Supro pour Magento 2.

Surcharger le template app/design/frontend/Mgs/supro/Magento_Search/templates/form.mini.phtml dans votre thème enfant (si vous n’en avez pas, il faudra en créer un… Dans notre exemple: app/design/frontend/Sodifrance/pdv/Magento_Catalog/templates/product/view/addtocart.phtml) et remplacer les lignes suivantes:

<input id="search"
       data-mage-init='{"quickSearch":{
            "formSelector":"#search_mini_form",
            "url":"<?php /* @escapeNotVerified */ echo $block->getUrl('search/ajax/suggest', ['_secure' => $block->getRequest()->isSecure()]); ?>",
            "destinationSelector":"#search_autocomplete"}
       }'
       type="text"
       name="<?php /* @escapeNotVerified */ echo $helper->getQueryParamName() ?>"
       value="<?php /* @escapeNotVerified */ echo $helper->getEscapedQueryText() ?>"
       placeholder="<?php /* @escapeNotVerified */ echo __('Start Searching...'); ?>"
       class="input-text"
       maxlength="<?php /* @escapeNotVerified */ echo $helper->getMaxQueryLength();?>"
       role="combobox"
       aria-haspopup="false"
       aria-expanded="false"
       aria-autocomplete="both"
       autocomplete="off"/>

<input id="search"

data-mage-init='{"quickSearch":{

"formSelector":"#search_mini_form",

"url":"<?php /* @escapeNotVerified */ echo $block->getUrl('search/ajax/suggest', ['_secure' => $block->getRequest()->isSecure()]); ?>",

"destinationSelector":"#search_autocomplete"}

type="text"

name="<?php /* @escapeNotVerified */ echo $helper->getQueryParamName() ?>"

value="<?php /* @escapeNotVerified */ echo $helper->getEscapedQueryText() ?>"

placeholder="<?php /* @escapeNotVerified */ echo __('Start Searching...'); ?>"

class="input-text"

maxlength="<?php /* @escapeNotVerified */ echo $helper->getMaxQueryLength();?>"

role="combobox"

aria-haspopup="false"

aria-expanded="false"

aria-autocomplete="both"

autocomplete="off"/>

(c’est en fait uniquement la ligne placeholder="<?php /* @escapeNotVerified */ echo __('Start Searching...'); ?>" qu’on remplace) …par:

placeholder="<?= $block->escapeHtml(__('Search entire store here...')); ?>"

1	placeholder="<?= $block->escapeHtml(__('Search entire store here...')); ?>"

Traduction dans un fichier JS

La méthode de traduction de chaînes de caractères incluses dans des fichiers JS dans Magento 2 est expliquée ici.

Note: notre exemple tient toujours compte du fait que nous utilisions le thème Supro, mais il reste appliquable dans d’autres cas. Nous allons surcharger le fichier app/code/MGS/AjaxCart/view/frontend/web/js/action/product-add-to-cart.js dans app/design/frontend/Vendor/theme/MGS_AjaxCart/web/js/action/product-add-to-cart.js.

(Si ce n’est pas fait) lier la librairie `'mage/translate'` via requireJS

require([
    'jquery',
	'MGS_AjaxCart/js/config',
    'Magento_Ui/js/modal/modal',
	'mage/translate'
], function($, mgsConfig, modal) {

require([

'jquery',

'MGS_AjaxCart/js/config',

'Magento_Ui/js/modal/modal',

'mage/translate'

], function($, mgsConfig, modal) {

Utiliser la fonction `$.mage.__('<chaîne de caractères>');`

    $(document).on("click","#product-addtocart-button",function() {
		var $_this = jQuery(this);
        var form = jQuery('#product_addtocart_form');
        var isValid = form.valid();
        if(isValid){
            // $_this.text("Adding...");
	    $_this.text($.mage.__('Adding...'));

$(document).on("click","#product-addtocart-button",function() {

var $_this = jQuery(this);

var form = jQuery('#product_addtocart_form');

var isValid = form.valid();

if(isValid){

// $_this.text("Adding...");

$_this.text($.mage.__('Adding...'));

ATTENTION: les clés de traduction sont sensibles à la casse. Respectez les minuscules/majuscules! Exemple d’un cas que j’ai dû déboguer:

success: function(response, status) {
	// $_this.text("Add to cart");
	$_this.text($.mage.__('Add to Cart'));

success: function(response, status) {

// $_this.text("Add to cart");

$_this.text($.mage.__('Add to Cart'));

Note: il est également possible de déclarer un alias pour la fonction $.mage.__('<chaîne de caractères>');. Exemple:

require([
    'mage/translate'
], function($t) {
...
$t('Add to Cart');

require([

'mage/translate'

], function($t) {

...

$t('Add to Cart');

Traduction dans un composant UI de Magento 2 (fichier *.html)

Dans notre exemple, nous allons surcharger le fichier natif vendor/magento/module-checkout/view/frontend/web/template/cart/shipping-rates.html dans app/design/frontend/MyVendor/myTheme/Magento_Checkout/web/template/cart/shipping-rates.html pour corriger un bug de Magento 2.3 sur le libellé Flat Rate qui n’est pas traduit dans la page panier. Nous remplacerons pour ce faire la ligne:

<dt class="item-title"><span data-bind="text: $data"></span></dt>

1	<dt class="item-title"><span data-bind="text: $data"></span></dt>

…par:

<dt class="item-title"><span data-bind="i18n: $data"></span></dt>

1	<dt class="item-title"><span data-bind="i18n: $data"></span></dt>

Note: la traduction française de l’expression Flat Rate existe déjà dans le fichier vendor/imaginaerum/magento2-language-fr-fr/dictionary.csv, donc nul besoin de la recréer.

La partie à ne pas oublier dans ce cas (surcharge de composant UI sous forme de fichier HTML), est d’exécuter les commandes suivantes: »

1. Pour faire en sorte que la surcharge du fichier HTML soit prise en compte:

php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

php bin/magento setup:upgrade

php bin/magento setup:static-content:deploy

php bin/magento cache:clean

…et si vous utilisez Grunt:

grunt less && grunt watch
rm -rf pub/static/*; rm -rf var/view_preprocessed/*
php bin/magento setup:upgrade
php bin/magento cache:clean

grunt less && grunt watch

rm -rf pub/static/*; rm -rf var/view_preprocessed/*

php bin/magento setup:upgrade

php bin/magento cache:clean

2. Pour faire en sorte que la traduction de votre libellé soit prise en compte (nous sommes dans un cas où le libellé est généré via JavaScript):

rm -rf pub/static/*; rm -rf var/view_preprocessed/*

1	rm -rf pub/static/; rm -rf var/view_preprocessed/

Traduction inline via l’interface d’admin de Magento 2

Pas testé. Source: How to use the inline translation?

Chemin en BO: Stores > Configuration > Advanced > Developer > Translate Inline > Enable for Storefront > Yes.

[Thème Supro uniquement] Surcharge de styles

C’est honteux mais, dans la source du thème Supro, certains textes se retrouvent dans les feuilles de style. Si votre site est multilingue, il faut créer un thème par langue pour corriger le problème de traduction.

Si vous suivez ce tuto: [Magento 2] Astuces d’utilisation du thème Supro: surcharger (override) les valeurs de style par défaut (ou celles définies depuis l’interface d’admin)… la surcharge LESS ci-dessous est à placer dans le fichier app/design/frontend/Vendor/theme/web/css/supro-override.less.

// from: app/design/frontend/Mgs/supro/supro/web/css/mgs_theme.less
/* Update Ajax Loading Cart  */
.products-grid .items .product-item .product-item-info {
  &.adding-cart-text {
    .product-top {
      &.loading-ajax{
        .product-item-inner {
          .action.tocart {
            &:before {
              content: "Ajout en cours...";
            }
          }
        }
      }
    }
  }
}
.lookbook-container .popup__content--product .product-details {
  &.adding-cart-text {
    .action.tocart.tocart-loading {
      &:after {
        content: "Ajout en cours...";
      }
    }
  }
}
.catalog-product-view .product-info-main .box-tocart,
.catalog-product-view .block-bundle-summary .box-tocart {
  &.adding-cart-text {
    .action.tocart.tocart-loading {
      &:after {
        content: "Ajout en cours...";
      }
    }
  }
}
// end: app/design/frontend/Mgs/supro/supro/web/css/mgs_theme.less

// from: app/design/frontend/Mgs/supro/supro/web/css/mgs_theme.less

/* Update Ajax Loading Cart */

.products-grid .items .product-item .product-item-info {

&.adding-cart-text {

.product-top {

&.loading-ajax{

.product-item-inner {

.action.tocart {

&:before {

content: "Ajout en cours...";

}

.lookbook-container .popup__content--product .product-details {

&.adding-cart-text {

.action.tocart.tocart-loading {

&:after {

content: "Ajout en cours...";

}

.catalog-product-view .product-info-main .box-tocart,

.catalog-product-view .block-bundle-summary .box-tocart {

&.adding-cart-text {

.action.tocart.tocart-loading {

&:after {

content: "Ajout en cours...";

}

// end: app/design/frontend/Mgs/supro/supro/web/css/mgs_theme.less

[Drupal 7.x] Les preprocess functions dans template.php

03/03/2017 / admin

Initialiser un fichier template.php à la racine de votre thème :

<?php

/**
 * @file
 * template.php file for <my_theme>.
 *
 * Implement preprocess functions and alter hooks in this file.
 */


/**
 * Preprocess function for page.tpl.php
 */

<?php

/**

* @file

* template.php file for <my_theme>.

* Implement preprocess functions and alter hooks in this file.

/**

* Preprocess function for page.tpl.php

Afficher les hooks disponibles dans la page

function <my_theme>_preprocess(&$variables, $hook) {
  kpr($hook);
}

function <my_theme>_preprocess(&$variables, $hook) {

kpr($hook);

}

Afficher l’ordre dans lequel les hooks sont chargés dans la page

Petite info supplémentaire par rapport à la fonction précédente :

function <my_theme>_preprocess(&$variables, $hook) {
  static $i;
  kpr($i .' '. $hook);
  $i++;
}

function <my_theme>_preprocess(&$variables, $hook) {

static $i;

kpr($i .' '. $hook);

$i++;

}

Seulement quand le hook page est chargé (1x par chargement de page) :

function ninesixtyrobots_preprocess(&$variables, $hook) {
  if ($hook == 'page') {
    static $i;
    kpr($i .' '. $hook);
    $i++;
  }
}

function ninesixtyrobots_preprocess(&$variables, $hook) {

if ($hook == 'page') {

static $i;

kpr($i .' '. $hook);

$i++;

}

On passe le hook page dans le nom de la fonction. Plus besoin de le passer en argument.

function ninesixtyrobots_preprocess_page(&$variables) {
  print 'wooooooooo';
}

function ninesixtyrobots_preprocess_page(&$variables) {

print 'wooooooooo';

}

Voir quelles variables sont disponibles

function ninesixtyrobots_preprocess_page(&$variables) {
  kpr($variables);
}

function ninesixtyrobots_preprocess_page(&$variables) {

kpr($variables);

}

Changer la valeur de la variable « site_solgan » dans une preprocess function

function ninesixtyrobots_preprocess_page(&$variables) {
  $variables['site_slogan'] = 'my new value';
}

function ninesixtyrobots_preprocess_page(&$variables) {

$variables['site_slogan'] = 'my new value';

}

Un slogan qui s’affiche en random

On crée un tableau $slogans qu’on remplit avec différents slogans qu’on fera s’afficher de manière choisie au hasard et alternée :

function ninesixtyrobots_preprocess_page(&$variables) {
  $slogans = array(
    t('lorem ipsum'),
    t('dolor sit amet'),
    t('today is gonna be the day'),
    t('that they_re gonna throw it back to you'),
  );

  // Select a random slogan from the list and set the $site_slogan variable to
  // the new random slogan
  $slogan = $slogans[array_rand($slogans)];
  $variables['site_slogan'] = $slogan;
}

function ninesixtyrobots_preprocess_page(&$variables) {

$slogans = array(

t('lorem ipsum'),

t('dolor sit amet'),

t('today is gonna be the day'),

t('that they_re gonna throw it back to you'),

);

// Select a random slogan from the list and set the $site_slogan variable to

// the new random slogan

$slogan = $slogans[array_rand($slogans)];

$variables['site_slogan'] = $slogan;

}

Des locales avec la fonction t()

Utiliser la fonction t() pour mettre en place du texte traduisible en plusieurs langues :

$slogans[] = t('lorem ipsum');

1	$slogans[] = t('lorem ipsum');

[Magento] Ajouter des locales de traduction pour des nouveaux termes dans Magento

03/02/2015 / admin

Source : How to add translations for new words in Magento?.

For this:

<?php echo Mage::helper('catalog')->__('Text here'); ?>

1	<?php echo Mage::helper('catalog')->__('Text here'); ?>

app/locale/{lang_ISO}/Mage_Catalog.csv

"Text here","Translation here"

1	"Text here","Translation here"

For this:

<?php echo $this->__('Text here'); ?>

1	<?php echo $this->__('Text here'); ?>

app/design/frontend/{interface}/{theme}/locale/{lang_ISO}/translate.csv

"Text here","Translation here"

1	"Text here","Translation here"

Or In your theme folder :

/locale/fr_FR/translate.csv

"Inspiration","Your French Translation"

1	"Inspiration","Your French Translation"

Passer un paramètre (comme un libellé produit) dans la locale (source : PHP Manual > String Functions) :

<?php echo $this->__('Specifications for %s', $_helper->productAttribute($_product, $_product->getName(), 'name')); ?>

1	<?php echo $this->__('Specifications for %s', $_helper->productAttribute($_product, $_product->getName(), 'name')); ?>

app/design/frontend/{interface}/{theme}/locale/{lang_ISO}/translate.csv

"Specifications for %s","Spécifications de %s"

1	"Specifications for %s","Spécifications de %s"

Insérer un ou plusieurs liens dans une même chaîne de caractères:

Insérer un mail:

Une locale contenant des balises HTML dans un fichier PHP:

Fichier PHP

Fichier PHTML

Fichier CSV

Solution #1 (testée Magento 2.3.4, non fonctionnelle)

Solution #2 (non testée)

Solution #3 (testée Magento 2.3.4, non fonctionnelle)

Solution #4 (non testée)

Solution #5 (testée non fonctionnelle Magento 2.3.3, 2.3.4)

Packs de langues (traductions)

Installer mageplazza

Créer un token depuis Github

Outils

En ligne de commande (à envisager, d’autres solutions existent)

[Méthode globale pour corriger les erreurs de localisation] Les traductions pour certains libellés de base sont déclarées dans un fichier dictionary.csv…

Traduction/Localisation du libellé du bouton « Add to Cart/Ajouter au panier » dans la fiche produit

Traduction/Localisation du libellé du placeholder « Start Searching…/Rechercher… » du champ de recherche dans le bandeau du site

Traduction dans un fichier JS

(Si ce n’est pas fait) lier la librairie 'mage/translate' via requireJS

Utiliser la fonction $.mage.__('<chaîne de caractères>');

Traduction dans un composant UI de Magento 2 (fichier *.html)

Traduction inline via l’interface d’admin de Magento 2

[Thème Supro uniquement] Surcharge de styles

Afficher les hooks disponibles dans la page

Afficher l’ordre dans lequel les hooks sont chargés dans la page

Voir quelles variables sont disponibles

Changer la valeur de la variable « site_solgan » dans une preprocess function

Un slogan qui s’affiche en random

Des locales avec la fonction t()

[Méthode globale pour corriger les erreurs de localisation] Les traductions pour certains libellés de base sont déclarées dans un fichier `dictionary.csv`…

(Si ce n’est pas fait) lier la librairie `'mage/translate'` via requireJS

Utiliser la fonction `$.mage.__('<chaîne de caractères>');`