Stand: 20.7.2025, Plugin Pro Version 1.0.0
1. Einleitung
Flex Redirect ist ein einfaches Plugin für Joomla! 4 und Joomla! 5, mit dessen Hilfe sich Weiterleitungen erstellen lassen Das Plugin prüft, ob bestimmte Parameter und Werte im Query-String der URL vorhanden sind und leitet dann entsprechend weiter. Die Weiterleitungen kannst du im Plugin individuell konfigurieren.
2. Anforderungen
Flex Redirect ist eine Joomla-Erweiterung, daher benötigst du eine Joomla-Webseite. Das Plugin funktioniert mit den Joomla-Versionen 4.x und 5.x. Bitte stelle sicher, dass mindestens PHP 7.4+ auf deinem Webspace läuft.
3. Installation & Aktualisierung
Wenn du Flex Redirect von meiner Website herunterlädst, erhältst du eine Datei mit dem Namen flexredirect_VERSION.zip oder flexredirect_pro_VERSION.zip. VERSION steht für die aktuelle Version des Plugins.
- Melde dich als Superadministrator im Backend deiner Joomla-Installation an.
- Gehe zu System und klicke auf Installieren → Erweiterungen
- Ziehe die Datei in den Upload-Bereich oder wähle die Datei über den Upload-Button aus.
Nachdem der Installationsvorgang abgeschlossen ist, wirst du benachrichtigt. Navigiere zum Plugin (System → Verwalten → Plugins) und aktiviere es.
Wenn eine neuere Version des Flex Redirect Plugins zum Download bereitsteht, wirst du im Joomla-Backend darüber informiert. Du kannst dann direkt über Erweiterungen: Aktualisieren die neueste Version installieren. Wenn du die Pro-Version von Flex Redirect nutzt, so stelle sicher, dass du eine gültige Download ID in das entsprechende Feld eingegeben hast. Alternativ kannst du die neuesten Versionen auch von meiner Webseite herunterladen und wie oben erläutert installieren.
4. Weiterleitungsregeln einrichten (Pro-Version)
Wenn du das Plugin öffnest, kannst du die Weiterleitungen nach deinen Wünschen anlegen. Das Plugin fragt den Query-String aus der URL ab und vergleicht mit den angegebenen Regeln. Ein Query-String sieht zum Beispiel so aus: /example?id=1&color=white Ist in der Regel im Feld Parameter "color" und im Feld Wert "white" angegeben, so leitet das Plugin auf die Adresse, welche im Feld Ziel-URL eingetragen wird.
Parameter: Gib hier den Parameter (Name) an, welcher im Query-String angefragt wird, also z.B. "color".
Wert: Hier muss der entsprechende Wert des Parameters eingetragen werden, also z.B. "white".
Ziel-URL: Gib die Adresse an, zu welcher weitergeleitet werden soll. Dies kann eine relative oder absolute URL sein. Bei relativen URLs stelle bitte ein Slash "/" an den Anfang.
Weiterleitungstyp: Hier kannst du den entsprechenden Typ der Weiterleitung angeben. Du kannst zwischen 301 (permanent), 302 (temporär) und 307 (temporär strikt) wählen und so dauerhafte oder vorübergehende Weiterleitungen einrichten. Dies kann für SEO wichtig sein. Beachte, dass der Weiterleitungstyp nur einbezogen wird, wenn du im Plugin im Tab Einstellungen die Option Weiterleitungstyp aktiviert hast. Ist diese nicht aktiv, wird automatisch eine temporäre 302-Weiterleitung genutzt.
Regulärer Ausdruck: Klicke das Kästchen an, wenn du reguläre Ausdrücke für die entsprechende Weiterleitungsregel nutzen möchtest. Hier ein paar Beispiele für reguläre Ausdrücke:
wert=\d{4}→ nur vierstellige Zahlenpage=(home|kontakt|about)→ bestimmte Wertegruppenid=^abc→ beginnt mit "abc"
Sprache: Hier kannst du die Sprache auswählen, für welche die Weiterleitungsregel gelten soll. Dies ist nützlich, wenn du mehrsprachige Seiten betreibst. So kannst du zum Beispiel für die deutsche Seite (de-DE) eine andere Weiterleitung einrichten als für die englische Seite (de-GB). In der Dropdownliste erscheinen alle auf der Seite installierten Sprachen. Wenn die Weiterleitung für alle Sprachen gelten soll, so wähle dies entsprechend aus.
5. Weiterleitungsregeln einrichten (kostenlose Version)
In der kostenlosen Version des Plugins findest du nur ein Feld, in dem du die Weiterleitungsregeln einrichten kannst. Gib hier eine Regel pro Zeile im folgenden Format an: parameter=value:/target-url
Bitte beachte, dass es Parameter gibt, die von Joomla intern verwendet werden - zum Beispiel "id", "option", "view", "ItemId" usw. Diese Parameter solltest du nicht benutzen, um keine Konflikte mit Joomla oder installierten Erweiterungen auszulösen. In der Pro-Version des Flex Redirect Plugins kannst du wählen, ob diese Parameter genutzt werden dürfen oder nicht.
Du kannst beliebig viele Weiterleitungen einrichten, es werden jedoch nur die ersten fünf genutzt. Wenn du mehr nutzen möchtest, so musst du die Pro-Version kaufen.
6. Einstellungen *
Flex Redirect Pro bietet dir weitere Möglichkeiten, das Plugin zu konfigurieren. Klicke dazu auf den Tab Einstellungen.
Reservierte Parameter zulassen (nicht empfohlen): Joomla nutzt bestimmte Parameter intern, z. B. 'id', 'view', 'option', was zu Konflikten führen kann. Standardmäßig ist diese Option deaktiviert, so dass die reservierten Parameter nicht genutzt werden können. Du kannst sie in den Weiterleitungsregeln angeben, dann wird die entsprechende Regel jedoch ignoriert. Bitte aktiviere diese Option nur, wenn du sicher bist, was du tust.
Weiterleitungstyp: Wenn diese Option aktiviert ist, werden die bei den Weiterleitungsregeln angegebenen Typen (301, 302, 307) genutzt. Ist die Option nicht aktiv, so wird jede Weiterleitung mit dem Code 302 versehen.
6. Download-ID *
Wenn du die Pro-Version von Flex Redirect gekauft hast, gib bitte deine Download-ID ein, um Updates über das Joomla-Update-System zu erhalten.
7. Deinstallation
Um das Plugin zu deinstallieren, gehe zu System, klicke auf Installieren → Erweiterungen und wählen dann Erweiterungen verwalten in der oberen Leiste aus. Wähle das Plugin Flex Redirect aus und klicke auf Deinstallieren, um das Plugin von der Joomla-Seite zu löschen.
8. Support
Wenn du Hilfe benötigst, dann wende dich per Support-Ticket an mich. Logge dich dazu in dein Benutzerkonto ein und wähle aus dem Top-Menü Support aus. Du erhältst von mir schnellstmöglich eine Antwort.
* nur in der Pro-Version verfügbar