SOQVER Quelle vorbereiten
Deutsch

SO4AG Facts für WordPress

Ein kostenloses Plugin veröffentlicht die Angaben Ihres Unternehmens auf Ihrer eigenen Website. So können KI-Assistenten und andere Programme korrekt erfassen, was für wen und bis wann gilt. Dazu gehören Preise, Öffnungszeiten, Zahlung, Versand, Stornierung und Garantie.

Plugin herunterladen (ZIP, Version 0.1.0) Anleitung lesen

Kostenlos, ohne Konto und ohne kostenpflichtige Funktionen. Funktioniert mit WooCommerce. WordPress 6.4 oder neuer, PHP 7.4 oder neuer. Lizenz GPL-2.0-or-later.

Was das Plugin auf Ihrer Website bereitstellt

Eine Datei für Programme

https://your-site.com/so4ag.json

Alle Angaben stehen im offenen SO4AG-Format bereit. Jeder kann sie ohne Schlüssel und ohne Registrierung lesen.

Eine Seite für Ihre Besucher

Auf jeder beliebigen Seite können Sie eine Tabelle „Fakten und Bedingungen“ einfügen. Sie zeigt die Angabe, ihren Wert sowie für wen und bis wann sie gilt.

Die Tabelle lässt sich über einen Block oder den Shortcode [so4ag_facts] einfügen.

Strukturierte Daten

Dieselben Angaben stehen als JSON-LD (schema.org) im Code der Seite. Suchmaschinen und Tools, die JSON-LD bereits lesen, können sie dort abrufen.

So funktioniert es

1. Sie erfassen die Fakten

Im WordPress-Administrationsbereich. Mit WooCommerce genügt zum Einstieg ein Klick. Das Plugin schlägt Versandkosten und Zahlungsarten aus Ihren Shop-Einstellungen vor.

2. Sie bestätigen die Fakten

Es wird nichts automatisch veröffentlicht. Vor der Veröffentlichung müssen Sie ausdrücklich bestätigen, dass die Angaben stimmen.

3. Die Fakten sind in drei Formen öffentlich verfügbar

Die Datei, die Seite und die JSON-LD-Daten enthalten stets dieselbe zuletzt bestätigte Fassung. Unfertige Änderungen bleiben privat.

4. Das Plugin überwacht die Gültigkeitsdaten

Für jede Angabe ist ein letzter Gültigkeitstag festgelegt. Zwei Wochen vorher erinnert Sie der Administrationsbereich daran, die Angabe zu prüfen und erneut zu bestätigen.

Was zu jeder Angabe gehört

Schritt-für-Schritt-Anleitung

Die folgenden Bezeichnungen für Tabs und Schaltflächen entsprechen denen im Plugin.

Inhalt: 1. Installieren · 2. Ihr Unternehmen · 3. Fakten hinzufügen · 4. Bedingungen · 5. WooCommerce · 6. Veröffentlichen · 7. Die Seite · 8. Prüfen · 9. Aktuell halten · 10. llms.txt · 11. Fehlerbehebung

1. Plugin installieren

  1. Laden Sie die ZIP-Datei von dieser Seite herunter. Öffnen Sie im WordPress-Administrationsbereich Plugins → Add New → Upload Plugin, wählen Sie die heruntergeladene Datei aus und klicken Sie auf Install Now.
  2. Wählen Sie Activate. Im Administrationsmenü erscheint der neue Eintrag SO4AG Facts.

2. Geben Sie an, wer Sie sind

Prüfen Sie auf dem Tab Business den Namen Ihres Unternehmens und wählen Sie die Unternehmensart aus. Bei Bedarf können Sie Registrierungskennungen ergänzen (jeweils ein Schema und einen Wert, etwa ein und Ihre EIN oder vat und eine Umsatzsteuer-Identifikationsnummer). Die Kontaktangabe für Korrekturen ist freiwillig und öffentlich sichtbar.

3. Fügen Sie Ihre Fakten hinzu

