Incrusta Gobierto en otra web

Puedes incrustar (embeber) un Gobierto en tu aplicación web. Esto permite incorporar los módulos de Gobierto como una sección más en tu página web, manteniendo tu diseño, navegación y URLs. Mediante la incrustación de un código de JS que invoca la web de Gobierto, se puede mostrar Gobierto integrado en tu web. Esto permite lo siguiente:

1. Actualización de las URLs en la barra de direcciones: Con una pequeña configuración en tu servidor web o aplicación, Gobierto podrá ir actualizando la URL en la barra de direcciones según el usuario va navegando en las distintas páginas, de modo que la sección principal donde se incrusta Gobierto podrá tener su propia URL, pero también cada una de las páginas por las que vaya navegando el usuario "dentro" de Gobierto.
2. Mantener tu diseño y navegación: El código de embed se incrusta en tu layout, por lo que la sección donde incluyas Gobierto será una sección más de tu web y por tanto podrás controlar en qué lugar aparece, su URL, su menú de navegación, etc.

📘

Tienes un mecanismo para incrustar el calendario de una persona en otra web. Más información.

Cómo funciona

Deberás crear una página en tu CMS, y ésta deberá permitir incrustar un código JavaScript. Este código es el que invoca a Gobierto. Para sincronizar las URLs deberás incluir un código sencillo en tu aplicación o servidor web. Te damos las instrucciones.

Cómo ponerlo en marcha

1. Solicita tu cuenta de Gobierto

Deberás tener un Gobierto activo y funcionando.

2. OPCIONAL Para sincronizar las URLs Configurar tu servidor web o aplicación

Para que se actualice la barra de direcciones según el usuario va navegando dentro de Gobierto, deberás añadir una pequeña instrucción en la configuración de tu servidor web o de tu aplicación. Te damos algunos ejemplos:

Configuración en servidor web Nignx

location /tu-gobierto/ {
  try_files /tu-gobierto/index.html last;
}

Configuración en servidor web Apache

RewriteRule "^/tu-gobierto/(.+)" "/tu-gobierto/index.html" [L,PT]

Configuración a nivel de aplicación - ejemplo para Ruby On Rails

# Entrada en el fichero config/routes.rb
get "/tu-gobierto(/*any)" => "gobierto#index"

3. Definir en tu CMS la página base donde se inscrustará Gobierto

4. Incluir el código para incrustar Gobierto en tu página

HTML

<script type="text/javascript" src="https://tugobierto.es/embed.js"></script>
<div 
  gobierto-embed="https://tugobierto.es/seccion" 
  base-path="https://tusitio.es/seccion-gobierto/
">
</div>

• gobierto-embed es el enlace a la sección de Gobierto que se quiere incrustrar. Por ejemplo si se quieren incrustrar los presupuestos se puede utilizar https://tugobierto.es/presupuestos
• base-path es la URL completa del sitio donde se va a integrar Gobierto, con dominio y path. Por ejemplo https://tusitio.es/transparencia/presupuestos

Puedes ver un ejemplo en vivo en https://gobierto.es/demo-embed/

5. Configuración en Gobierto

En el interfaz de administración de Gobierto, en Configuración del sitio > Otras variables de configuración hay que indicar el dominio de la web donde se va a integrar:

allowed_iframe_origin: "https://tusitio.es"

Esta configuración garantiza que el código de incrustración solo funcione en los sitios que autoricemos.

6. Personalizar los estilos de Gobierto para adaptarlos a tu diseño

Gobierto permite ser integrado dentro de una web existente a través de un iframe de HTML. Para ello basta con utilizar el siguiente código: