Howto debug templates in Akelos

One of the problems with having everything built into a framework is that, if someone messes up, it is really difficult to find where.
If you want to debug templates in Akelos (i.e. put error_log() calls inside your .tpl files), you’ll need to edit your config/config.php file and add

define(‘AK_TEMPLATE_SECURITY_CHECK’,false);

Then if you want to get more logs about what’s happening inside your application (as seen by Akelos), you can take the opportunity to also add

define(‘AK_LOG_EVENTS’,true);

This last constant definition will write all internal logs to the log/ directory (log/production.log if you’re in production, or log/development.log if you’re in development mode)

Working on online translation for Akelos

We are currently working on the development (or co-development, as a base was made available to us by the Akelos team itself) of a plugin to Akelos that fixes the current problems of language variables duplication, deprecation and need for a manual edition of the files.

There are still a few things to be fixed in terms of getting that into a production environment for Akelos instead of just the development environment, but we’re working on that.

Curso interno sobre Akelos

Jhon y Ronny nos están honrando hoy con un pequeño curso sobre Akelos, el framework PHP con el cual van desarrollando OpenC2C y otras aplicaciones desde hace tiempo.

El framework Akelos, aparte de ofrecer funcionalidades basadas en el modelo de Ruby on Rails (mucho más que CakePHP), ofrece una gestión integrada de pruebas automatizadas (generación de esqueletos de pruebas), gestión de internacionalización y creación automatizada de esqueletos de objetos (incluyendo interfaces CRUD – Create Read Update Delete).

Este capacitación interna viene frente a un proyecto de desarrollo grande en el cual vamos a estar trabajando a lo largo del mes de Septiembre.

Subir archivos usando AKelos Framework + validaciones respectivas

En este post el objetivo es conocer un poco más sobre este poderoso Framework y todas sus bondades, para ello en esta sección voy a compartir con ustedes como subir archivos al servidor y las validaciones respectivas (tamaño, tipo, extension, etc).

Primero como todos sabemos interactuamos con la vista para cargar el archivo a subir, en formato Akelos:

<p><label for=”screenshot_file”>_{Image}</label><br />
<?= $form_tag_helper->file_field_tag(‘screenshot[file]‘); ?> <i>_{Only accepts JPG, JPEG, PNG or GIF (no animation)}</i>
</p>
<p><label for=”screenshot_title”>_{Image description}</label><br />
<?php  echo $active_record_helper->input(‘screenshot’, ‘title’,array(‘maxlength’=>50))?>
</p>

Luego interactúa el controlador primero guardando el nombre del archivo en BD y enviando los datos del archivo en un array a una función dentro del modelo, recojemos los valores POST:

@$fileuploaded = $this->params['screenshot']['file'];
@$this->params['screenshot']['file'] = $this->params['screenshot']['file']['name'];

Enviamos lo datos a la funció setUploadedFile:

$this->Screenshot->setUploadedFile($fileuploaded);

Seteamos la variable para realizar el save() en Akelos:

$this->Screenshot->setAttributes($this->params['screenshot']);

Finalmente ahora el trabajo depende del modelo screenshot.php:

function setUploadedFile($var) {
$this->uploadedfile = $var;
}

Ahora validamos:

