Hoy quiero mostrarles como usar FBML. FBML es un lenguaje de etiquetas muy similar al HTML. El FBML es lo que nos va a permitir tener acceso a diferentes elementos del perfil y acciones de un usuario. Como es eso? Pues facebook por cuestiones de privacidad no permite que uno pueda acceder a datos de los usuarios, uno solo puede acceder a los ID de usuario. Y mediante ese ID mas FBML uno puede acceder a los otros datos del perfil (nombre, foto, amigos, etc etc) y solo desde una aplicacion que se ejecute en el mismo facebook. Es todo una cuestion de seguridad y muy buena segun yo.

Tenemos que recordar que nuestras aplicaciones estan alojadas en nuestros propios servidores y que facebook no nos da ningun alojamiento ni nada parecido, por lo tanto las bases de datos tambien las alojamos nosotros. Entonces a la hora de guardar algo deben guardar el ID de un usuario pues no tendran acceso al nombre, foto ni nada mas del usuario.

Ej: vamos a suponer que tenemos el ID de un usuario X que es 111222777 entonces…si en nuestra aplicacion quisieramos mostrar el nombre de esa persona hariamos asi:

<fb:name uid="111222777" />

O si por ejemplo quisieramos ver las foto de perfil de ese usuario hariamos asi:

<fb:profile-pic uid='111222777' />

Como veran no es dificil. No son muchas etiquetas. Y reciben parametros con las que podremos aprovecharlas mejor.

Veamos un ejemplo mas completo inspirado en un post de ikhuerta.

Vamos a usar el los mismos pasos que en mi tuto anteior. Solo vamos a cambiar el paso 9, el archivo index.php contendra lo siguiente:

<?php
// Llamar el archivo que contiene los parametros de configuración y obtine el id del usuario
require_once 'includes/facebook_config.php';

// Extraemos a un array los id's de todos sus amigos
$friends_ids = $facebook->api_client->friends_get();
?>
<!-- Mostrando foto del usuario logueado -->
<p>Hola! esta es tu foto: <fb:profile-pic uid="<?php echo $id_usuario; ?>" linked="true" /></p>

<!-- Mostramos las fotos de los amigos y nombres en una tabla-->
<table border=1>
	<tr>
		<td>Foto</td>
		<td>Nombre</td>
	</tr>
	<?php foreach ( $friends_ids as $friend_id ) {?>
	<tr>
		<td><fb:profile-pic uid='<?php echo $friend_id; ?>' linked='true' /></td>
		<td><fb:name uid='<?php echo $friend_id; ?>' /></td>
	</tr>
	<?}?>
</table>

Eso les va a mostrar primero tu foto y luego una tabla con las fotos y nombres de tus amigos. Algo asi:

Muy sencillo. Espero sus comentarios y dudas.

El dia de hoy quiero mostrarles como hacer su primera aplicacion para facebook usando PHP. No es una aplicacion para nada util pues solo muestra un ‘Hola mundo’ seguido de tu nombre. Pero antes hay que entender algunas cosas.

Facebook logro su popularidad al permitir contener aplicaciones realizadas por terceros y realizar negocios con ello. Eso no quiere decir que facebook te de un espacio en disco ni bases de datos para que tu hagas tus aplicaciones. Todo lo que hagas lo tendras que hacer en tu servidor o hosting. Facebook lo unico que hara se brindarte la conexion entre tu aplicacion y los datos de los perfiles de los millones de usuarios de la su red.

Los recursos disponibles a los desarrolladores se agrupan en 3 categorías:

• API: es una interfaz basada en REST que permite el acceso a los datos del perfil, amigos, fotos y eventos del usuario mediante la utilización de mensajes GET o POST.
• Consultas (FQL, “Facebook Query Language”): es un lenguaje de consultas similar a SQL utilizado para acceder a los mismos datos que la API pero permitiendo consultas más complejas.
• Maquetación (FBML, “Faceboook Markup Language”): es un lenguaje de markup similar a HTML que permite ser intercalado con el HTML a utilizar para integrar las aplicaciones a la experiencia de usuario Facebook. Utilizando FBML se pueden acceder distintos puntos de la red como ser el perfil, acciones del perfil, canvas y feeds. Este lenguaje también incluye soporte para AJAX y Javascript.

Una aplicación en Facebook posee una compleja estructura que permite brindar una experiencia de usuario completa:

