Artigo de blog apresentado num leitor RSS com ligação à publicação original.

RSS no WordPress: o que distribui e como controlar

WordPress

O RSS no WordPress pode distribuir artigos para outras aplicações através de um feed, um endereço que disponibiliza conteúdo para consulta. Se um artigo aparece inteiro num leitor, a opção de texto completo pode ser a causa; é possível escolher um excerto nas definições do site.

O que o RSS distribui e quais são os seus limites

Use o feed para disponibilizar artigos a leitores que consultam o endereço periodicamente. A aplicação apresenta as novidades que encontra, podendo mostrar o artigo completo ou apenas um excerto, consoante o conteúdo fornecido.

Artigo distribuído por RSS para um leitor com ligação à origem.

O feed não é uma newsletter: não envia emails por si. Também não garante a indexação nos motores de pesquisa nem substitui uma cópia de segurança completa. O guia Como exportar conteúdos WordPress em 4 passos explica a exportação de conteúdos em WXR, que tem outra finalidade.

Como encontrar o feed e distinguir artigos de comentários

Para saber como encontrar o feed RSS no WordPress, procure uma ligação RSS no site e abra-a. Um endereço habitual para os artigos é o endereço principal do site seguido de /feed/, mas a configuração pode variar.

Exemplos ilustrativos, não endereços do seu site: se a página inicial for https://exemplo.pt/, os caminhos habituais são https://exemplo.pt/feed/ para artigos e https://exemplo.pt/comments/feed/ para comentários. Sem ligações permanentes amigáveis, pode encontrar https://exemplo.pt/?feed=rss2. A função oficial get_feed_link() usa o endereço público configurado e permite filtros: confirme a ligação real em vez de adivinhar o caminho.

Se o endereço público do blog for https://exemplo.pt/blog/, mantenha esse prefixo ao procurar o feed. A pasta onde o WordPress está instalado não determina, por si só, o endereço visível do site. Também pode haver feeds de categorias ou de comentários de um artigo; registe qual pretende distribuir antes de o adicionar ao leitor.

Dois feeds distintos para artigos e comentários de um blog.

Confirme o endereço e o conteúdo devolvido: um feed usa XML, mesmo quando o navegador lhe aplica um estilo parecido com uma página normal. O feed de artigos distribui publicações; o de comentários distribui respostas. A documentação WordPress Feeds distingue estes tipos e explica que nem todos os temas mostram ligações para todos eles.

Se a página inicial não mostrar um botão RSS, abra o código-fonte da página no navegador e procure application/rss+xml. A função feed_links() do WordPress pode anunciar no cabeçalho do HTML ligações que não aparecem na página. Na etiqueta com rel="alternate", o atributo href contém o endereço a copiar e o title ajuda a distinguir artigos de comentários. Comece pela página inicial pública do blog: a página de uma categoria ou de um artigo pode anunciar também um feed desse contexto.

Por exemplo, o código-fonte da página inicial do Radar UniversoWeb anuncia duas ligações RSS: «Radar UniversoWeb » Feed» aponta para /feed/ e «Radar UniversoWeb » Feed de comentários» aponta para /comments/feed/. Ambas têm o mesmo tipo no HTML, por isso esse campo não chega para escolher. Num site que não anuncie nenhuma ligação, a ausência da etiqueta não demonstra que o feed esteja desativado: abra o endereço indicado pelo responsável do site e confirme se o XML contém os artigos públicos esperados.

Escolher texto completo ou excerto no feed RSS

Com uma conta autorizada a gerir definições, abra Definições > Leitura, escolha texto completo ou excerto no feed RSS e guarde. O número de entradas da distribuição é diferente do número apresentado nas páginas do blog. Consulte a referência Definições de leitura para identificar cada campo; não altere a página inicial nem a visibilidade nos motores de pesquisa para resolver uma dúvida do feed.

De onde vem o excerto apresentado

