Manual de instalación de nuevos blogs de proyectos

De cara a facilitar la instalación de nuevos blogs de proyectos en la comunidad Morfeo, se ha creado una guía de instalación y configuración. Esta guía está disponible aquí.

Instalando un weblog en Morfeo

Ampliaciones a Wordpress

El nuevo Website de la Comunidad Morfeo requiere, además de las funcionalidades típicas de un blog y las que ofrecía la antigua Web (con Joomla), servir como agregador de noticias y eventos de los distintos proyectos que en ella se desarrollan. Para conseguir todo esto, se han añadido los siguientes plugins:

  • Language Switcher: permite mantener un blog bilingüe o multilingüe posibilitando la traducción tanto de contenidos como categorías, opciones de administración, etc. Para su instalación se deben seguir los pasos recomendados en http://www.poplarware.com/bilingualblog.html, en los que se requiere la reescritura de algunos ficheros de Wordpress para adaptarlos a las necesidades del plugin, y se ha instalado el plugin disponible en http://www.poplarware.com/languageplugin.html. Además es necesario añadir las traducciones (para más documentación sobre cómo obtener las traducciones de los términos de un template visitar: http://www.poplarware.com/languageplugin.html) que se deseen en la carpeta languagesdel directorio wp-includes de la instalación de Wordpress (ficheros .po y .mo).
  • Collapsing Page Menu: muestra una lista no ordenada de páginas estáticas que se pliega o despliega en función de la página actual.
  • Friends RSS Aggregator: agrega un conjunto de feeds RSS de otros blogs organizados en categorías. Sobre este plugin, obtenido de http://adam.404.org/projects/friends-rss, se han realizado varias modificaciones debido a que no es compatible con la versión 2.2 de Wordpress. Por ello, se ha cambiado en el fichero >friends_rss.php la llamada a la función get_linkobjectsbyname, que está obsoleta, por get_bookmarks(“category_name=$category”). Del mismo modo, se ha modifiado este fichero para compatibilizar este plugin con el de Language Switcher. Así, obtiene el lenguaje en el que se deben mostrar los elementos del RSS mediante las funciones proporcionadas por el plugin del lenguaje. Además, Se ha modificado el fichero wp-admin/index-extra.php para evitar un posible error en la pantalla inicial de administración, comentando la línea 3:
  • require_once (ABSPATH . WPINC . ‘/rss.php’);

    Por otro lado, la funcionalidad de este plugin no cubre todas las necesidades que han ido surgiendo a lo largo de la ampliación del Website de Morfeo, por lo que ha sido mejorado en la FI-UPM para que aporte toda la funcionalidad necesaria, cambiando su nombre a RSS Aggregator. Así, se ha modificado la administración de este plugin para que contemple el hecho de manejar varios RSS organizados en categorías, de forma que sea posible, dependiendo de las necesidades, agregar únicamente los RSS pertenecientes a una determinada categoría. Además se ha modificado la configuración del plugin (en el fichero wp-content/plugins/rss-aggregator/rss_fetch.inc) para que el acceso a los distintos feeds sea realizado a través de un Proxy. Otra mejora realizada sobre este plugin es que se ha añadido la posibilidad de establecer un proceso Cron que actualice la caché de RSS automáticamente para que en el acceso al Website estén ya agregados los RSS necesarios. Además, se ha establecido un tiempo máximo de vida de la caché de 60 minutos (en el fichero wp-content/plugins/rss-aggregator/rss_aggregator.php), de forma que, si no existe un proceso Cron que realice la sincronización, se llevará a cabo una actualización de la caché con el primer acceso al Websiteque se realice pasado dicho tiempo.

  • PJW Mime Config: permite extender la lista de tipos mime soportados por la herramienta de subida de archivos de Wordpress.
  • Search Everything: permite ampliar las capacidades de búsqueda de Wordpress a elementos distintos a posts
    como, por ejemplo, páginas estáticas.
  • Social Bookmarking Reloaded: añade los iconos de los servicios de etiquetado social más utilizados a los contenidos mantenidos en el blog para facilitar su etiquetado. Este plugin también ha sido modificado para posibilitar que los posts creados en la categoría Eventos dispongan de un nuevo icono que permite añadir dicho evento a Google Calendar.
  • Simple Tagging: permite al autor de un contenido añadir palabras clave que serán mostradas en un Tag Cloud para facilitar las búsquedas y la navegación de los lectores.
  • BackupWordpress: permite al administrador realizar de forma sencilla un backup del blog, así como programar backups semanales o diarios.
  • Email Immunizer: proporciona protección frente a posible spam en los correos electrónicos que aparecen en los posts y páginas estáticas publicados en el weblog.Este plugin no necesita ser configurado ya que, de manera automática, modifica los correos electrónicos publicados cambiando aleatoriamente algunos de sus caracteres por el código ASCII asociado a los mismos. De esta forma se impidien que robots maliciosos puedan obtener la dirección del correo sin necesidad de que el usuario se percate de dicha actuación.
  • Random AntiSpam: proporciona protección frente a comentarios de tipo spam generados automáticamente por máquinas. Para llevar a cabo su tarea, este plugin obliga al usuario que desea realizar un comentario sobre un post a cumplimentar un código Captcha generado de manera aleatoria.El código Captcha generado dispone además de un soporte sonoro para facilitar la labor a personas con deficiencias visuales.

