Brzi početak: određivanje kartice pregleda stranice

Najkraći put od „dodatak je instaliran“ do „podijeljena stranica prikazuje naslov, tekst i sliku koje ste odredili“. Tri koraka, otprilike deset minuta.

Preduvjeti

wkopengraph je instaliran i uključen u upravitelju proširenja.
Prijavljeni ste kao superuser — zaslon sa zadanim vrijednostima namijenjen je samo administratorima.
Slika za pregled, najmanje 600 × 315 piksela.
Za završnu provjeru na internetu: adresa dostupna izvana. Usluga ne može pročitati stranicu do koje ne dolazi. Bez toga provjeravate u HTML izvoru, što je dovoljno.

Korak 1: pogledajte što stranica već ispisuje

Otvorite stranicu i prikažite njezin HTML izvor. U <head> već stoje og: i twitter: navodi, izvedeni iz naslova stranice i zadanih vrijednosti instalacije.

To je polazište — a ne prazan list.

Korak 2: postavite zadane vrijednosti

Administracija → Društveni pregled (Open Graph), izravno /doku.php?do=admin&page=wkopengraph.

Polje	Što ide u njega
Naziv stranice	Naziv sjedišta kako treba stajati u pregledu.
Zadana slika	Apsolutna adresa, koja počinje s `https://`.
Zadani opis	Tekst za stranice bez vlastitoga.

Kartica ispod polja odmah pokazuje što iz vrijednosti nastaje.

Zadana slika mora biti navedena apsolutno. Adresa relativna prema wikiju tiho je bezvrijedna: usluga koja čita dohvaća sliku sa svojeg poslužitelja, gdje relativna putanja ne znači ništa.

Spremite. Time je podignut pod za svaku stranicu odjednom.

Korak 3: odredite pojedinu stranicu

Postavite na stranicu blok <og>:

<og>
title: Planiranje ruta
description: Kako se planiraju ture i koji rubni uvjeti vrijede.
image: :wiki:pregled:ture.png
</og>

Vodeća dvotočka ispred slike označava je kao oznaku medija, a ne kao gotovu adresu; ona se za vas razrješava u apsolutnu.

Isti blok možete uređivati i preko Uredi oznake stranice na administracijskom zaslonu. To je obična izmjena stranice s revizijom — dakle u svakom trenutku poništiva.

Provjera rezultata

Ponovno učitajte stranicu i pogledajte HTML izvor:

<meta property="og:title" …> nosi vaš naslov.
Adresa slike je apsolutna.
Navod koji ste ostavili praznim uopće se ne ispisuje. To je namjerno: prazan content tvrdio bi „ova stranica nema opis“ i spriječio uslugu da ga sama potraži. Izostavljanje oznake to joj dopušta.

Usluge koje čitaju uporno pamte rezultate. To što se promjena na internetu ne vidi odmah, redovit je slučaj, a ne pogreška — HTML izvor je pouzdana provjera.

Sljedeći korak

wki18n — naslov, opis i slika po jeziku iz jednog bloka: title: hr:Planiranje ruta|en:Delivery scheduling.
wkopengraph (njemački) — stranica paketa: sva svojstva, oblik twitterCard, najmanje mjere slike.