• Product Directory: cuando un usuario navega el directorio de aplicaciones de Facebook, por cada aplicación se muestra una pequeña sección con el nombre, una imagen y una pequeña descripción.
• About: esta página muestra información general de la aplicación. Debe inducir al usuario a instalar la aplicación.
• Left Nav: es el panel de navegación izquierdo. Las aplicaciones pueden tener su ícono y nombre en este panel.
• Canvas Page: es la página principal de la aplicación. Home: esta página es accedida utilizando el panel de navegación de la izquierda, en general muestra información de los amigos del usuario. User Dashboard: es la página donde el usuario administra sus datos en una aplicación y determina de que forma las aplicaciones acceden a sus datos personales.
• Profile: es la representación online de la identidad del usuario. La API provee múltiples puntos de integración con el perfil del usuario permitiendo actualizar datos del mismo.Profile Box: presenta información actualizada sobre las acciones recientes del usuario.Profile Actions Links: debajo de la foto del usuario en el perfil, se pueden agregar enlaces para invocar acciones en la aplicación.
• Privacy Settings: se utiliza para definir los niveles de privacidad de los datos del perfil por aplicación.
• News Feed: como su nombre lo indica es un “feed” de noticias, allí las aplicaciones pueden “publicar” información del usuario de la misma.
• Alerts: las aplicaciones pueden enviar notificaciones a los usuarios a través del correo electrónico.
• Message Attachments: las aplicaciones pueden incluir archivos adjuntos que aparecen en la ventana para componer mensajes.
• Requests: las aplicaciones pueden crear peticiones que aparecen en la parte superior izquierda de la página principal. En general son iniciados por amigos que solicitan realizar alguna acción.

Todo eso de arriba lo copie de maestrosdelweb. La verdad para hacer nuestra primera aplicacion no nos interesa mucho todo eso.

Manos a la obra

Pongamos manos a la obra, he de aclarar que para hacer estos 10 pasos me base en otro blog que ya no existe mas

Paso 1: Debes ser usuario de la red social facebook para poder crear las aplicaciones.

Paso 2: Te vas a la pagina de developers y a la derecha veras un boton o enlace que dice ‘Configurar una nueva aplicacion’

Paso 3: En la pagina que aparecio poner un nombre para la aplicacion, Ej: ‘Saludador’ y acepten los terminos y condiciones.

Paso 4: En la siguiente ventana les apareceran como pestañas laterales a la izquierda.

En la que dice ‘Basico‘ llenamos los campos mas obvios: nombre de la aplicacion, icono, logotipo, descripcion, idioma. Aunque para nuestra pequeña primera aplicacion bastara con que coloquen solo el nombre. En esa misma pestaña tambien tienen el ID de aplicacion, el Api Key y secret key, copienlos en algun lado porque despues los vamos a usar.

En la pestaña Autenticacion marcamos la opcion Instalacion posible para usuarios.

Y en la pestaña Lienzo o Canvas si esta en ingles colocan en ‘Dirección web (URL) de la página de lienzo’ colocan lo que se convertira en su ‘direccion facebook’ Ej: http://apps.facebook.com/saludador y en ‘Canvas Callback URL’ colocan la direccion donde este almacenada su aplicacion, en este caso sera http://tudominio.com/saludador

Guarden todos los cambios.

Paso 5: Ahora hay que subir los archivos necesarios y la aplicacion a nuestro servidor. Antes que nada habra que bajar las librerias que nos permiten interactuar con el API de facebook.

Paso 6: Dentro del comprimido encontraran 2 carpetas (php y footprints) que deberan subir a su hosting.

Paso 7: Crear un archivo llamado facebook_config.php que contendra algunos datos:

<!--?php require_once 'php/facebook.php'; // codigo(KEY) que identifica a nuestra aplicación y es utilizadas en cada llamada a Facebook $appapikey = 'colocar aqui su API KEY'; // llave privada para autenticar la aplicación en el servidor de Facebook $appsecret = 'colocar aqui su SECRET'; // Crear una instancia del objeto Facebook $facebook = new Facebook($appapikey, $appsecret); // Obtener el id del usuario que este utilizando la aplicación $id_usuario = $facebook--->require_login();

$appcallbackurl = 'http://tudominio.com/saludador';

//catch the exception that gets thrown if the cookie has an invalid session_key in it
  if (!$facebook->api_client->users_isAppUser()) {
    $facebook->redirect($facebook->get_add_url());
  }
