Schnelleinstieg: Die Vorschaukarte einer Seite festlegen

Der kürzeste Weg von „Plugin ist installiert“ zu „eine geteilte Seite zeigt den Titel, den Text und das Bild, die Sie bestimmt haben“. Drei Schritte, etwa zehn Minuten.

Voraussetzungen

wkopengraph ist installiert und im Erweiterungsmanager aktiviert.
Sie sind als Superuser angemeldet — der Bildschirm für die Standardwerte ist Administratoren vorbehalten.
Ein Vorschaubild, mindestens 600 × 315 Pixel.
Für die Endkontrolle im Netz: eine von außen erreichbare Adresse. Ein Dienst kann keine Seite auslesen, die er nicht erreicht. Ohne das prüfen Sie im HTML-Quelltext, was auch genügt.

Schritt 1: Sehen, was die Seite heute schon ausgibt

Öffnen Sie eine Seite und lassen Sie sich den HTML-Quelltext anzeigen. Im <head> stehen bereits og:- und twitter:-Angaben, gebildet aus dem Seitentitel und den Vorgaben der Installation.

Das ist der Ausgangspunkt — nicht ein leeres Blatt.

Schritt 2: Die Standardwerte setzen

Administration → Social-Vorschau (Open Graph), direkt /doku.php?do=admin&page=wkopengraph.

Feld	Was hinein gehört
Site-Name	Der Name der Site, wie er in einer Vorschau stehen soll.
Standardbild	Eine absolute Adresse, also mit `https://` beginnend.
Standard-Beschreibung	Der Text für Seiten ohne eigenen.

Die Karte unterhalb der Felder zeigt sofort, was aus den Werten wird.

Das Standardbild muss absolut angegeben werden. Eine wiki-relative Adresse ist stillschweigend wirkungslos: Der auslesende Dienst holt das Bild von seinem Server, und dort bedeutet ein wiki-relativer Pfad nichts.

Speichern Sie. Damit ist der Boden für jede Seite auf einmal angehoben.

Schritt 3: Eine einzelne Seite bestimmen

Setzen Sie auf die Seite einen <og>-Block:

<og>
title: Tourenplanung
description: Wie Touren geplant werden und welche Randbedingungen gelten.
image: :wiki:vorschau:tourenplanung.png
</og>

Der führende Doppelpunkt vor der Bildangabe kennzeichnet sie als Medien-Kennung statt als fertige Adresse; sie wird für Sie in eine absolute Adresse aufgelöst.

Denselben Block können Sie auch über Seiten-Markup pflegen auf dem Verwaltungsbildschirm bearbeiten. Das ist eine gewöhnliche Seitenänderung mit Revision — also jederzeit zurücknehmbar.

Ergebnis prüfen

Laden Sie die Seite neu und sehen Sie erneut in den HTML-Quelltext:

<meta property="og:title" …> trägt Ihren Titel.
Die Bildadresse ist absolut.
Eine Angabe, die Sie leer gelassen haben, erscheint gar nicht. Das ist beabsichtigt: Ein leeres content würde behaupten „diese Seite hat keine Beschreibung“ und den Dienst davon abhalten, sich selbst eine zu suchen. Die Angabe wegzulassen erlaubt ihm genau das.

Auslesende Dienste halten Ergebnisse hartnäckig fest. Dass eine Änderung im Netz nicht sofort sichtbar wird, ist der Regelfall und kein Fehler — der HTML-Quelltext ist die verlässliche Prüfung.

Nächster Schritt

wkopengraph — Referenz: alle Eigenschaften, das Kartenformat twitterCard, die Mindestmaße für Bilder.
wki18n — Titel, Beschreibung und Bild je Sprache aus einem Block: title: de:Tourenplanung|en:Delivery scheduling.