Wählen Sie auf dem Tab Facts die Art der Angabe und klicken Sie auf Add. Für jede Angabe werden vier Punkte abgefragt:

  1. Der Wert oder We do not state this oder It does not apply to us.
  2. Bedingungen (Applies to): nur die Bedingungen, von denen die Angabe tatsächlich abhängt.
  3. Der letzte Gültigkeitstag (Applies until).
  4. Die Seite Ihrer Website, auf der die Angabe steht (Page that states it). Wenn Sie das Feld leer lassen, wird die Angabe als Ihre eigene Aussage veröffentlicht.
AngabeFundstelleErforderliche BedingungLängste Dauer
BetreiberFußzeile, AGB–400 Tage
StandortKontaktseite: Adresse und Öffnungszeiten–180 Tage
KontaktKontaktseitechannel180 Tage
PreisPreislisteitem60 Tage
ZahlungsartenAGB, Kasse–180 Tage
Buchung erforderlich, AntwortzeitBuchungsseite, Kontaktseite–90 Tage
Kostenlose Stornierung, StornogebührStornierungsbedingungen–90 Tage
GarantieGarantiebedingungen–180 Tage
Nimmt Neukunden anKontaktseite–30 Tage
VersandkostenVersandseitecountry, delivery_method60 Tage
Kostenloser Versand ab, NachnahmegebührVersandseitecountry / –60 Tage
Rückgabefrist, GarantiefristRückgabebedingungen, AGB–180 Tage

Das Plugin bietet 25 Fakten für jedes Unternehmen und 10 für einen Onlineshop. „Höchstdauer“ gibt an, für welchen Zeitraum Sie einen Fakt auf einmal bestätigen können. Das Plugin akzeptiert kein späteres Datum.

4. So verwenden Sie Bedingungen

5. Ein Onlineshop mit WooCommerce

Die Schaltfläche Suggest from the shop liest Ihre Shop-Einstellungen aus und erstellt Vorschläge für:

Für jeden Vorschlag wählen Sie Accept, Complete oder Dismiss. Vorschläge sind nicht öffentlich. Kann das Plugin Angaben nicht aus den Einstellungen lesen, weist es Sie darauf hin. Das gilt etwa für einen per Formel berechneten Preis, kostenlosen Versand nur per Gutschein oder Versanddienstleister aus anderen Plugins.

6. Bestätigen und veröffentlichen

Der Tab Confirm and publish zeigt, was veröffentlicht wird und was sich seit dem letzten Mal geändert hat. Bestätigen Sie per Kontrollkästchen, dass die Fakten heute zutreffen, und wählen Sie Confirm and publish. Danach bleiben alle Änderungen bis zur nächsten Bestätigung privat.

Um die Veröffentlichung der Fakten zurückzunehmen, wählen Sie im selben Tab Withdraw. Ihre Arbeitsfassung bleibt erhalten.

7. Zeigen Sie die Fakten auf einer Seite an

Wählen Sie im Tab Output and check die Option Create a draft page "Facts and terms", prüfen Sie die Seite, veröffentlichen Sie sie und verlinken Sie sie in Ihrer Fußzeile. Um die Fakten auf einer eigenen Seite einzubinden, fügen Sie den Block Facts and terms oder diesen Shortcode ein:

[so4ag_facts]
[so4ag_facts heading="no"]
[so4ag_facts level="h3"]

Das Plugin fügt Ihrer Website weder einen Link noch ein Badge hinzu und verändert die Ausgabe anderer Plugins nicht. Das JSON-LD erscheint nur auf Seiten, auf denen Sie die Fakten einbinden.

8. Prüfen Sie das Ergebnis

  1. Wählen Sie im Tab Output and check die Option Check the public addresses too. Die Prüfung kontrolliert die Dateistruktur, die Datumsangaben und ob die Seite dieselben Fakten wie die Datei enthält.
  2. Öffnen Sie die Adresse der Datei im Browser: https://your-site.com/so4ag.json
  3. Für eine zweite Prüfung fügen Sie die Adresse in das öffentliche Prüfwerkzeug ein.

9. Halten Sie Ihre Fakten aktuell

