Fonction de traduction

Si vous souhaitez traduire un texte personnalisé, vous pouvez le faire en appelant la fonction de traduction trp_translate($content, $language = null, $prevent_over_translation = true);.

Les paramètres suivants sont utilisés dans la fonction de traduction :

• $content (requis) : Le texte que vous souhaitez réellement traduire. Il peut s'agir de texte simple ou de HTML.
• $langue (facultatif) : le code de langue vers lequel vous souhaitez que votre contenu soit traduit. Le code de langue (par ex. ‘ en_US ’, ‘ de_DE ’) se trouve dans Paramètres -> TranslatePress -> Général. Il ne correspond pas nécessairement au slug de la langue (par ex. ‘ en ’, ‘ de ’). Si vous n'ajoutez pas ce paramètre, le contenu sera traduit dans la langue actuelle.
• $_prévenir_une_traduction_excessive (facultatif) : ce paramètre sert à garantir que le texte traduit ne sera pas repris par TranslatePress par la suite pour tenter une deuxième traduction. Il ajoute un retour à la ligne <span data-no-translation> tag. This default behavior can be changed by setting $prevent_over_translation to false in which case the <span> tag will not be added. It’s safe to set it to ‘false’ if the translated text is not simply printed (echoed) in the HTML source and therefore detected by TP.

La valeur retournée est une chaîne contenant le contenu traduit sous sa forme initiale (texte ou HTML), en utilisant la traduction disponible dans la base de données ou la traduction automatique si elle est activée. La structure HTML est conservée, la fonction traduisant uniquement les nœuds et les attributs à l'intérieur des balises.

Dans l'exemple suivant, nous pouvons observer la fonctionnalité de la fonction trp_translate :

• Dans un fichier PHP, écrivez le code suivant :
• 
  

  function tpc_enqueue_scripts(){
  
      $message = trp_translate(&#x27;'<div>Salut, c'est un test.</div><p>Ceci est un autre test.</p>', 'fr');
  
      $tpc_array = array();
  
      $tpc_array['alert'] = $message;
  
      echo 'Cliquez ici';
  
      wp_enqueue_script( 'tpc_test_trp_translate_function', plugin_dir_url( __FILE__ ). '/assets/output.js', array("jquery"), 1.0, true );
  
      wp_localize_script( 'tpc_test_trp_translate_function', 'tpc_alert_message', $tpc_array);
  
  }
  
  add_action('wp_enqueue_scripts', 'tpc_enqueue_scripts');

  
  
• dans un fichier javascript écrivez le code suivant :

jQuery(function() {

    jQuery( '#tpc_test_button' ).on( 'click', function () {
        alert( tpc_alert_message['alert'] );
    } );

});

L'exemple ci-dessus ajoute un bouton qui, lorsqu'il est cliqué, affichera une boîte d'alerte avec le HTML traduit.