KumbiaPHP Framework Versión 1.0 Beta2

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>

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

$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

$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"

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)