_BuTToN_PuSHeR_

Schema für phpBB-Foren 3.3.x

Schema for phpBB ist eine kostenlose Erweiterung von ButtonPusher für phpBB 3.3.x, die Themenseiten von Foren um strukturierte Daten des Typs Schema.org DiscussionForumPosting ergänzt.

Die Erweiterung wurde für die strukturierten Daten von Google für Diskussionsforen entwickelt. Sie verwendet Microdata, die direkt mit den bereits sichtbaren Seiteninhalten verknüpft sind. Der vollständige Text von Beiträgen und Antworten wird nicht zusätzlich in einem separaten JSON-LD-Block dupliziert.

Support und Diskussion auf phpBB.com: Diskussionsthread zur Erweiterung Schema for phpBB.

Funktionen

  • Schema.org-Markup vom Typ DiscussionForumPosting für phpBB-Themenseiten.
  • Antworten auf der aktuellen Themenseite werden als Comment-Elemente ausgezeichnet, sofern sie unterstützten Text oder Bilder enthalten.
  • Thementitel und kanonische Themen-URL.
  • Autorenname und Autoren-URL, sofern verfügbar.
  • Öffentliche Profil-URLs für registrierte Benutzer.
  • Unterstützung für Gastautoren sowie gelöschte Benutzerkonten, einschliesslich lokalisierter Ersatznamen ohne ungültige Profillinks.
  • Veröffentlichungs- und Änderungsdatum.
  • Vollständiger sichtbarer Beitragstext als Microdata, ohne ihn im Seitenquelltext zu duplizieren.
  • Anzahl der Antworten über commentCount.
  • Anzahl der Themenaufrufe über InteractionCounter und ViewAction.
  • Angaben zum übergeordneten Forum.
  • In Beiträge eingebettete Bilder werden über die Eigenschaft image eingebunden.
  • Für phpBB-Bildanhänge wird die URL des vollständigen Bildes anstelle der automatisch erzeugten Vorschaubild-URL verwendet.
  • phpBB-Smileys und Inhaltssymbole werden von der Schema.org-Eigenschaft image ausgeschlossen.
  • Antworten, die ausschliesslich aus Smileys bestehen, werden nicht als Comment ausgezeichnet. Dadurch wird die Google-Warnung zu fehlenden Eigenschaften text, image oder video vermieden; bei commentCount werden diese Antworten weiterhin mitgezählt.
  • Unterstützung für Themen mit mehreren Seiten.
  • Sichere Verarbeitung von Themen, deren erster Beitrag gelöscht, ausgeblendet oder anderweitig nicht verfügbar ist.
  • Kompatibel mit ButtonPusher Clean URLs, wenn diese Erweiterung aktiviert ist.
  • Keine zusätzlichen Datenbanktabellen oder Migrationen.
  • Keine Einstellungen im Administrationsbereich erforderlich.
  • Keine Änderungen an den phpBB-Kerndateien.

Funktionsweise

Forenbeiträge können sehr umfangreich sein. Würde der vollständige Inhalt eines Themas mitsamt allen Antworten zusätzlich in einen zweiten JSON-LD-Block kopiert, würde dies den generierten HTML-Code unnötig vergrössern.

Schema for phpBB versieht stattdessen den bereits von phpBB ausgegebenen Nachrichtentext mit der Schema.org-Eigenschaft text und verknüpft ihn mit dem entsprechenden DiscussionForumPosting- oder Comment-Element.

So bleiben die strukturierten Daten unmittelbar mit den Inhalten verbunden, die Besucher tatsächlich sehen, ohne dass jeder Beitrag ein zweites Mal im Seitenquelltext erscheint.

Themen und Antworten

Wenn der Inhalt des ersten Beitrags verfügbar ist, wird dieser als zentrales DiscussionForumPosting verwendet. Antworten, die auf der aktuellen Seite angezeigt werden, werden als Comment-Elemente hinzugefügt, sofern sie unterstützten Text oder Bilder enthalten.

Antworten, die ausschliesslich phpBB-Smileys enthalten, werden nicht als Comment-Elemente ausgegeben. Das HTML-Attribut alt eines Smileys wird nicht als sichtbarer Beitragstext gewertet, und dekorative Smiley-Bilder werden nicht als Inhaltsbilder ausgegeben. Diese Antworten bleiben dennoch in commentCount enthalten.

