_BuTToN_PuSHeR_

Clean URLs für phpBB 3.3.x

Clean URLs ist eine kostenlose phpBB-Erweiterung von ButtonPusher, die lange Standard-URLs von phpBB durch kurze, stabile und gut lesbare Adressen ersetzt.

Die Erweiterung sorgt für kompakte URLs, ohne die normale Funktionalität von phpBB einzuschränken. Statt langer Abfragezeichenfolgen wie viewtopic.php?f=5&t=123 erzeugt Clean URLs einfache, ID-basierte Adressen.

Support und Diskussion auf phpBB.com: Diskussion zur Erweiterung Clean URLs.

Funktionen

  • Kurze URLs für Themen, Foren, Beiträge, Benutzerprofile, Mitgliederlisten, Suchseiten und die Anzeige der aktuell angemeldeten Benutzer.
  • Stabile, ID-basierte URLs, die nicht von Themen- oder Forentiteln abhängen.
  • Übersichtliche URLs für die Seitennummerierung von Themen, Foren, Mitgliederlisten und weiteren unterstützten Seiten.
  • Einstellungsseite im Administrationsbereich (ACP).
  • Anpassbare URL-Muster für unterstützte Routen.
  • Unterstützung für Platzhalter wie [ID], [START] und [CHAR].
  • Konfigurierbares URL-Format für Themen, beispielsweise t[ID] oder topic[ID].
  • Konfigurierbares URL-Format für Foren, beispielsweise forum-[ID] oder f[ID].
  • Konfigurierbares Format für direkte Beitrags-URLs, beispielsweise p[ID] oder post[ID].
  • Wahl zwischen direkten Beitrags-URLs und SEO-freundlichen, themenbasierten Beitragslinks.
  • Optimierte Erzeugung SEO-freundlicher Beitragslinks mit geringerer Datenbanklast.
  • Dynamisch erzeugte Rewrite-Regeln für Apache/LiteSpeed und nginx auf Grundlage der aktuellen URL-Einstellungen.
  • Option zum Zurücksetzen auf die Standardeinstellungen im ACP.
  • Bereinigte Links im von phpBB erzeugten HTML.
  • Unterstützung für direkte Beitragslinks und Beitragsanker.
  • Korrekte themenbasierte URLs beim Öffnen des ersten ungelesenen Beitrags aus einer phpBB-E-Mail-Benachrichtigung.
  • Korrekte Freigabelinks für moderationspflichtige Themen und Antworten, einschließlich bereinigter Rücksprung-URLs nach der Freigabe.
  • Bereinigte URLs in Sitemaps.
  • Weiterleitungen von unterstützten Standard-URLs von phpBB.
  • Entfernung von Sitzungs-IDs aus öffentlichen Foren-URLs im SEO-freundlichen Modus unter Beibehaltung erforderlicher URL-Parameter.
  • Beibehaltung der nativen Sitzungsverwaltung im Kompatibilitätsmodus sowie sicherheitsrelevanter Sitzungs-IDs für Administration und Abmeldung.
  • Funktioniert mit phpBB im Stammverzeichnis einer Domain oder in einem Unterverzeichnis wie /forum/.
  • Keine Änderungen an den Kerndateien von phpBB erforderlich.
  • Unterstützung für Apache, LiteSpeed und nginx.
  • Mehrere Sprachpakete enthalten.

Screenshot

ButtonPusher Clean URLs

URL-Beispiele

Mit den Standardeinstellungen verwendet Clean URLs kompakte Routen wie:

  • /t123 – Thema
  • /t123-20 – Thema mit Seitennummerierung
  • /forum-5 – Forum
  • /forum-5-25 – Forum mit Seitennummerierung
  • /p456 – direkte Beitrags-URL
  • /memberlist-50 – Mitgliederliste mit Seitennummerierung
  • /memberlist-a – nach Anfangsbuchstaben gefilterte Mitgliederliste
  • /profile-17 – Benutzerprofil
  • /team – Teamseite
  • /newposts – Suche nach neuen Beiträgen
  • /unanswered – unbeantwortete Themen
  • /activetopics – aktive Themen
  • /viewonline – Benutzer, die gerade online sind
  • /login – Anmeldeseite
  • /register – Registrierungsseite

Ein Link zu einem bestimmten Beitrag kann eine direkte URL wie /p456#p456 verwenden oder, wenn der SEO-freundliche Modus für Beitragslinks aktiviert ist, eine themenbasierte URL wie /t123#p456.

