This manual is an english port of Manual Kumbia PHP Framework. It is work in progress. You are free to help to improve it.

Until the work is finished, the manual will have spanish text mixed with english text. You are free to help us with the translation :-).

Sumario

1 AGRADECIMIENTOS
2 PREFACIO
3 GETTING STARTED WITH KUMBIA PHP FRAMEWORK
4 WORKING WITH KUMBIA PHP FRAMEWORK
5 MODELOS
- 5.1 ACTIVE RECORD
- 5.2 ACTIVE RECORD API
6 APPLICATION CONTROLLER
- 6.1 Métodos de la Clase ApplicationController
7 ApplicationController Class Methods
8 VISTAS Y HELPERS
9 AJAX
10 EXTENSIONS (Módulos extras de KumbiaPHP)
- 10.1 Filter
11 GENERADOR DE FORMULARIOS
12 EJEMPLOS
13 GLOSARIO

AGRADECIMIENTOS

   Este manual es para agradecer a quienes con su tiempo y apoyo en gran o en poca medida han ayudado a que este framework sea cada día mejor.
   A todos ellos Gracias Totales:
      Andres Felipe Gutierrez gutierrezandresfelipe@gmail.com
      Deivinson Tejeda deivinsontejeda@kumbiaphp.com
      Emilio Silveira emilio.rst@kumbiaphp.com
      César Caballero aka Phillipo phillipo@kumbiaphp.com
   Y a toda la comunidad que rodea a Kumbia, con sus preguntas, notificaciones de errores(Bug's), aportaciones, etc...

PREFACIO

GETTING STARTED WITH KUMBIA PHP FRAMEWORK

WORKING WITH KUMBIA PHP FRAMEWORK

MODELOS

ACTIVE RECORD API

This is a reference of the methods in ActiveRecord class sorted in alphabetic order:

Consultas

Métodos para hacer consulta de Registros:

Creación-Actualización-Borrado de Registros

APPLICATION CONTROLLER

Métodos de la Clase ApplicationController

This class has several useful methods to work with controllers.

ApplicationController Class Methods

This class has several useful methods to work with controllers.

render($view)

Shows a view belonging to the same controller.

Example:

<?php
   class ProductsController extends ApplicationController {
      function index(){
         $this->render('list');
      }
    } //end of class
?>

In this case, the view views/products/list.phtml will be rendered.

redirect($url, $seconds=0.5)

Redirects the execution to another controller after wait the specified number the seconds

Example:

<?php
  class ProductsController extends ApplicationController {
     function index(){
        $this->redirect('tickets/new', 2);
     }
  }
?>

The browser will go to tickets/new 2 seconds later

post($value)

Object oriented access to $_POST[$value].

get($value)

Object oriented access to $_GET[$value].

request($value)

Object oriented access to $_REQUEST[$value].

render_partial($name)

Render the partial view belonging to the same controller. Example:

Example:

   <?php
   class ProductsController extends ApplicationController {
       function index(){
           $this->render_partial('show_menu');
       }//end of method
    }//end of class
   ?>

The above example will output the partial view views/products/_show_menu.phtml

route_to([params: value])

Redirect from a controller to another or from an action to another. The parameters are:

controller: Destination controller to do the redirect.
action: Destination action to do the redirect
id: route id

Example:

   return $this->route_to("controller: clients", "action: query", "id:1");

The redirects are internal ones, meaning the users will not realize they are been redirected.

redirect($url_controlador)

Do a redirect to another controller or action using HTTP. This is a "real" redirect to another HTML page. The URL page changes in the user browser.

Example:

   $this->redirect("/products/query");

cache_layout($minutes)

Cache the view views/layout/ belonging to the controller for $minutes.

not_found($controller, $action) =

Optional method. It could be defined in any controller. If not_found method is defined then it will be called every time some action is not found. This is useful to process this kind of errors.

Example

<?php
   class TestController extends ApplicationController {
       function index(){
           $this->render_text("This is the index");
       }
       function not_found($controller, $action){
           Flash::error("I am sorry. The action $action is not defined, redirecting to index...");
           return $this->route_to('action: index');
       }
   }
?>

Note: There is in the 0.5 version a default view views/not_found.phtml with the same behaviour for the whole application. If not_found method is not implemented in a controller, the views/not_found.phtml actionn will be executed. Using this default action speeds up the development.

set_response($type)

Set the controlled generated answer type.

If $type is "view" then kumbiaPHP will output the view only without layout, template or any html header. This is useful to generate AJAX or PDF output.

Another $type value is "XML".

Example

<?php
   class TestController extends ApplicationController {
       function accion_ajax(){
           $this->set_response("view");
       }
   }
?>

is_alnum($value)

Checks if $value is alphanumeric. Useful to do user input validation.

<?php
   class TestController extends ApplicationController {
       function add(){
          $price = $this->request("price");
          if($this->is_alnum($price)==false){
              Flash::error("price has not a valid value");
              return;
           }
          /* ..*/
      }
  }
?>

load_record($record, $args...)

Load the fields in a ActiveRecord record like controller attributes. The parameters are:

$record, ActiveRecord or a string ActiveRecord record to load. If the parameter is a string then it must be a name of a model.
$args, optional parameters:

 * field: comma separated field names to load
 * except: comma separated field name to NOT load.
 * suffix: suffix for the attribute in the controller
 * preffix: preffix for the attribute in the controller

//Ejemplo1: $usuario = $this->Usuario->find(1); $this->load_record($usuario);

//Ejemplo2: $usuario = $this->Usuario->find(1); $this->load_record($usuario, 'except: id, sexo');

//Ejemplo3: $usuario = $this->Usuario->find(1); $this->load_record($usuario, 'field: nombre, apellido');

//Ejemplo4: $usuario = $this->Usuario->find(1); $this->load_record($usuario, 'preffix: c_');

//Ejemplo5: $this->load_record('Usuario');

//Ejemplo6: $this->load_record('Usuario', 'field: nombre, apellido');

== is_numeric($valor) ==

Evalúa si un campo es numérico o no. Es útil para validar la entrada de datos al recibirlos por parte de usuarios.

<?php

   class PruebaController extends ApplicationController {
      function adicionar(){
          $precio = $this->request(“precio”);
          if($this->is_numeric($precio)==false){
               Flash::error(“Entrada invalida para precio”);
               return;
          }
          /* ..*/
      }
   }

Anónimo

Buscar

English Manual KumbiaPHP Framework 1.0 Index

Sumario

GETTING STARTED WITH KUMBIA PHP FRAMEWORK

WORKING WITH KUMBIA PHP FRAMEWORK

ACTIVE RECORD API

ApplicationController Class Methods

render($view)

redirect($url, $seconds=0.5)

post($value)

get($value)

request($value)

render_partial($name)

route_to([params: value])

redirect($url_controlador)

cache_layout($minutes)

not_found($controller, $action) =

set_response($type)

is_alnum($value)

load_record($record, $args...)

Navegación

Herramientas wiki

Herramientas de página