WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

it:Riferimento funzioni/load plugin textdomain

Contents

Descrizione

Caricare le stringhe tradotte del plugin.

Se non viene fornito un percorso verrà utilizzata la cartella base del plugin. I nomi dei file .mo e .po devono essere costituiti dal dominio seguito da un trattino e poi dal codice regionale esatto. Il codice regionale è il codice della lingua e/o il codice del paese definito nella costante WPLANG nel file wp-config.php. Ad esempio, il codice regionale per il tedesco è 'de_DE', e il codice regionale per il danese è 'da_DK'. Se il dominio del proprio plugin è "mio-plugin" i file .mo e .po danesi devono avere come nome "mio-plugin-da_DK.mo" e "mio-plugin-da_DK.po". Questa funzione va richiamata nel proprio plugin appena viene chiamata l'azione plugins_loaded.

Se si chiama load_plugin_textdomain più volte per lo stesso dominio, le traduzioni verranno unite. Se entrambi gli insiemi hanno la stessa stringa, verrà considerata la traduzione tratta dal primo insieme.

Utilizzo

<?php load_plugin_textdomain$domain$abs_rel_path$plugin_rel_path ?>

Parametri

$domain
(string) (richiesto) Identificatore univoco per recuperare le stringhe tradotte.
Default: Nessuno
$abs_rel_path
(string) (opzionale) Percorso relativo a ABSPATH di una cartella, dove il file .mo risiede. Deprecato, ma ancora in funzione fino alla versione 2.7
Default: false
$plugin_rel_path
(string) (opzionale) Percorso relativo a WP_PLUGIN_DIR, con una barra finale. Questo è l'argomento preferito da usare. Ha precedenza su $abs_rel_path
Default: false

Valori restituiti

Questa funzione non restituisce alcun valore.

Esempi

function myplugin_init() {
  load_plugin_textdomain( 'mio-plugin', false, dirname( plugin_basename( __FILE__ ) ) ); 
}
add_action('plugins_loaded', 'myplugin_init');

O se si preferisce inserire i file della lingua in una sottocartella.

load_plugin_textdomain( 'mio-plugin', false, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );

Note

  • l10n è un'abbreviazione di localization.

Log delle modifiche

  • Da: 1.5.0
  • 2.7.0: il parametro '$abs_rel_path' è stato deprecato.

File sorgente

load_plugin_textdomain() si trova in wp-includes/l10n.php.

Correlati

Localization: get_locale(), load_default_textdomain(), load_plugin_textdomain(), load_textdomain(), load_theme_textdomain()

Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.