Wurde der erste Beitrag gelöscht, ausgeblendet oder ist er auf der ersten Themenseite anderweitig nicht verfügbar, verhindert die Erweiterung die Ausgabe eines unvollständigen DiscussionForumPosting ohne gültige Eigenschaft text, image oder video. Dadurch werden kritische Fehler in den strukturierten Daten vermieden, ohne fehlende Beitragsinhalte zu erfinden.

Bei Themen mit mehreren Seiten verweist der Hauptbeitrag weiterhin auf die erste Themenseite, während Antworten ihre dauerhaften Beitrags-URLs verwenden. Ist ButtonPusher Clean URLs installiert und aktiviert, verwendet Schema for phpBB automatisch die entsprechenden suchmaschinenfreundlichen URLs für Themen, Foren, Profile und Beiträge.

Bilder

Die Erweiterung fügt der Schema.org-Eigenschaft image ausschliesslich echte Inhaltsbilder hinzu.

Eingebettete Bilder und phpBB-Bildanhänge werden automatisch erkannt. Bei Anhängen wird die URL des vollständigen Bildes verwendet, nicht die des kleineren technischen Vorschaubildes, das phpBB erstellt.

Smileys, Symbole und ähnliche grafische Elemente der Benutzeroberfläche werden bewusst ausgeschlossen, da sie keine repräsentativen Bilder des Beitrags sind. Antworten mit normalem Text und zusätzlichen Smileys können weiterhin als Comment ausgezeichnet werden.

Bei einem Thema, das ausschliesslich Text enthält, kann der Google Rich Results Test die Warnung Missing field "image" (optional) anzeigen. Das ist zu erwarten und macht die strukturierten Daten nicht ungültig.

Ältere Videobeiträge

Einige ältere phpBB-Integrationen für [video] geben im serverseitig generierten HTML lediglich einen Platzhalter für den Videoplayer aus. Dadurch stehen nicht genügend Informationen zur Verfügung, um ein gültiges Schema.org-VideoObject zu erzeugen.

Eine Antwort, die ausschliesslich ein solches älteres Video-Widget enthält, wird deshalb nicht als eigenständiges Comment ausgegeben, sofern sie nicht zusätzlich unterstützten Text oder Bilder enthält. Die Antwort wird weiterhin in commentCount berücksichtigt.

Damit wird verhindert, dass unvollständiges Comment-Markup ohne gültige Eigenschaft text, image oder video entsteht.

Systemanforderungen

  • phpBB 3.3.0 oder neuer innerhalb der phpBB-3.x-Reihe.
  • PHP 7.2 oder neuer.

Enthaltene Sprachen

Die Erweiterung enthält Sprachpakete für Tschechisch, Deutsch, Englisch, Spanisch, Französisch, Hebräisch, Italienisch, Polnisch, Portugiesisch, brasilianisches Portugiesisch, Russisch, Türkisch und Ukrainisch.

Installation

  1. Das Archiv der Erweiterung herunterladen.
  2. Das Archiv in die phpBB-Installation entpacken, sodass sich die Erweiterungsdateien in folgendem Verzeichnis befinden:
    ext/buttonpusher/schema/
  3. Den phpBB-Administrationsbereich (ACP) öffnen.
  4. Zu Customise → Manage extensions wechseln.
  5. ButtonPusher Schema for phpBB Forums suchen und auf Enable klicken.
  6. Den phpBB-Cache leeren.

Um eine bestehende Installation zu aktualisieren, die Erweiterung zunächst deaktivieren, ohne ihre Daten zu löschen. Anschliessend die Erweiterungsdateien durch die neue Version ersetzen, die Erweiterung erneut aktivieren und den phpBB-Cache leeren. Falls eine ältere PHP-Datei zwischengespeichert bleibt, zusätzlich den PHP-OPcache leeren.

Änderungen an den phpBB-Kerndateien, Templates oder der Datenbank sind nicht erforderlich.

Validierung

Nach der Installation ein öffentlich zugängliches Thema öffnen und dessen URL mit dem Google Rich Results Test oder dem Schema.org Markup Validator prüfen.