function validateOnCreate() {
if ($this->getErrorsOn(‘file’) === false) {
try{
$safe_extension = array(‘png’,'jpeg’,'jpg’,'gif’,'JPG’,'GIF’);  // solo acepta estas extensiones (bueno para imagenes)

if ($this->uploadedfile['error'])
throw new Exception($this->t(‘Error while uploading file!’));

@$path_parts = pathinfo($this->uploadedfile['name']);
if (!empty($path_parts['extension'])) {
if (!in_array($path_parts['extension'],$safe_extension))
throw new Exception($this->t(‘Invalid file type in pictures.’));  // validamos la extension del file
}

} catch (Exception $e) {
$this->addError(‘file’,'<span style=”color:red”>’.$e->getMessage().’</span>’);
}
}
if ($this->hasErrors()) return false;
else return true;
}

Ahora creamos una funcion para parsee el nombre del archivo y lo guarde en el campo file (por ejempo) de la BD:

function beforeCreate(){
@$path_parts = pathinfo($this->uploadedfile['name']);
if (!empty($path_parts['basename'])) {
$name_length = 31 – strlen($path_parts['extension']);
$this->uploadedfile['name'] = AK::randomString($name_length).’.’.$path_parts['extension'];
$this->set(‘file’, $this->uploadedfile['name']);
}
return true;
}

Ahora usamos una función para guardar el file en nuestro servidor.

function afterCreate(){
$root = ‘ruta_path’;
$target_path_root = $root;
AK::make_dir(substr($target_path_root,0,-1)); // crea el directorio si no existe

$target_path = $target_path_root.basename($this->uploadedfile['name']);
move_uploaded_file($this->uploadedfile['tmp_name'], $target_path); // lo copia
return true;
}

Y por últomo una función para elimianr en caso de hacer un destroy():

function beforeDestroy(){
$path = ‘ruta_path’;
@unlink($path.$this->get(‘file’));
return true;
}

Ojo: no cambiar el nombre de las funciones (son propias de Akelos), y si quiero actualizar mi imagen uso en vez de Create -> Update.

Espero que sea de ayuda para aquellos que quieren iniciarse con Akelos, luego explicaré como convertir una imagen a thumbnail.

Traducciones con parámetros

Akelos

i18n

La i18n (internationalization) de Akelos (framework PHP) nos permite incluir parámetros en la invocación. A continuación compartimos un ejemplo con ustedes:

.

Trabajaremos con el controlador product

Y el método greeting

archivo app/controller/product_controller.php
function greeting() {

}

.

En la vista (archivo app/views/product/greeting.tpl):
translate( 'Hello %user_name. Justice %question_mark', array('%user_name' => 'Osho', '%question_mark' => '?') );
?>
Aquí debemos prestar atención a los parámetros que se indican con el prefijo de porcentaje (‘%’). Y como segundo parámetro del método translate tenemos el arreglo con llaves y valores para los parámetros.

.

En los archivos de traducción se puede ser flexibles con la presencia y posición de las variables al interior de las expresiones.

Ej:

archivo app/locales/product/en.php
$dictionary['Hello %user_name. Justice %question_mark']='Hello %user_name. Justice %question_mark';

archivo app/locales/product/es.php
$dictionary['Hello %user_name. Justice %question_mark']='%user_name e. Justicia chu.';

Obtendríamos como resultado:
- Hello Joseph. Justice?
- Joseph e. Justicia chu.

De esta forma podemos ubicar las palabras en el lugar correspondiente de acuerdo a las reglas de cada lenguaje. Incluso prescindir de elementos como ciertos signos de puntuación que sólo son válidos en determinados idiomas.

También podemos reutilizar expresiones ya traducidas, así evitamos las variaciones en la traducción de frases muy similares. La clave es identificar patrones en las expresiones, cuando en la práctica escribimos repetidas veces lo mismo.

- Ha fallado el comando DELETE.
- Command EXECUTE has failed.

Y podemos dar por cerrada una etapa de traducción antes de terminar el proceso de desarrollo de la lógica de una solución.

- Le quedan 2 tareas por revisar.
- 1 task to do.

Introducción a Akelos Framework

Quiero compartir mi experiencia ya que desde hace meses atrás empece a involucrarme en el mundo de los framework y en especial con Akelos Framewok y a sido una gran experiencia ya que facilita y recude muchas lineas de codigo a la hora de desarrollar aplicaciones.

en este post empésaremos comentaremos el origen y algunos conceptos basicos de este potente framewoks.

Akelos PHP Framework es una versión para PHP de la plataforma de desarrollo Ruby on Rails. Al igual que Rails, proclama incrementar la velocidad y facilidad con la que se pueden desarrollar aplicaciones web que utilizan bases de datos.

Combina la simplicidad con la posibilidad de desarrollar aplicaciones escribiendo menos código que con otros frameworks y con un mínimo de configuración, ofreciendo también la posibilidad de crear esqueletos de código (Scaffolds) para acelerar este proceso.
Abreviado generalmente como Akelos, es un proyecto de código abierto escrito en el lenguaje de programación PHP. Las aplicaciones escritas utilizandoAkelos siguen paradigma de la arquitectura Modelo Vista Controlador (MVC).

Akelos a sido desarrollado por Bermi Ferrer, este framework soporta Multiplataforma y la gran ventaja es que cuenta con una licencia LGPL.

Aqui les comparto un enlace externo donde entrevistan que le hicieron a Bermi Ferrer.

Entrevista

Site Akelos

Nota: en nuestro siguiente post comensaremos a iniciarnos en el mundo del desarrollo de las aplicaciones con akelos desde lo basico a lo complejo. espero sus comentarios y aportes que siempre seran vienvenidos.

Algunos frameworks para PHP más usados

A continuación las características de algunos de los Frameworks para PHP más usados.

Zend Frameworks

El Zend Frameworks es simple, no necesita instalación especial, requiere PHP 5 e incorpora el patrón MVC.

Se debe descargar y copiarlo hacia nuestro servidor local, veamos a través de un pequeño ejemplo cómo podemos crear un lector de RSS. Los ficheros que creemos podemos copiarlos dentro del directorio “library”.

<?php
// Componente requerido
require_once 'Zend/Feed.php';

// Incluimos la dirección de nuestro fichero rss que deseamos importar
$feed = Zend_Feed::import('http://localhost/rss.php');

// Se recorrerán todos los item del fichero, mostrando el titulo y el enlace
foreach ($feed->items as $item) {
    echo "<p>" . $item->title() . "<br />";
    echo $item->link()  . "</p>";
}
?>

Symfony

Diseñado con el objetivo de optimizar la creación de las aplicaciones web, con el uso de sus características. Posee una librería de clases que permiten reducir el tiempo de desarrollo.

Symfony está desarrollado en PHP5, se puede utilizar en plataformas *nix (Unix, Linux) y Windows. Requiere de una instalación, configuración y líneas de comando, incorpora el patrón MVC, soporta AJAX, plantillas y un gran número de bases de datos.

Luego de descargar, debemos desempaquetar hacia un directorio dentro de nuestro servidor web. Puede configurar el archivo “symfony.bat” e introducir la ruta completa del archivo “php.exe” en la línea 34.

set PHP_COMMAND=c:/xampp/xampp/php/php.exe

Si nos encontramos en el directorio “sf_sandbox” podemos ir a las líneas de comando y conocer la versión del framework: symfony -V. Podemos verificar la creación de nuestro proyecto introduciendo en el navegador, por ejemplo: http://localhost/sf_sandbox/web/frontend_dev.php

La estructura de los directorios es:

sf_sandbox/ // directorio del proyecto
 apps/      // archivos de la aplicación
 batch/     // procesos
 cache/     // cache
 config/    // configuración
 data/      // archivos y códigos de datos
 doc/       // documentación
 lib/       // librerías y códigos de proposito general
 log/       // archivos de log
 plugins/   // plugins
 test/      // tests
 web/       // directorio público

Si deseamos crear un weblog debemos crear el archivo “schema.yml” en el directorio “sf_sandbox/config/”. Después de haberlo creado podemos usar las siguientes líneas de comando dentro del directorio “sf_sandbox/”:

• symfony propel-generate-crud frontend post Post : crear y listar Post.
• symfony propel-generate-crud frontend comment Comment : crear y listar comentarios.
• symfony clear-cache : limpiar la cache.

Los modulos serán creados en “sf_sandbox\apps\frontend\modules\”. Podemos ver el resultado:

• http://localhost/sf_sandbox/web/frontend_dev.php/post
• http://localhost/sf_sandbox/web/frontend_dev.php/comment

Se puede acceder a los archivos y modificar las plantillas a nuestro gusto.

Seagull

El framework Seagull, nos permite realizar una programación modular, posee un Sistema de Gestión de Contenidos (CMS).

Entre sus características de encuentran su compatibilidad con PHP 4 y PHP 5, ORM integrado, incorpora el patrón MVC, uso de templates, soporte para múltiples bases de datos, validación de datos, alto nivel de configuración, autentificación, integración de librerías PEAR.

Debemos descargar el framework, luego descomprimirlo hacia un directorio dentro de nuestro servidor web. Luego introducimos la dirección en nuestro navegador para realizar su instalación. Ejemplo: http://localhost/seagull/www/.

Debemos completar los 6 pasos siguientes:

• Aceptar la licencia
• Autorización
• Debemos crear en el directorio el archivo “AUTH.txt” que contenga el código generado o descargarlo en “seagull/”. Si se crea correctamente podremos continuar al siguiente paso.
• Detección: aquí se detectará los módulos disponibles, así como la configuración y versión de PHP.
• Conexión con las bases de datos: debemos configurar los datos necesarios para realizar la conexión con el servidor de base de datos.
• Configuración de la base de datos: introducir el nombre de la base de datos. Se puede utilizar una existente.
• Creación del Usuario Administrador: se creará la cuenta de usuario que utilizaremos para administrar a Seagull Framework.

Luego de Finalizar su instalación podemos crear contenidos visitando http://localhost/ seagull/www/ e introduciendo el usuario y clave de administración.

Prado

Prado está basado en componentes eventos con el objetivo de acelerar el desarrollo de aplicaciones web usando PHP 5.

El concepto del desarrollo de aplicaciones en Prado es diferente, se utilizan componentes, eventos y propiedades en vez de procedimientos, URL y parámetros.

Este Framework combina especificaciones en un archivo XML, plantillas HTML y una clase PHP. Prado, cuenta con soporte para AJAX, validación, autentificación, plantillas, múltiples bases de datos.

Entre los beneficios que podemos encontrar para el desarrollo de aplicaciones web se encuentran:

• Reutilización: los códigos y componentes pueden ser reutilizados.
• Fácil uso: la creación y uso de componentes es fácil.
• Funcionamiento: utiliza una técnica de caché para asegurar el funcionamiento de aplicaciones basadas en el.
• Integración: permite la separación del contenido y la presentación.

Podemos descargar y descomprimir Prado en un directorio, luego acceder al siguiente demo.

CodeIgniter

CodeIgniter es un buen framework, utilizado por una gran comunidad de usuarios. Construido para codificadores PHP que necesitan una herramienta de desarrollo fácil para crear aplicaciones web simples y elegantes.

Entre sus características podemos encontrar su compatibilidad con PHP 4 y PHP 5, incorpora el modelo MVC, soporte para múltiples bases de datos, plantillas, validaciones, no requiere instalación, podemos encontrar una librería con un gran número de clases.

Podemos descargarlo y descomprimir este paquete dentro un directorio en nuestro servidor web.

Cómo instalar CodeIgniter:

Debemos acceder al archivo “application/config/config.php” e introducir la URL de nuestro sitio. Si realizaremos conexiones con nuestro servidor de base de datos necesitaremos configurar el archivo “application/config/database.php” e introducir los datos necesarios para realizar la conexión como son: host del servidor, usuario, contraseña, nombre de la base de datos, driver a utilizar (mysql, postgre, oracle, etc).

Crea tu primera aplicación con CodeIgniter:

CodeIgniter framework contiene un directorio donde se crearán las vistas “view” y los controles “controllers”. Crearemos nuestra primera vista en “application/views/” y la llamaremos “aplicacionview.php” con el contenido:

<html>
<head>
<title><?=$title;?></title>
</head>
<body>
<h1><?=$heading;?></h1>
<h3>Mi aplicación</h3>
<ul>
<?php foreach($todo_list as $item):?>
<li><?=$item;?></li>
<?php endforeach;?>
</ul>
</body>
</html>

Luego crearemos el control para esta vista en “application/controller/” llamado “aplicacion.php” con el siguiente código:

<?php
//Aplicación es el nombre del control
class Aplicación extends Controller {

	function index()
	{
		//utilizamos un array
		$data['todo_list'] = array('Chat', 'Encuesta', 'Correo');
		// títulos y bienvenida de la aplicación
		$data['title'] = "Mi aplicación";
		$data['heading'] = "Bienvenidos a mi aplicación";

//nombre de la vista que deseamos cargar
		$this->load->view('aplicacionview', $data);
	}
}
?>

Para ver nuestra aplicación solo basta con introducir en la URL: http://localhost/CodeIgniter/index.php/aplicacion/

CakePHP

CakePHP es un Framework similar a CodeIgniter de desarrollo rápido. Es una estructura de librerías y clases para programar aplicaciones web. Su base es el Framework de Ruby on Rails.

Nos brinda la posibilidad de interactuar con las base de datos, usando ActiveRecord. Incorpora el patrón MVC, compatible con PHP4 y PHP5, URLs amigables, Soporta AJAX, incluye caching, validación.

Debemos descargarlo, descomprimirlo y hacer un directorio. La estructura de directorios es la siguiente:

.../(Directorio donde se encuentra instalado)
    /app
        /config
        /controllers
        /models
        /plugins
        /tmp
        /vendors
        /views
        /webroot (se incluirán imagines, javascript, css)
        .htaccess
        index.php
    /cake
    /vendors
    .htaccess
    index.php

El directorio “app/tmp/” debe tener permiso de escritura. Podemos observar el sitio en http://localhost/cake/. Para editar la página es necesario crear un documento dentro del directorio “/app/views/pages/” con el nombre “home.html“:

<h1>PRUEBA</h1>

Para modificar el diseño se debe crear un documento en “/app/views/layouts/” con el nombre “default.html”:

<html>
<head>
<title><?php echo $title_for_layout?></title>
</head>
<body>
<!-- Aquí se mostrarán las vistas -->
<?php echo $content_for_layout ?>
</body>
</html>

También podemos hacer uso de controles, modelos, entre otros.

PHP on TRAX

El PHP on TRAX es compatible con PHP5, incluye el patrón MVC, incluye validación y AJAX, múltiples bases de datos. Podemos descargarlo y descomprimirlo hacia un directorio en nuestro servidor web.

Zoop Framework

Zoop es un Framework PHP Orientado a Objeto basado en el modelo MVC, sus desarrolladores lo caracterizan por ser rápido, eficiente y fácil destinado para programadores.

Requiere PHP 4.3.10 o superior, además podemos contar con librerías para “PEAR”. Cuenta con soporte e integración con AJAX, caching, validación, sistemas de plantillas Smarty, creación de PDF, plantillas para el envío de correo electrónico usando SMTP, cuenta con compatibilidad con múltiples base de datos.

Debemos descargar los archivos que encontramos en el repositorio y descomprimirlos hacia un directorio de nuestro servidor web. Los usuarios pueden encontrar en su comunidad: blog, foros de discusión, listas de correo, documentación, video demostraciones, ejemplos sobre el uso de las librerías “Prototype”.

Luego nos permite acceder al directorio de “skeleton” y configurar el archivo “config.php”, donde debemos definir la ruta del framework: define(’zoop_dir’, app_dir . “c:/apache/htdocs/zoop”);

WACT

Por sus siglas en ingles “Web Application Component Toolkit” es un frameworks para el desarrollo de aplicaciones web.

Facilita un aprovechamiento modular, sus componentes permiten la integración con otras aplicaciones web. Implementa el patrón MVC. La versión actual de WACT requiere PHP 5, por ahora solo está disponible desde Subversión.

AKELOS PHP FRAMEWORK

Es una plataforma de desarrollo de aplicaciones web basado en el MVC (Modelo Vista Controlador), patrón de diseño. Sobre la base de las buenas prácticas, que lo permite:

1.- Escribir opiniones usando Ajax fácilmente
2.- Control de las solicitudes y las respuestas a través de un controlador
3.- Gestión de aplicaciones internacionalizadas
4.- Comunicar los modelos y la base de datos mediante simples convenciones

Su Akelos puede ejecutar aplicaciones basadas en la mayoría de los proveedores de servicios de alojamiento compartido, ya que sólo requiere Akelos PHP estará disponible en el servidor. Esto significa que el Akelos PHP Framework es el candidato ideal para la distribución independiente de las aplicaciones web, ya que no requiere ningun estándar para ejecutar la configuración de PHP. Descargar Akelos.

Como solucionar el conflicto entre JQuery y Prototype usando Akelos PHP Framework

Como sabemos JQuery y Prototype son frameworks escritos en Javascript que permiten simplificar la manera de interactuar con documentos HTML orientándose al desarrollo sencillo y dinámico de aplicaciones web.

Akelos PHP Framework es una plataforma de desarrollo de aplicaciones web basado en el MVC (Modelo Vista Controlador) desarrollado por Bermi Ferrer, el cual contiene las buenas prácticas permitiendo simplificar el tiempo de implementación.

Bueno después de esta pequeña introducción, vamos a nuestro caso:

A veces queremos manejar eventos, desarrollar animaciones y agregar interacción con la tecnología AJAX a nuestras aplicaciones web y para ello decidimos usar JQuery, pero como Akelos por defecto usa el Prototype hay un probrema de compatibilidad, entonces para poder solucionar este problema:

Para nuestro ejemplo nos vamos al directorio view / layouts porsupuesto dentro de nuestra aplicación y seleccionamos main.tpl (puede ser otro tpl, pero se recomienda que sea en el principal).
La librería Prototype ya está funcionando así que la llamamos:

<%= javascript_include_tag ‘prototype’ %>
<%= javascript_include_tag ‘scriptaculous’ %>
<%= javascript_include_tag ‘editam’ %>

Luego después de haber instalado nuestra librería JQuery en (se recomienda en este directorio) : public / javascripts / jquery.js la llamamos en nuestro tpl:

<%= javascript_include_tag ‘jquery’ %>
<%= javascript_include_tag ‘treeview’ %> (un plugin jquery de ejemplo)

Al final de las llamadas Prototype y Jquery ingresamos esta pequeña línea de código:

<script>jQuery.noConflict();</script>

Ah y no te olvides de cambiar el caracter “#” por “jQuery”, por ejemplo:

Antes:

function change_visibility(url,container){
#(container).html(‘<b style=”color:blue”>_{Updating}…</b>’);
#(container).load(url);
}

Despues:

function change_visibility(url,container){
jQuery(container).html(‘<b style=”color:blue”>_{Updating}…</b>’);
jQuery(container).load(url);
}

Y ya está solucionado el problema de trabajar con estos dos grandes frameworks.

Nota: Todas las llamadas a los scripts se deben ingresar antes del script que evita el conflicto.

Akelos : Time Zones

Primero tenemos que tener en cuenta que debemos activar “getters” and “setters”, que son metodos con los cuales podemos procesar los atributos de un objeto, antes de grabarlos o llamarlos. Para activar getters and setters debe escribir la siguiente linea en config.php:

define(‘AK_ACTIVE_RECORD_ENABLE_AUTOMATIC_SETTERS_AND_GETTERS’, true);

Para manejar TimeZones, debemos tener un punto de referencia absoluto, por eso vamos a guardar todas las fechas en GMT y formato datetime (SQL), lo guardamos en formato datetime y no timestamp para aprovechar las funciones SQL (tipo DateAdd o Datediff dependiendo de la plataforma)  y para mayor entendimiento en caso de una revision visual de la base de datos.

Hay que tener en cuenta que la conversion de fechas solo lo haremos desde el servidor, osea no vamos a cambiar nada en la base de datos, solo definir campos datetimes.

Para convertir una fecha a GMT necesitamos 2 variables, la FECHA y el TIMEZONE del usuario y lo mismo si queremos convertir la fecha GMT (sacada de la base de datos) al Timezone del usuario. Akelos viene integrado con una clase muy util llamada AKTimeZone, esta clase nos ayudara a facilitar el proceso.

Entonces lo primero que tenemos que hacer es llamar a la clase AKTimeZone e inicializar un objeto AKTimezone que nos ayudara a hacer las conversiones.

Vamos al archivo shared_model.php y incluiremos la clase AKTimezone y para inicializar el objeto lo haremos dentro del metodo init(). Hay que tener en cuenta que cuando incluimos la clase AKTimezone automaticamente cambia el timezone del sistema a GMT.

require_once(AK_LIB_DIR.DS.’AkLocalize’.DS.’AkTimeZone.php’);
require_once(AK_LIB_DIR.DS.’AkActiveRecord.php’);

class ActiveRecord extends AkActiveRecord
{
var $my_timezone;

function init($attributes)
{

if(@empty($_SESSION['timezone']['name'])) $_SESSION['timezone']['name'] = ‘UTC’;
$_AkCurrentZone = new AkTimeZone();
$this->my_timezone =& $_AkCurrentZone->create($_SESSION['timezone']['name']);

return parent::init($attributes);

}

Ten en cuenta que debes tener a la mano el Timezone del usuario en este caso yo lo tengo en la variable $_SESSION['timezone']['name'], con esto ya puedes crear el objeto que nos ayudara para las conversiones.

Dado que AKTimezone configura el sistema en GMT, no es necesario crear ningun metodo para guardar en GMT las fechas generadas por created_at o updated_at.

Lo que si tenemos que hacer es crear un Getter para cada fecha GMT que queremos mostrar con el Timezone del usuario actual. Aqui un ejemplo de mostrar created_at en el Timezone actual del usuario, fijate que el getter debe ser escrito de manera CamelCase.

function getCreatedAt(){
$var = $this->created_at;
$converted = gmmktime(substr($var,11,2),substr($var,14,2),substr($var,17,2),substr($var,5,2),substr($var,8,2),substr($var,0,4));
return gmdate(“Y-m-d H:i:s”,$this->my_timezone->adjust($converted));//my time
}

Para llamar un getter en el View hay 2 formas, presta atención que los getters and setters solo son ejecutados con este tipo de llamadas:

$sale->get(‘created_at’)
{sale.created_at?}

Este tipo de llamada NO activaran los getters and setters:

$sale->created_at

En el caso que tengamos un campo en un formulario, donde el usuario ingresa una fecha, tenemos que convertir la fecha ingresada a GMT y despues ajustarla usando el Timezone del usuario, pero esto lo haremos solo cuando vaya a ser grabado en la base de datos. Aqui un ejemplo suponiendo que el campo se llame “user_input_date” :

function beforeSave(){
$var = $this->user_input_date;
$converted = gmmktime(substr($var,11,2),substr($var,14,2),substr($var,17,2),substr($var,5,2),substr($var,8,2),substr($var,0,4)); $this->user_input_date = gmdate(“M d Y H:i:s”,$this->my_timezone->unadjust($converted));
return true;
}

Y con esto cubrimos el manejo de zonas horarias (Time Zones) en akelos.

Extendido

1. Si estas preocupado por TimeZones con DST, no debes tener preocupaciones, la clase AKTimeZone deja que el sistema operativo se encargue de dar el “offset” correcto para el timezone usado, osea tu única preocupación es que el sistema operativo del servidor tenga sus librerias de zonas horarias actualizadas.

2. $_SESSION['timezone']['name'] contiene el nombre del timezone (ejm: America/Chicago, America/Costa Rica), eso significa que cada usuario debe tener un campo en la base de datos con su respectivo nombre de Timezone. Si  tienes un sistema de usuarios y solo tienes guardado el offset de cada usuario (ejm: -09:00,+05:00), esta información no es suficiente en el mundo real, ya que cada pais y region tiene sus propias reglas horarias y reglas DST, por lo cual es obsoleto guardar solo el offset, la manera correcta es guardar la zona horaria.

3. AKTimeZone viene con algunos metodos bastante utiles. por ejemplo toString() el cual imprimira : “(GMT+01:10) TimezoneActual”, si quieres usarlo con los ejemplos previos, puedes usarlo asi:

<div align=”right”>_{Current Time Zone} : <?php echo $my_timezone->toString() ?></div>

En caso quieras generar una lista “select” de TimeZones puedes usar el metodo getTimezones() que devolvera un array de los timezones. para generar el codigo akelos completo puedes hacerlo asi:
<? echo $form_options_helper->select(‘user’, ‘timezone’, array_keys($my_timezone->getTimezones())); ?>

4. Debes saber que la clase AKTimeZone ya viene con timezones definidos lo cual seria un problema si mas adelante aparece un timezone nuevo, por lo cual debes tomar las medidas necesarias para enfrentar estas situaciones como por ejemplo teniendo una tabla de timezones en la base de datos.

Manually install an Akelos project in development

Akelos is a PHP Framework designed to be as close as possible to the Ruby on Rails framework, but in PHP.

When developing a web application with Akelos in a group of several developers, and until an installation procedure has been put in place, you might want to manually install the application from the sources. This document will take you through the step of doing just that. It is based on the asumption that you have a general directory with a copy of the Akelos repository and you own application as subdirectories.

First, make sure you have defined a Virtual Host in Apache to point to the main directory (the directory containing both Akelos and your application). This might be improved later on by only using the application directory, but considering we are still in the development phase, we don’t really care (do we?).

If you go to your Virtual Host with a web browser at this point, you will see that Akelos shows up with a wizard asking you to configure Akelos. This is not what we want. We don’t want to configure Akelos, we want to configure our application. Just leave this page as is.

Second, we want to create a configuration file and a route file to enable the retrieval of our application. Entering the config/ directory, you will see two files there, called DEFAULT-config.php and DEFAULT-routes.php. Make a copy of both under the names config.php and routes.php.

localhost:/var/www/myapp$ cd config

localhost:/var/www/myapp$ cp DEFAULT-config.php config.php

localhost:/var/www/myapp$ cp DEFAULT-routes.php routes.php

Now that you have those two new files, edit config.php.

localhost:/var/www/myapp$ vi config.php

In config.php, you need to update the three databases informations. If you don’t have a database user with permissions to create databases, you should make sure you prepare it before you go any further. Check the Akelos documentation to know more about the three databases. The idea is that you need one that has a meaningful name for the project for the production part. For example, if my application is called “myapp”, then my production database name could be “myapp”. My development database name could be “myapp_dev” and my test database name could be “myapp_test”.

Also make sure that the AK_FRAMEWORK_DIR constant defined at the end of the script is pointing directly to your akelos directory. In this example, the value would be: ‘/var/www/myapp/akelos’

To avoid noisy permission errors, you have to make the config/, tmp/, app/installers/versions/ and app/locales/ directories writeable by the web browser. You could do that ugligly by allowing anyone to write on these directories. Don’t do this in production environments!

localhost:/var/www/myapp$ sudo chmod -R 0777 config tmp app/installers/versions app/locales

That’s it. Now you need to generate the databases structure from the Akelos scripts.

localhost:/var/www/myapp$ ./script/migrate myapp install

In the event of having inclusion problems, like me, with constants.php, it might be that you haven’t read well my comment on the AK_FRAMEWORK_DIR constant above. Make sur you fix this and try again.

This should now give you a considerable amount of output, ending with something (if using MySQL) like:

(mysqlt): COMMIT
—–
—–
(mysqlt): SET AUTOCOMMIT=1
—–
Smart Commit occurred

localhost:/var/www/myapp$

Now, by pointing your browser to your Virtual Host, and possibly apending the name of a controller to your url, you should be able to start testing the current state of development.