VISTAS Y HELPERS - Historial de revisiones

Ashrey en 16:39 10 sep 2012

2012-09-10T16:39:04Z

200.86.12.147 en 18:56 22 jul 2011

2011-07-22T18:56:37Z

200.109.244.228: /* Uso de Partials */

2009-11-27T21:49:45Z

Uso de Partials

Onizukar: /* form_remote_tag($action, $objeto_que_actualiza) */

2009-09-28T20:00:41Z

form_remote_tag($action, $objeto_que_actualiza)

Onizukar: /* link_to_remote($accion, $texto, $objeto_a_actualizar,[$parametros]) */

2009-09-28T20:00:16Z

link_to_remote($accion, $texto, $objeto_a_actualizar,[$parametros])

Joanhey: /* Uso de content() */

2009-09-11T10:37:31Z

Uso de content()

Joanhey: /* Uso de CSS en Kumbia */

2009-09-11T10:37:10Z

Uso de CSS en Kumbia

Joanhey: /* Uso de Partials */

2009-09-11T10:34:34Z

Uso de Partials

Joanhey: /* Uso de Layouts */

2009-09-11T10:33:55Z

Uso de Layouts

Joanhey: /* Uso de Vistas */

2009-09-11T10:33:00Z

Uso de Vistas

← Revisión anterior		Revisión del 16:39 10 sep 2012
Línea 1:		Línea 1:
		+	{{Obsoleto\|version=0.5}}
		+
	= Introducción =		= Introducción =
	KumbiaPHP posee un sistema de presentación basado en vistas (views) que viene siendo el tercer componente del sistema '''MVC''' (Model View Controller).		KumbiaPHP posee un sistema de presentación basado en vistas (views) que viene siendo el tercer componente del sistema '''MVC''' (Model View Controller).

@@ Línea 361: / Línea 361: @@
 <source lang="php" line>
-<?php echo submit_tag("Enviar Formulario") ?>
+<?php echo submit_image_tag("Enviar Formulario", "img/button.gif") ?>
 </source>

← Revisión anterior		Revisión del 21:49 27 nov 2009
Línea 115:		Línea 115:
	'''views/layouts/administracion.phtml'''		'''views/layouts/administracion.phtml'''

−	~~=Uso de Partials=~~

−	~~Los partials (parciales) son pequeñas vistas que pueden incluirse dentro de otra vista y que evitan repetir código.~~
−
−	~~Un partial se reconoce porque empieza con _ (underscore) antes del nombre de la vista.~~
−
−	~~Se puede hacer el llamado a visualizar un partial usando la función render_partial de esta forma:~~
−
−	~~<source lang="php">~~
−	~~<?php echo render_partial('menu') ?>~~
−	~~</source>~~
−
−	~~De esta forma estaríamos mostrando el archivo _menu.phtml del directorio del controlador actual.~~

	=Uso de CSS en Kumbia=		=Uso de CSS en Kumbia=

@@ Línea 323: / Línea 323: @@
 <source lang="php" line>
