Avvio rapido: definire la scheda di anteprima di una pagina

Il percorso più breve da «il plugin è installato» a «una pagina condivisa mostra il titolo, il testo e l'immagine che avete stabilito». Tre passi, circa dieci minuti.

Prerequisiti

wkopengraph è installato e attivato nel gestore delle estensioni.
Siete autenticati come superuser — la schermata dei valori predefiniti è riservata agli amministratori.
Un'immagine di anteprima, almeno 600 × 315 pixel.
Per la verifica finale in rete: un indirizzo raggiungibile dall'esterno. Un servizio non può leggere una pagina che non raggiunge. Senza di ciò si verifica nel sorgente HTML, il che è sufficiente.

Passo 1: vedere che cosa la pagina già emette

Aprire una pagina e visualizzarne il sorgente HTML. Nel <head> ci sono già indicazioni og: e twitter:, ricavate dal titolo della pagina e dai valori predefiniti dell'installazione.

Questo è il punto di partenza — non un foglio bianco.

Passo 2: impostare i valori predefiniti

Amministrazione → Anteprima social (Open Graph), direttamente /doku.php?do=admin&page=wkopengraph.

Campo	Che cosa vi va
Nome del sito	Il nome del sito come deve apparire in un'anteprima.
Immagine predefinita	Un indirizzo assoluto, che inizia con `https://`.
Descrizione predefinita	Il testo per le pagine che non ne hanno uno proprio.

La scheda sotto i campi mostra subito che cosa ne risulta.

L'immagine predefinita va indicata in forma assoluta. Un indirizzo relativo al wiki è silenziosamente inutile: il servizio che legge preleva l'immagine dal proprio server, dove un percorso relativo al wiki non significa nulla.

Salvare. Con ciò è alzato il pavimento per tutte le pagine in un colpo solo.

Passo 3: definire una singola pagina

Collocare sulla pagina un blocco <og>:

<og>
title: Pianificazione dei giri
description: Come si pianificano i giri e quali vincoli valgono.
image: :wiki:anteprima:giri.png
</og>

I due punti iniziali davanti all'immagine la contrassegnano come identificatore di media e non come indirizzo già pronto; viene risolta in un indirizzo assoluto al vostro posto.

Lo stesso blocco si può modificare anche tramite Gestisci il markup della pagina nella schermata di amministrazione. È una normale modifica di pagina con revisione — quindi annullabile in qualsiasi momento.

Verifica del risultato

Ricaricare la pagina e rileggere il sorgente HTML:

<meta property="og:title" …> porta il vostro titolo.
L'indirizzo dell'immagine è assoluto.
Un valore lasciato vuoto non viene emesso affatto. È voluto: un content vuoto affermerebbe «questa pagina non ha descrizione» e impedirebbe al servizio di cercarsene una. Omettere il tag glielo consente.

I servizi che leggono conservano i risultati con tenacia. Che una modifica non si veda subito in rete è la norma e non un difetto — il sorgente HTML è la verifica affidabile.

Passo successivo

wki18n — titolo, descrizione e immagine per lingua da un solo blocco: title: it:Pianificazione dei giri|en:Delivery scheduling.
wkopengraph (in tedesco) — la pagina del pacchetto: tutte le proprietà, il formato twitterCard, le misure minime dell'immagine.