KumbiaPHP Framework Versión 1.0 Beta2

De KumbiaPHP Framework Wiki

Documentación de KumbiaPHP 1.0 beta2

Clase Html

Clase con métodos estáticos con la que podemos crear etiquetas HTML optimizadas respetando las convenciones de KumbiaPHP.


Html::img()

Permite incluir una imagen

$src ruta de la imagen
$alt atruibuto alt para la imagen
$attrs atributos adicionales

img ($src, $alt=NULL, $attrs = NULL)
/*Ejemplo*/
echo Html::img('spin.gif','una imagen'); //se muestra la imagen spin.gif que se encuentra dentro de "/public/img/" 
//con el artibuto alt 'una imagen'


Html::link()

Permite incluir un link

$action ruta a la accion
$text texto a mostrar
$attrs atributos adicionales

link ($action, $text, $attrs = NULL)
/*Ejemplo*/
echo Html::link('pages/show/kumbia/status','Configuracion'); //se muestra un link con el texto 'Configuracion'


Html::lists()

Crea una lista html a partir de un array

$array contenido de la lista
$type por defecto ul, y si no ol
$attrs atributos adicionales 

lists($array, $type = 'ul', $attrs = NULL)
/*Ejemplo*/
$ar = array('Abdomen' => 'Abdomen',
            'Brazos' => 'Brazos',
            'Cabeza' => 'Cabeza',
            'Cuello' => 'Cuello',
            'Genitales' => 'Genitales',
            'Piernas' => 'Piernas',
            'Tórax' => 'Tórax',
            'Otros' => 'Otros');
//$ar el array que contiene los items de la lista
echo Html::lists($ar, $type = 'ol'); //Muestra una lista <ol></ol>


$ar2 = array('Abdomen','Brazos','Cabeza','Cuello','Genitales','Piernas','Tórax','Otros');
echo Html::lists($ar2, $type = 'ol'); //Muestra una lista <ol></ol>


Html::includeCss()

Incluye los archivos CSS que previamente fueron cargados a la lista mediante Tag::css()

Tag::css('bienvenida');    //Pone en lista un CSS (app/public/css/bienvenida.css)
echo Html::includeCss();  //Adiciona los recursos enlazados de la clase en el proyecto


Html::headLink()

Enlaza una acción

me falta info...

Html::headLinkAction()

Enlaza una accion

me falta info...


Html::headLinkResource()

Enlaza un recurso de la aplicacion

me falta info...


Html::includeHeadLinks()

Incluye los links para el head

echo Html::headLink('www.google.com');
echo Html::includeHeadLinks();


Clase Tag

Esta clase nos va a permitir adicionar archivos JS y CSS a nuestro proyecto (como lo hacíamos con las funciones stylesheet_link_tag y javascript_include_tag de la Beta1), bien sean archivos que se encuentren en nuestro servidor o en un servidor externo. Tambien vamos a poder hacer

Las funciones de esta clase son de tipo static lo que nos permite referenciarlas directamente de la forma como se presentan a continuación.

Tag::css()

Incluye un archivo CSS a la lista

Tag::css('bienvenida');    //Pone en lista un CSS (app/public/css/bienvenida.css)
echo Html::includeCss();  //Adiciona los recursos enlazados de la clase en el proyecto

Tag::js()

Incluye un archivo JavaScript a la vista, partial o template

Tag::js('jquery/jquery.kumbiaphp')    //Adiciona un archivo javascript (app/public/javascript/jquery/jquery.kumbiaphp)


Clase Form

Clase para el manejo y la creación de formularios


Form::open()

Crea una etiqueta de formulario

$action acción a  la que envía los datos, por defecto llama la misma acción de donde proviene
$method 'post' o 'get', por defecto se tiene en 'post'
$attrs atributos adicionales

open($action = NULL, $method = 'post', $attrs = NULL)
/*Ejemplo*/
echo Form::open();//inicia un formulario que enviara los datos a la acción que corresponde a la vista actual
echo Form::open('usuarios/nuevo');//inicia un formulario que enviara los datos al controller 'usuario' y la acción 'nuevo'



Form::multipart()

Crea una etiqueta de formulario multipart, este es ideal para formularios que contienen campos de subida de archivos

$action acción a  la que envía los datos, por defecto llama la misma acción de donde proviene
$attrs atributos adicionales

openMultipart ($action = NULL, $attrs = NULL)
/*Ejemplo*/
echo Form::multipart();//inicia un formulario multipart que enviara los datos a la acción que corresponde a la vista actual
echo Form::multipart('usuarios/nuevo');//inicia un formulario multipart que enviara los datos al controller 'usuario' y la acción 'nuevo'


Form::close()

Crea una etiqueta de cierre de formulario

/*Ejemplo*/
echo Form::close();//crea una etiqueta de cierre de formulario </form>