A escolha em Leitura determina se o feed fornece o artigo completo ou um resumo; não é o local onde se escreve o resumo de cada publicação. Esse texto pertence ao artigo. Ao rever uma publicação, procure o campo Excerto no editor e confirme se foi preenchido manualmente. Se estiver vazio, o WordPress pode gerar um resumo a partir do conteúdo.

A referência the_excerpt_rss() mostra que o feed obtém o excerto do artigo; wp_trim_excerpt() documenta a geração automática e os filtros que podem alterar o tamanho e o final do resumo. Por isso, um comprimento diferente não prova, sozinho, que a opção de Leitura falhou. Não edite ficheiros PHP para reproduzir um limite visto noutro site.

Escreva um excerto que identifique o assunto e diga por que interessa ao leitor, sem depender de uma imagem. Para descobrir onde o texto mudou, compare o excerto guardado no artigo, a descrição no feed e o que o leitor mostra.

Ilustração conceptual das opções de texto completo e excerto num feed RSS.

Escolher o conteúdo do feed

OpçãoVantagemLimitação
Texto completoPermite ler o artigo no leitor.O conteúdo fica disponível fora do site e pode ser copiado.
ExcertoMostra uma parte do conteúdo e uma ligação para a origem.Não impede cópias nem garante visitas ao site.

O excerto não é um controlo de acesso nem recolhe cópias já distribuídas. Consulte o endereço sem sessão iniciada para verificar o que qualquer visitante recebe. Conteúdos reservados exigem uma política de acesso própria; não devem ser publicados no feed público com a expectativa de que o leitor os esconda.

Se o artigo depende de um formulário, de um vídeo incorporado ou de uma tabela extensa, o leitor pode não os apresentar como o site. Nesse caso, um excerto com ligação dá ao leitor contexto para decidir se abre o original.

Mesmo em modo de excerto, o modelo RSS 2.0 do WordPress inclui título, ligação, autor, data e categorias. Verifique a entrada completa: se o nome do autor ou o de uma categoria não puder ser divulgado, corrija-o na origem.

A aplicação que subscreve o endereço pode conservar entradas já obtidas, mesmo depois de deixarem de aparecer na lista recente. Reduzir o número de artigos do feed não equivale a apagar o arquivo do blog ou os registos do leitor. Se foi divulgado conteúdo indevido, trate a origem e as cópias conhecidas como um incidente separado; mudar para excerto não resolve retroativamente a divulgação.

O limite em Leitura define quantos artigos recentes aparecem no feed. Se o site publicar mais artigos do que esse limite enquanto o leitor estiver sem consultar, use o arquivo público para recuperar os que ficaram de fora. Ajuste o limite ao ritmo de publicação e aos períodos previsíveis sem consulta.

Como verificar um feed RSS num leitor

Adicione o endereço do feed de artigos a um leitor RSS e observe uma publicação pública. Confirme o conteúdo sem sessão iniciada e registe o que a aplicação apresenta; a ficha permite atribuir a verificação sem presumir o resultado.

Leitor de feed RSS com artigo e ficha de verificação por preencher.

Ficha de teste do feed

  • URL do feed de artigos: por verificar.
  • Título do artigo público no leitor: por verificar.
  • Data apresentada: por verificar.
  • Texto completo ou excerto apresentado: por verificar.
  • Ligação para o artigo de origem: por verificar.
  • Responsável pela verificação: por identificar.

Num exemplo hipotético, uma empresa de Aveiro altera o feed para excerto e consulta um artigo público no leitor. Deve confirmar se a mudança aparece e se a ligação abre o artigo certo, tendo em conta o momento da última consulta do leitor.

Se uma publicação nova não aparece, confirme que está efetivamente publicada e acessível ao público, não apenas guardada como rascunho ou marcada para uma data futura. Verifique também se subscreveu um feed limitado a uma categoria. Não use um rascunho confidencial para testar distribuição externa: escolha um artigo já público e registe o resultado sem introduzir dados de clientes.

O teste passa se o endereço corresponder ao âmbito pretendido, a entrada estiver presente, o texto respeitar a opção definida e a ligação abrir o artigo certo. Junte à ficha a data e o nome da aplicação. Repita a verificação nos destinos efetivamente usados.