Estos plugins deben situarse en la carpeta wp-content/plugins de la instalación de Wordpress y activarse desde la zona de administración de Wordpress. Una vez instalados se podrá llevar a cabo su configuración, en caso de que fuese necesario.

Además de su instalación y configuración, muchos plugins requieren modificar el template para añadir determinada sentencia que permite mostrar los efectos de los plugins. Estas modificaciones se han llevado a cabo sobre un template creado para el website de Morfeo. Este template dota al website del aspecto estético deseado e incluye en él todas las
funcionalidades deseadas que permiten mostrar las funcionalidades que proporcionan los plugins descritos anteriormente.

Para la creación de este template (ubicado en wp-contents/templates/morfeo) se han añadido determinados ficheros específicos que no son estándares a todos los templates de Wordpress. Estos son:

  • El fichero navbar.php permite especificar un array cuyos pares clave-valor conformarán la barra de navegación basada en pestañas del website. De esta forma, si se desea añadir un nuevo elemento se deberá añadir un nuevo elemento, cuya clave será el texto que se desea mostrar y cuyo valor será la dirección del enlace al que apuntará la nueva pestaña.
  • El fichero linkfeeds_by_date.php añade un nuevo formato de una página que muestre los eventos agregados de los blogs de los proyectos asociados a la comunidad. Este formato debe tener el mismo aspecto que el del resto del template. En el paquete que se distribuye esta acción ya está realizada.
  • Los ficheros pagetemplate.simpletagging.php y sidebartag.php permiten dar un formato adecuado a la página generada al consultar las entradas que se encuentran etiquetadas con uno o varios tags. El primero de ellos se encarga del cuerpo central de la página y el segundo de los menús laterales. Al igual que en el caso anterior, deben mantener el mismo aspecto que el resto del template. En el paquete que se distribuye esta acciónya está realizada.
  • El fichero logos.php permite incluir tanto los logos de las entidades financiadoras como los logos de los miembros del proyecto. En este fichero pueden especificarse el nombre, la URL y el logo de cada entidad para que esta información sea mostrada en la sección “subvencionado por”, en el caso de los logos de los financiadores, y en la sección “miembros”, en el caso de los logos de colaboradores. Si no se desea que se muestren estas secciones basta con no incluir ninguna referencia a entidades en el fichero logos.php. Además, el directorio logos es el destinado al almacenamiento de los logos de las entidades especificadas en el fichero logos.php.
  • Los ficheros ie.css e iefixes.js permiten una visualización correcta del website en el navegador Internet Explorer 6 y 7. Como aclaración recalcar que el fichero style.css garantiza la correcta visualización en el navegador Firefox.

Buenas prácticas de edición

Wordpress permite gestionar dos tipos de contenidos: páginas estáticas y posts. Para editar contenidos de ambos tipos, la herramienta dispone de un editor de texto que permite tanto editar directamente en formato HTML como en modo WYSIWYG. La instalación básica de Wordpress proporciona un editor TinyMCE con una configuración bastante simple, por lo que, para facilitar el modo de edición de contenidos en el Website de Morfeo, se ha aumentado la funcionalidad de este editor según las necesidades, realizando algunos cambios en su configuración inicial siguiendo las pautas marcadas en http://tinymce.moxiecode.com.

Reglas de edición

Una vez autenticado en el sistema, la edición de contenidos se puede llevar a cabo en el menú de administración Escribir/Escribir entrada (o Escribir página, en el caso de páginas estáticas).

writepage_es.bmp

