Nueva modificación Weblib.php

Después de varios días trabajando con la capa de presentación, y aconsejados por algunos miembros del DFWikiteam, modificamos el weblib.php.

Las funciones creadoras de los tags, pasarán a tener como mucho tres parámetros de entrada. Para ello utilizaremos un objeto que contenga todas las propiedades de los tags, en vez de tener un parámetro de entrada para cada atributo. De este modo conseguimos que la capa de presentación sea más sencilla, tanto a la hora de utilizarla, como a la hora de modificarla.

Una de las grandes ventajas de este cambio, es que si necesitamos una nueva propiedad para un tag, únicamente tendríamos que modificar la función, añadiendole al objeto la nueva propiedad. Pero este cambio no supondría modificar todas las llamadas que ya habíamos realizado a esta función, ya que los parámetros seguirían siendo los mismos.

En breve colgaremos un nuevo manual para la utilización del nuevo weblib.php

Cumple XHTML Strict

Por fin!!!

Después de semanas de trabajo, modificando el código de los archivos principales de la nwiki, hemos conseguido que cumpla XHTML Strict.

De aquí a final de proyecto, nuestro objetivo es modificar el código de la nwiki, que todos los archivos utilicen el weblib.php, es decir, la nueva capa de presentación. Además, tenemos que ampliar el nwiki.css, creando nuevos estilos propios utilizados para la creación del código html.

Manual Weblib.php

Este manual es una ayuda para que los desarrolladores del DFWikiTeam puedan utilizar el weblib.php. Este fichero complementa al weblib de moodle y actúa como capa de presentación. Contiene una serie de funciones para crear las diferentes etiquetas de HTML que utilizamos.

Puntos importantes para la utilización de weblib.php:

• CUMPLE XHTML STRICT

Todas las funciones tienen como parámetros únicamente aquellos atributos de los tags que se utilizan para el desarrollo de la nwiki y siguen el XHTML Strict. De este modo conseguimos que las etiquetas creadas con la utilización de este fichero cumplan el estándar.

La mayoría de atributos que no cumplan el estándar se pueden definir en el atributo class o style. Estos atributos están contenidos en todas las etiquetas. Su función es la de asignar al tag un formato o estilo, cumpliendo las normas de XHTML Strict. Este formato puede estar definido en una hoja de estilo (css), y por lo tanto utilizaríamos el atributo class para asignarle la clase ya definida, o mediante el style, en caso de que no este declarado.

Ejemplo:
wiki_change_column('', 'top', '', '', '', 'width:1%;white-space:nowrap');
sería
</td><td valign="top" style="width:1%;white-space:nowrap">

• PARÁMETRO RETURN

Todas las funciones tienen como último parámetro la variable $return, inicializada por defecto a false.

En caso de ser false, la función escribiría el tag directamente. Y si lo cambiásemos a true, la función retornaría una variable con la etiqueta.

• CREACIÓN DE TAGS

Todas las funciones siguen un mismo patrón para el orden de sus parámetros.

Si la etiqueta tiene información entre la apertura y cierre de ésta, la función tendrá un primer parámetro ($info), que contendrá dicha información. A excepción de las tablas y listas, que se explicarán más adenate.

Los parámetros estilo y clase siempre se ubican en la penúltima y antepenúlima posición. A excepción de la etiqueta
que no tiene formato.

Como hemos dicho anteriormente, la variable $return está ubicada como último parámetro.

El resto de parámetros dependerá de los diferentes atributos que puedan tener las etiquetas.

• Creación de tablas

Para la creación de tablas tenemos varias funciones:

wiki_table_start($border=0, $width='', $padding='', $spacing='', $class='', $style='',
$aligntd='', $valigntd='', $colspantd='', $rowspantd='', $classtd='', $styletd='', $return=false)
Inicia tabla, fila y columna, con las respectivas propiedades. Los seis primeros parámetros son atributos de la tabla y los seis siguientes de la primera columna.

wiki_table_end($return=false)
Cierra una columna, fila y tabla.

wiki_change_column($align='', $valign='', $colspan='', $rowspan='', $class='', $style='', $return=false)
Cierra columna e inicia una nueva con las propiedades correspondientes.

wiki_change_row($align='', $valign='', $colspan='', $rowspan='', $class='', $style='', $return=false)
Cierra columna y fila e inicia una nueva fila y una columna con las propiedades correspondientes.

Ejemplo:
wiki_table_start('0','100%','','','','','right');
echo '1';
wiki_change_row();
echo '2';
wiki_table_end();
sería
<table width="100%" border="0">
<tr><td align="right">
1
</td></tr><tr><td>
2
</td></tr>
</table>

• Creación de listas

Para crear las listas tenemos varias funciones que siguen la misma mecánica que las utilizadas para la creación de tablas.

wiki_start_ul($class='', $style='', $classli='', $styleli='', $return=false)
Inicia una lista no ordenada y el primer ítem

wiki_end_ul($return=false)
Cierra el último ítem y la lista no ordenada

wiki_change_li($class='', $style='', $return=false)
Cambio de ítem

Para las listas ordenadas las funciones son iguales.

Comienzo de creación de Weblib.php

Tras varias pruebas decidimos que el enfoque que habíamos dado para crear este fichero no era el correcto, y decidimos seguir otro proceso, creando un fichero, que complementa el weblib de moodle, adaptandose más a nuestras necesidades.

Este fichero contiene una serie de funciones para crear las diferentes etiquetas de HTML que utilizamos, teniendo como parametros únicamente propiedades de los tags que sigan el estándar XHTML Strict.

Cambio de versión!!!

Tras conseguir que la nwiki para moodle 1.7 cumpliese el XHTML Transitional, el grupo de desarrolladores DFWikiTeam da por cerrada la versión para 1.7, y empezamos el desarrollo de la nwiki para moodle 1.8.

Esta versión utiliza el XHTML Strict y por lo tanto nuestro objetivo es conseguir que la nwiki también lo cumpla.

Este objetivo, además de mejorar la accesibilidad, es actualmente el requisito indispensable para que la nwiki pase a ser el módulo oficial de moodle.

Nuevo enfoque del proyecto

Durante esta última semana hemos estado arreglando todo el código para que cumpliese el estándar XHTML transitional.

Nos dimos cuenta que en casi todos los ficheros había código html y tras la reunión del miércoles se decidió separar la presentación de los datos.
Para ello crearemos un fichero nuevo llamado weblib.php donde situremos todo lo relacionado con la presentación (todos los tags de html).
Como supone mucho trabajo, hemos decidido realizar el proceso en dos pasos.

1. Trasladar todo el código html a nuestro fichero sin tener en cuenta si hay información de dominio mezclada.
   
2. Después de haber aislado el código html en un único fichero, crearemos nuevas funciones para conseguir los datos del dominio necesarios, y así separar por completo la presentación, creando una nueva capa.

A medida que vayamos haciendo nuevas funciones, iremos informado a los proyectistas para que hagan uso de ellas!

Nos mudamos a la Farga

SourceForge solo es para versiones estables y después de hablar con parte del DFWikiteam, nos trasladamos a LaFarga!!!!

Además, siguiendo los consejos de Pigui, utilizaremos el cvs que lleva integrado eclipse en vez de Tortoise.