?>

Deberan completar el archivo con sus propios datos de aplicacion.

Paso 8: Subir facebook_config.php al mismo nivel que las carpetas anteriores.

Paso 9: Crear un archivo index.php que contendra la aplicacion propiamente dicha que mostrara un mensaje saludando y mostrando el nombre de la persona:

<!--?php // Llamar el archivo que contiene los parametros de configuración y obtine el id del usuario require_once 'facebook_config.php'; ?-->

Hola, Buen dia

Como veran aqui estamos haciendo uso de FMBL obtenemos el nombre de la persona que esta viendo la aplicacion. Y el parametro useyou=”false” se usa para que aunque habras tu mismo la aplicacion muestre tu nombre en vez de decirte ‘Tu’

Paso 10: Suban el archivo al mismo nivel que los otros archivos.

Eso seria todo, ahora si entran a la direccion que elijieron en el paso 4. Ej: http://apps.facebook.com/saludador  veran como su aplicacion los saluda con un pequeño mensaje

Fue todo muy sencillo y seguramente si llegaste a leer hasta aqui ya estas pensando en hacer alguna aplicacion A mi personalmente me parecio sencillo y ademas me parece genial que uno pueda almacenar sus propias aplicaciones porque eso significa que puedo usar mi querido KumbiaPHP framework para hacer alguna aplicacion.

Posibles errores que te pueden aparecer:

• Si solo te muestra el mensaje del saludo pero no tu nombre es porque cuando estas configurando tu aplicacion en la pestaña Lienzo debes elegir FBML en metodo de renderizacion.
• Si te da algun error de ‘cant open’ o algun error de PHP parecido seguramente sera por los permisos de los archivo o carpetas. Coloca permisos 755 a los archivos y carpetas involucrados.
• Y si te dice algo como: FBML Error (line 7): illegal tag “noscript” under “fb:canvas” seguramente es porque tienes tu aplicacion en algun hosting gratuito que esta metiendo al codigo algo que indeseado.

Aclaro que no soy experto ‘aun’ en el uso de kumbiaphp asi que mis explicaciones pueden estar un poco incompletas.

Segun el blog oficial:

KumbiaPHP es un framework para aplicaciones web libre escrito en PHP5. Basado en las prácticas de desarrollo web como DRY y el Principio KISS para software comercial y educativo. Kumbiaphp fomenta la velocidad y eficiencia en la creación y mantenimiento de aplicaciones web, reemplazando tareas de codificación repetitivas por poder, control y placer.

KumbiaPHP Framework intenta proporcionar facilidades para construir aplicaciones robustas para entornos comerciales. Esto significa que el framework es muy flexible y configurable.

KumbiaPHP es un esfuerzo por producir un framework que ayude a reducir el tiempo de desarrollo de una aplicación web sin producir efectos sobre los programadores.

Sus principales características son:

• Sistema de Plantillas sencillo
• Administración de Cache
• Scaffolding Avanzado
• Modelo de Objetos y Separación MVC
• Soporte para AJAX
• Generación de Formularios
• Componentes Gráficos
• Seguridad
• y muchas cosas más.

Adicional a esto Kumbia integra lo mejor de la Web en un solo framework para producir las aplicaciones Web del mañana (prototypejs, phpMailer, Smarty, FPDF, Script.aculo.us)

Segun yo:

KumbiaPHP es un framework de PHP muy poderoso y a la vez facil de usar para construir paginas web y sistemas web completos.

Entre las facilidades que les he descubierto puedo nombrar:

• Implementa completamente la arquitectura MVC. Esto hace que sea mas facil separar la programacion en si del diseño permitiendo reutilizar modelos y vistas.
• Implementacion de ORM. Esto permite usar convertir las bases de datos relacional en bases de datos orientadas a objetos. O mas sencillamente usar las tablas y registros como si fueran objetos.
• Etiquetas para facilitar el diseño de formularios, intregacion con jQuery y mucho mas.

Creo que si cabe destacar 2 cosas en KumbiaPHP framework son:

• Es creado por personas que hablan español y su documentacion esta en español.
• La comunidad alrededor es muy amigable y siempre dispuesta a ayudar.

Existen muchas fuentes de informacion y consulta para aprender a usar KumbiaPHP que ya les habia nombrado pero se las vuelvo a nombrar:

• wiki
• blog
• foro
• googlegroups
• IRC

