Como gerar marcação Open Graph para pré-visualização de partilhas sociais

Para que serve

Esta ferramenta gera marcação de metadados orientada para a pré-visualização de partilhas sociais. Pode ser útil quando pretende preparar os valores que acompanham uma página, como o título, a descrição, a imagem, o endereço, o nome do site, o tipo e o idioma. O resultado é uma marcação construída a partir dos textos fornecidos, não uma confirmação de como uma plataforma social irá apresentar o endereço. [not allowed]

Como utilizar

1. Introduza um título, se quiser gerar entradas de metadados. Os campos de descrição, imagem, endereço, nome do site, tipo e idioma são valores de texto opcionais.

2. Preencha a descrição e os restantes campos que pretende incluir. A imagem, o endereço e o nome do site só entram na marcação quando os respetivos valores não estão vazios.

3. Selecione o tipo e o idioma quando precisar de valores diferentes dos predefinidos. Quando esses campos ficam por preencher, o tipo usado é website e o idioma usado é en_US.

4. Execute a operação e consulte a marcação devolvida. Os valores fornecidos são convertidos para uma forma HTML segura antes de serem colocados no resultado. Guarde ou integre a marcação de acordo com o fluxo do seu projeto, sem colocar segredos juntamente com estes dados.

Como ler o resultado

Com um título preenchido, espere encontrar metadados para o título e a descrição, mesmo que a descrição fique vazia. Também deverá encontrar os valores de tipo e idioma: os introduzidos por si ou, na sua ausência, website e en_US. A imagem, o endereço e o nome do site não aparecem quando os campos correspondentes não têm valor.

Se o título ficar vazio, a operação pode terminar com sucesso sem devolver entradas de metadados. Por isso, uma resposta sem marcação nesse caso não significa necessariamente que a operação falhou. Para obter uma saída preenchida, reveja primeiro o título e depois confirme os campos opcionais que quer incluir.

A marcação deve ser lida como o resultado dos valores introduzidos e das regras acima. A ferramenta não verifica o conteúdo de um endereço nem de uma imagem remota, e a marcação não garante uma apresentação específica numa plataforma social.

Exemplo prático

Uma pequena loja prepara uma página chamada "Pão & Café" e introduz a descrição "Pão fresco " para preparar a marcação de partilha social.

Introduza o título e a descrição indicados, deixe os restantes campos vazios e execute a operação. Depois, confirme a presença dos metadados de título e descrição e a utilização dos valores predefinidos para tipo e idioma.

A saída tem metadados de título e descrição, inclui tipo e idioma e pode incluir imagem, endereço e nome do site quando esses campos têm valores. O valor fornecido para a descrição aparece convertido para uma forma HTML segura.

Limitações

• A ferramenta gera marcação a partir dos valores fornecidos. Não deve ser tratada como uma verificação do conteúdo de um endereço ou de uma imagem, nem como garantia da apresentação numa plataforma social.
• Os valores são convertidos para uma forma HTML segura na marcação; a ferramenta não substitui a revisão do conteúdo e do contexto onde essa marcação será usada.

Erros comuns

• Causa: o título foi deixado vazio e a operação devolveu sucesso sem entradas. Correção: preencha o título antes de executar novamente.

Perguntas frequentes

É necessário preencher o título?

Sim, desde que o título não esteja vazio: a operação termina com sucesso e inclui metadados de título e descrição. Com o título vazio, também pode terminar com sucesso, mas sem entradas de metadados.

A imagem, o endereço e o nome do site são obrigatórios?

Não. Se o campo ficar vazio, o respetivo metadado não é incluído. A mesma regra aplica-se ao endereço e ao nome do site.

O que acontece se eu não escolher o tipo e o idioma?

Se não introduzir esses valores, a marcação usa website como tipo e en_US como idioma quando existe um título.