Die URL-Muster lassen sich im Administrationsbereich ändern. Beispielsweise kann t[ID] durch topic[ID] und p[ID] durch post[ID] ersetzt werden.

Voraussetzungen

  • phpBB 3.3.x
  • PHP 7.2 oder neuer
  • Apache oder LiteSpeed mit mod_rewrite oder nginx
  • Berechtigung zum Bearbeiten der .htaccess oder der nginx-Serverkonfiguration

Installation

  1. Laden Sie das Archiv der Erweiterung herunter.
  2. Entpacken Sie es in Ihre phpBB-Installation, sodass sich die Dateien der Erweiterung hier befinden:
    ext/buttonpusher/cleanurls/
  3. Öffnen Sie bei Apache oder LiteSpeed die Datei:
    ext/buttonpusher/cleanurls/docs/apache-rules.txt

    Dieselben Rewrite-Regeln für Apache/LiteSpeed stehen auch auf der Einstellungsseite von Clean URLs im Administrationsbereich zur Verfügung.
  4. Fügen Sie die Rewrite-Regeln in die .htaccess-Datei Ihrer phpBB-Installation ein, direkt nach der Zeile:
    RewriteEngine on
  5. Wenn phpBB in einem Unterverzeichnis wie /forum/ installiert ist, bearbeiten Sie die .htaccess-Datei in diesem phpBB-Verzeichnis.
  6. Verwenden Sie bei nginx die mitgelieferten Rewrite-Regeln oder kopieren Sie sie von der Einstellungsseite von Clean URLs im Administrationsbereich.
  7. Speichern Sie die Webserver-Konfiguration.
  8. Öffnen Sie den Administrationsbereich von phpBB.
  9. Wechseln Sie zu Anpassen → Erweiterungen verwalten.
  10. Suchen Sie Clean URLs und klicken Sie auf Aktivieren.
  11. Öffnen Sie die Einstellungsseite von Clean URLs im Administrationsbereich.
  12. Überprüfen Sie die URL-Muster und den Modus für Beitragslinks.
  13. Wenn Sie URL-Muster gegenüber den Standardwerten ändern, kopieren Sie die neu erzeugten Rewrite-Regeln für Apache/LiteSpeed oder nginx von der Einstellungsseite und aktualisieren Sie die Serverkonfiguration entsprechend.
  14. Leeren Sie den phpBB-Cache.

Apache und LiteSpeed

Für Apache und LiteSpeed sind die standardmäßigen Rewrite-Regeln in folgender Datei enthalten:

ext/buttonpusher/cleanurls/docs/apache-rules.txt

Dieselben Regeln werden auch auf der Einstellungsseite von Clean URLs im Administrationsbereich angezeigt und können direkt von dort kopiert werden.

Fügen Sie die Regeln in die .htaccess-Datei von phpBB ein, direkt nach:

RewriteEngine on

Wenn phpBB in einem Unterverzeichnis wie /forum/ installiert ist, bearbeiten Sie die .htaccess-Datei in diesem Verzeichnis.

Wenn Sie URL-Muster auf der Einstellungsseite von Clean URLs ändern, verwenden Sie die dort erzeugten, aktualisierten Apache/LiteSpeed-Regeln anstelle der Standardregeln aus apache-rules.txt.

Die Kerndateien von phpBB müssen nicht geändert werden.

nginx

nginx verwendet keine .htaccess. Die Erweiterung enthält fertige nginx-Rewrite-Regeln für die standardmäßige URL-Konfiguration.

Die nginx-Regeln werden auch auf der Einstellungsseite von Clean URLs im Administrationsbereich angezeigt und können dort direkt kopiert werden.

Wenn Sie URL-Muster ändern, werden die auf der Einstellungsseite erzeugten nginx-Regeln entsprechend aktualisiert.

Fügen Sie die Regeln in den Serverblock Ihrer phpBB-Installation ein, laden Sie die nginx-Konfiguration neu und leeren Sie den phpBB-Cache.

URL-Einstellungen

Seit Version 1.0.3 verfügt Clean URLs über eine Einstellungsseite im Administrationsbereich, auf der die unterstützten URL-Muster angepasst werden können.