La verdad esta demasiado disperso todo, personalmente me gustaria que estuviera un poco mas centrado todo. Pero de todas esas fuentes recomiendo googlegroups, la wiki y el IRC, los van a atender muy bien y ayudarlos en todo.

Como empezar?

• Pues con el clasico hola mundo. Hay uno en la wiki y otro en mi blog.
• Luego aprender a hacer CRUD (Create, Read, Update, Delete).
• Y luego tienen varios minitutoriales en mi blog y en la wiki.

Bueno como algunos no tienen idea de lo que es un framework aprovecho para decirles que no es como VisualBasic que tienen una interfaz y arrastran cosas a la pantalla, aqui sigue siendo todo codigo pero se vuelve muchisimo mas facil programar usando un framework que con el tradicional PHP.

Eso es todo, espero que les haya quedado claro. Ahora cuando alguien me pregunte que es KumbiaPHP lo mando a esta pagina

Como crear un blog paso a paso – parte 1
Como crear un blog paso a paso – parte 2
Poner creditos a los videos con Kino
Poner creditos a los videos con Kino – segunda forma
Como instalar un servidor Apache+PHP+MySQL en Linux
Herramientas de modelado UML
Herramientas para diagramas de Gantt
Que es el RSS
Gravatar, que son y como los uso
Usar enlaces permanentes

Otra manera sencilla de hacer que nuestro blog cargue mas rapido es reducir las llamadas a la base de datos. Para ellos tendremos que editar un poco de codigo. Por ejemplo:

Abrimos nuestro archivo headers.php, alli veremos varias llamadas a la base de datos en php para pedir cosas que nosotros podemos escribir en html y nos ahorramos ese pequeño tiempo que se tarda en pedir algo a la base de datos y esperar su respuesta.

Donde dice:

<?php bloginfo('name'); ?>

Lo podemos reemplazar por el nombre del blog, en mi caso: Paraiso Linux

Donde dice:

<?php bloginfo('rss_url'); ?>

Lo podemos reemplazar por nuestra direccion de feeds, ya se http://paraisolinux.com/feed o si estan usando feedburner sera algo asi: http://feeds.feedburner.com/paraisoLinux

Donde dice:

<?php bloginfo('url'); ?>

lo podemos reemplazar por la direccion de nuestro blog, por ejemplo http://paraisolinux.com

Donde dice:

<?php bloginfo('description'); ?>

pueden reemplazarlo por la descripcion de su blog.

Y asi pueden buscar estos pequeños trozos de codigo y reemplazarlos por su valor correspondiente, por lo general podran hacer esto en los archivos header.php, footer.pgp y sidebar.php, puede que encuentren tambien trozos similares en otros archivos pero eso ya dependera del theme que esten usando.

Aprendi varias cosas ultimamente con KumbiaPHP y en parte gracias a la buena onda de los desarrolladores que siempre estan dispuestos a ayudar.

Hoy quiero compartir con Ustedes un metodo sencillo para tener varias vistas para una misma accion en kumbiaPHP.

De que nos sirve esto? Pues esto es una de las ventajas del modelo MVC y nos sirve para muchas cosas. Por ej: Si yo hago una aplicacion web y quiero que tambien pueda ser accedida desde los celulares no es necesario programar toda la aplicacion de nuevo, sino simplemente cambiar la vista pero que el controlador siga siendo el mismo.

Vamos a lo practico.

Supongamos que tenemos un controlador llamado ejemplo_controller.php y el cual tiene una accion index y esa accion queremos que tenga 2 vistas. El controlador tendra el siguiente codigo:

<?php
class EjemploController extends ApplicationController {

function index($var=null){
 $this-&gt;nombre="Fede";
 if ($var=="wap"){
 $this-&gt;render("index2","default");
 }
}

}
?>

Lo que tenemos que tener en cuenta es que la accion recibe una variable que yo le llame $var y si esa variable tiene el valor “wap” (wap es solo un ejemplo, pueden usar lo que quieran) entonces carga y usa la vista llamada “index2″.

Veamos ahora las vistas:

ejemplo/index.phtml (o sea la vista default para la accion index) tiene el siguiente codigo:

<h1>Hola <?= $nombre?></h1>
<br/>
Mas texto de ejemplo para la vista.

Y la vista ejemplo/index2.phtml tiene el siguiente codigo:

Chau <?= $nombre?>

