Publicar no seu próprio site

O Nolorem publica em WordPress, Ghost e Webflow através das suas próprias APIs. Se o seu site não for nenhum destes, não precisa de o ser. Declare-o como o seu próprio site, e o Nolorem torna-se um destino de publicação de pleno direito para ele, tal como qualquer conector.

Este artigo percorre a configuração desde o primeiro dia, do início ao fim. Não pressupõe nada sobre a tecnologia do seu site, apenas que consegue receber um pedido HTTP.

O que este acordo realmente significa

Leia isto primeiro, porque determina como constrói o outro lado.

O Nolorem nunca chama o seu site. Não há webhook, nem push, nem callback. É o seu site que chama o Nolorem, com a periodicidade que escolher. A Public Content API é um feed apenas de leitura: o seu site consulta-o, e tudo o resto, incluindo a frequência, é decisão sua.

O Nolorem avisa-o quando a sua própria configuração parece estar errada. Se o seu site está declarado mas nada o consulta, ou algo o consulta e não recebe nada em troca, isso aparece na página de definições de publicação em vez de permanecer invisível. A secção mais abaixo sobre verificar se o seu site está realmente a consultar o feed não é um pormenor secundário; existe porque um feed que responde em silêncio, para sempre, com nada, é exatamente a falha que este acordo foi construído para detetar.

Passo 1: introduza o endereço do seu site

Abra Publicação nas definições do seu blog e introduza o endereço do seu site. Clique em Encontrar a minha plataforma.

O Nolorem verifica se o seu endereço corre em WordPress ou Ghost. Se for o caso, é-lhe apresentado diretamente o formulário de ligação próprio dessa plataforma em vez dos passos abaixo, uma vez que já existe um conector real para ela.

Se nada for reconhecido, esse é um resultado normal e esperado, não um erro. A maioria dos sites feitos por medida, e qualquer site construído sobre uma plataforma para a qual o Nolorem não tem conector, acaba aqui. É-lhe mostrada uma breve mensagem que o confirma, e avança diretamente para declarar o seu próprio site, com o endereço que acabou de escrever já preenchido.

Passo 2: confirme o endereço e o padrão de URL

Dois campos descrevem o seu site: o endereço (confirmado a partir do que introduziu) e o padrão de URL das publicações, a forma que o URL de uma única publicação assume no seu site, por exemplo /{slug} ou /blog/{slug}.

O Nolorem tenta ler um URL de artigo real do seu site e propor um padrão a partir dele. Se encontrar um, o campo do padrão mostra um selo Proposto com uma nota sobre em que página foi lido; verifique-o em relação a um URL que sabe estar correto e depois confirme. Se não encontrar nenhum, o campo começa vazio e preenche-o você mesmo.

Este campo é obrigatório, e nunca é adivinhado em silêncio. Uma versão anterior deste acordo preenchia automaticamente um padrão predefinido quando um cliente deixava o campo por tocar, e esse padrão predefinido estava errado com frequência suficiente para enviar os leitores para um erro 404. O Nolorem exige agora uma resposta real, seja da deteção ou de si, antes de compor um único link para uma publicação no seu site.

Guarde. O seu site está agora declarado como destino.

Passo 3: crie uma chave da API Pública de Conteúdo

Publicar no seu próprio site requer uma chave ativa da API Pública de Conteúdo, para que o seu site tenha com o que se autenticar. Aceda a Definições, Chaves API e crie uma, associada a este blog. Consulte Public Content API para o percurso completo sobre âmbitos de chave, autenticação e cada endpoint que o feed expõe; este artigo não o repete.

A API Pública de Conteúdo está disponível em qualquer plano pago, incluindo um período de avaliação. É uma subscrição ativa que a desbloqueia, não um nível específico.

Passo 4: aponte o seu site para o feed

O seu site faz o pedido GET /api/v1/posts com a chave como token bearer, e a partir daí percorre as páginas de resultados. A forma exata de o consumir, incluindo consultas económicas com If-None-Match e a cópia de imagens para o seu próprio armazenamento em vez de as ligar diretamente às do Nolorem, é trabalhada do início ao fim num script Node executável e sem dependências: sync.mjs (com o respetivo README). Descarregue-o e use-o como ponto de partida.

Passo 5: verifique se o seu site está realmente a consultar o feed

De volta à página de definições de publicação, a secção sob o seu site declarado mostra se estão realmente a chegar pedidos:

• Ainda sem pedidos significa que a chave existe mas ainda não foi usada. Normal nos minutos após a configuração; um problema se a situação persistir.
• Um pedido recente mostra quando o feed foi consultado pela última vez e por qual chave.
• O alerta aparece quando a sua chave tem feito pedidos repetidamente e recebido um feed vazio de cada vez. É exatamente a situação que antes ficava invisível: um site a pedir conteúdo que nunca chega, em silêncio, sem que ninguém saiba. Se o vir, verifique se a chave está associada ao blog em que realmente publica, e se já publicou alguma coisa.

Se publica em mais do que um idioma

Peça cada idioma separadamente. GET /api/v1/posts?locale=nl devolve os mesmos artigos que já recebia, mas em neerlandês onde exista uma tradução neerlandesa completa, e inalterados onde não exista. Não é um filtro: nenhum artigo desaparece por ter pedido um idioma. Use ?language= quando quiser mesmo filtrar pelo idioma em que um artigo foi escrito.

Cada artigo diz por si que idiomas tem. available_locales enumera-os e locale_slugs indica o slug que cada idioma transporta. Esses slugs diferem mesmo de idioma para idioma, porque cada um é escolhido em torno da palavra-chave desse idioma. Construa por isso o seu URL por idioma a partir de locale_slugs, em vez de traduzir o slug ou reutilizar o da origem.

Os detalhes, incluindo o que acontece a uma tradução ainda por terminar, estão em Public Content API.

O que "publicado" significa aqui

Uma publicação feita no seu próprio site mostra, em qualquer lugar onde o estado de uma publicação apareça no Nolorem, Disponível para o seu site em vez de "Publicado". Não se trata de um estado inferior: a publicação está ativa no feed, exatamente como aconteceria com qualquer outro destino. A redação reflete apenas o facto de o próprio Nolorem nunca confirmar que a publicação foi de facto apresentada em algum lugar; essa confirmação fica entre o seu site e o que ele faz com o feed.

Mudar de ideias mais tarde

Se o seu site mudar de plataforma, ou passar de um site feito por medida para WordPress ou outro CMS suportado, use Alterar destino na mesma página de definições de publicação. Isso guia-o pelo mesmo fluxo de migração de qualquer outra mudança de plataforma.