-<?php echo form_remote_tag(“saludo/hola”, “update: midiv”, “before:alert('Se ha enviado el Formulario')”) ?>
+<?php echo form_remote_tag(“saludo/hola”, “update: midiv”, “before:alert('Se ha enviado
   Tu Nombre?: <?php echo text_field_tag(“nombre”) ?>
   <?php echo submit_tag("Envio") ?>

@@ Línea 228: / Línea 228: @@
 <source lang="php" line>
-<?php echo link_to_remote(“Borrar Producto”, “update: midiv”, “action: productos/borrar/11”, “confirm: Esta seguro desea borrar el producto?”) ?>
+<?php echo link_to_remote(“Borrar Producto”, “update: midiv”, “action: productos/borrar/11”,
 <div id=’midiv’>Este texto será actualizado</div>;
 </source>
@@ Línea 234: / Línea 235: @@
 link_to_remote puede recibir n parámetros adicionales que corresponden a atributos html
 correspondientes a la etiqueta 'a'.
 ==button_to_remote_action($accion, $texto, $objeto_a_actualizar,[$parametros])==

@@ Línea 176: / Línea 176: @@
 =Uso de content()=
-Esta función tiene como objetivo indicar al sistema de plantillas en que parte de la vista
+Esta función tiene como objetivo indicar al sistema de plantillas en que parte de la vista se va a visualizar el siguiente nivel de vista. Si por ejemplo se pretende visualizar una vista y el llamado a content() no esta presente en el layout, entonces la vista no se va a visualizar.
 =Helpers=

@@ Línea 131: / Línea 131: @@
 =Uso de CSS en Kumbia=
-Kumbia todo su entorno se ejecuta en la carpeta '''public/''' a pesar que cuando nos
+Kumbia todo su entorno se ejecuta en la carpeta '''public/''' a pesar que cuando nos encontramos desarrollando las vistas de nuestra aplicación la vamos dejando en el directorio '''apps/default/views/'''.
-Esto significa que cuando se le indica alguna ruta de alguna imagen por decir algo a tus
+Esto significa que cuando se le indica alguna ruta de alguna imagen por decir algo a tus CSS estas deberían estar respecto a '''public/'''.
-Un ejemplo sencillo, imaginemos que deseas incluir una imagen como background y
+Un ejemplo sencillo, imaginemos que deseas incluir una imagen como background y nuestra imagen se encuentra en la carpeta public/img/. Nuestra vista esta en apps/default/views/index.phtml (esta en la vista principal de todo el framework)...
-Ahora editamos el archivo que contiene los estilos en este caso sera
+Ahora editamos el archivo que contiene los estilos en este caso sera '''public/css/style.css'''
-<source lang="css" line>
+<source lang="css">
 body {
   backgroundimage: url("/nombre_mi_aplicacion/img/error.gif");
@@ Línea 151: / Línea 145: @@
 </source>
-Donde nombre_mi_aplicacion es el nombre de tu carpeta donde esta el framework,
+Donde nombre_mi_aplicacion es el nombre de tu carpeta donde esta el framework, esta es una utilización básica...
-Sin embargo kumbia maneja unas variables para evitar cambios grandes a nivel de los
+Sin embargo kumbia maneja unas variables para evitar cambios grandes a nivel de los archivos CSS, un escenario posible es si cambiamos el nombre de la carpeta raiz del framework porque?... sencillo si cámbianos el nombre de la aplicación (en este caso el nombre de la carpeta raíz), esto conlleva a cambiar estas rutas en todos los CSS...
-En la versión 0.5 de Kumbia hemos encontrado una solución a este problema la cual
+En la versión 0.5 de Kumbia hemos encontrado una solución a este problema la cual cuando incluyes los archivos css que contengan alguna ruta de archivo como fue en el ejemplo anterior una imagen, lo ideal seria incluir este archivo CSS como se muestra abajo...
-<source lang="css" line>
+<source lang="css">
 <?php echo stylesheet_link_tag('style', 'use_variables: true')?>
 </source>
-Observen el parámetro use_variables, con este parámetro podemos hacer en el algo
+Observen el parámetro use_variables, con este parámetro podemos hacer en el algo como se muestra a continuación en los archivos CSS y nos basamos en el mismo ejemplo anterior...
-<source lang="css" line>
+<source lang="css">
 backgroundimage: url("@path/img/error.gif");
 </source>
 '''@path''' contiene el nombre de la carpeta raíz del framework.<br/>
-'''@img_path''' contiene la ruta hasta la carpeta '''public/img''', es decir que el mismo ejemplo
+'''@img_path''' contiene la ruta hasta la carpeta '''public/img''', es decir que el mismo ejemplo anterior tendría un funcionamiento igual de la siguiente manera..
 anterior tendría un funcionamiento igual de la siguiente manera..
-<source lang="css" line>
+<source lang="css">
 backgroundimage: url("@img_path/error.gif");
 </source>
-'''@css_path''' contiene la ruta hasta la carpeta public/css, esto tiene una utilidad si en
+'''@css_path''' contiene la ruta hasta la carpeta public/css, esto tiene una utilidad si en nuestro archivo CSS se hiciera una inclusión de otro archivo CSS.
-<source lang="css" line>
+<source lang="css">
 @import url("@css_path/otro_css.css");
 </source>

@@ Línea 117: / Línea 117: @@
 =Uso de Partials=
-Los partials (parciales) son pequeñas vistas que pueden incluirse dentro de otra vista y
+Los partials (parciales) son pequeñas vistas que pueden incluirse dentro de otra vista y que evitan repetir código.
 que evitan repetir código.
 Un partial se reconoce porque empieza con _ (underscore) antes del nombre de la vista.
-<source lang="php" line>
+Se puede hacer el llamado a visualizar un partial usando la función render_partial de esta forma:
 <?php echo render_partial('menu') ?>
 </source>
-De esta forma estaríamos mostrando el archivo _menu.phtml del directorio del
+De esta forma estaríamos mostrando el archivo _menu.phtml del directorio del controlador actual.
 =Uso de CSS en Kumbia=

@@ Línea 69: / Línea 69: @@
 =Uso de Layouts=
-Kumbia también permite opcionalmente el uso de una plantilla superior a nivel de
+Kumbia también permite opcionalmente el uso de una plantilla superior a nivel de controlador que se encuentra en el directorio '''views/layouts''' .
 controlador que se encuentra en el directorio '''views/layouts''' .
 Para nuestro ejemplo anterior tenemos el archivo '''views/layouts/clientes.phtml'''::
-<source lang="html4strict" line>
+<source lang="html4strict">
 <h1>Este es el Controlador
 <? content() ?>
 </source>
-El llamado a content() hace que el contenido de la vista para acción se muestre en esa
+El llamado a content() hace que el contenido de la vista para acción se muestre en esa parte del layout.
 parte del layout.
 Un llamado a clientes/adicionar nos visualizaría:
@@ Línea 88: / Línea 88: @@
-No es obligatorio definir un layout para todos los controladores, si este no existe Kumbia,
+No es obligatorio definir un layout para todos los controladores, si este no existe Kumbia, va a simularlo.
 =Uso de Templates=

@@ Línea 39: / Línea 39: @@
 =Uso de Vistas=
-Tal y como se vio en la [[Primera Aplicación en Kumbia]], las vistas son automáticamente
+Tal y como se vio en la [[Primera Aplicación en Kumbia]], las vistas son automáticamente visualizadas si se sigue la convención de nombrarlas con el mismo nombre de la acción dentro de un directorio con el nombre del controlador en views.
 visualizadas si se sigue la convención de nombrarlas con el mismo nombre de la acción
-dentro de un directorio con el nombre del controlador en views.
+Las vistas, layouts, templates y partiales tienen la extensión .phtml que indica que es php con html.
 Las vistas, layouts, templates y partiales tienen la extensión .phtml que indica que
 Ejemplo: Si tuviéramos un controlador Clientes y queremos mostrar una vista para su
 acción adicionar entonces hacemos lo siguiente:
-<source lang="php" line>
+<source lang="php">
   <?php
       class ClientesController extends ApplicationController {
@@ Línea 60: / Línea 59: @@
 y la vista sería el archivo views/clientes/adicionar.phtml:
-<source lang="html4strict" line>
+<source lang="html4strict">
 <h2>Hola desde Acción Adicionar</h2>
 </source>
-No es necesario definir una vista para cada acción en un controlador, esto debe hacerse
+No es necesario definir una vista para cada acción en un controlador, esto debe hacerse sólo para aquéllas que requieran presentar información al usuario.
 sólo para aquéllas que requieran presentar información al usuario.
-Las vistas que sean presentadas mediante AJAX deben realizar un llamado a $this-
+Las vistas que sean presentadas mediante AJAX deben realizar un llamado a $this->set_response('view') en su respectivo método del controlador. Así lograremos una salida optimizada para AJAX.
 =Uso de Layouts=