Edición de «Como Usar los Modelos en KumbiaPHP»

== Introducción ==
Los Modelos representan la lógica de la aplicación y son parte fundamental para el momento que se desarrolla una aplicación, un buen uso de estos nos permiten un gran poder al momento que se necesita escalar, mantener y rehusar código en una aplicación.

Por lo general un mal uso de los modelos es solo dejar el archivo con la declaración de la clase y toda la lógica se genera en el controlador. Esta práctica trae como consecuencia que en primer lugar el controlador sea entendible por alguien que intente agregar y/o modificar algo en esa funcionalidad, en segundo lugar lo poco que puedes rehusar el código en otros controladores y lo hace es repetirse el código que hace lo mismo en otro controlador.

Partiendo de este principio los controladores '''NO''' deberían contener ningún tipo de lógica solo se encargan de atender las peticiones del usuarios y solicitar dicha información a los modelos con esto garantizamos un buen uso del [http://es.wikipedia.org/wiki/Modelo_Vista_Controlador MVC].

==El Modelo extiende el ActiveRecord==
[http://www.kumbiaphp.com KumbiaPHP] usa [http://es.wikipedia.org/wiki/POO POO (Programación orientada a objetos)], asi que ActiveRecord es una clase que ya lleva métodos listos para usar. Que facilitan al usuario el manejo de las tablas de las bases de datos, metodos como: find, find_all, save, update,...

El Modelo extiende la clase ActiveRecord para que el usuario pueda añadir sus métodos, y asi encapsular la logica.

== Un Buen Modelo ==
A continuación una muestra de un buen modelo en [http://www.kumbiaphp.com KumbiaPHP]

<source lang=php >
<?php

class Articulos extends ActiveRecord {
	
	public function ver($page=1,$ppage=10){
		
		return $this->paginate('order: creat_at desc',
					"page: $page",
					"per_page: $ppage");	
	}
	
	public function ultimos($limit=10) {
		$today = date('now');
		return $this->find('order: creat_at desc',
				   "conditions: data <= $today",
				   "limit: $limit");
		
	}
	
	public function buscar($busqueda){
		$busqueda = filter_var($busqueda, FILTER_SANITIZE_STRING);
		return $this->find_all_by_sql("SELECT * FROM copa.articulos a WHERE MATCH (titulo,texto) 
                                               AGAINST('\"$busqueda\"' IN BOOLEAN MODE) ORDER BY creat_at DESC");
		
	}
}
</source>

Normalmente este código muchos usuarios lo colocan en el controller quedando el mismo '''ilegible''', colocandolo como se muestra arriba queda muy limpia la implementación de los mismo en nuestros modelos en los controller.

== Implementando mis modelos en los controladores ==
A continuación se muestra un controller donde se puede apreciar lo '''legible''' que queda nuestro controller si delegamos las funciones que corresponden a sus responsables dentro del [http://es.wikipedia.org/wiki/Modelo_Vista_Controlador Patrón MVC] que promueve [http://www.kumbiaphp.com KumbiaPHP].

<source lang=php>
<?php
class MiController extends ApplicationController
{
    public function index ($id = 1)
    {
        $this->noticias = $this->Articulos->ver($id);
    }
    public function ver ($slug)
    {
        if ($slug) {
            $this->noticia = $this->Articulos->buscar($slug);
        }
    }
    public function rss ()
    {
        $this->noticias = $this->Articulos->ultimos();
        $this->set_response("view");
    }
}
</source>

Lo que mencionamos arriba sobre el rehuso del código si vemos el método ultimos() del modelo Articulos nos sirve para crear un RSS, un [[KumbiaPHP_Framework_Versión_1.0_Spirit#views.2Fpartials.2F |Partial]] (widget) con los artículos recientes, etc. es decir donde necesitemos los últimos artículos.