Preguntas frecuentes

Conceptos

¿Qué es un CMS headless?

Un CMS headless es un sistema de gestión de contenidos que separa el lugar donde se gestiona el contenido de la pantalla donde se muestra. Aquí, "headless" significa que no lleva acoplada una pantalla (interfaz) predeterminada.

En el enfoque tradicional, el lugar donde se gestiona el contenido y la pantalla del sitio web que lo muestra forman un único conjunto. Un CMS headless separa ambas cosas. El contenido se gestiona en un solo sitio y se entrega por un canal acordado (una API, una forma de intercambiar datos por una dirección según reglas establecidas). Así, un mismo contenido puede tomarse y usarse en varias pantallas distintas, como un sitio web o una aplicación móvil.

WEEGLOO es uno de estos CMS headless. Cuando crea y publica el contenido en el estudio de contenidos, el sitio web o la aplicación toma esa versión publicada y la muestra en pantalla. El funcionamiento completo de WEEGLOO se trata en Cómo funciona.

¿De qué forma se entrega el contenido?

WEEGLOO entrega el contenido mediante una API RESTful basada en JSON (un formato de datos basado en texto que se usa para intercambiar datos). Una API es un canal por el que se intercambian datos a través de una dirección según reglas establecidas.

Hay varias API divididas según su uso.

• La CDA (Content Delivery API), que lee el contenido publicado: se usa cuando el sitio web o la aplicación toma el contenido para mostrarlo a los visitantes.
• La CMA (Content Management API), que crea y gestiona el contenido: se usa cuando se quiere realizar desde código tareas como crear, modificar o publicar, que normalmente se hacen en el estudio de contenidos.

Como la lectura y la gestión están separadas, en cada entorno puede elegir solo el canal que necesita para aprovechar el contenido. Qué API conviene usar en cada situación se trata en la Referencia de la API.

¿Se puede usar también en una aplicación móvil?

Sí. Como se explica en ¿Qué es un CMS headless?, WEEGLOO gestiona el contenido separándolo de la pantalla que lo muestra. Por eso, un mismo contenido puede tomarse y usarse tanto en un sitio web como en una aplicación móvil. La forma de traer el contenido publicado desde la aplicación es la misma que en la web.

Al añadir el inicio de sesión de miembros a una aplicación móvil (Android o iOS) hay una diferencia. La conexión por la que el resultado vuelve a la aplicación una vez terminado el inicio de sesión no es igual que en la web, por lo que hacen falta unos pasos técnicos aparte. Esos pasos se tratan en la Auth API.

Puede ver de principio a fin un ejemplo completo que integra una aplicación móvil con WEEGLOO en el Servicio de registro de carreras.

Gestión de contenido

¿Cómo distribuyo el contenido en varios idiomas?

Para ofrecer un Content o un Media en varios idiomas, primero añada el idioma (Locale) al Space.

1. En el menú de la izquierda, abra la configuración del Space y vaya a la pantalla de gestión de Locales.
2. Pulse el botón + Añadir de arriba a la derecha y elija el idioma que quiera en el desplegable.
3. (Opcional) Defina un Fallback Locale. Es el idioma que se muestra en su lugar cuando el valor de ese idioma está vacío.
4. Pulse Guardar.

Después de añadir un Locale, hay que activar el multilingüe en cada Field que vaya a recibir un valor distinto por idioma. En la pantalla de edición del Content Type, abra la Configurar Field del Field correspondiente y, en la pestaña Configuración, compruebe que Activar localización para este Field esté activado.

Los detalles se tratan en Gestión multilingüe.

¿Cómo se valida un Content?

La validación es la función que pone a un Field la condición de "qué valores pueden entrar en esta casilla". Los valores que no cumplen la condición no se guardan, lo que evita que se acumulen Content incorrectos.

Las condiciones que se pueden poner varían según el tipo de Field. Por ejemplo, un Field que enlaza con un Media tiene condiciones para limitar los tipos de archivo que se pueden subir o para limitar el tamaño del archivo o el tamaño de la imagen, y un Field numérico tiene condiciones para definir el rango del valor.

Para añadir una validación a un Field, siga estos pasos.

