Edición de «KumbiaPHP Framework Versión 1.0 Beta2»

De KumbiaPHP Framework Wiki

Advertencia: no has iniciado sesión. Tu dirección IP se hará pública si haces cualquier edición. Si inicias sesión o creas una cuenta, tus ediciones se atribuirán a tu nombre de usuario, además de otros beneficios.

Puedes deshacer la edición. Antes de deshacer la edición, comprueba la siguiente comparación para verificar que realmente es lo que quieres hacer, y entonces guarda los cambios para así efectuar la reversión.

Revisión actual Tu texto
Línea 52: Línea 52:
  
 
== Helpers ==
 
== Helpers ==
Los helpers (ayudas) se usan en los views. Encapsulan código en métodos para su fácil reuso.
 
KumbiaPHP ya viene con helpers creados.
 
  
Pero lo realmente útil, es que los usuarios se pueden crear sus propios helpers y colocarlos en app/extensions/helpers/. Y después usarlos tranquilamente en sus views, KumbiaPHP se encarga de cargar transparentemente sus helpers asi como los uses.
 
 
=== Clase Html ===
 
=== Clase Html ===
  
Línea 122: Línea 119:
 
</source>
 
</source>
  
 
==== Html::gravatar() ====
 
Incluye imágenes de http://www.gravatar.com
 
<pre>
 
$email Correo para conseguir su gravatar
 
$alt Texto alternativo de la imagen. Por defecto: gravatar
 
$size Tamaño del gravatar. Un numero de 1 a 512. Por defecto: 40
 
$default URL gravatar por defecto si no existe, o un default de gravatar. Por defecto: mm
 
</pre>
 
<source lang=php>
 
echo Html::gravatar( $email ); // Simple
 
echo Html::link( Html::gravatar($email), $url); // Un gravatar que es un link
 
echo Html::gravatar( $email, $name, 20, 'http://www.example.com/default.jpg'); //Completo
 
</source>
 
  
  
Línea 182: Línea 165:
  
 
<source lang="php" line>
 
<source lang="php" line>
//Se agrega a la cola de links el enlace a un recurso externo, en este caso la hoja de estilo ubicada en "http://www.kumbiaphp.com/public/style.css"
+
Html::headlink('http://www.kumbiaphp.com/public/style.css',"rel='stylesheet',type='text/css' media='screen'"); //Se agrega a la cola de links el enlace a un recurso externo, en este caso la hoja de estilo ubicada en "http://www.kumbiaphp.com/public/style.css"
Html::headlink('http://www.kumbiaphp.com/public/style.css',"rel='stylesheet',type='text/css' media='screen'");  
 
  
 
/*Agrega a la cola de links "<link rel="alternate" type="application/rss+xml" title="KumbiaPHP Framework RSS Feed" href="http://www.kumbiaphp.com/blog/feed/" />" con lo cual podemos incluir un feed sin usar las convenciones de kumbiaphp */
 
/*Agrega a la cola de links "<link rel="alternate" type="application/rss+xml" title="KumbiaPHP Framework RSS Feed" href="http://www.kumbiaphp.com/blog/feed/" />" con lo cual podemos incluir un feed sin usar las convenciones de kumbiaphp */
Línea 244: Línea 226:
 
echo Html::includeHeadLinks();
 
echo Html::includeHeadLinks();
 
</source>
 
</source>
 +
 +
 +
  
 
=== '''Clase Tag''' ===
 
=== '''Clase Tag''' ===
Línea 262: Línea 247:
 
Incluye un archivo JavaScript a la vista, partial o template
 
Incluye un archivo JavaScript a la vista, partial o template
 
<source lang=php>
 
<source lang=php>
<?php echo Tag::js('jquery/html5shiv');?>  //Adiciona un archivo javascript (app/public/javascript/jquery/html5shiv.js)
+
<?php echo Tag::js('jquery/jquery.kumbiaphp');?>  //Adiciona un archivo javascript (app/public/javascript/jquery/jquery.kumbiaphp)
// no poner la terminación js
 
// no olvides de poner echo antes de TAG
 
 
</source>
 
</source>
  
Línea 418: Línea 401:
  
 
==== Form::dbSelect() ====
 
==== Form::dbSelect() ====
Crea un select con los datos de la tabla relacionada.
+
Crea campo Select que toma los valores de un array de objetos de ActiveRecord
 +
<pre>
 +
$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
  
La forma más simple usa convención, pero se puede configurar también. Ojo, no es necesario instanciar el modelo en el controller.
+
dbSelect($field, $data, $show, $blank = NULL, $attrs = NULL, $value = NULL)
 +
</pre>
  
Ejemplos de uso:
+
Controlador
<source lang=php>Form::dbSelect('model.campo_id');</source>
+
<source lang=php>
Esto carga el modelo(campo) y muestra el primer campo despues del pk(id), ordenado ascendentemente.
+
$usuarios = new Usuarios();
 +
$this->usuarios = $usuarios->find();
 +
</source>
  
El 80-90% casos es suficiente.
+
Vista
 
+
<source lang=php>
Tambien se puede elegir poner en la tabla el siguiente campo (id,usuario,...)(id,ciudad,...)(id,pais,...)
+
echo Form::dbSelect('usuarios.campo_id', $usuarios, 'nombres', '- seleccione -');
(id,departamento,...)(id,nombre,...).
+
</source>
 
 
 
 
Para elegir otro campo, que no es el siguiente al pk.
 
 
 
Queda muy fácil asi:
 
<source lang=php>Form::dbSelect('model.campo_id','campo');</source>
 
En este caso le indigamos el campo a mostrar y se muestra ordenado ascendentemente.
 
 
 
 
 
Para casos especiales también se puede configurar:
 
