Hitri začetek: določitev kartice predogleda za stran

Najkrajša pot od »vtičnik je nameščen« do »deljena stran prikaže naslov, besedilo in sliko, ki ste jih določili«. Trije koraki, približno deset minut.

Predpogoji

wkopengraph je nameščen in vklopljen v upravitelju razširitev.
Prijavljeni ste kot skrbnik (superuser) – zaslon s privzetimi vrednostmi je na voljo samo skrbnikom.
Slika za predogled, vsaj 600 × 315 slikovnih točk.
Za končno preverbo v omrežju: naslov, dosegljiv od zunaj. Storitev ne more prebrati strani, do katere ne pride. Brez tega preverjate v izvorni kodi HTML, kar zadošča.

Korak 1: poglejte, kaj stran že izpisuje

Odprite stran in prikažite njeno izvorno kodo HTML. V <head> so že navedbe og: in twitter:, izpeljane iz naslova strani in privzetih vrednosti namestitve.

To je izhodišče – in ne prazen list.

Korak 2: nastavite privzete vrednosti

Skrbništvo → Družbeni predogled (Open Graph), neposredno /doku.php?do=admin&page=wkopengraph.

Polje	Kaj vpišete
Ime spletišča	ime spletišča, kot naj bo prikazano v predogledu
Privzeta slika	Absoluten naslov, ki se začne z `https://`.
Privzeti opis	Besedilo za strani brez lastnega.

Kartica pod polji takoj pokaže, kaj iz vrednosti nastane.

Privzeta slika mora biti navedena absolutno. Naslov, relativen glede na wiki, je tiho neuporaben: storitev, ki bere, sliko pobere s svojega strežnika, kjer relativna pot ne pomeni ničesar.

Shranite. S tem ste izboljšali izhodišče za vse strani hkrati.

Korak 3: določite posamezno stran

Postavite na stran blok <og>:

<og>
title: Načrtovanje poti
description: Kako se načrtujejo ture in kateri robni pogoji veljajo.
image: :wiki:predogled:ture.png
</og>

Vodilno dvopičje pred sliko jo označi kot oznako predstavnosti in ne kot dokončen naslov; namesto vas se razreši v absolutnega.

Isti blok lahko urejate tudi prek Urejanje oznak strani na skrbniškem zaslonu. To je navadna sprememba strani z različico – torej jo je mogoče kadar koli preklicati.

Preverjanje rezultata

Znova naložite stran in poglejte izvorno kodo HTML:

<meta property="og:title" …> nosi vaš naslov.
Naslov slike je absoluten.
Navedba, ki ste jo pustili prazno, se sploh ne izpiše. To je namerno: prazen content bi trdil »ta stran nima opisa« in storitvi preprečil, da si ga sama poišče. Izpust oznake ji to dovoli.

Storitve, ki berejo, rezultate trdovratno hranijo. To, da se sprememba v omrežju ne pokaže takoj, je pravilo in ne napaka – izvorna koda HTML je zanesljivo preverjanje.

Naslednji korak

wki18n – naslov, opis in slika po jezikih iz enega samega bloka: title: sl:Načrtovanje poti|en:Delivery scheduling.
wkopengraph – stran paketa: vse lastnosti, oblika twitterCard, najmanjše mere slike.