Beispiele:

  • t[ID] oder topic[ID] für Themen
  • forum-[ID] oder f[ID] für Foren
  • p[ID] oder post[ID] für direkte Beitrags-URLs
  • profile-[ID] für Benutzerprofile
  • memberlist-[START] für die Seitennummerierung der Mitgliederliste

Erforderliche Platzhalter müssen in den URL-Mustern erhalten bleiben. Beispielsweise muss eine Themenroute [ID] enthalten.

Bei jeder Änderung eines URL-Musters erzeugt die Erweiterung auf derselben Einstellungsseite passende Rewrite-Regeln für Apache/LiteSpeed und nginx.

Modi für Beitragslinks

Clean URLs bietet zwei Modi für Links zu einzelnen Beiträgen.

Der Modus für direkte Beitragslinks verwendet Adressen wie:

/p456#p456

Diese Variante ist kompatibler, da die Beitrags-ID ausreicht, um den Beitrag auch dann zu finden, wenn er später in ein anderes Thema verschoben wird.

Der SEO-freundliche, themenbasierte Modus verwendet Adressen wie:

/t123#p456

Dadurch entsteht eine übersichtlichere themenbasierte Adresse. Ein solcher Link kann jedoch weniger zuverlässig sein, wenn der Beitrag in ein anderes Thema verschoben wird.

Version 1.0.2 optimiert die Erzeugung SEO-freundlicher Beitragslinks und beseitigt unnötige Datenbankabfragen pro Link, die auf manchen Seiten zu hoher Serverlast und HTTP-503-Fehlern führen konnten.

Seit Version 1.0.3 werden direkte Beitragslinks wie /p456#p456 im SEO-freundlichen Modus auf das entsprechende Thema mit Beitragsanker weitergeleitet, beispielsweise auf /t123#p456. Befindet sich der Beitrag auf einer späteren Seite, enthält die Zieladresse den korrekten Seitenoffset, etwa /t123-20#p456. Benutzerdefinierte URL-Muster und phpBB-Installationen in Unterverzeichnissen werden unterstützt.

Version 1.0.7 behebt fehlerhafte Links zum ersten ungelesenen Beitrag aus phpBB-E-Mail-Benachrichtigungen. Im SEO-freundlichen Modus führt ein Link wie /t123?e=1&view=unread#unread nun zur themenbasierten Beitrags-URL, beispielsweise /t123#p456 oder /t123-20#p456 bei einem Beitrag auf einer späteren Seite. Stattdessen blieb zuvor eine direkte Beitrags-URL wie /p456#p456 in der Adressleiste des Browsers stehen.

Version 1.0.6 behebt fehlerhafte Freigabelinks für moderationspflichtige Beiträge. Wenn ein Administrator den ersten Beitrag eines neuen Themas freigibt, führt die Rücksprung-URL nun zur bereinigten Themenadresse, beispielsweise /t123, statt zu einer fehlerhaften Adresse wie /t123&p=456#p456. Bei der Freigabe späterer Antworten bleibt das korrekte Beitragsziel einschließlich Seitennummerierung und konfigurierter URL-Muster erhalten.

Nach dem Erstellen eines Themas oder dem Bearbeiten seines ersten freigegebenen Beitrags führt der Rücksprung-Link zur bereinigten Themen-URL. Nach dem Speichern einer Antwort oder dem Bearbeiten eines anderen Beitrags gelangt der Benutzer zum betreffenden Beitrag, einschließlich des korrekten Seitenoffsets und eines einzelnen Beitragsankers.

Im SEO-freundlichen Modus wird sid aus öffentlichen Foren-URLs entfernt; die Anmeldung wird über Cookies aufrechterhalten. Cookies müssen daher aktiviert und die Cookie-Einstellungen des Forums korrekt konfiguriert sein. URLs des Administrationsbereichs und Abmeldelinks behalten die von phpBB benötigten Sicherheits-Sitzungs-IDs. Im Kompatibilitätsmodus bleibt die native Verarbeitung von Sitzungs-IDs erhalten.

Die im Administrationsbereich angezeigten Beispiele berücksichtigen automatisch die konfigurierten URL-Muster für Themen und direkte Beitragslinks.

Keine Änderungen am phpBB-Kern

Clean URLs funktioniert als reguläre phpBB-Erweiterung. Änderungen an den PHP-Kerndateien oder Templates von phpBB sind nicht erforderlich.

Serverseitig muss lediglich die URL-Umschreibung für Apache, LiteSpeed oder nginx eingerichtet werden.

