Diferencia entre revisiones de «Módulo Drupal Guifi.net»
De Guifi.net - Wiki Hispano
m |
|||
| (No se muestran 5 ediciones intermedias realizadas por 2 usuarios) | |||
| Línea 1: | Línea 1: | ||
La [[Web Guifi.net|web de Guifi.net]] funciona con el gestor de contenidos Drupal. | La [[Web Guifi.net|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 | + | 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 Github <ref>https://github.com/guifi/drupal-guifi</ref>. |
| − | La portada está diseñada mediante plantillas y se pueden encontrar en otro repositorio de | + | La portada está diseñada mediante plantillas y se pueden encontrar en otro repositorio de Github<ref>http://gitorious.org/guifi/portada</ref><ref>https://github.com/guifi/drupal-theme_guifinet2011</ref>. |
== Historial de cambios == | == Historial de cambios == | ||
| Línea 16: | Línea 16: | ||
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. | 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/<ref> | + | La documentación de dicha API se encuentra en el repositorio drupal-guifi, en la carpeta contrib/api_doc/<ref>https://github.com/guifi/drupal-guifi/tree/master/contrib/api_doc</ref> y en la url [http://guifi.net/sites/all/modules/guifi/contrib/api_doc/index.php 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/<ref>https://github.com/guifi/drupal-guifi/tree/master/contrib/api_client</ref>. |
Las acciones posibles que se pueden realizar desde la API son las siguientes: | Las acciones posibles que se pueden realizar desde la API son las siguientes: | ||
| Línea 140: | Línea 140: | ||
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. | 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 [[i18n#Traducción de la portada de la web|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 [https://guifi.net/admin menú de administrador]: [https://guifi.net/admin/content/image galería de imágenes]. Ahí se pueden encontrar todas las imágenes que hay subidas. | ||
| + | |||
| + | Para añadir una imagen nueva, [https://guifi.net/node/add/image 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.<ref>https://lists.guifi.net/pipermail/guifi-webdev/2011-March/001083.html</ref> | ||
== Referencias == | == Referencias == | ||
Última revisión de 17:53 3 sep 2017
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 Github [1].
La portada está diseñada mediante plantillas y se pueden encontrar en otro repositorio de Github[2][3].
Contenido
Historial de cambios
- Mapas y Google API v3, junio de 2012
Características
- Gestión de zonas y nodos
- Mapa de crecimiento
- Unsoloclic
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
- ↑ https://github.com/guifi/drupal-guifi
- ↑ http://gitorious.org/guifi/portada
- ↑ https://github.com/guifi/drupal-theme_guifinet2011
- ↑ https://github.com/guifi/drupal-guifi/tree/master/contrib/api_doc
- ↑ https://github.com/guifi/drupal-guifi/tree/master/contrib/api_client
- ↑ https://lists.guifi.net/pipermail/guifi-webdev/2011-March/001083.html
Véase también
Enlaces externos
- Sitio oficial de Drupal
- API (Wikipedia)
