yakamara/yrewrite

There is no license information available for the latest version (2.12.0) of this package.

yrewrite for REDAXO 6: URL rewriting, multidomain and SEO

Maintainers

Package info

github.com/yakamara/yrewrite

Type:redaxo-addon

pkg:composer/yakamara/yrewrite

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 56

Open Issues: 45

2.12.0 2025-06-26 14:32 UTC

README

YRewrite erzeugt sprechende URLs und verwaltet mehrere Domains in einer REDAXO-Installation. Aus index.php?article_id=13&clang=1 wird zum Beispiel /de/news/archiv/. Zusätzlich liefert das AddOn die SEO-Ausgabe (Meta-Tags, Open Graph, Canonical, hreflang), eine sitemap.xml und eine robots.txt je Domain.

Das ist yrewrite für REDAXO 6 (Composer-Paket yakamara/yrewrite, Namespace Yakamara\YRewrite, Branch 3.x).

Funktionen

  • Mehrere Domains in einer Installation, optional pro Sprache (clang)
  • Sprechende, suchmaschinenfreundliche URLs in verschiedenen Schemata
  • Eigene URL pro Artikel sowie Umleitungen auf einen Artikel oder eine externe Adresse
  • Allgemeine Weiterleitungen (301/302/303/307) für URLs, die es in der Struktur nicht gibt – praktisch beim Relaunch
  • Alias-Domains, die auf eine Hauptdomain weiterleiten
  • SEO-Daten pro Artikel: Titel, Description, Vorschaubild, Indexierung, Canonical-URL
  • sitemap.xml und robots.txt, domain- und sprachabhängig
  • Seitentitel-Schema pro Domain
  • Erweiterbar über eigene URL-Schemes und Extension Points

Voraussetzungen

  • REDAXO 6
  • PHP 8.5 oder neuer
  • Apache mit mod_rewrite (für NGINX siehe Hinweis bei der Installation)

Installation

YRewrite wird in REDAXO 6 über Composer eingebunden.

  1. Paket im Projektverzeichnis installieren:

    composer require yakamara/yrewrite
  2. AddOn installieren und aktivieren – im Backend unter AddOns oder über die Konsole:

    php bin/console addon:install yrewrite
  3. .htaccess einrichten: im Backend unter YRewrite → Setup auf .htaccess-Datei setzen klicken. Damit wird die Datei im öffentlichen Verzeichnis (public/) erstellt bzw. ersetzt, die für das Rewriting nötig ist. Eine bereits vorhandene .htaccess vorher sichern.

    Auf NGINX greift keine .htaccess. Dort die Rewrite-Regeln direkt im Server-Block hinterlegen.

  4. Mindestens eine Domain anlegen: YRewrite → Domains → +. Host, Startartikel und 404-Artikel angeben. Ohne konfigurierte Domain nutzt YRewrite automatisch den aktuellen Host.

Danach werden alle Frontend-URLs umgeschrieben.

Verwendung

SEO-Meta-Tags im <head> des Templates ausgeben:

use Yakamara\YRewrite\Seo;

$seo = new Seo();
echo $seo->getTags();

URL und aktuelle Domain ermitteln:

use Yakamara\YRewrite\YRewrite;
use Redaxo\Core\Filesystem\Url;

echo Url::article(42, 1);                  // sprechende URL eines Artikels
echo YRewrite::getCurrentDomain()?->getName();

Backend

Das AddOn legt unter AddOns → YRewrite folgende Reiter an:

  • Domains – Domains anlegen und verwalten
  • Alias Domains – weiterleitende Hosts
  • Weiterleitungen – manuelle Redirects auf Artikel, Medien oder externe Links
  • Setup.htaccess einrichten, Einstellungen, Übersicht von sitemap.xml/robots.txt

URL und SEO-Daten lassen sich zusätzlich direkt im Artikel-Editor in der Seitenleiste pflegen.

Lizenz

MIT. Siehe Angaben in der composer.json.