Como veran son vistas que muestran cosas diferentes pero trabajan con la misma variable de la misma accion.

Para ver el ejemplo carguen su accion primero asi:

http://ruta_de_la_aplicacion/controlador/accion

como yo estoy probando en un servidor local seria asi:

http://localhost/aplicacion/ejemplo/index

Con eso veran como se carga la primer vista. Y ahora si ponen asi:

http://ruta_de_la_aplicacion/controlador/accion/variable

veran la segunda vista, en mi caso seria asi:

http://localhost/aplicacion/ejemplo/index/wap

En realidad esta sencillo no?

Pero que pasa si queremos hacer que todas las vistas de un sitio o aplicacion tenga varias vistas? Estar pidiendo variables en cada accion es un poco engorroso pero les tengo una solucion.

Primero que nada deberemos cargar la clase session en el boot.ini de nuestra aplicacion, este archivo se encuentra en la carpeta config, casi siempre viene cargado la clase logger, es solo cuestion de agregar separada por coma la clase session, nos quedaria asi:

[modules]
libs = logger, session

Ahora vamos a modificar nuestro accion index, para que quede asi:

function index($var=null){
 if ($var=="wap"){
 Session::set("wap", "wap");
 }
}

Como veran sigue recibiendo por parametro una variable, la diferencia ahora esta en que esta sera la unica accion que reciba una variable, las otras acciones podran hacer uso de la variable de session que acabamos de crear. De ahora en mas cualquier otra accion de nuestra aplicacion podra saber si cargar una vista u otra dependiendo del valor de esa variable de session, con este simple codigo:

if (Session::get("wap")=="wap"){$this->render("otraaccion");}

Este codigo debera ser agregado en cada accion que deseemos que tenga una o mas vistas alternativas, en este caso yo lo hice solo con 2 vistas pero puede ocurrir que alguien necesite tener mas de 2 vistas para una misma accion.

Esta manera, usando variables de session, creo que es la mas comoda ya que solo necesitamos pasar una variable por URL a la primer accion.

Bueno asi com me sirvio a mi espero que les sirva a Ustedes. Cualquier cosa me preguntan o se conectan al IRC de KumbiaPHP y ahi seguro que los ayudan.

Pero igualmente siempre es util algo de informacion para los que recien estan empezando o simplemente no les gusta usar frameworks como mi amigo blogger deckerix que ha preparado este cortito pero sencillo ejemplo de como leer paginas web con php.

Pero con que proposito querriamos leer una pagina web desde otra pagina web? Pues existen muchisimas razones y voy a decirles cuales se me ocurren en este momento:

• aprovechar los datos mostrados por otra pagina para usarlos en la nuestra (en algunos paises esto se llama “robar contenido” )
• podriamos armarnos un lector de archivos online
• podriamos procesar el codigo html de una pagina de manera online
• y estoy escaso de ideas pero es util para muchas cosas

Vamos a los hechos:

Para leer una simple página web e imprimirla podemos utilizar el código siguiente:

ijense como lo que usamos es la funcion fopen que no solo sirve para trabajar con paginas sino basicamente con archivos de texto. La pagina leida, o mejor dicho su codigo estara guardado en la variable $texto.

Si por ejemplo queremos leer un listado de páginas y procesar una a una todas las líneas:

Lo que hacemos no es muy diferente a lo mostrado en el primer ejemplo, la diferencia esta en que ahora leemos varias paginas y hacemos algun trabajo sobre cada linea haciendo uso de ciclos for y arrays.

Muy util y sencillo verdad?

PD: se preguntaran porque puse imagenes en vez de escribir el codigo verdad? Pues la respuesta es que no pude poner codigo y no se porque, probe con todos los plugins que encontre pero no podia escribir codigo ….si alguien sabe como hacerlo por favor digamelo.

Nueva estructura de directorios - click para agrandar

• Entre las buenas nuevas tenemos que ya la
  versión 1.0 codename Spirit tiene su pantalla de bienvenida, y que no sólo es la bienvenida a la que estamos acostumbrados a ver, lo digo más que todo para los usuarios que tienen tiempo en el proyecto notarán la diferencia , esta nueva pantalla de bienvenida trae una serie de elementos que servirán de ayuda al momento que nos iniciamos con el framework, aparte de ser un diseño mas pensado y vistoso podremos manejar información de nuestra configuración.

