Website Manager AddOn für REDAXO 4.5+

Ein Multidomain AddOn für REDAXO 4.5+

Features

• Verwaltung mehrere Websites mit einer REDAXO-Installation
• Website-Umschalter auf oberster Ebene
• Drag und Drop Sortierung der Websites
• Der Style des Backend wird je nach ausgewählter Website angepasst (inkl. autom. generierter farbiger Favicons)
• Man kann auswählen ob man gleiche oder verschiedene Templates, Module, Medien, Clangs, Meta-Infos und Image-Types für die Websites haben will
• Ein zusätzlicher URL-Rewriter kann frei gewählt und eingesetzt werden (sofern dieser die aktuellen REDAXO Variablen unterstützt)
• Man kann von Websites ganze Artikel und Blöcke (Sices) ausgeben auch wenn man sich in einer ganz anderen Website befindet (siehe API)
• Tools wie "Cache global löschen"
• Rechtemanagement
• Theme-Plugin (inkl. SCSS Unterstützung) um pro Website bestimmte Werte (z.B. Farbwerte, Logos) abspeichern und dann z.B. eine CSS darauss generieren zu können.

Hinweis zu REDAXO-Unterordnerinstallationen

Es ist technisch nicht möglich so wie hier das AddOn mit einer REDAXO-Unterordnerinstallation zu betreiben: http://localhost/rex45multi Es wird je eine Domain bzw. Subdomain pro Website benötigt. Arbeitet man mit einem lokalen Webserver so werden virtuelle Hosts (Apache) benötigt.

Bitte auch die weiteren Hinweise (s.u.) beachten...

Sicherheit

• Backup! Wenn man das AddOn live einsetzt, wird dringend angeraten eine automatische Backuplösung für die gesamte Datenbank einzurichten, z.B. über das CronJob AddOn und den MySQLDumper. Man muss drauf achten, dass die angelegten MySQL Views auch mitgesichert und wieder zurückgeschrieben werden.
• Man sollte sich überlegen, ob man nicht grundsätzlich das Löschen von Websites für alle User unterbindet (empfohlen). Dafür ist die Option allow_website_delete da.

Under Construction

• Gleiche Meta-Infos für alle Websites ist noch nicht vollständig implementiert. Hier hilft aktuell nur die Meta Infos von Hand zu duplizieren pro Website. Neu: Man passt die Stelle im Code des MetaInfo AddOns für das eigene Projekt an: https://github.com/redaxo/redaxo4/blob/master/redaxo/include/addons/metainfo/_install.sql#L45-L53 Bei jeder Reinstallation werden so schonmal immer die gleichen MetaInfos angelegt.
• Gleiche Clangs sind noch nicht ausreichend getestet und damit unsupported.
• Ctypes sind aktuell noch nicht berücksichtigt. D.h. es kann schon Out of the Box gehen oder eben nicht ;)

Benötigter Patch für REDAXO 4.5.0

• Damit der Image Manager auch sauber im Backend funktioniert (nur wenn identical_media auf false) müssen die Dateien /redaxo/include/pages/mediapool.media.inc.php und /redaxo/media/standard.js gegen diese hier ausgetauscht werden:

https://raw.github.com/redaxo/redaxo4/master/redaxo/include/pages/mediapool.media.inc.php https://raw.github.com/redaxo/redaxo4/master/redaxo/media/standard.js

Hinweis: Ab REDAXO 4.5.1 ist dieser Patch nicht mehr nötig.

API (Auszug)

// ausgabe des artikels mit id = 10 von website mit id = 5 
echo $REX['WEBSITE_MANAGER']->getWebsite(5)->getArticle(10);

// ausgabe des slices mit id = 40 von website mit id = 3
echo $REX['WEBSITE_MANAGER']->getWebsite(3)->getSlice(40);

// ausgabe des feldes "color1" des aktuellen themes (nur wenn "themes" plugin installiert)
echo $REX['WEBSITE_MANAGER']->getCurrentWebsite()->getTheme()->getValue('color1');

// php methode um on the fly websites zu switchen (z.B. in modulen einsetzbar)
$REX['WEBSITE_MANAGER']->websiteSwitch(2, function() {
	// hier gilt jetzt website id = 2
	$article = new rex_article(7);
	echo $article->getArticle();
});

// ...und hier direkter aufruf für die master website
$REX['WEBSITE_MANAGER']->masterWebsiteSwitch(function() {
	// hier drin gilt jetzt website id = 1 (master)
});

Kompatible AddOns