<source lang=php>Form::dbSelect('model.campo_id','campo',array('modelo','metodo','param'));</source>
 
Campo es el campo a mostrar.
 
El array de datos para la conexión, $modelo->metodo(param).
 
 
 
En este último caso el único parámetro opcional es el 'param'.
 
 
 
KISS KumbiaPHP :).
 
  
 
==== Form::select() ====
 
==== Form::select() ====
Línea 499: Línea 475:
 
echo Form::close(); //Cierra el formulario
 
echo Form::close(); //Cierra el formulario
 
</source>
 
</source>
 +
  
 
==== Form::button() ====
 
==== Form::button() ====
Línea 515: Línea 492:
  
 
==== Form::submitImage() ====
 
==== Form::submitImage() ====
Crea un botón de tipo imagen siguendo las convenciones de kumbiaphp, la imagen deberá estar dentro del directorio '/public/img/'
+
Crea un botón de tipo imagen siguendo las convenciones de kumbiaphp, la imagen devera estar dentro del directorio '/public/img/'
 
<pre>
 
<pre>
 
$img ruta de la imagen que usa el botón
 
$img ruta de la imagen que usa el botón
Línea 526: Línea 503:
 
echo Form::submitImage('botones/edit.gif'); //Crea un botón con la imagen 'botones/edit.gif'
 
echo Form::submitImage('botones/edit.gif'); //Crea un botón con la imagen 'botones/edit.gif'
 
</source>
 
</source>
 +
  
 
==== Form::submit() ====
 
==== Form::submit() ====
Línea 563: Línea 541:
 
$checked indica si se marca el campo
 
$checked indica si se marca el campo
  
check($field, $value, $attrs = NULL, $checked = NULL);
+
check($field, $value, $attrs = NULL, $checked = NULL)
 
</pre>
 
</pre>
  
Línea 1026: Línea 1004:
 
$img = Upload::factory('imagen', 'image');
 
$img = Upload::factory('imagen', 'image');
  
// Archivos de imágenes
+
// Archivos de Imagenes
// Para una mayor referencia del estándar MIME: http://www.w3schools.com/media/media_mimeref.asp
+
// Para una mayor referencia: http://www.w3schools.com/media/media_mimeref.asp
$img->setTypes(array('jpeg', 'gif', 'png'));
+
$img->setExtension(array('image/jpeg', 'image/gif', 'image/png'))
 
</source>
 
</source>
  
Línea 1043: Línea 1021:
 
$img = Upload::factory('imagen', 'image');
 
$img = Upload::factory('imagen', 'image');
  
// Formatos de Imagenes
+
// Archivos de Imagenes
$img->setExtensions(array('jpg', 'gif', 'png'));
+
// Para una mayor referencia: http://www.w3schools.com/media/media_mimeref.asp
 +
$img->setExtension(array('image/jpeg', 'image/gif', 'image/png'))
  
 
</source>
 
</source>
Línea 1184: Línea 1163:
 
<?php echo Form::close() ?>
 
<?php echo Form::close() ?>
 
</source>
 
</source>
 
== Libreria Session ==
 
 
A la libreria Session se le modifican sus métodos quedando de la siguiente forma:
 
 
=== Session::set() ===
 
Crear o especifica el valor para un indice de la sesión actual.
 
 
<pre>
 
$index      Nombre para el indice.
 
$value      Valor a almacenar.
 
$namespace  Espacio individual donde se almacenara el indice.
 
 
Session::set($index, $value, $namespace='default')
 
</pre>
 
 
<source lang=php>
 
/* Ejemplo */
 
Session::set('usuario', 'Administrador'); // Genera el indice 'usuario' que contendra 'Administrador'.
 
</source>
 
 
=== Session::get() ===
 
Obtiene el valor para un indice de la sesión actual.
 
 
<pre>
 
$index      Nombre del indice a obtener.
 
$namespace  Espacio individual donde se almacena el indice.
 
 
Session::get($index, $namespace='default')
 
</pre>
 
 
<source lang=php>
 
/* Ejemplo */
 
echo Session::get('usuario'); // Pinta 'Administrador'.
 
</source>
 
 
=== Session::delete() ===
 
Elimina el valor para un indice de la sesión actual.
 
 
<pre>
 
$index      Nombre del indice a eliminar.
 
$namespace  Espacio individual donde se almacena el indice.
 
 
Session::delete($index, $namespace='default')
 
</pre>
 
 
<source lang=php>
 
/* Ejemplo */
 
Session::delete('usuario'); // Elimina el indice 'usuario'.
 
</source>
 
 
=== Session::has() ===
 
Verifica que este definido el indice en la sesión actual.
 
 
<pre>
 
$index      Nombre del indice a verificar.
 
$namespace  Espacio individual donde se almacena el indice.
 
 
Session::has($index, $namespace='default')
 
</pre>
 
 
<source lang=php>
 
/* Ejemplo */
 
Session::has('id_usuario'); // Retorna FALSE.
 
</source>
 
 
NOTA: '''$namespace''' es un espacio individual en el cual se pueden contener las variables de sesión, permitiendo evitar colisiones con nombres de variables.
 

Ten en cuenta que todas las contribuciones a KumbiaPHP Framework Wiki pueden ser editadas, modificadas o eliminadas por otros colaboradores. Si no deseas que las modifiquen sin limitaciones, no las publiques aquí.
Al mismo tiempo, asumimos que eres el autor de lo que escribiste, o lo copiaste de una fuente en el dominio público o con licencia libre (véase Proyecto:Derechos de autor para más detalles). ¡No uses textos con copyright sin permiso!

Para editar esta página, responde la pregunta que aparece abajo (más información):

Cancelar Ayuda de edición (se abre en una ventana nueva)