• De las nuevas implementaciones, podemos decir algo con suma gratificación y es que estrenamos nueva estructura de directorios, pensada para que los usuarios tengan aplicaciones mas flexibles de administrar y escalables, esto significa que hemos desacoplado el core de kumabiaphp framework de nuestra aplicación (Yo he estado observando esta neuva estructura de directorios y me parece mucho mejor asi).

• Otra de las implementaciones que viene próxima a ser integrada a kumbiaphp framework, es el soporte sin mod_rewrite de apache, para aquellos que utilizan hosting compartidos (Esto es simplemente Genial!).

• Y por último y no menos importante hemos quitado (eliminado) el componente StandardForm, ya que es de conocimiento de todos los múltiples Bugs que presentaba el componente. Y aunado a eso el costo en cuanto a tiempo de mantenimiento que significa, por estos motivos hemos considerado suficiente el soporte a este componente. Esto no significa que haya terminado la era del scaffold y en este sentido ya tenemos el primer boceto del nuevo Scaffold (StandardForm) el cual busca ser mas personalizable y escalable por los mismo usuarios, cosa que era imposible hacer con el actual (Esto yo aun no lo he visto pero segun Deivison Tejeda ,co-fundador y desarrollador de kumbiaphp, esta muy bueno en cuanto a personalizacion respecta).

Por último recordamos para aquellos usuarios que deseen trabajar con la versión 1.0 Sipirit beta estará disponible en unos días para descargarla desde el SVN. Y para los que no saben como descargar esta version desde el SVN yo escribire un post en los proximos dias al respecto.

Mientras solo me queda recomendarles este framework ya que la verdad desde que lo uso todo me ha parecido genial, es facil aprenderlo, es mas rapido y productivo que trabajar solo con PHP y la gente que esta metida en el proyecto es realmente muy buena onda.

Para usar ActiveRecord es necesario crear un modelo para cada tabla como ya habiamos visto en el ejemplo anterior. Es decir que por ejemplo para la tabla clientes nuestro modelo sera un archivo llamado clientes.php dentro del directorio models y que contenga:

<?php
class Clientes extends ActiveRecord {
}
?>

Antes de pasar a ver como se usa voy a recomendarles que sigan 2 convenciones que son las sugeridas tambien en el libro.

• Llamar Id al campo clave de tabla y colocarla como autonumerica
• campo_id: Los campos terminados en _id indican relaciones foráneas a otras tablas, de esta forma se puede definir fácilmente las relaciones entre las entidades del modelo. Un campo llamado clientes_id en una tabla indica que existe otra tabla llamada clientes y esta contiene un campo id que es foránea a este.

CRUD: Create (Crear), Read (Leer), Update (Actualizar), Delete (Borrar)

ActiveRecord implementa automáticamente las cuatro operaciones básicas sobre una tabla: Crear, Leer, Actualizar y Borrar. Veamos ahora como usarlos:

Crear Registros

Manteniendo la idea del Objeto-Relacional podemos pensar que crear registros es lo mismo que crear objetos. Asignar valores a los atributos de un objeto y ejecutar el método create o save es lo mismo que hacer un INSERT y guardar valores en los campos.

$cliente=new clientes();

$cliente->nombre=”Eduardo”;

$cliente->apellido=”Santillan”;

$cliente->edad=”23″;

$cliente->save(); // seria igual si podemos $cliente->create();

Consultar Registros

En cuanto a la busqueda o consulta de registros existen muchos metodos y formas de hacerlo. Voy a mostrar solo un par de ejemplos. Si quieren algo mas detallado deberan consultar el libro.

$cliente=$clientes->find(85);

Lo que hace la anterior consulta es devolver en el objeto $cliente el registro cuyo id es 85. Es la forma mas basica de busqueda con activeRecord.

Para buscar segun otros campos distintos al id podemos hacer:

foreach($clientes->find(“apellido=’Santillan” and edad<24″) as $cliente){
print $cliente->nombre;
}

Con lo anterior estaremos buscando todos los registros cuyo campo apellido sea “Santillan” y cuyo campo edad sea menor a 24. Asumo que saben usar el foreach.

Actualizar Registros

Para actualizar la tarea es sencilla. Primero buscamos el registro que deseamos actualizar, luego cambiamos los valores que deseemos y por ultimo aplicamos el metodo save() o create().

$cliente=$clientes->find(369);

$cliente->edad=27;

$cliente->save();