• SEO42 ab v2.6.0: https://github.com/RexDude/seo42
• Slice Status ab v2.0.0: https://github.com/RexDude/slice_status
• String Table ab v1.3.1: https://github.com/RexDude/string_table
• Tracking Code ab v1.0.0: https://github.com/RexDude/tracking_code

Stand: 21. Mai 2013

AddOns fitmachen für den Website Manager

Damit andere AddOns auch problemlos mit dem Website Manager zusammentun, muss man hauptsächlich folgende REDAXO Variablen einsetzen, anstelle der sonst üblichen hartcodierten Strings:

$REX['TABLE_PREFIX']
$REX['MEDIAFOLDER']

// neu ab REDAXO 4.5
$REX['MEDIA_DIR']
$REX['MEDIA_ADDON_DIR']
$REX['GENERATED_PATH']

Wichtig: Um Abwärtskompatibilität der AddOns mit älteren REDAXO Versionen zu gewährleisten, sollten immer über isset() geprüft werden ob die Variablen überhaupt exisitieren. Hier mal ein Beispiel:

if (isset($REX['MEDIA_DIR'])) {
	return $REX['MEDIA_DIR'];
} else {
	return 'files';
}

Hinweise

• Läuft nur mit REDAXO 4.5+
• AddOn-Ordner lautet: website_manager
• Installieren Sie nur die nötigsten AddOns!
• Ein Log-File wird unter /website_manager/generated/log/ angelegt mit Debug-Informationen, wenn man eine Website hinzufügt oder entfernt.
• Der Table-Prefix in der master.inc.php sollte nicht verändert werden vor der REDAXO-Installation und auf dem Standardwert rex_ belassen werden.
• Das Recht CREATE VIEW für die MySQL Datenbank muß vom Provider freigeschaltet sein. In der Log-Datei kann man sonst sehen, dass die MySQL Views nicht angelegt wurden.
• Import/Export AddOn läuft aktuell nur für die Master-Website. Evtl. sollte man es deshalb vorerst deinstallieren.
• Meta-Infos und Image-Types werden von Haus aus unterstützt. Zusätzliche AddOns/PlugIns kann man über die entsprechenden Arrays in der settings.inc.php hinzufügen sofern man wünscht dass diese pro Website ihren eigenen Datenbestand anlegen. Beispiel-Addons: seo42, slice_status, string_table, tracking_code
• Das Meta Info Fixer Tool (noch nicht implementiert) erscheint nur wenn in der settings.inc.php die Option identical_meta_infos auf true steht.
• Bei gleichen Templates/Modulen muss man den Cache global löschen für alle Websites sobald man Änderungen an diesen vorgenommen hat. Siehe dazu das entsprechende Tool.
• Die settings.inc.php sollte, nachdem man die zweite Website angelegt hat, nicht mehr verändert werden!
• Das Theme-Plugin ist so gedacht, dass man es für das jeweilige Projekt anpasst bevor man es installiert bzw. verwendet.
• Muss man irgendwann mal nachträglich ein AddOn installieren (d.h. wenn mehr als 1 Website angelegt wurde), so muss dieses momentan noch von Hand für jede Website reinstalliert werden (gleiches gilt gerade auch für die MetaInfos).
• Der Website Manager wurde aktuell nur in Zusammenspiel mit SEO42 getestet. Für ein optimales Zusammenspiel bitte ALLE Codebeispiele von SEO42 nutzen!
• Für eine optimale Darstellung sollte als Skin das Standard agk_skin Skin von REDAXO genutzt werden.
• Die Option ignore_permissions ist dafür da allen User Zugriff auf alle Websites zu geben. Evtl. nützlich wenn man viele User hat und der Kunde ohne Admin Websites hinzufügen kann/soll.

Changelog

siehe CHANGELOG.md

Lizenz

siehe LICENSE.md

Credits

• Supported by Peter Bickel und Gregor Harlan
• Danke an das REDAXO-Team für die Erlaubnis die nötigen Core-Änderungen für das AddOn durchführen zu können
• Danke an Jan Kristinus für die Customizer Idee die hier direkt ins AddOn integriert wurde
• Danke an die Tester und Contributors: olien, riotweb, skerbis, alexplusde
• Website Manager uses KLogger PHP-Class: https://github.com/katzgrau/KLogger
• Website Manager uses Spectrum Colorpicker: https://github.com/bgrins/spectrum
• Website Manager Themes Plugin uses scssphp PHP-Class: https://github.com/leafo/scssphp/