Una guía rápida de cómo escribir un contenido en Wordpress se encuentra en: http://codex.wordpress.org/Writing_posts. A modo de resumen, los pasos más importantes son:

  1. Establecer el título del contenido. Al tratarse de un blog multilingüe, para mostrar el título del contenido en los idiomas deseados es necesario englobar la traducción del título entre las etiquetas

    etiquetas de traducción

    donde xx es el código ISO del idioma en cuestión. Por ejemplo, el título “Primer Post” en dos idiomas (español e inglés) se expresaría:

    ejemplo 1

  2. Establecer el Nombre de URL o Slug. Es necesario definir una palabra clave que identifique el contenido de forma única, ya que este texto será utilizado para formar la URI con que se accederá al mismo (debido a que en las URIs se utiliza un formato amigable para el lector). Una buena práctica es añadir la fecha actual a la palabra clave utilizada para asegurar su unicidad. Así, si el Slug del post del ejemplo anterior es firstpost_DDMMYY, en lugar de formar la URI del mismo con su título,

    ejemplo 2

    la URI resultado será

    dominio/archives/firspost_DDMMYY.

  3. Establecer la categoría o categorías del contenido de un post. Wordpress permite clasificar los post mantenidos en distintas categorías. Esta acción puede llevarse a cabo mediante el campo Categorías del menú de escritura de un post.

    categorias_es.bmp

    En este menú es posible también añadir una nueva categoría en el momento de creación del post. Debido al carácter multilingüe del Website, es necesario indicar las posibles traducciones del nombre de la categoría mediante las etiquetas:

    etiquetas de traducción

    CATEGORÍAS ESPECIALES
    Si se considera que un post puede ser interesante para el resto de la comunidad, debe incluirse en la categoría que represente a los interesados. En el ejemplo de la figura, podría marcarse un post determinado como de “interés para Morfeo” incluyéndolo en la categoría Morfeo’s relevant con lo que dicho post se mostraría, además de en el blog donde se publilca, en el blog de la comunidad Morfeo. Asimismo, si se desea que un post quede reflejado en la web del chapter que lo contiene, debe ser categorizado como <CHAPTER>’s relevant, esto es, de “interés para <CHAPTER>”. Del mismo modo, la categoría Events representa a los eventos relevantes para la comunidad Morfeo, y por lo tanto, serán mostrados también en el blog de Morfeo y, en su caso, en el blog del chapter padre.
    En el caso de tratarse de un chapter, si se desea enviar información a los hijos del mismo, el post debe ser publicado en la categoría cuyo nombre se corresponde con el de dicho chapter. Por ejemplo, tratándose del chapter Business Support, un post que fuera de interés para todos sus hijos debería publicarse en la categoría “Business Support”.
    Por otro lado, en el caso de publicar en el blog del chapter Morfeo un post de interés para todos los proyectos y chapters hijos del mismo, este contenido debe categorizarse como de “interés para Morfeo”, debido al carácter especial de dicho chapter.
    En los blogs chapters este comportamiento se encuentra establecido por defecto, es decir, si no se indica manualmente ninguna categoría mediante la sección Categorías, el post se incluirá automáticamente en la categoría encargada de propagar la información a los blogs hijos (en el ejemplo anterior, categoría “Business Support” y en el caso de Morfeo, “interés para Morfeo”). En caso de indicar alguna categoría de forma manual, el comportamiento establecido por defecto no se aplica (en el ejemplo anterior, la categoría “Business Support” dejaría de añadirse por defecto), por lo que el editor del post es el responsable de seleccionar las categorías adecuadas.

  4. Rellenar el contenido. Si se desea ofrecer varias traducciones de un mismo contenido es necesario, al igual que en el caso del título, indicar el idioma de cada una de las traducciones disponibles. Para ello, cada traducción debe estar englobada entre las etiquetas de traducción del lenguaje.
  5. uso de las etiquetas del lenguaje

  6. Elegir las opciones de edición. El editor WYSIWYG ampliado del que dispone el Website consta de las funcionalidades básicas de edición (listas, tablas, estilos, etc.) junto con otras funcionalidades adicionales como abrir el editor en una ventana completa para ver el texto en su totalidad y mostrar el código HTML en una nueva ventana.
  7. editor WYSIWYG

  8. Extraer un resumen de un post. En caso de contenidos extensos, es recomendable establecer una parte del contenido del post como resumen del mismo para que éste sea mostrado en los listados de entradas en lugar del post completo. Esta división se puede llevar a cabo mediante la inclusión de la etiqueta <!–more–> (en formato de comentario HTML) desde el editor HTML (o mediante su correspondiente boton en el editor visual). En el caso de ofrecer un post en varios idiomas, la inclusión de la etiqueta <!–more–> requiere un cuidado especial. Es necesario que antes de su inclusión se encuentre la traducción del fragmento resumen en todos los idiomas ofrecidos y después de dicha etiqueta, las traducciones del resto del texto. Así, el siguiente post,

    etiqueta leer más

    en un listado de posts se visualizaría de la siguiente forma (en español):

    leer más

  9. Paginar un contenido estático. En caso de que una página estática sea demasiado extensa es conveniente dividir su contenido en varias páginas. Para ello debe utilizarse la etiqueta <!–nextpage–> desde el editor HTML y su utilización en conjunto con las etiquetas de traducción del lenguaje es análoga a la propia de la etiqueta <!–more–>.
  10. Subir ficheros. Es posible que un contenido conste de una imagen, un link a un fichero PDF, etc. Para añadir estos ficheros, en la página de edición de contenidos Wordpress dispone de un apartado especial para especificar el fichero
  11. herramienta upload

    y añadirlo al texto del editor

    añadir fichero al texto

    Para más información sobre cómo subir ficheros visitar http://codex.wordpress.org/Using_Image_and_File_Attachments

  12. Etiquetar el contenido: es posible definir un conjunto de etiquetas que categoricen el contenido editado. Si se trata de una lista de etiquetas, éstas deben separarse con comas (”,“).

Manual de edición en los weblogs de Morfeo

Para la correcta edición de posts y páginas estáticas en los weblogs de la comunidad Morfeo, se ha creado un manual de edición. Es recomendable que los editores de cada weblog lo tengan presente al realizar sus aportaciones para mantener un estilo de edición uniforme.

El manual está disponible aquí.

Tags: , ,