diff --git a/docs/es/appendixes/tips.xml b/docs/es/appendixes/tips.xml index df112580..c65db98e 100644 --- a/docs/es/appendixes/tips.xml +++ b/docs/es/appendixes/tips.xml @@ -11,8 +11,9 @@ usted defíne a una variable vacia en vez de imprimir nada, tal como imprimir "&nbsp;" a fin de que el plano del fondo de la tabla funcione correctamente. Muchos usarian una sentencia - {if} para manejar esto, mas existe otra forma con Smarty, usando - el modificador de la variable default. + {if} para manejar esto, + mas existe otra forma con Smarty, usando el modificador de la variable + default. Imprimiendo &nbsp; cuando una variable esta vacia @@ -33,6 +34,10 @@ ]]> + + Ver tambien default + y Default Variable Handling. + @@ -43,7 +48,7 @@ mencionado puede evitar un bit desagradable. Usted puede remediar esto con la atribución de un valor por default a la variable con la función - assign. + {assign}. Atribuyendo el valor por default a una variable en el template @@ -58,62 +63,79 @@ usted lo exiba *} ]]> + + Vea tambiéen default y + Blank Variable Handling. + + Pasando la variable titulo a la cabecera del template Cuando la mayoria de sus templates usan los mismo encabezados y los mismos pies de pagina, es común dividirlos uno en cada template - y entonces incluirlos. Que pasara si el encabezado necesita tener - un titulo diferente, dependiendo de que pagina estas viniendo? - usted puede pasar el titulo en el encabezado cuando este es incluido. + y entonces incluirlos {include}. + Que pasara si el encabezado necesita tener un titulo diferente, + dependiendo de que pagina estas viniendo? usted puede pasar el + titulo en el encabezado cuando este es incluido. Pasando la variable titulo al encabezado del template + + mainpage.tpl + + + + archives.tpl + + + - -{$title|default:"BC News"} - - - - -footer.tpl ----------- - - +]]> + + + header.tpl + + + + +{$title|default:"BC News"} + + +]]> + + + footer.tpl + + + + ]]> Cuando la pagina principal es mostrada, el titulo de la "Página - Principal" es pasado al template header.tpl, y será posteriormente - usado como el titulo. Cuando la pagina de archivo es mostrada, el - titulo sera "Archivos". Observelo en el ejemplo de archivo, nosotros - estamos usando una variable del archivo archives_page.conf en vez de - una variable codificada rigida. Tambien note que "BC news" es mostrada - si la variable $titulo no esta definida, usando el modificador de la - variable default. + Principal" es pasado al template header.tpl, + y será posteriormente usado como el titulo. Cuando la pagina de archivo + es mostrada, el titulo sera "Archivos". Observelo en el ejemplo de archivo, + nosotros estamos usando una variable del archivo + archives_page.conf en vez de una variable codificada + rigida. Tambien note que "BC news" es mostrada si la variable $titulo no + esta definida, usando el modificador de la variable + default. @@ -129,7 +151,7 @@ footer.tpl En el Smarty 1.4.0, usted puede parsar fechas al Smarty como timestamps unix,mysql, o cualquier otra fecha interpretable - por strtotime(). + por strtotime(). @@ -169,10 +191,10 @@ Jan 4, 2001 - Cuando usa {html_select_date} en un template, el programador - normalmente va a querer convertir la salida de un formulario - de vuelta al formato timestamp. Aquí esta una función para - ayudar con esto. + Cuando usa {html_select_date} + en un template, el programador normalmente va a querer convertir + la salida de un formulario de vuelta al formato timestamp. Aquí + esta una función para ayudar con esto. Convirtiendo elementos en forma de fecha de vuelta a un timestamp @@ -202,18 +224,28 @@ function makeTimeStamp($year="", $month="", $day="") ]]> + + Vea también + {html_select_date}, + {html_select_time}, + date_format + y $smarty.now, + + WAP/WML - Los templates WAP/WML requieren de un encabezado de Content-Type de + Los templates WAP/WML requieren de un encabezado de + Content-Type de PHP para ser pasado junto con el template. La forma mas fácil de hacer esto seria escribir una función de manera habitual que imprima - el encabezado. Si usted esta usando el sistema de cache, este no - funcionara, entonces nosotros haremos esto usando una etiqueta de - insert (recuerde que las etiquetas insert no son "cacheadas!"). - Asegurarse que no exista ninguna salida al navegador antes del template, - de otro modo el encabezado fallara. + el encabezado. Si usted esta usando el sistema de + cache, este no funcionara, entonces + nosotros haremos esto usando una etiqueta de + {insert} (recuerde que + las etiquetas insert no son "cacheadas!"). Asegurarse que no exista + ninguna salida al navegador antes del template, de otro modo el encabezado fallara. Usando insert para escribir un encabezado WML Content-Type @@ -273,12 +305,14 @@ Pretty easy isn't it? Templates con Componetes - Tradicionalmente, programar templates en sus aplicaciones sigue - esta forma: Primero, usted acumula sus variables dentro de su + Tradicionalmente, programar templates en sus aplicaciones es de + la siguiente forma: Primero, usted acumula sus variables dentro de su aplicación PHP, (talvez como requisiciones de una base de datos). - Entonces, usted instancia su objeto Smarty, atribuye valores a - las variables y muestra el template. Por ejemplo nosotros tenemos - un registrador de existencias en nuestro template. Nosotros + Entonces, usted instancia su objeto Smarty + assign(), atribuye valores a + las variables y muestra el template + display(). Por ejemplo nosotros + tenemos un registrador de existencias en nuestro template. Nosotros recolectaremos los datos de las existencias en nuestra aplicación, entonces damos valor a estas variables en el template y lo mostramos. Ahora esto seria genial si usted adicionara este registrador de @@ -292,11 +326,16 @@ Pretty easy isn't it? Templates con Componetes + + function.load_ticker.php - + deja el archivo en + $plugins directory + ]]> + + index.tpl + + + Vea también {include_php}, + {include} y + {php}. + + Ofuscando direcciones de E-mail @@ -340,14 +383,14 @@ Stock Name: {$ticker.name} Stock Price: {$ticker.price} combatir este problema, usted puede hacer que su direccion de E-mail aparesca en javascript mostrado en el codigo HTML, este mismo aparecera y funcionara correctamente en el navegador. - Esto se puede hacer con el plugin mailto. + Esto se puede hacer con el plugin + {mailto}. Ejemplo de ofuscamiento de una direccion de E-mail + + Vea también escape + y {mailto}. + {include file=$includeFile} {include file=#includeFile#} {* display dropdown lists *} + ]]> diff --git a/docs/es/designers/language-basic-syntax/language-syntax-functions.xml b/docs/es/designers/language-basic-syntax/language-syntax-functions.xml index dab796df..67fbe9ff 100644 --- a/docs/es/designers/language-basic-syntax/language-syntax-functions.xml +++ b/docs/es/designers/language-basic-syntax/language-syntax-functions.xml @@ -6,7 +6,8 @@ Cada etiqueta Smarty muestra una variable o utiliza algún tipo de función. Las funciones son procesadas y mostradas colocando - los atributos de la función entre delimitadores, así: + los atributos de + la función entre delimitadores, así: {funcname attr1="val" attr2="val"}. @@ -29,14 +30,20 @@ Las funciones internas y las funciones habituales, ambas deben tener - la misma sintaxis dentro del template. Las funciones internas que - funcionan en Smarty, son: if, - section y strip. - Estas no pueden ser modificadas. Las funciones habituales son - funciones adicionales implementadas por plugins. Estas si pueden + la misma sintaxis dentro del template. Las funciones internas que + funcionan en Smarty, son: + {if}, + {section} y + {strip}. + Estas no pueden ser modificadas. + Las funciones habituales son + funciones adicionales implementadas + por plugins. Estas si pueden ser modificadas como usted quiera, o usted también puede adicionar nuevas. - html_options y html_select_date + {html_options} y + {popup} son ejemplos de funciones habituales. diff --git a/docs/es/designers/language-basic-syntax/language-syntax-quotes.xml b/docs/es/designers/language-basic-syntax/language-syntax-quotes.xml index fdedcaef..e03f3728 100644 --- a/docs/es/designers/language-basic-syntax/language-syntax-quotes.xml +++ b/docs/es/designers/language-basic-syntax/language-syntax-quotes.xml @@ -3,10 +3,14 @@ Colocando variables entre comillas dobles - Smarty puede reconocer variables asignadas entre comillas aunque estas + Smarty puede reconocer variables + asignadas entre comillas aunque estas solo tengan números, letras, guiones bajos y corchetes[]. Con cualquier otro carácter(puntos, referencia de objetos, etc.) las variables deben estar entre apostrofos. + Usted no puede incrustar modificadores, + Estos deben ser siempre aplicados fuera de las comillas. + Sintaxis entre comillas @@ -19,6 +23,7 @@ SYNTAX EXAMPLES: {func var="test $foo[bar] test"} <-- sees $foo[bar] {func var="test $foo.bar test"} <-- sees $foo (not $foo.bar) {func var="test `$foo.bar` test"} <-- sees $foo.bar +{func var="test `$foo.bar` test"|escape} <-- modifiers outside quotes! PRACTICAL EXAMPLES: {include file="subdir/$tpl_name.tpl"} <-- will replace $tpl_name with value @@ -26,6 +31,10 @@ PRACTICAL EXAMPLES: ]]> + + Ver también escape. + + - foreach,foreachelse + {foreach},{foreachelse} @@ -24,8 +24,7 @@ array Si n/a - El nombre de la matriz a la que usted estara pegando - los elementos + El nombre de la matriz a la que usted estara pegando los elementos item @@ -54,8 +53,9 @@ Los ciclos(loop) foreach son una alternativa para loop - section. foreach es usado para pegar - cada elemento de una matriz asociativa simple. + {section}. + foreach es usado para pegar cada elemento de una + matriz asociativa simple. La sintaxis para foreach es mucho mas simple que section, pero tiene una desventaja de que solo puede ser usada en una única matriz. @@ -73,64 +73,115 @@ foreach - + + assign('custid', $arr); + ?> + ]]> + + + {/foreach} - -SALIDA: - -id: 1000<br> -id: 1001<br> -id: 1002<br> +]]> + + + Esta es la salida del ejemplo de arriba: + + + +id: 1001
+id: 1002
+]]> + foreach key - -{* La llave contiene la llave para cada valor del ciclo(loop) - -asignacion fisica de esta manera: - -$smarty->assign("contacts", array(array("phone" => "1", "fax" => "2", "cell" => "3"), - array("phone" => "555-4444", "fax" => "555-3333", "cell" => "760-1234"))); - -*} - + +assign('contacts', array( + array('phone' => '1', + 'fax' => '2', + 'cell' => '3'), + array('phone' => '555-4444', + 'fax' => '555-3333', + 'cell' => '760-1234') + )); +?> +]]> + + + {foreach key=key item=item from=$contact} - {$key}: {$item}<br> + {$key}: {$item}
{/foreach} {/foreach} - -SALIDA: - -phone: 1<br> -fax: 2<br> -cell: 3<br> -phone: 555-4444<br> -fax: 555-3333<br> -cell: 760-1234<br> - +]]> + + + Esta es la salida del ejemplo de arriba: + + + + phone: 1
+ fax: 2
+ cell: 3
+
+ phone: 555-4444
+ fax: 555-3333
+ cell: 760-1234
+]]> + + + + Ejemplo de {foreach} - con base de datos (eg PEAR o ADODB) + +assign("contacts", $db->getAssoc($sql)); +?> +]]> + + +{$con.name} - {$con.nick}
+{/foreach} +]]> + + El ciclo(Loop) foreach también tiene sus propias variables para manipular las propiedades del foreach. - Estas son indicadas así: {$smarty.foreach.foreachname.varname} con - foreachname siendo el nombre especificado del atributo + Estas son indicadas así: + {$smarty.foreach.foreachname.varname} + con foreachname siendo el nombre especificado del atributo name del foreach. - + Ver {section} + para ejemplos ide las propiedades bajo las cuales son identicos. + iteration iteration es usado para mostrar la interación actual del ciclo(loop). - - - iteration siempre comienza en 1 incrementado uno a uno en cada interaciónn. + iteration siempre comienza en 1 incrementado en uno cada interación. @@ -166,13 +217,14 @@ cell: 760-1234<br> total Es usado para mostrar el número de interaciones del foreach. Este puede ser usado dentro o después de el. + + Ver tambien {section} y + $smarty.foreach. + - - - - + - include_php + {include_php} @@ -48,34 +48,27 @@ Nota técnica - include_php es muy desaprovechado desde Smarty, usted puede + {include_php} es muy desaprovechado desde Smarty, usted puede lograr la misma funcionalidad por medio de las funciones de costumbre del template. - La unica razón para usar include_php es si usted en realidad tiene - la necesidad de poner en cuarentna la funcion de php fuera del - directorio de plugin y su codigo de la aplicación. + La unica razón para usar {include_php} es si usted en realidad tiene + la necesidad de poner en cuarentena la funcion de php fuera del + directorio de plugins y + su codigo de la aplicación. Vea un ejemplo de templates componentizados para detalles. - Las etiquetas include_php son usadas para incluir un script PHP - dentro de su template. Si la seguridad estuviera activada, entonces - el script PHP debe estar localizado en la ruta $trusted_dir. + Las etiquetas {include_php} son usadas para incluir un script PHP + dentro de su template. + Si la seguridad estuviera activada, entonces + el script PHP debe estar localizado en la ruta $trusted_dir. La etiqueta include_php debe tener el atributo "file", el cual contiene la ruta del archivo PHP a ser incluido, o el relativo - al $trusted_dir, o una ruta absoluta. - - - include_php es un buen medio para manipular templates con componentes, - y mantiene el código PHP separado de los archivos del template. - Vamos adecir que usted tenga un template que muestre la navegación de - su sitio, el cual es tirado automáticamente a partir de una base de - datos. Usted puede mantener su lógica de PHP que obtiene los datos en - un directorio separado, e incluirla arriba del template. Ahora usted - puede incluir este template en cualquier lugar sin preocuparse si la - información de la base de datos fue obtenida por la aplicación antes - de usarla. + al $trusted_dir, o + una ruta absoluta. Por default, los archivos son incluidos solo una vez a un cuando son @@ -87,38 +80,50 @@ Usted puede opcionalmente pasar el atributo assign, el cual especificara una variable del template la cual contendra toda la - salida del include_php en vez de mostrarla. + salida del {include_php} en vez de mostrarla. El objeto smarty esta disponible como $this dentro del script php que usted incluyo. -funcion include_php - -load_nav.php -------------- + funcion {include_php} + load_nav.php + +query("select * from site_nav_sections order by name",SQL_ALL); +$this->assign('sections',$sql->record); - // carga variables de una base de datos mysql y defíne esta para el template - require_once("MySQL.class.php"); - $sql = new MySQL; - $sql->query("select * from site_nav_sections order by name",SQL_ALL); - $this->assign('sections',$sql->record); - -?> - - -index.tpl ---------- +?> +]]> + + + Donde index.tpl es: + + + + {$curr_section.name}
+{/foreach} +]]> + + + Ver también {include}, + {php}, {capture}, Template Resources y Componentized Templates + + - ldelim,rdelim + {ldelim},{rdelim} - ldelim y rdelim son usados para escapar delimitadores en el template, + {ldelim} y {rdelim} son usados para + escapar delimitadores en el template, en nuestro caso "{" or "}". Usted puede usar solo {literal}{/literal} para escapar bloques de texto. - Vea tambien {$smarty.ldelim} - y {$smarty.rdelim} + Vea tambien {$smarty.ldelim}. - ldelim, rdelim + {ldelim}, {rdelim} + Otros ejemplos con algunos javascript + + +function foo() {ldelim} + ... code ... +{rdelim} + +]]> + + + esta es la salida + + + +function foo() { + .... code ... +} + +]]> + + + Vea también Escaping Smarty Parsing - php + {php} - Las etiquetas php permiten que usted adicione código php directamente + Las etiquetas {php} permiten a suetdd incrustar código php directamente en el template. No será escapado, no importando la definición de $php_handling. Esto es solo para usuario avanzados y normalmente no es necesario. -Etiqueta php - + Etiqueta {php} + + + include("/path/to/display_weather.php"); +{/php} +]]> + + +Nota técnica + + Para poder tener acceso a las variables de PHP puede ser necesario usar la palabra clave + global de PHP. + + + + ver También + $php_handling, + {include_php}, + {include} y + Componentized Templates. + + - strip + {strip} Muchas veces el diseñador de web tiene problemas con los espacios en blanco y retornos de carro que afectan la salida del HTML @@ -20,33 +20,36 @@ Nota Técnica {strip}{/strip} no afeta el contenido de las variables del template. - Vea strip modifier function. + Vea la función strip modifier. -strip tags - + {strip} tags + - - - - This is a test - - - + + + +
+ + This is a test + +
{/strip} - - -SALIDA: - -
This is a test
]]> - - + + + salida del ejemplo de arriba: + + +strip modifier + - assign + {assign} @@ -37,20 +37,86 @@ - assign es usado para definir valores a las variables de template - durante la ejecución del template. + {assign} es usado para definir valores a las variables de template + durante la ejecución del template. -assign - + {assign} + + + + + Salida del ejemplo de arriba: + + + + + -SALIDA: + + Accesando variables desde un script de PHP. {assign} + + Puedes accesar {assign} variables desde php usando + get_template_vars(). + sin embargo, las variables solo estan disponibles despues/durante + la ejecución del template como en el siguiente ejemplo + + + + + + - +// this will output nothing as the template has not been executed +echo $smarty->get_template_vars('foo'); + +// fetch the template to a dead variable +$dead = $smarty->fetch('index.tpl'); + +// this will output 'smarty' as the template has been executed +echo $smarty->get_template_vars('foo'); + +$smarty->assign('foo','Even smarter'); + +// this will output 'Even smarter' +echo $smarty->get_template_vars('foo'); + +?> +]]> + + + + + La siguiente función optionally también puede asignar variables al template. + + + + {capture}, + {include}, + {include_php}, + {insert}, + {counter}, + {cycle}, + {eval}, + {fetch}, + {math}, + {textformat} + + + + Ver también assign() + y get_template_vars(). + - counter + {counter} @@ -65,7 +65,7 @@ - counter es usada para mostrar un conteo. counter va a depender del + {counter} es usada para mostrar un conteo. {counter} va a depender del conteo en cada iteración. Usted puede ajustar el número, el intervalo y la dirección del conteo, asi como determinar cuando mostrar o no el conteo. Usted puede tener varios contadores al mismo tiempo, dando un diff --git a/docs/es/designers/language-custom-functions/language-function-cycle.xml b/docs/es/designers/language-custom-functions/language-function-cycle.xml index 1fafbfec..5fee8401 100644 --- a/docs/es/designers/language-custom-functions/language-function-cycle.xml +++ b/docs/es/designers/language-custom-functions/language-function-cycle.xml @@ -63,16 +63,23 @@ n/a La variable del template que recibirá la salida + + reset + boolean + No + false + Este coloca al ciclo en el primer valor y no le permite avanzar + - Cycle es usado para hacer un ciclo a través de un conjunto + {Cycle} es usado para hacer un ciclo a través de un conjunto de valores. Esto hace mas fácil alternar entre dos o mas colores en una tabla, o ciclos a travéz de una matriz de valores. - Usted puede usar el cycle en mas de un conjunto de valores en su + Usted puede usar el {cycle} en mas de un conjunto de valores en su template supliendo el atributo name. De cada uno de los conjuntos de valores. diff --git a/docs/es/designers/language-custom-functions/language-function-debug.xml b/docs/es/designers/language-custom-functions/language-function-debug.xml index f7696f8e..a3153f47 100644 --- a/docs/es/designers/language-custom-functions/language-function-debug.xml +++ b/docs/es/designers/language-custom-functions/language-function-debug.xml @@ -1,7 +1,7 @@ - debug + {debug} @@ -23,7 +23,7 @@ output string No - html + javascript Tipo de salida, html o javascript @@ -38,6 +38,10 @@ decir en uso. Usted puede ver todas las variables disponibles del template con scope. + + Ver también Debugging console + + - eval + {eval} @@ -37,7 +37,7 @@ - eval es usado para evaluar una variable como de template. Esto puede + {eval} es usado para evaluar una variable como de template. Esto puede ser usado para cosas como incrustar tags(etiquetas)/variables del template dentro de las variables o tags(etiquetas)/variables dentro de las variables de un archivo de configuración. @@ -60,43 +60,51 @@ Las variables evaluadas son compiladas en cada invocación, las vesiones compiladas no son salvas. Sin embargo, si usted tiene - activado el cache, la salida se va a fijar en la cache junto con - el resto del template. + activado el cache, la salida se va a fijar en la + cache junto con el resto del template. -eval - -setup.conf ----------- + {eval} + + + emphend = + title = Welcome to {$company}'s home page! + ErrorCity = You must supply a {#emphstart#}city{#emphend#}. + ErrorState = You must supply a {#emphstart#}state{#emphend#}. +]]> + + + Where index.tpl is: + + + + + + La salida del ejemplo de arriba: + + +city. + You must supply a state. -index.tpl ---------- - -{config_load file="setup.conf"} - -{eval var=$foo} -{eval var=#title#} -{eval var=#ErrorCity#} -{eval var=#ErrorState# assign="state_error"} -{$state_error} - -SALIDA: - -This is the contents of foo. -Welcome to Foobar Pub & Grill's home page! -You must supply a <b>city</b>. -You must supply a <b>state</b>. - - - +]]> + + - fetch + {fetch} @@ -37,7 +37,7 @@ - fetch es usado para obtener archivos de sistema local, http o ftp, y + {fetch} es usado para obtener archivos de sistema local, http o ftp, y mostrar el contenido. Si el nombre del archivo comienza con "http://", la página del web site sera traida y mostrada. Si el nombre del archivo comienza con "ftp://", el archivo será obtenido del servidor ftp y @@ -46,13 +46,13 @@ Si usted indica el atributo especial "assign", la salida de la función - fetch se ira a una variable de template en vez de ser mostrada en el + {fetch} se ira a una variable de template en vez de ser mostrada en el template. (nuevo en Smarty 1.5.0) Nota Técnica - Esto no soporta redirecionamento http, tenga la certeza de incluir + Esto no soporta redirecionamento http, tenga la certeza de incluirlo en la barra el seguimiento para ir a buscar donde sea necesario. @@ -62,30 +62,35 @@ Si tiene activada la seguridad en su template y usted estuviera recibiendo un archivo del sistema de archivos local, esto permitira que solo archivos de uno de los directorios estuviera definido como - seguro. ($secure_dir) + seguro. ($secure_dir) fetch {$weather} + {$weather} {/if} ]]> + + Ver también {capture}, + {eval} + y fetch(). + - html_checkboxes + {html_checkboxes} @@ -41,7 +41,7 @@ una matriz de salida para los botones checkbox - selected/checked + selected string/array No empty @@ -72,8 +72,9 @@ - html_checkboxes es una función personalizada que crea un grupo - de checkbox con datos privistos. Este cuida cuales items(s) + {html_checkboxes} es una + función personalizada + que crea un grupo de checkbox con datos privistos. Este cuida cuales items(s) estan selecionados por default. Los atributos requeridos son values y output, a menos que usted use options. Toda la salida es compatible con XHTML. @@ -84,65 +85,99 @@ <input> creada. - html_checkboxes + {html_checkboxes} assign('cust_ids', array(1000,1001,1002,1003)); -$smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','Jane Johnson','Charlie Brown')); +$smarty->assign('cust_names', array( + 'Joe Schmoe', + 'Jack Smith', + 'Jane Johnson', + 'Charlie Brown') + ); $smarty->assign('customer_id', 1001); -$smarty->display('index.tpl'); ?> -]] +]]> - where index.tpl is: +donde el template es "} -]] +{html_checkboxes name="id" values=$cust_ids output=$cust_names + selected=$customer_id separator="
"} +]]> + + o donde el codigo es: + assign('cust_checkboxes', array( - 1000 => 'Joe Schmoe', - 1001 => 'Jack Smith', - 1002 => 'Jane Johnson', - 1003 => 'Charlie Brown')); + 1000 => 'Joe Schmoe', + 1001 => 'Jack Smith', + 1002 => 'Jane Johnson', + 1003 => 'Charlie Brown') + ); $smarty->assign('customer_id', 1001); -$smarty->display('index.tpl'); + ?> ]]> - Donde index.tpl es: + y el template es "} ]]> - Salida (los dos ejemplos): + salida de ambos ejemplos: Joe Schmoe
-
+ +


]]> + + + ejemplo de base de datos (eg PEAR o ADODB): + + +assign('types',$db->getAssoc($sql)); + +$sql = 'select * from contacts where contact_id=12'; +$smarty->assign('contact',$db->getRow($sql)); + +?> +]]> + + +"} +]]> + + + + Vea también + {html_radios} + y {html_options} + - html_image + {html_image} @@ -66,17 +66,19 @@ - html_image es una función habitual que genera una etiqueta - HTML para una imagen. La altura y lo largo son automáticamente - calculadas a partir del archivo de la imagen si ningún valor - suplido. + {html_image} es una + función habitual + que genera una etiqueta HTML para una imagen. La altura y lo largo + son automáticamente calculadas a partir del archivo de la imagen si + ningún valor suplido. basedir es el directorio base en el cual las rutas relativas de las imagenes estan basados. Si no lo proporciona, el document root del - servidor (variable de ambiente DOCUMENT_ROOT) es usada como el - directorio base. Si la seguridad esta habilitada, la ruta para la - imagen debe estar dentro de un directorio seguro. + servidor (env variable + de ambiente DOCUMENT_ROOT) es usada como el + directorio base. Si la $security + esta habilitada, la ruta para la imagen debe estar dentro de un directorio seguro. href es el valor href a donde la imagen @@ -91,46 +93,35 @@ Nota Técnica - html_image requiere un acceso a disco para leer la imagen y - calcular la altura y el largo. Si usted no usa cache en el - template, generalmente es mejor evitar html_image y utilizar - las etiquetas de imagem estáticas para un optimo funcionamiento. + {html_image} requiere un acceso a disco para leer la imagen y + calcular la altura y el largo. Si usted no usa cache en el template, + generalmente es mejor evitar {html_image} y utilizar + las etiquetas de imagen estáticas para un optimo funcionamiento. html_image example - -display('index.tpl'); - -?> -]]> - - - Donde index.tpl es: - - + - - - SALIDA (posible): - - + + + la posible saldida puede ser: + + ]]> - - + + - html_options + {html_options} @@ -58,15 +58,16 @@ - html_options es una función customizada que crea un grupo - html option con los datos proporcionados. Este se encarga de - cuidar cuales datos han sido selecionado por default. + {html_options} es una + función customizada + que crea un grupo html <select><option> con los datos proporcionados. + Este se encarga de cuidar cuales datos han sido selecionado por default. Los atributos son valores y salidas, a menos que usted utilice options en lugar de eso. - Si un valor es una matriz, este será tratado como un OPTGROUP html, - y mostrara los grupos. La recursión es soportada por OPTGROUP. + Si un valor es una matriz, este será tratado como un <optgroup> html, + y mostrara los grupos. La recursión es soportada por <optgroup>. Todas las salidas son compatibles con XHTML. @@ -76,58 +77,116 @@ De otra manera solo es generada la lista de opciones. - Todos los parámetros que no estan en la lista de arriba son + Todos los parámetros que no estan en la lista de arriba son exibidos como name/value-pairs dentro de las etiquetas <select>. Estas son ignoradas si la opcion name no es dada. -html_options + {html_options} + + Ejemplo 1: + + +assign('cust_ids', array(1000,1001,1002,1003)); +$smarty->assign('cust_names', array( + 'Joe Schmoe', + 'Jack Smith', + 'Jane Johnson', + 'Charlie Brown')); +$smarty->assign('customer_id', 1001); + +?> +]]> + + + donde el template es: + + + + {html_options values=$cust_ids output=$cust_names selected=$customer_id} + +]]> + + + Ejemplo 2: + + +assign('cust_options', array( + 1000 => 'Joe Schmoe', + 1001 => 'Jack Smith', + 1002 => 'Jane Johnson', + 1003 => 'Charlie Brown') + ); +$smarty->assign('customer_id', 1001); + +?> +]]> + + +donde el template es: + + + + {html_options options=$cust_options selected=$customer_id} + +]]> + + + Salida de ambos ejemplos de arriba: + + + + + + + + + +]]> + + + + {html_options} - Ejemplo con base de datos (eg PEAR o ADODB): + +assign('types',$db->getAssoc($sql)); + +$sql = 'select contact_id, name, email, type_id + from contacts where contact_id='.$contact_id; +$smarty->assign('contact',$db->getRow($sql)); + +?> +]]> + + +Donde el template es: + -index.php: - -require('Smarty.class.php'); -$smarty = new Smarty; -$smarty->assign('cust_ids', array(1000,1001,1002,1003)); -$smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','Jane -Johnson','Carlie Brown')); -$smarty->assign('customer_id', 1001); -$smarty->display('index.tpl'); - -index.tpl: - -<select name=customer_id> - {html_options values=$cust_ids selected=$customer_id output=$cust_names} -</select> - - -index.php: - -require('Smarty.class.php'); -$smarty = new Smarty; -$smarty->assign('cust_options', array( - 1001 => 'Joe Schmoe', - 1002 => 'Jack Smith', - 1003 => 'Jane Johnson', - 1004 => 'Charlie Brown')); -$smarty->assign('customer_id', 1001); -$smarty->display('index.tpl'); - -index.tpl: - -<select name=customer_id> - {html_options options=$cust_options selected=$customer_id} -</select> - - -SALIDA: (Ambos ejemplos) - -<select name=customer_id> - <option value="1000">Joe Schmoe</option> - <option value="1001" selected="selected">Jack Smith</option> - <option value="1002">Jane Johnson</option> - <option value="1003">Charlie Brown</option> -</select> - + + + {html_options name="type" options=$types selected=$contact.type_id} + +]]> + + + + vea también + {html_checkboxes} + y {html_radios} + - html_radios + {html_radios} @@ -65,11 +65,12 @@ - html_radios es una función customizada que crea grupos de - botones de radio html con los datos proporcionados. Este esta - atento para saber cual objeto esta selccionado por default. - Los atributos requeridos son valores y salidas, a menos que usted - use option en lugar de eso. Toda salida es compatible con XHTML. + {html_radios} es una + función customizada + que crea grupos de botones de radio html con los datos proporcionados. + Este esta atento para saber cual objeto esta selccionado por default. + Los atributos requeridos son valores y salidas, a menos que usted + use option en lugar de eso. Toda salida es compatible con XHTML. Todos los parámetros que no estan en la lista de arriba son impresos @@ -77,49 +78,105 @@ -html_radios - -index.php: + {html_radios} : Ejemplo 1 + +assign('cust_ids', array(1000,1001,1002,1003)); +$smarty->assign('cust_names', array( + 'Joe Schmoe', + 'Jack Smith', + 'Jane Johnson', + 'Charlie Brown') + ); +$smarty->assign('customer_id', 1001); - -index.tpl: - -{html_radios name="id" values=$cust_ids selected=$customer_id output=$cust_names separator="<br />"} - - -index.php: - -require('Smarty.class.php'); -$smarty = new Smarty; -$smarty->assign('cust_radios', array( - 1000 => 'Joe Schmoe', - 1001 => 'Jack Smith', - 1002 => 'Jane Johnson', - 1003 => 'Charlie Brown')); -$smarty->assign('customer_id', 1001); -$smarty->display('index.tpl'); - - -index.tpl: - -{html_radios name="id" options=$cust_radios selected=$customer_id separator="<br />"} - - -SALIDA: (Ambos ejemplos) - -<input type="radio" name="id" value="1000">Joe Schmoe<br /> -<input type="radio" name="id" value="1001" checked="checked">Jack Smith<br /> -<input type="radio" name="id" value="1002">Jane Johnson<br /> -<input type="radio" name="id" value="1003">Charlie Brown<br /> +?> +]]> + + + Donde el template es: + + +"} + ]]> + + + {html_radios} : Ejemplo 2 + +assign('cust_radios', array( + 1000 => 'Joe Schmoe', + 1001 => 'Jack Smith', + 1002 => 'Jane Johnson', + 1003 => 'Charlie Brown')); +$smarty->assign('customer_id', 1001); + +?> +]]> + + + Donde index.tpl es: + + +"} +]]> + + + Salida de ambos ejemplos: + + + +Joe +Schmoe
+
+
+
+]]> + + + + {html_radios}- Ejemplo con base de Datos (eg PEAR o ADODB): + +assign('types',$db->getAssoc($sql)); + +$sql = 'select contact_id, name, email, type_id + from contacts where contact_id='.$contact_id; +$smarty->assign('contact',$db->getRow($sql)); + +?> +]]> + + +y el template: + + +"} +]]> + + + + ver también + {html_checkboxes} + y {html_options} + - html_select_date + {html_select_date} @@ -86,8 +86,7 @@ string No %02d - Cual debe ser el formato de salida del dia - dentro de (sprintf) + Cual debe ser el formato de salida del dia dentro de (sprintf) day_value_format @@ -245,105 +244,102 @@ - html_select_date es una función customizada que crea menus dropdowns - de fechas para usted. Este puede mostrar algunos o todos por año, - mes y dia. + {html_select_date} es una + función customizada + que crea menus dropdowns de fechas para usted. Este puede mostrar + algunos o todos por año, mes y dia. -html_select_date - + {html_select_date} + Codigo del Template + + - - - - -html_select_date - - -{* el año de comienzo y fin puede ser relativo al año actual *} -{html_select_date prefix="StartDate" time=$time start_year="-5" end_year="+1" display_days=false} - -SALIDA: (El año actual es 2000) - -<select name="StartDateMonth"> -<option value="1">January</option> -<option value="2">February</option> -<option value="3">March</option> -<option value="4">April</option> -<option value="5">May</option> -<option value="6">June</option> -<option value="7">July</option> -<option value="8">August</option> -<option value="9">September</option> -<option value="10">October</option> -<option value="11">November</option> -<option value="12" selected>December</option> -</select> -<select name="StartDateYear"> -<option value="1999">1995</option> -<option value="1999">1996</option> -<option value="1999">1997</option> -<option value="1999">1998</option> -<option value="1999">1999</option> -<option value="2000" selected>2000</option> -<option value="2001">2001</option> -</select> - +]]> + + + Esta es la salida: + + + + + + + ..... snipped ..... + + + + + + +]]> + + + + {html_select_date} + + + + + esta es la salida: (el año actual es 2000) + + + + + + + + + + + + + + + + + +]]> + + + + Ver también {html_select_time}, + date_format, + $smarty.now + y date tips. + + - html_select_time + {html_select_time} @@ -133,31 +133,27 @@ - html_select_time es una función customizada - que crea menus dropdowns de tiempo para usted. - Esta puede mostrar algunos valores, o - todo en hora, minuto, segundo y am/pm. + {html_select_time} es una + función customizada + que crea menus dropdowns de tiempo para usted. Esta puede mostrar + algunos valores, o todo en hora, minuto, segundo y am/pm. - Los atributos de time pueden tener diferentes - formatos. el puede ser un unico timestamp o - una cadena conteniendo Y-M-D. YYYY-MM-DD puede - ser lo mas común. exepto meses y dias con menos - de dos digitos también son reconocidos; - Si uno de los 3 valores (Y,M,D) es una cadena - vacia, que segun el select-box no es pre-seleccionada - del todo. este es especialmente usado con los - atributos empty_teay-, -month- y -day-. + Los atributos de time pueden tener diferentes formatos. Este puede ser + un unico timestamp o una cadena conteniendo YYYYMMDDHHMMSS o una cadena + parseda por php's strtotime(). - html_select_time + {html_select_time} - Esta es la salidat: + Esta es la salida: + + Ver también + $smarty.now, + {html_select_date} + y date tips. + - html_table + {html_table} @@ -31,13 +31,12 @@ integer No 3 - Número de columnas para la tabla. Si el - atributo cols esta vacio, los renglones seran determinados, - entonces el numero de columnas sera calculado por el - numero de renglones y el numero de elementos a mostrar - para ser ajustado a las columnas de todos los - elementos que seran mostrados, si ambos, renglones y - columnas, son omitidos las columnas por default son 3. + Número de columnas para la tabla. Si el atributo cols esta vacio, + los renglones seran determinados, entonces el numero de columnas + sera calculado por el numero de renglones y el numero de elementos a + mostrar para ser ajustado a las columnas de todos los elementos que seran + mostrados, si ambos, renglones y columnas, son omitidos las columnas por + default son 3. @@ -45,12 +44,10 @@ integer No empty - Número de renglones en la tabla. Si el atributo - rows es vacio, las columnas seran determinadas, - entonces el numero de renglones sera calculado por el - numero de columnas y el numero de elementos a mostrar - para ser ajustado el numero de renglones al total de - elementos a ser mostrados. + Número de renglones en la tabla. Si el atributo rows es vacio, + las columnas seran determinadas, entonces el numero de renglones sera + calculado por el numero de columnas y el numero de elementos a mostrar + para ser ajustado el numero de renglones al total de elementos a ser mostrados. @@ -58,12 +55,10 @@ string No cols - Dirección consecutiva de los elementos en el - arreglo para ser representados. - cols manera en que los - elementos son mostrados columna por columna. - rows manera en que los - elementos son mostrados renglon por renglon. + Dirección consecutiva de los elementos en el arreglo para ser representados. + cols manera en que los elementos son mostrados columna + por columna. rows manera en que los elementos son mostrados + renglon por renglon. @@ -101,10 +96,8 @@ string No right - dirección de una linea para ser representada. - posibles valores: - left (left-to-right), - right (right-to-left) + dirección de una linea para ser representada. posibles valores: + left (left-to-right), right (right-to-left) @@ -112,49 +105,55 @@ string No down - Dirección de las columnas para ser representadas. - posibles valores: - down (top-to-bottom), - up (bottom-to-top) + Dirección de las columnas para ser representadas. posibles valores: + down (top-to-bottom), up (bottom-to-top) - html_table Es una función customizada que - transforma un arreglo de datos en una tabla HTML. - El atributo cols determina el número de - columnas que tendra la tabla. - Los valores table_attr, - tr_attr y td_attr - determinan los atributos dados para las etiquetas tabla, tr y td. - Si tr_attr o td_attr - son arreglos, ellos entraran en un ciclo. - trailpad y el valor depositado dentro de - trailing cells en la ultima linea de la tabla si existe alguna - presente. + {html_table} Es una + función customizada + que transforma un arreglo de datos en una tabla HTML. El atributo + cols determina el número de columnas que tendra la tabla. + Los valores table_attr, tr_attr y + td_attr determinan los atributos dados para las etiquetas + tabla, tr y td. Si tr_attr o td_attr + son arreglos, ellos entraran en un ciclo. trailpad y el + valor depositado dentro de trailing cells en la ultima linea de la tabla si existe + alguna presente. + html_table - + assign('data',array(1,2,3,4,5,6,7,8,9)); $smarty->assign('tr',array('bgcolor="#eeeeee"','bgcolor="#dddddd"')); $smarty->display('index.tpl'); - -index.tpl: - +?> +]]> + + + + + + La salida de ambos ejemplos: + + + 123 456 @@ -170,9 +169,11 @@ SALIDA: 5678 9    -]]> - +]]> + + + - mailto + {mailto} @@ -31,15 +31,16 @@ string No n/a - El texto para mostrar, el default es la - dirección de correo (e-mail) + El texto para mostrar, el default es la dirección de correo (e-mail) encode string No none - Como codificar el e-mail. Puede ser none, hex o javascript. + Como codificar el e-mail. Puede ser + none, hex, + javascript o javascript_charcode. @@ -96,7 +97,7 @@ - mailto automatiza el proceso de creación de links de correo + {mailto} automatiza el proceso de creación de links de correo electronico(e-mail) y opcionalmente los codifica. Codificar el correo electronico(e-mail) hace mas difícil que las web spiders tomen las direciones de nuestro sitio. @@ -109,30 +110,49 @@ -mailto - -{mailto address="me@domain.com"} -{mailto address="me@domain.com" text="send me some mail"} -{mailto address="me@domain.com" encode="javascript"} -{mailto address="me@domain.com" encode="hex"} -{mailto address="me@domain.com" subject="Hello to you!"} -{mailto address="me@domain.com" cc="you@domain.com,they@domain.com"} -{mailto address="me@domain.com" extra='class="email"'} + {mailto} + +me@example.com -SALIDA: + {mailto address="me@example.com" text="send me some mail"} +send me some mail -<a href="mailto:me@domain.com" >me@domain.com</a> -<a href="mailto:me@domain.com" >send me some mail</a> -<script type="text/javascript" language="javascript">eval(unescape('%64%6f%63%75%6d%65%6e%74%2e%77%72%6 -9%74%65%28%27%3c%61%20%68%72%65%66%3d%22%6d%61%69%6c%74%6f%3a%6d%65%40%64%6f%6d% -61%69%6e%2e%63%6f%6d%22%20%3e%6d%65%40%64%6f%6d%61%69%6e%2e%63%6f%6d%3c%2f%61%3e -%27%29%3b'))</script> -<a href="mailto:%6d%65@%64%6f%6d%61%69%6e.%63%6f%6d" >me@domain.com</a> -<a href="mailto:me@domain.com?subject=Hello%20to%20you%21" >me@domain.com</a> -<a href="mailto:me@domain.com?cc=you@domain.com%2Cthey@domain.com" >me@domain.com</a> -<a href="mailto:me@domain.com" class="email">me@domain.com</a> - + {mailto address="me@example.com" encode="javascript"} + + + {mailto address="me@example.com" encode="hex"} +m&..snipped...#x6f;m + + {mailto address="me@example.com" subject="Hello to you!"} + me@example.com + +{mailto address="me@example.com" cc="you@example.com,they@example.com"} + me@example.com + +{mailto address="me@example.com" extra='class="email"'} + me@example.com + +{mailto address="me@example.com" encode="javascript_charcode"} + +]]> + + + + ver también + escape, + Obfuscating E-mail Addresses + y {textformat} + + - popup_init + {popup_init} - popup es una integración de overLib, una biblioteca usada para - ventanas popup. Esta es usada como contexto de infomación sensitiva, - como ventanas de ayuda o herramientas. popup_init debe ser usada una - vez hasta arriba de cada pagina donde usted planea usar la función + {popup} es una integración + de overLib, una biblioteca usada para + ventanas popup. Esta es usada como contexto de infomación sensitiva, como + ventanas de ayuda o herramientas. {popup_init} debe ser usada una vez hasta + arriba de cada pagina donde usted planea usar la función popup. - overLib fue escrita por Erik Bosrup, y la pagina esta localizada en - http://www.bosrup.com/web/overlib/. + overLib fue escrita por Erik Bosrup, y la + pagina esta localizada en &url.overLib;. A partir da versión 2.1.2 de Smarty, overLib NO viene con la distribución. Descargar el overLib, coloque el archivo overlib.js dentro de su document root e indique la ruta relativa en el parámetro - "src" de popup_init. + "src" de {popup_init}. popup_init {* popup_init debe ser llamado una sola vez hasta arriba de la pagina *} {popup_init src="/javascripts/overlib.js"} + ]]> diff --git a/docs/es/designers/language-custom-functions/language-function-popup.xml b/docs/es/designers/language-custom-functions/language-function-popup.xml index db395c77..b57d7c31 100644 --- a/docs/es/designers/language-custom-functions/language-function-popup.xml +++ b/docs/es/designers/language-custom-functions/language-function-popup.xml @@ -88,8 +88,7 @@ string No n/a - Defíne el color del texto para ser usado - en el texto principal + Defíne el color del texto para ser usado en el texto principal captionfont @@ -263,8 +262,7 @@ integer No n/a - - Indica al overLib desde que índice de la + Indica al overLib desde que índice de la matriz ol_text debe leer el texto, localizada en overlib.js. Este parámetro puede ser usado en vez del texto @@ -396,22 +394,31 @@ - popup es usado para crear ventanas popup con javascript. + {popup} es usado para crear ventanas popup con javascript. + {popup_init} DEBE ser + llamado primero para poder trabajar. popup - + +mypage {* usted puede usar html, links, etc en el texto del popup *} -<A href="mypage.html" {popup sticky=true caption="mypage contents" -text="<UL><LI>links<LI>pages<LI>images</UL>" snapx=10 snapy=10}>mypage</A> - +mypage +]]> + + + + Ver también {popup_init} + y overLib. + - textformat + {textformat} @@ -81,157 +81,194 @@ - textformat es una función de bloque usada para formatear texto. - Básicamente limpa espacios y caracteres especiales, y formatea - los párrafos cortando el texto al final de la palabra y endentando - lineas. + {textformat} es una función de bloque + usada para formatear texto. Básicamente limpa espacios y caracteres especiales, y + formatea los párrafos cortando el texto al final de la palabra y endentando lineas. - Usted puede definir los parámetros explícitamente, o usar un - estilo pre-definido. + Usted puede definir los parámetros explícitamente, o usar un estilo pre-definido. Actualmente el único estilo disponible es "email". -textformat - -{textformat wrap=40} + {textformat} + + + + + Salida del ajemplo de arriba: + + + + + + + + + Salida del ejemplo de arriba: + + + + + + + + + Salida del ejemplo de arriba: + + + + + + + + + Salida del ejemplo de arriba: + + + + + + + Ver también + {strip} + y {wordwrap}. + -SALIDA: - -This is foo. This is foo. This is foo. This is foo. This is foo. This is -foo. - -This is bar. - -bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo -bar foo foo. bar foo bar foo foo. bar foo bar foo foo. bar foo bar foo -foo. - - - - Technical Note + Nota Tecnica - The merge parameter respects array keys, so if - you merge two numerically indexed arrays, they may overwrite each other - or result in non-sequential keys. This is unlike the array_merge() function - of PHP which wipes out numerical keys and renumbers them. + El parametro merge es la llave respectiva del arreglo, asi si + usted asocia dos arreglos indexados numericamente, estos se sobre escriben uno al otro o + tener como resultado llaves no-secuenciales. Este es diferente a la funcion array_merge() de PHP + la cual limpia las llaves numericas y las vuelve a renumerar. '> - As an optional third parameter, you can pass a compile_id. - This is in the event that you want to compile different versions of - the same template, such as having separate templates compiled - for different languages. Another use for compile_id is when you - use more than one $template_dir but only one $compile_dir. Set - a separate compile_id for each $template_dir, otherwise - templates of the same name will overwrite each other. You can - also set the $compile_id variable once - instead of passing this to each call to this function. + Como tercer parametro opcional, usted puede pasar compile_id. + Este en el caso que usted quira compilar diferentes versiones del mismo Tempalte, + tal como tener separadas varios Templates compilados de diferentes lenguajes. + Otro uso para compile_id es cuando usted usa mas de un $template_dir pero solo un $compile_dir. + Ponga separado compile_id por cada $template_dir, de otra manera + los tempate con el mismo nombre se sobre escibiran uno sobre otro. + Uste puede poner también la variable $compile_id + una vez en lugar de pasar esta por cada llamada a la función. '> diff --git a/docs/es/make_chm_index.html b/docs/es/make_chm_index.html new file mode 100755 index 00000000..ff3344fc --- /dev/null +++ b/docs/es/make_chm_index.html @@ -0,0 +1,37 @@ + + + + Manual de Smarty + + + + + + + +
+
Manual de Smarty
 