Nach Ablauf seiner Gültigkeit bleibt ein Fakt in der Datei. Programme behandeln ihn als historischen Eintrag, und die Tabelle kennzeichnet ihn entsprechend. Der Administrationsbereich warnt Sie 14 Tage vor Ablauf. Ein sinnvoller Aktualisierungsrhythmus:

10. llms.txt

Das Plugin kann unter /llms.txt eine kurze Datei bereitstellen, die auf Ihre Fakten verweist. Die Funktion ist standardmäßig deaktiviert. Sie können sie im Tab Output and check aktivieren. Hat Ihre Website bereits eine Datei unter llms.txt, lässt das Plugin sie unverändert und zeigt Ihnen die Zeilen, die Sie selbst ergänzen können.

11. Fehlerbehebung

Was Sie sehenWas Sie tun können
/so4ag.json meldet „Nicht gefunden“Der Webserver hat diese Adresse nicht an WordPress weitergeleitet. Aktivieren Sie sprechende Permalinks (Settings → Permalinks) oder bitten Sie Ihren Hostinganbieter, Anfragen für fehlende Dateien an WordPress weiterzuleiten. Bis dahin funktioniert die Adresse /?so4ag_facts=json.
Laut Prüfung enthält die Seite andere Fakten als die DateiIm Cache liegt eine ältere Kopie der Seite. Leeren Sie den Cache und prüfen Sie erneut.
Die Seite enthält kein JSON-LDAuf der Seite fehlen sowohl der Block als auch der Shortcode, oder das Theme ruft wp_footer() nicht auf.
Das Plugin lehnt ein Datum abFür jede Art von Fakten gibt es eine Höchstdauer, für die sie bestätigt werden können. Wählen Sie ein früheres Datum und bestätigen Sie die Fakten später erneut.
Die Website läuft über httpDie Datei wird bereitgestellt, aber Programme erwarten sie über https.

Was das Plugin nicht tut

Für Entwickler und Agenturen

Erstellen oder betreuen Sie Websites für Kunden? Die Erfassung der Fakten stellen Sie selbst in Rechnung. Da Fakten nur begrenzt gültig sind, muss sie jemand regelmäßig überprüfen. Wenn ein Kunde zusätzlich die Überwachung durch den SOQVER-Dienst abonniert, erhalten Sie über das Partnerprogramm einen Anteil an den Abogebühren. Das Konto und die Fakten gehören dem Kunden.

Partnerprogramm Format und Werkzeuge für Entwickler

Der Quellcode des Plugins ist im Paket enthalten und steht unter der Lizenz GPL-2.0-or-later. SO4AG ist ein offenes Format, das als Arbeitsentwurf vorliegt. Die Spezifikation, der Validator und die Leseprogramme sind kostenlos. Spezifikation · GitHub

Häufig gestellte Fragen

Benötige ich ein Konto oder einen kostenpflichtigen Dienst?

Nein. Das Plugin allein genügt, um die Fakten einzugeben und zu veröffentlichen, die Datei, die Seite und das JSON-LD bereitzustellen und die Prüfung durchzuführen.

Funktioniert das Plugin mit meinem SEO-Plugin?

Ja. Das Plugin verändert die Ausgabe anderer Plugins nicht. Es fügt seinen eigenen JSON-LD-Block nur auf Seiten hinzu, auf denen Sie die Fakten platzieren.

Was passiert, wenn die Gültigkeit eines Fakts abläuft?

Der Fakt bleibt in der Datei. Programme behandeln ihn als historischen Eintrag, und in der Tabelle wird er als nicht mehr gültig gekennzeichnet. Prüfen Sie den Fakt, legen Sie ein neues Datum fest und bestätigen Sie ihn erneut.

Was wird entfernt, wenn ich das Plugin lösche?

Die Einstellungen des Plugins, der Bearbeitungsstand der Fakten und die veröffentlichte Fassung werden entfernt. Von Ihnen erstellte Seiten bleiben ohne die Tabelle erhalten.

Plugin herunterladen (ZIP, Version 0.1.0)