Diferencia entre revisiones de «Módulo Drupal Guifi.net»

De Guifi.net - Wiki Hispano
 
(No se muestran 15 ediciones intermedias realizadas por 3 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 Gitorious<ref>http://gitorious.org/guifi/drupal-guifi</ref>.
+
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 Gitorious<ref>http://gitorious.org/guifi/portada</ref>.
+
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 11: Línea 11:
 
* Gestión de zonas y nodos
 
* Gestión de zonas y nodos
 
* [https://guifi.net/guifi/menu/stats/growthmap Mapa de crecimiento]
 
* [https://guifi.net/guifi/menu/stats/growthmap Mapa de crecimiento]
−
* [[Unsolclic]]
+
* [[Unsoloclic]]
  
 
=== API ===
 
=== 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.
 
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/<ref>http://gitorious.org/guifi/drupal-guifi/trees/master/contrib</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>.
  
−
[http://guifi.net/sites/all/modules/guifi/contrib/api_doc/index.php Documentació de l'API de guifi.net] {{ca}}
+
Las acciones posibles que se pueden realizar desde la API son las siguientes:
 +
 
 +
<!-- Insertar en orden cronológico inverso!! -->
 +
 
 +
{| class="wikitable sortable"
 +
|- style="background:#ececec;"
 +
! 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
 +
|}
 +
 
 +
<pre>
 +
'''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
 +
</pre>
 +
 
 +
=== 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 [https://guifi.net/es/node/38115 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 [[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].

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. ↑ https://github.com/guifi/drupal-guifi
  2. ↑ http://gitorious.org/guifi/portada
  3. ↑ https://github.com/guifi/drupal-theme_guifinet2011
  4. ↑ https://github.com/guifi/drupal-guifi/tree/master/contrib/api_doc
  5. ↑ https://github.com/guifi/drupal-guifi/tree/master/contrib/api_client
  6. ↑ https://lists.guifi.net/pipermail/guifi-webdev/2011-March/001083.html

Véase también

Enlaces externos

Obtenido de «http://es.wiki.guifi.net/w/index.php?title=Módulo_Drupal_Guifi.net&oldid=4319»
Herramientas personales