+ +

+
+

Smarty Manual

+
Monte Ohrt
+
Andrei Zmievski
+
+

This file was generated: [GENTIME]
+Ir a http://smarty.php.net/download-docs.php + para obtener la version actual.

+ +

Copyright © 2001 - 2005 New Digital Group, Inc.

+ +
+ +

+ +
 
 
+ + diff --git a/docs/es/programmers/advanced-features/advanced-features-objects.xml b/docs/es/programmers/advanced-features/advanced-features-objects.xml index d8c83c94..fc7732e2 100644 --- a/docs/es/programmers/advanced-features/advanced-features-objects.xml +++ b/docs/es/programmers/advanced-features/advanced-features-objects.xml @@ -4,21 +4,24 @@ Objetos El Smarty permite acceso a objetos de PHP a través de sus templates. - Hay dos formas de accesarlos. Una forma es registrando objetos para el - template, entonces acceselos mediante sintaxis similar a las funciones - habituales. La otra es asignar objetos al template y accesarlos como si - fueran una variable asignada. El primer método tiene una sintaxis de - template mucho mas agradable. Y también mas segura, a medida que un - objeto registrado puede ser reescrito a ciertos métodos y propiedades. - Sin embargo tanto, un objeto registrado no puede ser puesto en loop o - ser asignado en arreglos de objetos, etc. El método que usted escoja - sera determinado por sus necesidades, pero utilice el primero método si - es posible para mantener un minimo de sintaxis en el template. + Hay dos formas de accesarlos. Una forma es + registrando objetos para el + template, entonces acceselos mediante sintaxis similar a las funciones + habituales. La otra es asignar objetos al + template y accesarlos como si fueran una variable asignada. El primer método + tiene una sintaxis de template mucho mas agradable. Y también mas segura, a + medida que un objeto registrado puede ser reescrito a ciertos métodos y + propiedades. Sin embargo tanto, un objeto registrado + no puede ser puesto en loop o ser asignado en arreglos de objetos, + etc. El método que usted escoja sera determinado por sus necesidades, pero + utilice el primero método si es posible para mantener un minimo de sintaxis + en el template. - Si la seguridad esta habilitada, ninguno de los dos métodos privados o - funciones pueden ser accesados (comenzando con "_"). Si un metodo y - propiedades de un mismo nombre existe, el método será usado. + Si $security esta habilitada, + ninguno de los dos métodos privados o funciones pueden ser accesados + (comenzando con "_"). Si un metodo y propiedades de un mismo nombre existe, + el método será usado. Usted puede restringir los métodos y propiedades que pueden ser accesados @@ -26,12 +29,12 @@ Por default, los parámetros pasados a los objetos a a través de los - templates son pasados de la misma forma en que las funciones de - costumbre los obtienen. Un arreglo asociativo es pasado como el primer - parámetro, y el objeto smarty como el segundo. Si usted quiere que los - parámetros pasados uno de cada vez por cada argumento pasen como - parámetros de un objeto tradicional, defina el cuarto parámetro de - registro en falso. + templates son pasados de la misma forma en que las + funciones de costumbre + los obtienen. Un arreglo asociativo es pasado como el primer parámetro, + y el objeto smarty como el segundo. Si usted quiere que los parámetros + pasados uno de cada vez por cada argumento pasen como parámetros de un + objeto tradicional, defina el cuarto parámetro de registro en falso. El quinto parámetro opcional solo tiene efecto con @@ -41,47 +44,48 @@ etiqueta de cierre en el template ({foobar->meth2}...{/foobar->meth2}) y los parámetros para los métodos tienen la misma sinopsis como - los parámetros de block-function-plugins: Ellos reciben 4 - parámetros $params, - $content,&$smarty - y &$repeat también se comportan como + los parámetros de block-function-plugins: + Ellos reciben 4 parámetros + $params, + $content, + &$smarty y + &$repeat también se comportan como block-function-plugins. usando un objeto registrado o atribuido - + register_object("foobar",$myobj); - -// Si usted quiere restringir acceso a ciertos metodos o propriedades, -// listelos +// Si usted quiere restringir acceso a ciertos metodos o propriedades, listelos $smarty->register_object("foobar",$myobj,array('meth1','meth2','prop1')); - -// Si usted quiere usar el formato de parámetro del objeto tradicional, -// pase un booleano en false +// Si usted quiere usar el formato de parámetro del objeto tradicional, pase un booleano en false $smarty->register_object("foobar",$myobj,null,false); -// también puede asignar ojetos. Posible cuando se asignan por -// referencia. +// también puede asignar ojetos. Posible cuando se asignan por referencia. $smarty->assign_by_ref("myobj", $myobj); $smarty->display("index.tpl"); ?> - -TEMPLATE: - +]]> + + + y como debera accesar a su objeto en index.tpl + + +meth1 p1="foo" p2=$bar} @@ -92,8 +96,8 @@ the output was {$output} {* accesando a nuestro objeto asignado *} {$myobj->meth1("foo",$bar)} ]]> - - + + -{* rest of template content... *} ]]> + + Observe como hacer la compilacion para Smarty del template index.tpl: + + + + {* rest of template content... *} + ]]> + ]]> + + Esto eliminara todos los comentarios en el codigo del template. + - Metodos + La clase Methods() de Smarty &programmers.api-functions.api-append; &programmers.api-functions.api-append-by-ref; &programmers.api-functions.api-assign; diff --git a/docs/es/programmers/api-functions/api-append-by-ref.xml b/docs/es/programmers/api-functions/api-append-by-ref.xml index 189750ea..0ce12b1c 100644 --- a/docs/es/programmers/api-functions/api-append-by-ref.xml +++ b/docs/es/programmers/api-functions/api-append-by-ref.xml @@ -3,10 +3,10 @@ append_by_ref - + pasando valores por referencia - + <title>Descipción voidappend_by_ref stringvarname @@ -14,9 +14,10 @@ boolmerge - Este es usado para adicionar valores al templete por referencia. - Si usted adiciona una variable por referencia entonces cambiara su valor, - el valor asignado sufrira el cambio también. Para objetos, append_by_ref() + Este es usado para pasar valores al + templete por referencia. Si usted pasa una variable por referencia entonces + cambiara su valor, el valor asignado sufrira el cambio también. Para + objetos, append_by_ref() también envia una copia en memoria del objeto adicionado. Vea el manual de PHP en referenciando variables para una mejor explicación del asunto. Si usted pasa el tercer parámetro en true, el valor será mezclado con el @@ -35,6 +36,11 @@ $smarty->append_by_ref("Address", $address); ]]> + + Ver también append() + y assign(). + + - append - + append() + agregando elementos a una matriz asignada - + <title>Descripción voidappend mixedvar @@ -37,11 +37,17 @@ $smarty->append("Name", "Fred"); $smarty->append("Address", $address); // passing an associative array -$smarty->append(array("city" => "Lincoln", "state" => "Nebraska")); +$smarty->append(array('city' => 'Lincoln', 'state' => 'Nebraska')); ?> ]]> + Ver también + append_by_ref(), + assign() + y + get_template_vars() + - assign - + assign() + pasando valores para el template - + <title>Descripción voidassign mixedvar @@ -17,25 +17,57 @@ mixedvar - Este es usado para asignar valores al template. Usted puede - explicitamente pasar pares de nombres/valores, o un arreglo + Usted puede explicitamente pasar pares de nombres/valores, o un arreglo asociativo conteniendo el par de nombre/valor. - assign - + assign() + assign('Name', 'Fred'); $smarty->assign('Address', $address); -// passing an associative array -$smarty->assign(array("city" => "Lincoln", "state" => "Nebraska")); +// pasando un arreglo asosiativo +$smarty->assign(array('city' => 'Lincoln', 'state' => 'Nebraska')); + +// pasando un row desde una base de datos (eg adodb) +$sql = 'select id, name, email from contacts where contact ='.$id; +$smarty->assign('contact', $db->getRow($sql)); ?> ]]> - + + + Accesando estos en el template con + + + +]]> + + + Para ver una asignacion de arreglos mas compleja + {foreach} + y + {section} + + + + Vea también assign_by_ref(), + get_template_vars(), + clear_assign(), + append() + y + {assign} + - clear_all_assign - + clear_all_assign() + >limpia el valor de todas las variables asignadas - + <title>Descripción voidclear_all_assign - - Esto limpia el valor de todas las variables asignadas. - - clear_all_assign + clear_all_assign() assign('Name', 'Fred'); +$smarty->assign('Address', $address); + +// will output above +print_r( $smarty->get_template_vars() ); + // clear all assigned variables $smarty->clear_all_assign(); + +// will output nothing +print_r( $smarty->get_template_vars() ); ?> ]]> + + Ver también + clear_assign(), + clear_config(), + assign() + y append() + - clear_assign - + clear_assign() + limpia el valor de una variable asignada - + <title> Descripción voidclear_assign mixedvar - Esto limpia el valor de una viariable asignada. Este puede ser un - valor simple, o un arreglo de valores. + Este puede ser un valor simple, o un arreglo de valores. - clear_assign + clear_assign() clear_assign("Name"); +$smarty->clear_assign('Name'); // clear multiple variables -$smarty->clear_assign(array("Name", "Address", "Zip")); +$smarty->clear_assign(array('Name', 'Address', 'Zip')); ?> ]]> + + Ver también + clear_all_assign(), + clear_config(), + get_template_vars(), + assign() + y append() + - clear_cache - + clear_cache() + Esto limpia el cache de un template especifico - + <title>Descripción voidclear_cache stringtemplate @@ -15,31 +15,36 @@ intexpire_time - Esto limpia el cahce de un template especifico. - Si usted tiene multiples caches en este archivo, usted puede limpiar un - cache especifico proporcionando el cache_id como - segundo parámetro Usted también puede pasar el - compile_id como un tercer parámetro. - Usted puede "agrupar" templates conjuntamente de esta manera estos pueden - ser removidos como un grupo. Vea el - caching section para mayor información. + Si usted tiene multiples caches + en este archivo, usted puede limpiar un cache especifico proporcionando el + cache_id como segundo parámetro Usted también puede pasar + el $compile_id + como un tercer parámetro. Usted puede "agrupar" + templates conjuntamente de esta manera estos pueden ser removidos como un grupo. + Vea el caching section para mayor información. Como un cuarto parámetro opcional, usted puede proporcionar un periodo minimo en segundos que el archivo de cache debe tener antes de ser anulado. - clear_cache + clear_cache() clear_cache("index.tpl"); +$smarty->clear_cache('index.tpl'); // clear the cache for a particular cache id in an multiple-cache template -$smarty->clear_cache("index.tpl", "CACHEID"); +$smarty->clear_cache('index.tpl', 'CACHEID'); ?> ]]> + + Ver también + clear_all_cache() + y + caching. + - clear_compiled_tpl - + clear_compiled_tpl() + Esto limpia la vesion compilada del recurso de un template especifico - + <title>Descripción voidclear_compiled_tpl stringtpl_file @@ -16,14 +16,16 @@ Esto limpia la versión compilada del recurso del template especificado, o todos los archivos de templates compilados si no fueron especificados. - si usted lo pasa compile_is es limpiado. si usted lo pasa con ex_time, - entonces solo compilara los templates anteriores al exp_time segundo - seran limpiados, por default todos los templates son compilados y - limpiados independientemente de su tiempo de vida. + si usted pasa $compile_id solo + sera compilado este template especificado + $compile_id es limpiado. + Si usted lo pasa con ex_time, entonces solo compilara los templates + anteriores al exp_time segundo seran limpiados, por default todos los + templates son compilados y limpiados independientemente de su tiempo de vida. Esta función es solo para uso avanzado, normalmente no es necesaria. - clear_compiled_tpl + clear_compiled_tpl() - clear_config - + clear_config() + Esto limpia todas las variables de configuración - + <title>Descripción voidclear_config stringvar - Esto limpia todas las variables de configuración asignadas. - Si es proporcionado el nombre de una variable, solamente esta - variable es limpiada. + Esto limpia todas las variables de + configuración asignadas. + Si es proporcionado el nombre de una variable, solo esa variable es limpiada. - clear_config + clear_config() clear_config('foobar'); ]]> + + Ver también + get_config_vars(), + config variables, + config files, + {config_load}, + config_load() + y + clear_assign() + - config_load - + config_load() + Carga el archivo de configuración y lo asigna al template - + <title>Descripción voidconfig_load stringfile stringsection - Esto carga el archivo de configuración de + Esto carga el archivo de configuración de datos y lo asigna al template. Esto funciona idéntico a la función - config_load. + {config_load}. Nota Técnica A partir de Smarty 2.4.0, las variables de template asignadas son - mantenidas a través de fetch() y display(). Las variables de + mantenidas a través de fetch() y + display(). Las variables de configuración cargadas de config_load() son siempre de alcance global. Los archivos de configuracion también son compilados para execución rapida, y respetar el @@ -31,7 +32,7 @@ - config_load + config_load() config_load('my.conf', 'foobar'); ]]> + + Ver también + {config_load}, + get_config_vars(), + clear_config(), + y + config variables + - display - + display() + Despliega el Template - + <title>Descripción voiddisplay stringtemplate @@ -14,7 +14,8 @@ stringcompile_id - Este despliega el template. cargando un tipo valido de path + Este despliega el template diferente de fetch(). Cargando un tipo valido de path template resource. Como un segundo parámetro opcional, usted puede pasar un identificador de cache. @@ -23,7 +24,7 @@ ¶meter.compileid; - display + display() display("index.tpl"); Use la sintaxis template resources - para mostrar archivos fuera del directorio $template_dir. + para mostrar archivos fuera del directorio + $template_dir. Ejemplos de recursos de la función display @@ -64,20 +66,24 @@ $smarty->display("index.tpl"); display("/usr/local/include/templates/header.tpl"); +$smarty->display('/usr/local/include/templates/header.tpl'); // absolute filepath (same thing) -$smarty->display("file:/usr/local/include/templates/header.tpl"); +$smarty->display('file:/usr/local/include/templates/header.tpl'); // windows absolute filepath (MUST use "file:" prefix) -$smarty->display("file:C:/www/pub/templates/header.tpl"); +$smarty->display('file:C:/www/pub/templates/header.tpl'); // include from template resource named "db" -$smarty->display("db:header.tpl"); +$smarty->display('db:header.tpl'); ?> ]]> + + Ver también fetch() y + template_exists(). + - fetch - + fetch() + Retorna la salida del template - + <title>Descripción stringfetch stringtemplate stringcache_id - stringcompile_id + string$compile_id - Este retorna la salida del template en vez de desplegarla. + Este retorna la salida del template en vez de + desplegarla. Proporcionando un tipo y path valido template resource. Como un segundo parámetro opcional, usted puede pasar el @@ -23,36 +24,37 @@ mayor información. ¶meter.compileid; + - fetch + fetch() caching = true; // only do db calls if cache doesn't exist -if(!$smarty->is_cached("index.tpl")) { +if(!$smarty->is_cached('index.tpl')) { // dummy up some data - $address = "245 N 50th"; + $address = '245 N 50th'; $db_data = array( - "City" => "Lincoln", - "State" => "Nebraska", - "Zip" => "68502" + 'City' => 'Lincoln', + 'State' => 'Nebraska', + 'Zip' => '68502' ); - $smarty->assign("Name","Fred"); - $smarty->assign("Address",$address); + $smarty->assign('Name','Fred'); + $smarty->assign('Address',$address); $smarty->assign($db_data); } // capture the output -$output = $smarty->fetch("index.tpl"); +$output = $smarty->fetch('index.tpl'); // do something with $output here @@ -62,8 +64,75 @@ echo $output; + + + Usando fetch() y enviando a un e-mail + + El template email_body.tpl + + + + + + El template email_disclaimer.tpl usando el modificador + {textformat}. + + + + + + y el script de PHP usando la función + mail() + + +getRow($sql); +$smarty->assign('contact', $contact); + +mail($contact['email'], 'Subject', $smarty->fetch('email_body.tpl')); + +?> +]]> + + + + + + Ver también + {fetch} + display(), + {eval}, + y + template_exists(). + + - get_config_vars - + get_config_vars() + retorna el valor asignado a la variable de configuración - + <title>Descripción arrayget_config_vars stringvarname - Este retona el valor de la variable de configuración dado. - Si no tiene un parámetro dado, un arreglo de todas las variables - de los archivos de configuración es retornado. + Si no tiene un parámetro asignado, un arreglo de todas las + variables + de los archivos de configuración es retornado. - get_config_vars + get_config_vars() + + Ver también + clear_config(), + {config_load}, + config_load() + y + get_template_vars(). + - get_registered_object - + get_registered_object() + Este retorna una referencia para un objeto registrado. - + <title>Descripción arrayget_registered_object stringobject_name - Este retorna una referencia para un objeto registrado. Este es útil dentro de una función habitual cuando usted - necesita acesar directamente a un objeto registrado. + necesita acesar directamente a un + objeto registrado. + Ver objects para mas + información; - get_registered_object + get_registered_object() + + Ver también + register_object(), + unregister_object() + y + objects section + - get_template_vars - + get_template_vars() + Retorna el valor asignado a una variable - + <title>descripción arrayget_template_vars stringvarname - Este retorna el valor de una variable asignada. Si no tiene un - parámetro dado, un arreglo de todas las variables asignadas es - retornado. + Si no tiene un parámetro dado, un arreglo de todas las variables + asignadas es retornado. get_template_vars @@ -33,6 +32,17 @@ print_r($tpl_vars); ]]> + + Ver también assign(), + {assign}, + assign_by_ref(), + append(), + clear_assign(), + clear_all_assign() + y + get_config_vars() + + - is_cached - + is_cached() + Retorna true si hay cache valido para ese template - + <title>Descripción boolis_cached stringtemplate @@ -14,12 +14,12 @@ stringcompile_id - Este retorna true si hay un cache valido para ese template. Esto solamente funciona si caching está asignado a true. + ver también caching section. - is_cached + is_cached() display("index.tpl"); - Usted también puede pasar un identificador de cache como un - segundo parámetro opcional en el caso que usted quiera multiples - caches para el template dado. + Usted también puede pasar un identificador de $cache como un + segundo parámetro opcional en el caso que usted quiera + multiples caches + para el template dado. Usted puede proporcionar el identidicador como un tercer parametro @@ -45,12 +46,13 @@ $smarty->display("index.tpl"); $compile_id es usada. - Si usted no quiere pasar el identificador de cache solamente - quiere pasar el compile id debe pasar null + Si usted no quiere pasar el + identificador de cache + solamente quiere pasar el compile id debe pasar null como el identidficador de cache. - is_cached con templates con multiple-cache + is_cached() con templates con multiple-cache display("index.tpl", "FrontPage"); is_cached retorna true. + + Ver también + clear_cache(), + clear_all_cache(), + y + caching section. + + - load_filter - + load_filter() + Carga un filtro de plugin - + <title> Descripción voidload_filter stringtype stringname - Esta función puede ser usada para cargar un filtro de plugin. El primer argumento especifíca el tipo de filtro a cargar y puede ser uno de los siguientes: 'pre', 'post', o 'output'. El segundo argumento especifíca el nombre del filtro del plugin, por ejemplo, @@ -31,6 +30,16 @@ $smarty->load_filter('output', 'compress'); // load output filter named 'compres ]]> + + Ver también + register_prefilter(), + register_postfilter(), + register_outputfilter(), + $autoload_filters + y + Advanced features. + + - register_block - + register_block() + Registra dinamicamente bloques de funciones de plugins - + <title>Descripción voidregister_block stringname @@ -38,11 +38,11 @@ plugins para saber como usar las propiedades. - register_block + register_block() register_block("translate", "do_translation"); +$smarty->register_block('translate', 'do_translation'); function do_translation ($params, $content, &$smarty, &$repeat) { @@ -67,6 +67,13 @@ Hello, world! ]]> + + Ver también + unregister_block() + y + Plugin Block Functions. + + - register_function - + register_function() + Registra dinamicamente un plugin de función para un template - + <title>Descripción voidregister_function stringname mixedimpl - boolcacheable - mixedcache_attrs + boolcacheable + mixedcache_attrs - Use este para registrar funciones de plugins dinámicamente para - el template. Pase en el template el nombre de la función, seguido + Pase en el template el nombre de la función, seguido por el nombre de la función PHP que implementa esto. - La llamada a la funcion-php impl puede ser - (a) una cadena conteniendo el nombre de la función o - (b) un arreglo en el formato - array(&$object, $method) con - &$object siendo una referencia para - un objeto y $method siendo una cadena - conteniendo el nombre del método o - (c) un arreglo en el formato - array(&$class, $method) con - $class siendo un nombre de clase y - $method siendo un método de esta clase. - + La llamada a la funcion-php impl puede ser: + + + + + a una cadena conteniendo el nombre de la función o + + + + un arreglo con la forma + array(&$object, $method) con + &$object siendo una referencia para un objeto y + $method siendo una cadena conteniendo el nombre del método + + + + un arreglo con la forma array(&$class, $method) + con $class siendo el nombre de una clase y + $method siendo un metodo de esa clase. + + + + - cacheable y cache_attrs - pueden ser omitidos en la mayoria de los casos. - Vea Controlando modos de Salida Cache de - los Plugins para obtener mayores informes. + cacheable y cache_attrs pueden ser omitidos + en la mayoria de los caasos. + Vea Controlando modos de Salida Cache de + los Plugins para obtener mayores informes. - register_function + register_function() register_function("date_now", "print_current_date"); +$smarty->register_function('date_now', 'print_current_date'); -function print_current_date($params) +function print_current_date($params, &$smarty) { if(empty($params['format'])) { $format = "%b %e, %Y"; @@ -54,12 +64,27 @@ function print_current_date($params) return strftime($format,time()); } } -// ahora usted puede usar eso en el Smarty para mostrar la fecha actual: -// {date_now} o, {date_now format="%Y/%m/%d"} para formatearle. ?> ]]> - + + y en el template + + + + + + + +Ver también unregister_function() +y Plugin functions. + + - register_modifier - + register_modifier() + mofidica dinámicamente plugins registrados - + <title>Descripción voidregister_modifier stringname mixedimpl - Use este para modificar dinámicamente plugins registrados. Pase en el template el nombre del modificador, seguido de la función PHP que implemente esto. La llamada de la funcion-php impl puede ser - (a) una cadena conteniendo el nombre de la función o - (b) un arreglo en el formato - array(&$object, $method) con - &$object siendo una referencia para - un objeto y $method siendo una cadena conteniendo - el nombre del método o - (c) un arreglo en el formato - array(&$class, $method) con - $class siendo un nombre de clase y - $method siendo un método de esta clase. + + + una cadena conteniendo el nombre de la función + + + un arreglo con la forma array(&$object, $method) con + &$object siendo una referencia para un objeto y + $method siendo una cadena conteniendo el nombre de un metodo + + + + un arreglo con la forma + array(&$class, $method) con + $class siendo el nombre de una clase y + $method siendo un metodo de esta clase. + + + - register_modifier - + register_modifier() + register_modifier('sslash', 'stripslashes'); -$smarty->register_modifier("sslash", "stripslashes"); - -// now you can use {$var|sslash} to strip slashes from variables ?> ]]> - + +template + + +]]> + + + + Ver También + unregister_modifier(), + register_function(), + modifiers, + Extending Smarty with plugins + y + Creating Plugin modifiers, + + - register_object - + register_object() + Registr un objeto para usar en el template - + <title>Descripción voidregister_object stringobject_name @@ -16,9 +16,13 @@ arrayblock_methods - Este es para registrar un objeto para usar en el template. - Vea object section - del manual para ejemplos. + Vea object section para ejemplos. + + + Vea también + get_registered_object(), + y + unregister_object(). diff --git a/docs/es/programmers/api-functions/api-register-outputfilter.xml b/docs/es/programmers/api-functions/api-register-outputfilter.xml index dc6e0e5e..6ea820de 100644 --- a/docs/es/programmers/api-functions/api-register-outputfilter.xml +++ b/docs/es/programmers/api-functions/api-register-outputfilter.xml @@ -2,36 +2,59 @@ - register_outputfilter - + register_outputfilter() + Registra dinamicamente filtros de salida - + <title>Descripción voidregister_outputfilter mixedfunction - Use este para registrar dinámicamente filtros de salida para - operaciones en la salida del template antes de mostrarlo. + Use este para registrar dinámicamente filtros de salida para + operaciones en la salida + del template antes de mostrarlo. Vea Filtros de Salida de Templates para mayores informes de como configurar una función de filtro de salida. - La llamada de la funcion-php function - puede ser - (a) una cadena conteniendo un nombre de función o - (b) un arreglo en el formato - array(&$object, $method) con - &$object siendo una referencia para - un objeto y $method siendo una cadena - conteniendo el nombre del método o - (c) un arreglo en el formato - array(&$class, $method) con - $class siendo el nombre de la clase y - $method siendo un método de esta clase. - + La llamada de la funcion-php function puede ser + + + + + una cadena conteniendo un nombre de función + + + + un arreglo con la forma + array(&$object, $method) con + &$object siendo referencia a un objeto y + $method siendo una cadena conteniendo el nombre de un metodo + + + + un arreglo con la forma + array(&$class, $method) con + $class siendo el nombre de la clase y + $method siendo un método de esta clase. + + + + +Vea también +unregister_outputfilter(), +register_prefilter(), +register_postfilter(), +load_filter(), +$autoload_filters +y +template output filters. + + - register_postfilter - + register_postfilter() + Resgistr dinamicamente postfiltros - + <title> Descripción voidregister_postfilter mixedfunction - Use esto para registrar dinámicamente postfiltros para + Use esto para registrar dinámicamente postfiltros para correr templates directos después de ser compilados. Vea postfiltros de template para mayores informes de como configurar funciones de postfiltering. - La llamada de la funcion-php function - puede ser: - (a) una cadena conteniendo un nombre de función o - (b) un arreglo con el formato - array(&$object, $method) con - &$object siendo una referencia para un - objeto y $method siendo una cadena conteniendo - el nombre de un método o - (c) un arreglo con el formato - array(&$class, $method) con - $class siendo un nombre de clase y - $method siendo un método de esta clase. - + La llamada de la funcion-php function puede ser: + + + + + una cadena conteniendo un nombre de función + + + + un arreglo con la forma + array(&$object, $method) con + &$object siendo una referencia para un + objeto y $method siendo una cadena conteniendo + el nombre de un método + + + + un arreglo con la forma + array(&$class, $method) con + $class siendo un nombre de clase y + $method siendo un método de esta clase. + + + + + Vea También + unregister_postfilter(), + register_prefilter(), + register_ouputfilter(), + load_filter(), + $autoload_filters + y template output filters. + - register_prefilter - + register_prefilter() + Registra dinamicamente prefiltros - + <title> Descripción voidregister_prefilter mixedfunction - Use esto para registrar prefiltros dinámicamente para correr - templates antes de que estos sean compilados. Vea - template prefilters + Use esto para registrar + prefiltros + dinámicamente para correr templates antes de que estos sean compilados. + Vea template prefilters para mayores informes de como configurar una función de prefiltering. - La llamada de la funcion-php function - puede ser: - (a) una cadena conteniendo un nombre de función o - (b) un arreglo con el formato - array(&$object, $method) con - &$object siendo una referencia para un - objeto y $method siendo una cadena conteniendo - el nombre de un método o - (c) un arreglo con el formato - array(&$class, $method) con - $class siendo un nombre de clase y - $method siendo un método de esta clase. + La llamada de la funcion-php function puede ser: + + + + una cadena conteniendo un nombre de función + + + + un arreglo con la forma + array(&$object, $method) con + &$object siendo una referencia para un + objeto y $method siendo una cadena conteniendo + el nombre de un método + + + + un arreglo con la forma + array(&$class, $method) con + $class siendo un nombre de clase y + $method siendo un método de esta clase. + + + + + + Ver también + unregister_prefilter(), + register_postfilter(), + register_ouputfilter(), + load_filter(), + $autoload_filters + y template output filters. + - template_exists - + template_exists() + Verifica si el template especificado existe - + <title>Descripción booltemplate_exists stringtemplate - Esta función checa si el template especificado existe. Este puede - aceptar un path para el template en el filesystem o un recurso de + Este puede aceptar un path para el template en el filesystem o un recurso de cadena especificando el template. + + template_exists() + + Este ejemplo utiliza $_GET['page'] este incluye el contenido del template. Si el + template no existe entonces un error de pagina es deplegado en su lugar. + + + El page_container.tpl + + + +{$title} + +{include file='page_top.tpl'} + +{* include middle content page *} +{include file=$page_mid} + +{include file='page_footer.tpl'} + +]]> + + + y el script PHP + + +template_exists($mid_template) ){ + $mid_template = 'page_not_found.inc.tpl'; +} +$smarty->assign('page_mid', $mid_template); + +$smarty->display('page_container.tpl'); + +?> +]]> + + + + Ver también + display(), + fetch(), + {include} + y {insert} + + - unregister_compiler_function - + unregister_compiler_function() + des-registrar dinámicamente una función de compilación - + <title>Descripción voidunregister_compiler_function stringname - Use este para des-registrar dinámicamente una función de compilación. - pase el nombre de la función compiladora. + Pase el nombre de la función compiladora. + + Ver también register_compiler_function() + y Plugin Compiler Functions. + + - unregister_function - + unregister_function() + des-registrar dinámicamente una función de plugin del template - + <title> Descripción voidunregister_function stringname - Use esta para des-registrar dinámicamente una función de - plugin del template. Pase en el template el nombre de la función. + Pase en el template el nombre de la función. - unregister_function + unregister_function() unregister_function("fetch"); ]]> + + Ver también register_function() . + + - unregister_modifier - + unregister_modifier() + des-registrar dinámicamente un modificador de plugin - + <title>Descripción voidunregister_modifier stringname - Use este para des-registrar dinámicamente un modificador de plugin. Pase en el template el nombre del modificador. - unregister_modifier + unregister_modifier() unregister_modifier("strip_tags"); ]]> + + Ver también register_modifier() + y Plugin modifiers, + + - unregister_object - + unregister_object() + Des-registra dinamicamente un objeto - + <title>Descripción voidunregister_object stringobject_name - - Use este para des-registrar un objeto. - + + Ver también register_object() + y objects section + + - unregister_outputfilter - + unregister_outputfilter() + des-registra dinámicamente un filtro de salida - + <title> Descripción voidunregister_outputfilter stringfunction_name @@ -14,6 +14,11 @@ Use este para des-registrar dinámicamente un filtro de salida. + + Ver también register_outputfilter() + y template output filters. + + - unregister_postfilter - + unregister_postfilter() + Des-registra dinamicamente un postfiltro - + <title>Descripción voidunregister_postfilter stringfunction_name - - Use esto para des-registrar dinámicamente un postfiltro. - + + Ver también + register_postfilter() + y template post filters. + + - unregister_prefilter - + unregister_prefilter() + Des-registra dinamicamente un prefiltro - + <title>Descripción voidunregister_prefilter stringfunction_name - Use esto para des-registrar dinámicamente un prefiltro. + Ver también + register_prefilter() + y pre filters. + - unregister_resource - + unregister_resource() + Des-registra dinamicamente un plugin de recurso - + <title> Descripción voidunregister_resource stringname - Use esto para des-registrar dinámicamente un recurso de plugin. Pase en el parámetro el nombre del recurso. - unregister_resource + unregister_resource() unregister_resource("db"); ]]> + + Ver también + register_resource() + y + template resources + + - Variables + Clase Variables de Smarty &programmers.api-variables.variable-template-dir; &programmers.api-variables.variable-compile-dir; @@ -58,4 +58,4 @@ End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> \ No newline at end of file +--> diff --git a/docs/es/programmers/api-variables/variable-autoload-filters.xml b/docs/es/programmers/api-variables/variable-autoload-filters.xml index 518cf7ac..26dd8b0f 100644 --- a/docs/es/programmers/api-variables/variable-autoload-filters.xml +++ b/docs/es/programmers/api-variables/variable-autoload-filters.xml @@ -20,6 +20,14 @@ $smarty->autoload_filters = array('pre' => array('trim', 'stamp'), + + Ver también + register_outputfilter(), + register_prefilter(), + register_postfilter() + y + load_filter() + - Nombres convensionales + Nombres convencionales Los archivos y funciones de Plugin deben seguir una convención de apariencia muy especifica a fin de que pueda ser localizada diff --git a/docs/es/programmers/plugins/plugins-prefilters-postfilters.xml b/docs/es/programmers/plugins/plugins-prefilters-postfilters.xml index 10b37ac8..a21bcdfd 100644 --- a/docs/es/programmers/plugins/plugins-prefilters-postfilters.xml +++ b/docs/es/programmers/plugins/plugins-prefilters-postfilters.xml @@ -15,12 +15,11 @@ - Los Prefilters son usados para procesar el fuente del template - inmediatamente antes de la compilación. El primer parámetro de - la función del prefilter es el fuente del template, posiblemente - modificado por algunos otros prefilters. El Plugin es supuesto - que retorne el fuente modificado. Observe que este código no - es salvado en ningun lugar, este es solo usado para la compilación. + Los Prefilters son usados para procesar el fuente del template inmediatamente + antes de la compilación. El primer parámetro de la función del prefilter es el + fuente del template, posiblemente modificado por algunos otros prefilters. + El Plugin es supuesto que retorne el fuente modificado. Observe que este código + no es salvado en ningun lugar, este es solo usado para la compilación. @@ -30,13 +29,12 @@ - Los Postfilters son usados para procesar la salida compilada del - template (el código PHP) inmediatamente después de que la compilacion - es terminada pero antes de que el template compilado sea salvado en - el sistema de archivos. El primer parámetro para la función postfilter - es el código del template compilado, posiblemente modificado por otros - postfilters. El plugin es supuesto que retorne la versión modificada - de este codigo. + Los Postfilters son usados para procesar la salida compilada del template + (el código PHP) inmediatamente después de que la compilacion es terminada + pero antes de que el template compilado sea salvado en el sistema de archivos. + El primer parámetro para la función postfilter es el código del template + compilado, posiblemente modificado por otros postfilters. + El plugin se supone retornara la versión modificada de este código. prefilter plugin diff --git a/docs/es/programmers/plugins/plugins-resources.xml b/docs/es/programmers/plugins/plugins-resources.xml index 40789086..5941ca52 100644 --- a/docs/es/programmers/plugins/plugins-resources.xml +++ b/docs/es/programmers/plugins/plugins-resources.xml @@ -3,9 +3,8 @@ Fuentes Las fuentes de los plugins son como una forma generica de suministrar - código fuente de template o componentes de script PHP al Smarty. - Algunos ejemplos de fuentes: base de datos, LDAP, memoria compartida, - sockets, etc. + código fuente de template o componentes de script PHP al Smarty. Algunos + ejemplos de fuentes: base de datos, LDAP, memoria compartida, sockets, etc. @@ -41,12 +40,11 @@ - La primera función debe devolver el recurso. - Su segundo parámetro es una variable pasada por referencia donde - el resultado debe ser almacenado. - La función debe retornar true si esta pudo - recuperar satisfactoriamente el recurso y en caso contrario - retornara false. + La primera función debe devolver el recurso. Su segundo parámetro + es una variable pasada por referencia donde el resultado debe ser + almacenado. La función debe retornar true si + esta pudo recuperar satisfactoriamente el recurso y en caso contrario + retornara false. diff --git a/docs/es/programmers/smarty-constants.xml b/docs/es/programmers/smarty-constants.xml index 6589b5c9..065d7460 100644 --- a/docs/es/programmers/smarty-constants.xml +++ b/docs/es/programmers/smarty-constants.xml @@ -9,22 +9,66 @@ Esta debe ser la ruta completa del path para la localización de los archivos de clases de Smarty. Si esta no fuera definida, Entonces Smarty intentara determinar el valor apropiado - automáticamente. Si es definido, el path debe finalizar con una - diagonal. + automáticamente. Si es definido, el path + debe finalizar con una diagonal. SMARTY_DIR ]]> + + Ver también + $smarty.const + y + $php_handling constants + + + + SMARTY_CORE_DIR + + Esta debe ser la ruta completa de localización del sistema de archivos + de Smarty core. Si no es definido, Smarty tomara por default esta constante de + libs/ + bajo el sub-directory SMARTY_DIR. + Si es definida, la ruta debe terminar con una diagonal. + Use esta constante cuando necesite incluir manualmente algun archivo de core.* + + + SMARTY_CORE_DIR + + +]]> + + + + + Ver también + $smarty.const +