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 intendible 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 MVC.

== 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.
@@ Línea 1: / Línea 1: @@
-{{cleanupbox
-|image=[[Archivo:Information_icon4.png|45px]]
-|texto ='''Este Artículo cumple con todos los requerimientos de los Kumbieros.'''<br />
-}}
 == 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 proporciona un gran poder al momento que se necesita escalar, mantener y reusar código en una aplicació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 difícilmente 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 que 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==
+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 intendible 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.
-[http://www.kumbiaphp.com KumbiaPHP] usa [http://es.wikipedia.org/wiki/POO POO (Programación orientada a objetos)], así que [[Indice#ACTIVE_RECORD | ActiveRecord]] es una clase que ya lleva métodos listos para usar. Estos [[Consultas |métodos]] facilitan al usuario el manejo de las tablas de las bases de datos; entre ellos están los siguientes: find, find_all, save, update, etc.
-El Modelo extiende la clase [[Indice#ACTIVE_RECORD | ActiveRecord]] para que el usuario pueda añadir sus propios métodos, y asi encapsular la lógica.
+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 MVC.
 == Un Buen Modelo ==
@@ Línea 35: / Línea 24: @@
 		$today = date('now');
 		return $this->find('order: creat_at desc',
-				   "conditions: data <= $today",
+				   "conditions: data > $today",
 				   "limit: $limit");
@@ Línea 42: / Línea 31: @@
 	public function buscar($busqueda){
 		$busqueda = filter_var($busqueda, FILTER_SANITIZE_STRING);
-		return $this->find_all_by_sql("SELECT * FROM bd.articulos a WHERE MATCH (titulo,texto)
+		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");
@@ Línea 49: / Línea 38: @@
 </source>
-Normalmente este código muchos usuarios lo colocan en el controller quedando el mismo '''ilegible''', colocándolo como se muestra arriba queda muy limpia la implementación de los mismo en nuestros modelos en los controller.
+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 AppController
-{
-    public function index ($id = 1)
-    {
-        $this->noticias = (new Articulos)->ver($id);
-    }
-    public function ver ($slug)
-    {
-        if ($slug) {
-            $this->noticia = (new Articulos)->buscar($slug);
-        }
-    }
-    public function rss ()
-    {
-        $this->noticias = (new Articulos)->ultimos();
-        View::template(null); //mostramos solo la vista, sin el template
-    }
-}
-</source>
-Lo que mencionamos arriba sobre la '''re-utilización''' de código y característica fundamental de la [http://es.wikipedia.org/wiki/POO POO], 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.
-[[Categoría:Tutoriales KumbiaPHP]]