Borrado de registros

Tampoco hay mucho que decir sobre el borrado de registros. Solo le pasamos el id que deseamos borrar.

$clientes->delete(45);

La verdad es que ahora no se como logre sobrevivir sin el ActiveRecord. Luego de probarlo me encanto porque es una manera de programar muy natural y sencilla.

Ya he explicado como instalar kumbia en Ubuntu/Linux y tambien una pequeña introduccion al Modelo MVC.

Entonces lo primero que vamos a hacer sera una aplicacion que solo utilizara una Vista y un Controlador. Para hacer el controlador lo que haremos sera crear un archivo en la carpeta controllers que esta dentro de la default que esta dentro de la carpeta apps que esta en la carpeta donde hayamos descimprimido kumbia durante la instalacion. podra parecer algo complicado pero no lo es realmente. Voy a explicarselo mas sencillo: la carpeta apps es donde pondremos nuestro proyecto, las cofiguraciones y el core de kumbia se encuentran en otras carpetas. La carpeta default es la carpeta por defecto donde pondremos nuestro proyecto entero. Y veremos que dento de la carpeta default hay 4 carpetas mas:

• controllers: sera donde estaran todos los controladores de nuestro proyecto o aplicacion.
• helpers: todavia no se para que sirve, cuando sepa les digo :p
• models: aqui estaran los modelos de la aplicacion
• views: obviamente aqui van las vistas.

Bueno ya explicada esta parte continuemos. Creen un archivo dentro de la carpeta controllers que se llame saludo_controller.php. Este sera el controlador llamado “saludo”. El hecho de ponerle _controller.php no es un capricho mio sino que asi debe llamarse para que kumbia sepa que es un controlador. Dentro del archivo creado coloquemos lo siguiente:

<?php
class SaludoController extends ApplicationController{
public function index() {
$this->mensaje=”Hola. Esto se encuentra en el archivo del controlador”;
}
}
?>

Analicemos lo que hemos escrito. Hemos creado una clase llamada SaludoController que hereda de ApplicationControllers, otra vez los nombre no son capricho mio sino que el nombre de la clase debe llamarse como el controlador seguido de Controller pero esta vez sin el guion bajo.

Tambien vemos que hay una funcion publica llamada index, esta funcion y todas las que creemos diremos que son las acciones del controlador. Dentro de esta funcion vemos que lo unico que hemos hecho es crear un atributo llamado mensaje que contiene una cadena de texto y nada mas.

Bueno ahora para que podamos ver algo debemos crear una vista que nos mostrara lo que hemos hecho. Entonces dentro de la carpeta de vistas creamos una carpeta llamada igual que el controlador, o sea una carpeta llamada saludo dentro de la carpeta views. Esto no es arbitrario tampoco sino que siempre sera asi, la carpeta se debe llamar igual que el controlador. Dentro de esa carpeta creamos un archivo llamado igual que la accion que queremos mostrar y con extension .phtml, en este ejemplo la accion que queremos mostrar es index, asi que creamos index.phtml dento de la carpeta saludo.

Esa vista puede contener todo el codigo html que deseen, pues justamente es una vista, por ejemplo nosotros lo llenaremos con lo siguiente:

<H1>Esto se encuentra en el archivo de vista</H1>
<H2><?php echo $mensaje; ?></H2>

Como veran son solo 2 lineas, la prima es un codigo html cualquiera que representa todo el codigo html que podemos poner en una vista, y el segundo es un codigo php donde lo unico que hacemos es mostrar en pantalla el atributo que creamos en la accion relacionada con esta vista. Como vemos solo pusimos el atributo como si fuera una variable, kumbia se encarga de entender que nos estamos refiriendo a un atributo del controlador.

Como veran aun no entramos en la parte de utilizar modelos, solo estamos usando vistas y controladores. Y como dije al principio no es una aplicacion que realmente pueda servir para algo, pero sirve para que entiendan como y donde creamos los archivos y como se maneja el modelo MVC en kumbia.

Para ver el resultado de los ejemplos deberemos poner en el navegador lo siguiente:

http://localhost/carpeta_de_instalacion_de_kumbia/default/saludo/index

y deberian ver algo como lo siguiente:

Primera aplicacion - click para agrandar

La proxima vez veremos como utilizar modelos para crear aplicaciones de alta-baja-modificacion en unas pocas lineas. Saludos y cualquier duda me preguntan.