Se uma ferramenta converte o feed em emails ou publicações noutra plataforma, determine quem aprova o envio, como se limita a audiência e como se suspende a automação. Teste numa pré-visualização ou num destino autorizado, nunca na lista real. Confirme nesse destino a entrega ou publicação: um XML válido não demonstra que a integração funcionou.

O que confirmar quando o conteúdo não corresponde

Confirme primeiro qual é o feed subscrito e quando o leitor o consultou pela última vez.

Separe a resposta da origem da apresentação no leitor. Se o XML já contém o excerto esperado e a aplicação mostra texto antigo, investigue a última atualização e a cópia dessa aplicação. Se o XML ainda tem o texto completo, confirme a gravação da opção e eventuais alterações introduzidas por extensões antes de intervir na aplicação externa.

Na leitura técnica de RSS 2.0, não confunda a descrição com o corpo completo. O modelo RSS 2.0 do WordPress inclui o excerto em <description> nas duas opções; com texto completo, pode acrescentar o corpo em <content:encoded>. Ver apenas um resumo na descrição não prova que o artigo completo deixou de ser distribuído. Confira todos os campos da entrada antes de validar a alteração.

Quando um artigo reaparece como novidade depois de uma correção, compare o título, a ligação e o identificador da entrada, não apenas a data. A especificação RSS 2.0 distingue <link>, que aponta para o artigo, de <guid>, que identifica a entrada. Um leitor pode usar esse identificador para reconhecer novidades. Alterá-lo pode fazer uma entrada parecer nova; não modifique identificadores na base de dados para tentar eliminar duplicados.

Uma mudança de domínio ou do endereço do blog também exige verificar a distribuição. Os leitores existentes podem continuar a consultar o endereço antigo, mesmo que o novo feed funcione. A documentação WordPress Feeds prevê encaminhamento entre endereços: peça ao responsável técnico um plano de redirecionamento do feed antigo para o novo, com testes antes e depois da mudança. Confirme que a resposta final é o XML pretendido, não a página inicial, e que as ligações das entradas abrem os artigos certos. Não copie regras antigas de .htaccess sem avaliar a configuração atual.

Num cenário hipotético de migração, registe antes da mudança o endereço subscrito, a ligação e o identificador de um artigo público. Depois, consulte o endereço antigo no mesmo leitor e compare esses elementos com o feed novo. Se aparecer uma segunda entrada para o mesmo artigo, preserve a evidência e verifique a continuidade dos identificadores com a equipa técnica. Um redirecionamento funcional não comprova, por si só, que todos os leitores conservaram o histórico sem duplicação.

Perante um erro de leitura, guarde a mensagem e o momento da ocorrência. Uma resposta vazia, HTML inesperado ou XML malformado pede investigação distinta de um feed válido sem novidades. Não desative controlos de segurança para permitir acesso a um leitor: encaminhe o diagnóstico para o responsável técnico, com o URL público e sem cookies, palavras-passe ou dados de subscritores.

Comparação do endereço, formato XML e atualização de um feed.

Resolver dúvidas na consulta

Aparecem respostas em vez de artigos?

Confirme se foi subscrito o feed de artigos e não o de comentários.

O endereço abre uma página normal?

O aspeto visual não basta para decidir. Consulte o código-fonte ou a resposta da rede: um feed RSS contém elementos como <rss>, <channel> e <item>. Uma página de erro, autenticação ou arquivo HTML não equivale ao feed esperado, ainda que abra sem erro visível.

O leitor mostra conteúdo antigo?

Verifique quando o leitor consultou o feed pela última vez e atualize-o nessa aplicação, se possível.

Se a dúvida persistir, registe o endereço, o artigo e o comportamento observado para análise. Não é necessário executar PHP, alterar o ficheiro .htaccess, desativar plugins em produção ou limpar cache indiscriminadamente para fazer esta verificação inicial.

Use a ficha para registar o que o leitor RSS recebe antes de alterar a configuração do site.