Función de Traducción

Si deseas traducir texto personalizado, puedes hacerlo llamando a la función de traducción trp_translate($content, $language = null, $prevent_over_translation = true);.

Los siguientes parámetros se utilizan en la función de traducción:

• $contenido (obligatorio): El texto real que deseas traducir. Puede ser cualquier texto simple o HTML.
• $idioma (opcional): El código de idioma al que deseas que se traduzca tu contenido. El código de idioma (p. ej., ‘en_US’, ‘de_DE’) se encuentra en Ajustes->TranslatePress->General. No tiene por qué coincidir con el slug del idioma (p. ej., ‘en’, ‘de’). Si no añades este parámetro, el contenido se traducirá al idioma actual.
• $evitar_una_traducción_excesiva (opcional): Este parámetro se utiliza para garantizar que el texto traducido no sea detectado posteriormente por TranslatePress con el fin de intentar una segunda traducción. Añade un salto de línea <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.

El valor devuelto es una cadena que contiene el contenido traducido en el formato inicial (texto o HTML), utilizando la traducción disponible en la base de datos o la traducción automática si está activada. La estructura HTML se mantiene, la función traduce solo el nodo y los atributos dentro de las etiquetas.

En el siguiente ejemplo, podemos observar la funcionalidad de la función trp_translate:

• en un archivo PHP escribe el siguiente código:
• 
  

  function tpc_enqueue_scripts(){
  
      $message = trp_translate(&#x27;'<div>Hola, esto es una prueba.</div><p>Esta es otra prueba.</p>', 'pt_BR');
  
      $tpc_array = array();
  
      $tpc_array['alert'] = $message;
  
      echo 'Haz clic aquí';
  
      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');

  
  
• en un archivo javascript escribe el siguiente código:

jQuery(function() {

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

});

El ejemplo anterior añade un botón que, al hacer clic, mostrará un cuadro de alerta con el HTML traducido.