Módulo Drupal Guifi.net

De Guifi.net - Wiki Hispano

(Redirigido desde «API de Guifi»)

La web de Guifi.net funciona con el gestor de contenidos Drupal.

Para añadirle las funcionalidades de documentación de red libre se usa un módulo especial llamado drupal-guifi. Este módulo es software libre y está disponible en el repositorio de Gitorious[1].

La portada está diseñada mediante plantillas y se pueden encontrar en otro repositorio de Gitorious[2][3].

Historial de cambios

Características

API

El módulo Drupal Guifi.net implementa una API que permite a los desarrolladores crear aplicaciones externas que consulten y modifiquen la base de datos de Guifi.net. Las peticiones a la API se realizan mediante consultas de tipo GET del protocolo HTTP.

La documentación de dicha API se encuentra en el repositorio drupal-guifi, en la carpeta contrib/api_doc/[4] y en la url Documentació de l'API de guifi.net. También hay disponible una librería PHP para trabajar más cómodamente con la API. Se puede encontrar en la carpeta contrib/api_client/[5].

Las acciones posibles que se pueden realizar desde la API son las siguientes:


Comando Descripción Ejemplo
guifi.auth.login Autentificar un usuario http://guifi.net/api?command=guifi.auth.login&username=&password=
guifi.zone.add Añadir una zona nueva http://guifi.net/api?command=guifi.zone.add
guifi.zone.update Actualizar una zona http://guifi.net/api?command=guifi.zone.update
guifi.zone.remove Borrar una zona http://guifi.net/api?command=guifi.zone.remove
guifi.zone.nearest Buscar la zona más cercana a un punto geográfico http://guifi.net/api?command=guifi.zone.nearest
guifi.node.add Añadir un nodo nuevo http://guifi.net/api?command=guifi.node.add
guifi.node.update Actualizar un nodo http://guifi.net/api?command=guifi.node.update
guifi.node.remove Borrar un nodo http://guifi.net/api?command=guifi.node.remove
guifi.device.add Añadir un nuevo dispositivo http://guifi.net/api?command=guifi.device.add
guifi.device.update Actualizar un dispositivo http://guifi.net/api?command=guifi.device.update
guifi.device.remove Borrar un dispositivo http://guifi.net/api?command=guifi.device.remove
guifi.radio.add Añadir una nueva radio http://guifi.net/api?command=guifi.radio.add
guifi.radio.update Actualizar una radio http://guifi.net/api?command=guifi.radio.update
guifi.radio.remove Borrar una radio http://guifi.net/api?command=guifi.radio.remove
guifi.radio.nearest Buscar las radios en modo AP más cercanas a un nodo http://guifi.net/api?command=guifi.radio.nearest
guifi.interface.add Añadir una nueva interfaz a una radio http://guifi.net/api?command=guifi.interface.add
guifi.interface.remove Borrar una interfaz de una radio http://guifi.net/api?command=guifi.interface.remove
guifi.link.add Añadir un nuevo enlace entre dos interfaces http://guifi.net/api?command=guifi.link.add
guifi.link.update Actualizar un enlace http://guifi.net/api?command=guifi.link.update
guifi.link.remove Borrar un enlace http://guifi.net/api?command=guifi.link.remove
guifi.misc.model Obtener los modelos de dispositivos soportados en Guifi.net http://guifi.net/api?command=guifi.misc.model
guifi.misc.manufacturer Obtener los fabricantes de dispositivos soportados en Guifi.net http://guifi.net/api?command=guifi.misc.manufacturer
guifi.misc.firmware Obtener los firmwares de dispositivos soportados en Guifi.net http://guifi.net/api?command=guifi.misc.firmware
guifi.misc.protocol Obtener los protocolos soportados en Guifi.net http://guifi.net/api?command=guifi.misc.protocol
guifi.misc.channel Obtener los canales de un protocolo soportados en Guifi.net http://guifi.net/api?command=guifi.misc.channel
'''MENSAJE OBTENIDO DE LISTAS DE CORREO PARA AGREGAR AQUI SI INTERESA'''
Para hacer uso de la capa de abstracción de base de datos que proporciona guifi_db.inc.php, o funciones ya desarrolladas tipo guifi_log, guifi_notify, etc

Roles de usuarios

Los roles definen lo que puede hacer cada usuario registrado. Por ejemplo: traducir páginas, modificar nodos que no son tuyos... etc.

Más información aquí en Roles de la web

Por defecto, el usuario tiene el rol más básico. Si necesitas más permisos para hacer algo, pídelos en alguna de las listas de correo como guifi-hispano, guifi-usuaris o guifi-rdes.

Portada

Cómo traducir la portada

Véase Traducción de la portada de la web.

Cómo añadir imágenes al 'slideshow'

Siendo administrador, se puede encontrar la opción desde el menú de administrador: galería de imágenes. Ahí se pueden encontrar todas las imágenes que hay subidas.

Para añadir una imagen nueva, subirla primero a Drupal. En el menú desplegable 'Imágenes' especificar Portada y especificar también el Idioma en el menú desplegable de más abajo.

NOTA: para que la imagen aparezca en todos los idiomas de la portada, deberá subirse tantas veces como idiomas haya y especificar cada vez un idioma distinto por cada imagen.

Las imágenes para la portada deben tener un tamaño de 910x454 píxeles.[6]

Referencias

  1. http://gitorious.org/guifi/drupal-guifi
  2. http://gitorious.org/guifi/portada
  3. https://gitorious.org/guifi-web/theme_guifinet2011
  4. http://gitorious.org/guifi/drupal-guifi/trees/master/contrib/api_doc
  5. http://gitorious.org/guifi/drupal-guifi/trees/master/contrib/api_client
  6. https://lists.guifi.net/pipermail/guifi-webdev/2011-March/001083.html

Véase también

Enlaces externos

Herramientas personales