Es empfiehlt sich, verschiedene Arten von Themen zu testen: reine Textbeiträge, Themen mit mehreren Antworten, Antworten nur mit Smileys, Text mit Smileys, Bildanhänge, eingebettete Bilder, mehrseitige Diskussionen und Themen mit gelöschten oder nicht verfügbaren ersten Beiträgen.

Antworten, die ausschliesslich aus Smileys bestehen, sollten nicht als unvollständige Comment-Elemente erscheinen, aber weiterhin in der Gesamtzahl commentCount enthalten sein.

Version 1.0.2

  • Die Google-Search-Console-Warnung Specify "text", "image" or "video" für Comment-Elemente bei Antworten behoben, die ausschliesslich phpBB-Smileys enthalten.
  • Die Inhaltserkennung korrigiert: Das alt-Attribut eines Smiley-Bildes wird nicht mehr fälschlich als tatsächlicher Beitragstext interpretiert.
  • Antworten nur mit Smileys von den Comment-Microdata ausgeschlossen, statt einen leeren text-Wert zu erzeugen oder dekorative Symbole als Inhaltsbilder zu verwenden.
  • Die vollständige Anzahl der Antworten in commentCount beibehalten, einschliesslich Antworten nur mit Smileys, die nicht als strukturierte Comment-Elemente ausgegeben werden.
  • Die Verarbeitung normaler Textantworten, von Text mit Smileys, echten eingebetteten Bildern und phpBB-Bildanhängen beibehalten.
  • Keine Datenbankänderungen oder Migrationen erforderlich.

Version 1.0.1

  • Den Fehler wegen fehlendem author.name in Schema.org DiscussionForumPosting behoben, wenn der Benutzername des ursprünglichen Themenautors leer oder nicht verfügbar ist.
  • Eine lokalisierte Ersatzbezeichnung für Gastautoren ergänzt, deren Benutzernamen nicht mehr ermittelt werden können.
  • Die Verarbeitung gelöschter oder nicht verfügbarer Benutzerkonten verbessert, indem ungültige Autoren-Profil-URLs vermieden werden.
  • Den kritischen Fehler Specify "text", "image" or "video" im Google Rich Results Test für Themen behoben, deren ursprünglicher Beitrag nicht mehr verfügbar ist.
  • Die Ausgabe unvollständigen DiscussionForumPosting-Markups auf der ersten Themenseite verhindert, wenn der ursprüngliche Beitrag fehlt, ausgeblendet oder gelöscht wurde.
  • Die Generierung strukturierter Daten für reguläre Themen und mehrseitige Diskussionen beibehalten.
  • Die Kompatibilität mit älteren Forenthemen mit gelöschten Beiträgen oder nicht verfügbaren Autoren verbessert.
  • Keine Datenbankänderungen oder Migrationen erforderlich.

Version 1.0.0

  • Erste öffentliche Veröffentlichung.
  • Schema.org-Microdata vom Typ DiscussionForumPosting für phpBB-Themenseiten hinzugefügt.
  • Strukturierte Daten für Autoren, Datumsangaben, Antworten, Aufrufzahlen und übergeordnete Foren hinzugefügt.
  • Erkennung eingebetteter Bilder und Bildanhänge hinzugefügt.
  • Unterstützung für mehrseitige Themen hinzugefügt.
  • Kompatibilität mit ButtonPusher Clean URLs hinzugefügt.
  • phpBB-Smileys von den strukturierten Inhaltsbildern ausgeschlossen.
  • Die Verarbeitung älterer Antworten, die ausschliesslich Videos enthalten, verbessert, um ungültiges Comment-Markup zu vermeiden.
  • Sprachpakete für Tschechisch, Deutsch, Englisch, Spanisch, Französisch, Hebräisch, Italienisch, Polnisch, Portugiesisch, brasilianisches Portugiesisch, Russisch, Türkisch und Ukrainisch hinzugefügt.

Download

Schema for phpBB 1.0.2 herunterladen

Aktuelle Version: 1.0.2

Lizenz: GNU General Public License v2.0 only (GPL-2.0-only).

Kommentare (0)

Cherson TOP