Publicar en tu propio sitio

Nolorem publica en WordPress, Ghost y Webflow a través de sus propias API. Si tu sitio no es ninguno de esos tres, no hace falta que lo sea. Decláralo como tu propio sitio, y Nolorem se convierte en un destino de publicación de pleno derecho para él, igual que cualquier conector.

Este artículo recorre la configuración desde el primer día, de principio a fin. No presupone nada sobre la tecnología de tu sitio, solo que pueda recibir una solicitud HTTP.

Lo que este acuerdo implica realmente

Lee esto primero, porque determina cómo construyes el otro extremo.

Nolorem nunca llama a tu sitio. No hay webhook, ni push, ni callback. Tu sitio llama a Nolorem, con la periodicidad que tú elijas. La Public Content API es un feed de solo lectura: tu sitio la consulta, y todo lo demás, incluida la frecuencia, depende de ti.

Nolorem te avisa cuando tu propia configuración parece incorrecta. Si tu sitio está declarado pero nada lo consulta, o algo lo consulta y no recibe nada a cambio, eso se muestra en la página de configuración de publicación en lugar de quedar invisible. La sección más abajo sobre comprobar que tu sitio consulta realmente el feed no es un detalle secundario; existe porque un feed que responde en silencio, para siempre, sin nada, es exactamente el fallo que este acuerdo está diseñado para detectar.

Paso 1: introduce la dirección de tu sitio

Abre Publicación en la configuración de tu blog e introduce la dirección de tu sitio web. Haz clic en Encontrar mi plataforma.

Nolorem comprueba si tu dirección funciona con WordPress o Ghost. Si es así, se te ofrece directamente el formulario de conexión propio de esa plataforma en lugar de los pasos siguientes, ya que para ella ya existe un conector real.

Si no se reconoce nada, ese es un resultado normal y esperado, no un error. La mayoría de los sitios hechos a medida, y cualquier sitio construido sobre una plataforma para la que Nolorem no tiene conector, terminan aquí. Se te muestra un mensaje breve que lo confirma, y pasas directamente a declarar tu propio sitio, con la dirección que acabas de escribir ya rellenada.

Paso 2: confirma la dirección y el patrón de URL

Dos campos describen tu sitio: la dirección (confirmada a partir de lo que has introducido) y el patrón de URL de las entradas, la forma que tiene la URL de una entrada individual en tu sitio, por ejemplo /{slug} o /blog/{slug}.

Nolorem intenta leer una URL de artículo real de tu sitio y proponer un patrón a partir de ella. Si encuentra una, el campo del patrón muestra una insignia Propuesto con una nota sobre en qué página se leyó; compáralo con una URL que sepas que es correcta y luego confirma. Si no encuentra ninguna, el campo empieza vacío y lo rellenas tú mismo.

Este campo es obligatorio, y nunca se adivina en silencio. Una versión anterior de este acuerdo rellenaba automáticamente un patrón por defecto cuando un cliente dejaba el campo sin tocar, y ese patrón por defecto era incorrecto con la frecuencia suficiente como para enviar a los lectores a un error 404. Nolorem ahora exige una respuesta real, ya sea de la detección o de ti, antes de componer un solo enlace hacia una entrada de tu sitio.

Guarda. Tu sitio queda ahora declarado como destino.

Paso 3: crea una clave de la Content API

Publicar en tu propio sitio necesita una clave de la Content API activa para que tu sitio tenga con qué autenticarse. Ve a Ajustes, Claves de API y crea una, asociada a este blog. Consulta Public Content API para el recorrido completo sobre alcances de clave, autenticación y cada endpoint que expone el feed; este artículo no lo repite.

La Content API está disponible en cualquier plan de pago, incluida una prueba. Lo que la desbloquea es una suscripción activa, no un nivel concreto.

Paso 4: apunta tu sitio hacia el feed

Tu sitio hace la solicitud GET /api/v1/posts con la clave como token bearer, y a partir de ahí recorre las páginas de resultados. Cómo consumirla exactamente, incluido el sondeo económico con If-None-Match y la copia de imágenes a tu propio almacenamiento en lugar de enlazarlas directamente desde el de Nolorem, se desarrolla de principio a fin en un script de Node ejecutable y sin dependencias: sync.mjs (con su README). Descárgalo y úsalo como punto de partida.

Paso 5: comprueba que tu sitio consulta realmente el feed

De vuelta en la página de configuración de publicación, la sección bajo tu sitio declarado muestra si están llegando solicitudes de verdad:

• Aún sin solicitudes significa que la clave existe pero todavía no se ha usado. Es normal en los minutos posteriores a la configuración; un problema si sigue así.
• Una solicitud reciente muestra cuándo se consultó el feed por última vez y con qué clave.
• La alarma aparece cuando tu clave ha estado consultando repetidamente y recibiendo un feed vacío cada vez. Es exactamente la situación que antes pasaba desapercibida: un sitio que pide contenido que nunca llega, en silencio, sin que nadie se entere. Si la ves, comprueba que la clave está asociada al blog en el que realmente publicas, y que ya has publicado algo.

Si publicas en más de un idioma

Pide cada idioma por separado. GET /api/v1/posts?locale=nl devuelve las mismas entradas que ya recibías, pero en neerlandés allí donde exista una traducción neerlandesa completa, y sin cambios donde no la haya. No es un filtro: ninguna entrada desaparece porque hayas pedido un idioma. Usa ?language= cuando sí quieras filtrar por el idioma en el que se escribió la entrada.

Cada entrada te dice qué idiomas tiene. available_locales los enumera y locale_slugs indica el slug que lleva cada idioma. Esos slugs se diferencian de verdad entre idiomas, porque cada uno se elige en torno a la palabra clave de ese idioma. Construye tu URL por idioma a partir de locale_slugs en lugar de traducir el slug tú mismo o reutilizar el del idioma original.

Los detalles, incluido lo que ocurre con una traducción sin terminar, están en Public Content API.

Qué significa "publicado" aquí

Una entrada publicada en tu propio sitio muestra, en cualquier lugar donde aparezca el estado de una entrada en Nolorem, Disponible para tu sitio en lugar de "Publicado". No es un estado inferior: la entrada está activa en el feed, exactamente igual que en cualquier otro destino. La redacción solo refleja que Nolorem nunca confirma por sí mismo que la entrada se haya representado en algún sitio; esa confirmación queda entre tu sitio y lo que haga con el feed.

Cambiar de opinión más adelante

Si tu sitio cambia de plataforma, o pasas de un sitio hecho a medida a WordPress u otro CMS compatible, usa Cambiar destino en esa misma página de configuración de publicación. Te guía por el mismo flujo de migración que cualquier otro cambio de plataforma.