Hitri začetek: določitev predoglednske kartice strani

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 superuser — zaslon s privzetimi vrednostmi je pridržan skrbnikom.
Predoglednska slika, 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> že stojijo 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 gre vanj
Ime spletišča	Ime spletišča, kot naj stoji 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 je tla dvignjeno 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 kadar koli preklicljiva.

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 zanesljiva preverba.

Naslednji korak

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