Erweiterung deaktivieren oder entfernen

Wenn Sie Clean URLs deaktivieren, verwendet phpBB wieder sein standardmäßiges URL-Format. Die IDs von Foren, Themen, Beiträgen und Benutzern bleiben unverändert.

Wenn Sie die Erweiterung dauerhaft entfernen, löschen Sie auch die Rewrite-Regeln, die Sie zur .htaccess-Datei oder nginx-Konfiguration hinzugefügt haben.

Änderungsprotokoll

1.0.7

  • Links zum ersten ungelesenen Beitrag aus phpBB-E-Mail-Benachrichtigungen im SEO-freundlichen Modus korrigiert. URLs wie /t123?e=1&view=unread#unread führen nun zu bereinigten, themenbasierten Beitrags-URLs wie /t123#p456, statt bei /p456#p456 zu enden.
  • Die von phpBB für den Anker ungelesener Beiträge und die Aktualisierung der Browser-Adressleiste per JavaScript verwendete URL U_MINI_POST korrigiert.
  • Seitennummerierung von Themen, benutzerdefinierte Themen-URL-Muster, bestehende direkte Beitragslinks und Weiterleitungen nach Moderationsfreigaben beibehalten.
  • Keine Änderungen an Rewrite-Regeln für Apache/LiteSpeed oder nginx, Erweiterungseinstellungen oder phpBB-Kerndateien erforderlich.

1.0.6

  • Fehlerhafte MCP-Weiterleitungen nach Freigaben korrigiert, bei denen phpBB &p=POST_ID#pPOST_ID an eine bereits bereinigte Themen-URL anhängte und das Ergebnis in den URL-codierten Parameter redirect einfügte.
  • Nach der Freigabe des ersten Beitrags eines noch nicht freigegebenen Themas wird der Administrator zur bereinigten Themen-URL, beispielsweise /t123, zurückgeführt statt zu /t123&p=456#p456.
  • Beitragsspezifische Zieladressen bei der Freigabe späterer Antworten erhalten, einschließlich Seitennummerierung, gewähltem Beitragslink-Modus und benutzerdefinierten URL-Mustern.
  • Andere MCP-Aktionen, gültige Weiterleitungen, Bestätigungstoken und sicherheitsrelevante Parameter unverändert gelassen.

Bereits funktionierende Rewrite-Regeln für Apache/LiteSpeed und nginx müssen beim Update von 1.0.5 auf 1.0.6 nicht geändert werden.

1.0.5

  • Fehlerhafte Weiterleitungen nach dem Verschieben eines Themas in ein anderes Forum über die Schnellmoderation von phpBB korrigiert. Der Browser öffnet nun die bereinigte Themen-URL, beispielsweise /t123, statt einer fehlerhaften URL wie /.%2Ft123.
  • Doppelte URL-Codierung des bereits von phpBB codierten Parameters redirect verhindert.
  • Codierte Abfrageparameter in Weiterleitungen sowie die Verarbeitung von Pluszeichen erhalten, ohne benutzerdefinierte URL-Muster oder andere URL-Parameter zu beeinträchtigen.

Bereits funktionierende Rewrite-Regeln für Apache/LiteSpeed und nginx müssen beim Update von 1.0.4 auf 1.0.5 nicht geändert werden.

1.0.4

  • Den expliziten Parameter t=TOPIC_ID beibehalten, wenn Erweiterungen von Drittanbietern Links zum letzten Beitrag mit sowohl t=TOPIC_ID als auch p=POST_ID erzeugen.
  • Kompatibilität mit Precise Similar Topics 1.8.0 und RH Topic Tags 3.0.0 verbessert, indem diese Links in kanonischer Themenform wie t123#p456 erhalten bleiben, statt auf p456#p456 reduziert zu werden.
  • Links in Suchergebnissen mit hilit korrigiert, sodass URLs wie viewtopic.php?t=123&hilit=... unter Beibehaltung der Suchbegriffhervorhebung in t123?hilit=... umgewandelt werden.

Bereits funktionierende Rewrite-Regeln für Apache/LiteSpeed und nginx müssen beim Update von 1.0.3 auf 1.0.4 nicht geändert werden.