1. Vaya a la pantalla de edición del Content Type y pulse el Field al que va a poner la condición.
2. En Configurar Field, vaya a la pestaña Validaciones.
3. Aparecerán las condiciones que se pueden usar con ese tipo de Field. Elija y configure las que necesite.

Los detalles se tratan en Validación.

¿Cómo se establece el título de un Content?

El título de un Content es el nombre con el que se reconoce cada elemento en la lista de Content. Puede usar como título cualquier Field de tipo ShortText.

En la pantalla de edición del Content Type, abra el Field que va a usar como título y configúrelo para que ese Field se utilice como título. Cada Content Type solo puede tener un Field como título, así que, si ya hay otro Field establecido como título, primero hay que quitarle esa configuración y luego establecer el nuevo.

El flujo para establecer un Field como título al crearlo por primera vez se trata en Modelado de Content.

Gestión de Organization y Space

¿Cómo invito a un usuario?

Para incorporar a un usuario a un Space, ese usuario debe pertenecer antes a la Organization. Por eso la colaboración empieza por invitar a la Organization.

Invitar a un usuario a una Organization lo pueden hacer los usuarios con el rol Owner o Admin.

1. Vaya a la pantalla de configuración de la Organization.
2. En el menú de la izquierda, pulse Memberships.
3. Pulse el botón Invitar de la parte superior derecha e introduzca datos como el correo electrónico y el rol que le va a dar para enviar la invitación.

El usuario invitado pasa a ser miembro de inmediato. No hay que pasar por un paso de "aceptación" aparte, y se envía un correo de aviso a la dirección invitada.

Los detalles sobre las invitaciones y los roles se tratan en Organization y Space.

API

¿El valor de sys.id es único?

Sí. El sys.id se genera de forma única en todo el servicio. Por eso su valor no coincide ni siquiera con el de recursos que pertenecen a otra Organization u otro Space.

La información que contiene sys se trata en Propiedades del sistema (sys).

¿Cómo consulto los recursos referenciados de un Content?

Con el parámetro include puede traer, en una sola petición, tanto un Content como los recursos referenciados a los que apunta.

GET /v1/spaces/{spaceId}/contents?include=1

La petición anterior consulta la lista de Content y trae a la vez los datos referenciados enlazados a un nivel de profundidad. Si sube el valor a 2 o 3, se despliegan y se traen niveles más profundos.

include no se usa solo con Content, sino que funciona igual en la consulta de cualquier recurso. Los detalles se tratan en Parámetros de consulta comunes.

¿Se admite la operación OR en las condiciones de búsqueda?

La REST API no admite directamente la función de combinar varias condiciones con OR (traer un elemento si cumple al menos una de ellas). Si en una petición se dan varias condiciones a la vez, solo salen los resultados que las cumplen todas (AND). Si necesita un OR, envíe una petición por separado para cada condición y combine los resultados recibidos.

La forma de acotar una lista con condiciones se trata en Parámetros de consulta comunes.

Pago y tarifas

¿Puedo cambiar de plan?

Puede subir (actualizar) o bajar (degradar) de plan en cualquier momento. Al actualizar, se prorratea el importe del periodo de facturación restante, y la degradación se aplica a partir del siguiente periodo de facturación.

Los límites y precios de cada plan se tratan en Planes.

¿Cómo se calcula el uso de la API?

Muchas plataformas de contenido miden el uso por el número de llamadas a la API (número de peticiones). WEEGLOO no calcula el uso según el número de llamadas, sino según la cantidad de datos realmente intercambiada (volumen de transferencia de datos). Aun con el mismo número de peticiones, si los datos intercambiados son más grandes, se contabiliza más uso.

Los planes Free, Basic y Pro incluyen en la cuota mensual un volumen de transferencia de datos determinado cada mes. La tabla de planes muestra también ese volumen convertido en número de llamadas, para que pueda hacerse una idea de la transferencia. Operaciones como Advanced Search, en las que una sola búsqueda se contabiliza como varias llamadas, también se consumen dentro de ese volumen de transferencia.

Si necesita un uso mayor que el volumen establecido, puede recurrir al plan Enterprise, que se factura según lo que se haya usado. Los límites de transferencia de datos de cada plan se tratan en Planes.