Brzi početak: umetanje slike u željenoj veličini

Najkraći put od „dodatak je instaliran“ do „preglednik dobiva sliku smanjenu na poslužitelju umjesto cijele datoteke“. Tri koraka, otprilike pet minuta.

Preduvjeti

wkimage je instaliran i uključen u upravitelju proširenja.
PHP ima knjižnicu za slike za formate koje koristite (GD ili Imagick).
Datoteka slike u medijskom arhivu i dopuštenje za uređivanje stranice.

Korak 1: prenesite sliku

Otvorite upravitelj medija (/doku.php?do=media), odaberite ili stvorite imenski prostor i prenesite datoteku, primjerice wiki:foto.jpg.

Zabilježite oznaku medija — imenski prostor i naziv datoteke spojeni dvotočkom.

Korak 2: umetnite sliku

Uredite stranicu i upišite:

{{wk:image>wiki:foto.jpg?width=800}}

Navodi iza ? slijede oblik upitnog niza; više njih spaja se znakom &.

Korak 3: dodajte pristupačan tekst

{{wk:image>wiki:foto.jpg?width=800&alt=Pogled na montažnu halu}}

alt je tekst koji čitač zaslona izgovara i koji preglednik prikazuje kada slika izostane. Slika koja nosi značenje treba ga.

Provjera rezultata

Slika stoji na stranici. Odlučujuća razlika vidljiva je u HTML izvoru: isporučuje se inačica široka 800 piksela, a ne izvornik smanjen CSS-om.
Atribut loading=“lazy” stoji na elementu — odgođeno učitavanje je zadano. Za sliku vidljivu bez pomicanja isključite ga s &lazy=0; inače čitatelj čeka na nešto što je već na zaslonu.
Ponovno učitajte stranicu. Slika dolazi iz međuspremnika, ne računa se ponovno. Zatražite drugu širinu i nastaje drugi spremljeni rezultat; prvi ostaje.

Na ovoj je instalaciji defaultMaxWidth postavljen na 800. Bez vlastitog navoda širine slika se dakle ograničava na najviše 800 piksela.

Sljedeći korak

wkopengraph — ako ista slika treba služiti kao kartica pregleda pri dijeljenju.
wkimage (njemački) — stranica paketa: sve mogućnosti (maxwidth, quality, format, inline), postavke i PHP pomoćnik.