1.0.3

  • Sitzungs-IDs im SEO-freundlichen Modus aus öffentlichen Foren-URLs entfernt, einschließlich Navigationslinks, Beitragsformularen und Weiterleitungszielen.
  • Sicherheitsrelevante Sitzungs-IDs für den Administrationsbereich und die Abmeldung sowie die native Sitzungsverwaltung im Kompatibilitätsmodus beibehalten.
  • Doppelte Beitragsanker wie #p456#p456 in Links und Weiterleitungen nach dem Speichern von Beiträgen korrigiert.
  • Rücksprung-URL nach dem Erstellen eines Themas oder dem Bearbeiten seines ersten freigegebenen Beitrags korrigiert, sodass sie zur bereinigten Themenadresse führt.
  • Rücksprung zu einer gespeicherten Antwort oder einem bearbeiteten, nicht ersten Beitrag korrigiert, einschließlich Beiträgen auf späteren Themenseiten.
  • Weiterleitungen von direkten Beitrags-URLs wie /p456#p456 auf die entsprechende Themen-URL mit Seitenoffset und Beitragsanker im SEO-freundlichen Modus korrigiert.
  • Bereits vorhandene Seitenoffsets von Themen bei der Verarbeitung bereinigter Beitragslinks erhalten.
  • Verarbeitung von Weiterleitungen direkter Beitragslinks für benutzerdefinierte URL-Muster und Foren in Unterverzeichnissen verbessert.
  • Relative Navigationslinks im ACP korrigiert, indem Administrationsanfragen von der URL-Umschreibung und dem Entfernen der Sitzungs-ID ausgenommen wurden.

Bereits funktionierende Rewrite-Regeln für Apache/LiteSpeed und nginx müssen beim Update von 1.0.2 auf 1.0.3 nicht geändert werden.

1.0.2

  • HTTP-503-Fehler behoben, die auf einigen Seiten bei aktivierten SEO-freundlichen Beitragslinks auftreten konnten.
  • Erzeugung SEO-freundlicher, themenbasierter Beitrags-URLs optimiert.
  • Unnötige Datenbankabfragen pro Link bei der Seitengenerierung entfernt.
  • Datenbanklast auf Seiten mit vielen Beitragslinks reduziert.
  • Verarbeitung von Links zum letzten Beitrag auf der Forenübersicht und auf Forenseiten verbessert.
  • Kompatibilität mit Themen- und Beitragszählern von phpBB 3.3.x verbessert.
  • SEO-freundliche Themen-URLs und Beitragsanker erhalten, ohne die übermäßige Anzahl an Datenbankabfragen zu verursachen.

1.0.1

  • Einstellungsseite im Administrationsbereich hinzugefügt.
  • Konfigurierbare URL-Muster für Themen, Foren, Beiträge, Profile, Mitgliederlisten, Suchseiten, Seiten mit angemeldeten Benutzern, Anmeldung, Registrierung und weitere unterstützte phpBB-Routen hinzugefügt.
  • Unterstützung für benutzerdefinierte Routenmuster mit Platzhaltern wie [ID], [START] und [CHAR] hinzugefügt.
  • Auswahl zwischen direkten Beitrags-URLs und SEO-freundlichen, themenbasierten Beitrags-URLs hinzugefügt.
  • Dynamisch erzeugte Rewrite-Regeln für Apache/LiteSpeed und nginx im ACP hinzugefügt.
  • Option zum Zurücksetzen der Einstellungen von Clean URLs auf die Standardwerte hinzugefügt.
  • URLs für die Seitennummerierung der Mitgliederliste wie /memberlist-50 korrigiert.
  • URLs für die Seitennummerierung von Themen wie /t123-20 korrigiert.
  • Seitennummerierung von Foren und alphabetisch gefilterten Mitgliederlisten verbessert.
  • Doppelte Beitragsanker wie #p456#p456 korrigiert.
  • Kompatibilität direkter Beitragslinks verbessert.
  • Unterstützung für alle enthaltenen Sprachpakete beibehalten.

1.0.0

  • Erste öffentliche Veröffentlichung.
  • Bereinigte URLs für Themen, Foren, Beiträge, Profile, Mitgliederlisten, Suchseiten und die Anzeige angemeldeter Benutzer hinzugefügt.
  • Rewrite-Regeln für Apache/LiteSpeed und nginx hinzugefügt.
  • Unterstützung für phpBB-Installationen im Stammverzeichnis einer Domain und in Unterverzeichnissen hinzugefügt.

Download

Clean URLs 1.0.7 herunterladen

Aktuelle Version: 1.0.7

Kommentare (0)

Cherson TOP