Guifi.net - Wiki Hispano - Contribuciones del usuario [es]

Módulo Drupal Guifi.net

2017-09-03T16:53:38Z

Servia:

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 Github <ref>https://github.com/guifi/drupal-guifi</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 ==
* [https://lists.guifi.net/pipermail/guifi-rdes/2012-June/024678.html Mapas y Google API v3], junio de 2012

== Características ==
* Gestión de zonas y nodos
* [https://guifi.net/guifi/menu/stats/growthmap 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/<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:



{| 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 ==
<references/>

== Véase también ==
* [[Módulo apadrinamientos]]
* [[Web Guifi.net]]

== Enlaces externos ==
* [http://drupal.org/ Sitio oficial de Drupal]
* [[wikipedia:es:Interfaz de programación de aplicaciones|API]] (Wikipedia)

[[Categoría:Desarrollo]]
[[Categoría:Web]]

Módulo Drupal Guifi.net

2017-09-03T16:50:06Z

Servia:

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 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><ref>https://gitorious.org/guifi-web/theme_guifinet2011</ref>.

== Historial de cambios ==
* [https://lists.guifi.net/pipermail/guifi-rdes/2012-June/024678.html Mapas y Google API v3], junio de 2012

== Características ==
* Gestión de zonas y nodos
* [https://guifi.net/guifi/menu/stats/growthmap 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/<ref>http://gitorious.org/guifi/drupal-guifi/trees/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>http://gitorious.org/guifi/drupal-guifi/trees/master/contrib/api_client</ref>.

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



{| 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 ==
<references/>

== Véase también ==
* [[Módulo apadrinamientos]]
* [[Web Guifi.net]]

== Enlaces externos ==
* [http://drupal.org/ Sitio oficial de Drupal]
* [[wikipedia:es:Interfaz de programación de aplicaciones|API]] (Wikipedia)

[[Categoría:Desarrollo]]
[[Categoría:Web]]