Form::input()

Crea un campo de tipo input

$attrs atributos para el tag
$content contenido interno

input($attrs = NULL, $content = NULL)
/*Ejemplo*/
echo Form::input('nombre');


Form::text()

Crea un campo de tipo input

Siempre que se le da el parmetro name de la forma model.campo, es decir un nombre que contenga un punto dentro del string, se crea el campo de texto con el name= "model[campo]" y el id="model.campo" (en la version 1.0 beta 1 se cambiaba por id="model_campo")

$field Nombre de campo
$attrs atributos de campo
$value valor inicial para el input

text($field, $attrs = NULL, $value = NULL)
/*Ejemplo*/
echo Form::text('nombre'); //crea un campo de tipo texto con el parametro name= "nombre", id = "nombre"
echo Form::text('usuario.nombre'); //crea un campo de tipo texto con el parametro name= "usuario[nombre]", id = "usuario.nombre"
echo Form::text('nombre',"class= 'caja'",'55'); //crea un campo de tipo texto con el parametro name= "nombre", id = "nombre", class= "caja", value = "55"


Form::pass()

Crea un campo de tipo Password

$field nombre de campo
$attrs atributos de campo
$value valor inicial para el campo

pass($field, $attrs = NULL, $value = NULL)
/*Ejemplo*/
echo Form::pass('password'); //crea un campo de tipo password con el parametro name= "password"


Form::textarea()

Crea un textarea

$field nombre de campo
$attrs atributos de campo
$value valor inicial para el textarea

textarea($field, $attrs = NULL, $value = NULL)
echo Form::textarea('detalles'); //Crea un textarea


Form::label()

Crea un label y lo asocia a un campo

$text texto a mostrar
$field campo al que hace referencia
$attrs array de atributos opcionales

label($text, $field, $attrs = NULL)
echo Form::label('nombre de usuario:','nombre'); //Crea un label para el campo nombre con el texto 'nombre de usuario:'
echo Form::text('nombre');


Form::hidden()

Crea un campo hidden (campo oculto)

$field nombre de campo
$attrs atributos adicionales de campo
$value valor inicial para el campo oculto

hidden($field, $attrs = NULL, $value = NULL)
echo Form::hidden('id',null,12); //Crea un campo oculto con el name="id" y el value="12"


Form::dbSelect()

Crea campo Select que toma los valores de un array de objetos

$field nombre de campo
$data array de valores para la lista desplegable
$show campo que se mostrara
$blank campo en blanco
$attrs atributos de campo
$value valor inicial para el campo oculto

dbSelect($field, $data, $show, $blank = NULL, $attrs = NULL, $value = NULL)
ejemplo pendiente...

Form::file()

Crea campo File para subir archivos, el formulario se debe abrir con Form::openMultipart()

 
$field nombre de campo
$attrs atributos de campo

file($field, $attrs = NULL)
echo Form::openMultipart(); //Abre el formulario multipart
echo Form::file('subir'); crear el campo para subir archivos
echo Form::close(); //Cierra el formulario

Migrando de 1.0 Beta 1 a 1.0 Beta 2

La versión 1.0 beta2 trae consigo correcciones y mejoras, nuevos helpers, clases y extensiones que facilitaran aun mas el trabajo.

Para realizar la migración de la versión 1.0beta1 a la versión 1.0beta2 solamente hay que tener presentes los cambios que se han realizado en cuanto a funcionamiento, la inclusión de nuevos helpers para las vistas y controllers.

Recordemos que todo lo que se incluye es con el fin de facilitar la curva de aprendizaje, la forma de trabajo y de poseer un framework con una semántica mucho mayor, claro esta que sigue sin perder su cualidades mvc y de scaffolding

Autoload libs (new)

En la versión 1.0 beta 2 las librerías se cargan automáticamente, siempre y cuando se encuentren en el directorio correspondiente “app/libs”, de igual modo se cargan las extensiones automáticamente “extensions/” y los helpers “helpers/”. Por esta razón el archivo “/config/boot.ini” ya no se usa en la versión 1.0 beta2

¿Que debo cambiar?

Si se tiene una APP con la versión 1.0 beta1, solamente debe eliminar (ya que no sera necesario) el archivo “/config/boot.ini” la carga de librerías que se realizaba mediante load::lib(); ya no es necesaria, así que estas también se pueden borrar. En resumen: eliminar todas las cargas de librerías que se hagan mediante load::lib(); y boot.ini

Como se usa

Como verán se omite la carga de librerías y se crea directamente el objeto

Versión 1.0 beta 1

Load::lib('util');
$var = new util();

Versión 1.0 beta 2

$var = new util();


--Onizukar 16:16 05 mar 2010 (UTC) --Ingjuanfelipe 20:38 21 feb 2010 (UTC)