En este Anexo, vamos a aprender a utilizar las ventajas que ofrece el Nuke en cuanto al lenguaje.
Cómo sabemos, PHP-Nuke permite por defecto la visualización del texto en varios idiomas. Sólo hay que presionar un botón y listo.
Bueno..., vamos a aprovechar esta cualidad para personalizar las traducciones y para crear nuevo texto que pueda ser visto en varios idiomas.
Primero haz una copia del archivo "lang-spanish.php" que está en la carpeta "language". Guarda la copia en "mis documentos" o donde quieras.
Ahora abre el archivo "lang-spanish". Vas a ver líneas de texto como estas:
define("_DOWNLOADNAME","Nombre de la Descarga");
define("_AUTHORNAME","Autor");
define("_AUTHOREMAIL","E-mail");
define("_INBYTES","En Bytes");
Estas son las del principio. Para la práctica vamos a usar sólo una línea:
define("_SEARCH","Buscar");
La palabra "Buscar" la puedes ver en el Menú Principal. Si presionas la opción inglesa del Nuke cambia a "Search"
Esto funciona de la siguiente manera..., lo que está escrito realmente es esto "._SEARCH."..., pero el Nuke lo traduce al Español (utilizando el archivo lang-spanish) o al Inglés (utilizando el archivo lang-english).
Para manipular el texto que se va a traducir, sólo tendrías que cambiar la parte donde dice "Buscar" y poner otro texto. Por ejemplo escribe........"Arroz con pollo", y guarda el archivo en tu Nuke. Ahora abre tu página y en el espacio en que debería decir "Buscar", va a decir "Arroz con pollo".
Fácil verdad..?.
Ok, ya sabes personalizar lo que está escrito..., ahora vamos a crear más opciones de texto a traducir (seguro que supones cómo se hace, pero hay te va):
Cópiate de las líneas del lang-spanish..., por ejemplo la misma de antes:
define("_SEARCH","Buscar");
Ahora creamos una:
define("_TOEC","Esto es Super Fácil verdad...?");
Introduce esta línea en el lang-spanish y guarda los cambios.
El siguiente paso es colocar el texto ("._TOEC.") en un bloque (debes repasar el Anexo 3: Cómo hacer tus Propios Bloques).
Lo pones así:
$content .= ""._TOEC."<br>";
Analicemos esto:
1. "._TOEC." ------> va encerrado entre comillas
2. Después de la primera comilla y antes de la última, se pone un punto ( . )
3. Pones lo mismo que en el lang-spanish
Listo...¡
Recuerda que si quieres que el texto sea "bilingüe", debes hacer lo mismo en el lang-english.
***Las anteriores son instrucciones básicas para utilizar los archivos "lang" en traducciones a textos de un Bloque.
Ahora, si quieres crear un Módulo con las mismas cualidades, es decir, que se pueda leer en varios idiomas, haces lo siguiente:
Importante: Esta función sólo puedes usarla en formato PHP, es decir que la parte donde aparece el código a traducir, debe estar encerrado entre las etiquetas de apertura y de cierre en PHP..., ejemplo:
<?php Aquí el código ?>
Entonces, a manera de ejemplo vas a crear un módulo (ya debes saber cómo hacerlo, con la ayuda del Manual sobre Módulos). Este módulo será lo más sencillo posible, sólo para que veas cómo utilizar los langs (las traducciones).
Copia lo siguiente y lo guardas con el nombre index.php, creas una carpeta con el nombre traduccion y pones el archivo index.php dentro. Ahora pon la carpeta traduccion dentro de la carpeta modules de tu Nuke.
<?php
if (!stristr($_SERVER['SCRIPT_NAME'], "modules.php")) {
die ("You can't access this file directly...");
}
require_once("mainfile.php");
include("header.php");
$module_name = basename(dirname(__FILE__));
get_lang($module_name);
Opentable();
?>
Aquí estoy escribiendo en HTML y más abajo está la parte
específica donde quiero utilizar el archivo lang-spanish, así
que lo encierro entre las etiquetas de apertura y de cierre en formato PHP.<br><br>
<?php echo "Presione "._SEARCH." luego de elegir la opción"; ?>
<br><br>
Como vez, se a transformado el código en la palabra "Buscar".<br><br>
Más abajo puedo seguir escribiendo en el formato que guste, si quieres
hacer todo el módulo en formato PHP lo puedes hacer, pero si sólo
quieres hacer una traducción (como en este caso), esta es una forma práctica
de hacerlo.
<?php
Closetable();
include("footer.php");
?>
Ok..., ahora una breve explicación:
Arriba en rojo, está el inicio del código en PHP que usamos anteriormente al crear un módulo.
En naranja he agregado un código que me permite usar las traducciones de los archivos lang-, ubicados en una carpeta llamada language que debe estar dentro del mismo módulo en que se encuentra el archivo.
Entonces, debes crear una carpeta llamada language en el mismo módulo, y dentro de esa carpeta creas los diferentes archivos lang. Por ejemplo, crea un archivo llamado lang-spanish.php con este contenido:
<?php
define("_SEARCH","Buscar");
?>
Guárdalo dentro de la carpeta language que creaste en el módulo.
Sigue el texto en formato HTML común y silvestre. Lo dejé con el color natural de las letras, que en este caso es blanco. Cuando lo pongas en tu Nuke cambiarán de color.
En azul, el código en PHP que contiene el texto que será traducido por los archivos langs que se encuentran en la carpeta language dentro del mismo módulo. Observa cómo lo he encerrado entre las etiquetas <?php y ?> para poder usar las traducciones. Desglosado es lo siguiente:
<?php = etiqueta de apertura en formato PHP.
echo " "; = lo que está encerrado entre sus comillas será interpretado por el navegador.
Presione / luego de elegir la opción = texto común.
"._SEARCH." = código que será interpretado a través de los archivos langs.
?> = etiqueta de cierre
Luego sigue otra parte en formato HTML.
Y terminamos cerrando la tabla (Closetable()
, incluyendo el archivo footer.php (para que se vea la parte de abajo de la Web en tu módulo), y luego cerramos con el símbolo ?>.
Seguramente hay partes del código en HTML que no le vez forma, pero cuando veas el módulo en tu Nuke podrás leer con claridad todo lo que escribí (te recomiendo que crees este módulo en local).
Espero que haya quedado claro cómo utilizar los diferentes archivos lang, si no es así me pones un post en el Foro para aclarar dudas.
Bueno... a dar rienda suelta a tu imaginación.., de ahora en adelante tu Nuke será original sin dejar de ser Multilingüe.
Cómo sabemos, PHP-Nuke permite por defecto la visualización del texto en varios idiomas. Sólo hay que presionar un botón y listo.
Bueno..., vamos a aprovechar esta cualidad para personalizar las traducciones y para crear nuevo texto que pueda ser visto en varios idiomas.
Primero haz una copia del archivo "lang-spanish.php" que está en la carpeta "language". Guarda la copia en "mis documentos" o donde quieras.
Ahora abre el archivo "lang-spanish". Vas a ver líneas de texto como estas:
define("_DOWNLOADNAME","Nombre de la Descarga");
define("_AUTHORNAME","Autor");
define("_AUTHOREMAIL","E-mail");
define("_INBYTES","En Bytes");
Estas son las del principio. Para la práctica vamos a usar sólo una línea:
define("_SEARCH","Buscar");
La palabra "Buscar" la puedes ver en el Menú Principal. Si presionas la opción inglesa del Nuke cambia a "Search"
Esto funciona de la siguiente manera..., lo que está escrito realmente es esto "._SEARCH."..., pero el Nuke lo traduce al Español (utilizando el archivo lang-spanish) o al Inglés (utilizando el archivo lang-english).
Para manipular el texto que se va a traducir, sólo tendrías que cambiar la parte donde dice "Buscar" y poner otro texto. Por ejemplo escribe........"Arroz con pollo", y guarda el archivo en tu Nuke. Ahora abre tu página y en el espacio en que debería decir "Buscar", va a decir "Arroz con pollo".
Fácil verdad..?.
Ok, ya sabes personalizar lo que está escrito..., ahora vamos a crear más opciones de texto a traducir (seguro que supones cómo se hace, pero hay te va):
Cópiate de las líneas del lang-spanish..., por ejemplo la misma de antes:
define("_SEARCH","Buscar");
Ahora creamos una:
define("_TOEC","Esto es Super Fácil verdad...?");
Introduce esta línea en el lang-spanish y guarda los cambios.
El siguiente paso es colocar el texto ("._TOEC.") en un bloque (debes repasar el Anexo 3: Cómo hacer tus Propios Bloques).
Lo pones así:
$content .= ""._TOEC."<br>";
Analicemos esto:
1. "._TOEC." ------> va encerrado entre comillas
2. Después de la primera comilla y antes de la última, se pone un punto ( . )
3. Pones lo mismo que en el lang-spanish
Listo...¡
Recuerda que si quieres que el texto sea "bilingüe", debes hacer lo mismo en el lang-english.
***Las anteriores son instrucciones básicas para utilizar los archivos "lang" en traducciones a textos de un Bloque.
Ahora, si quieres crear un Módulo con las mismas cualidades, es decir, que se pueda leer en varios idiomas, haces lo siguiente:
Importante: Esta función sólo puedes usarla en formato PHP, es decir que la parte donde aparece el código a traducir, debe estar encerrado entre las etiquetas de apertura y de cierre en PHP..., ejemplo:
<?php Aquí el código ?>
Entonces, a manera de ejemplo vas a crear un módulo (ya debes saber cómo hacerlo, con la ayuda del Manual sobre Módulos). Este módulo será lo más sencillo posible, sólo para que veas cómo utilizar los langs (las traducciones).
Copia lo siguiente y lo guardas con el nombre index.php, creas una carpeta con el nombre traduccion y pones el archivo index.php dentro. Ahora pon la carpeta traduccion dentro de la carpeta modules de tu Nuke.
<?php
if (!stristr($_SERVER['SCRIPT_NAME'], "modules.php")) {
die ("You can't access this file directly...");
}
require_once("mainfile.php");
include("header.php");
$module_name = basename(dirname(__FILE__));
get_lang($module_name);
Opentable();
?>
Aquí estoy escribiendo en HTML y más abajo está la parte
específica donde quiero utilizar el archivo lang-spanish, así
que lo encierro entre las etiquetas de apertura y de cierre en formato PHP.<br><br>
<?php echo "Presione "._SEARCH." luego de elegir la opción"; ?>
<br><br>
Como vez, se a transformado el código en la palabra "Buscar".<br><br>
Más abajo puedo seguir escribiendo en el formato que guste, si quieres
hacer todo el módulo en formato PHP lo puedes hacer, pero si sólo
quieres hacer una traducción (como en este caso), esta es una forma práctica
de hacerlo.
<?php
Closetable();
include("footer.php");
?>
Ok..., ahora una breve explicación:
Arriba en rojo, está el inicio del código en PHP que usamos anteriormente al crear un módulo.
En naranja he agregado un código que me permite usar las traducciones de los archivos lang-, ubicados en una carpeta llamada language que debe estar dentro del mismo módulo en que se encuentra el archivo.
Entonces, debes crear una carpeta llamada language en el mismo módulo, y dentro de esa carpeta creas los diferentes archivos lang. Por ejemplo, crea un archivo llamado lang-spanish.php con este contenido:
<?php
define("_SEARCH","Buscar");
?>
Guárdalo dentro de la carpeta language que creaste en el módulo.
Sigue el texto en formato HTML común y silvestre. Lo dejé con el color natural de las letras, que en este caso es blanco. Cuando lo pongas en tu Nuke cambiarán de color.
En azul, el código en PHP que contiene el texto que será traducido por los archivos langs que se encuentran en la carpeta language dentro del mismo módulo. Observa cómo lo he encerrado entre las etiquetas <?php y ?> para poder usar las traducciones. Desglosado es lo siguiente:
<?php = etiqueta de apertura en formato PHP.
echo " "; = lo que está encerrado entre sus comillas será interpretado por el navegador.
Presione / luego de elegir la opción = texto común.
"._SEARCH." = código que será interpretado a través de los archivos langs.
?> = etiqueta de cierre
Luego sigue otra parte en formato HTML.
Y terminamos cerrando la tabla (Closetable()
, incluyendo el archivo footer.php (para que se vea la parte de abajo de la Web en tu módulo), y luego cerramos con el símbolo ?>.
Seguramente hay partes del código en HTML que no le vez forma, pero cuando veas el módulo en tu Nuke podrás leer con claridad todo lo que escribí (te recomiendo que crees este módulo en local).
Espero que haya quedado claro cómo utilizar los diferentes archivos lang, si no es así me pones un post en el Foro para aclarar dudas.
Bueno... a dar rienda suelta a tu imaginación.., de ahora en adelante tu Nuke será original sin dejar de ser Multilingüe.
