Ein Multidomain AddOn für REDAXO 4.5+

• 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. SEO42 wird automatisch unterstützt wenn verfügbar.
• 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

• themes - 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.
• siteclone - SiteClone-Plugin: Mit diesem Plugin werden beim Anlegen einer neuen Website automatisch Struktur, Inhalte, Strings (aus dem String Table Addon) usw. dupliziert.

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.

• 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 können.
• 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.

• 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/4.5.1/redaxo/include/addons/metainfo/_install.sql#L45-L53 Bei jeder Reinstallation werden so schonmal immer die gleichen MetaInfos angelegt. Eine neue weitere Möglichkeit wird unter "AddOns mit gleichem Datenbestand" erklärt.
• 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 ;)

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.

// 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)
});

• AddOns die für alle Websites die gleichen Daten liefern sollen werden normal für die Master Website installiert.
• Entweder über den Extenion Point WEBSITE_AFTER_CREATED (empfohlen Methode! Codebeispiel unter s.u. "Website Manager Extension Points") oder in der create_website.after.inc.php Datei (zu finden unter /include/data/addons/website_manager/custom/) muss ein VIEW auf die enstprechende Master-Tabelle angelegt werden. Siehe z.B. Image Manager AddOn: https://github.com/RexDude/website_manager/blob/v1.3.0/classes/class.rex_website_manager.inc.php#L382-L384
• Bei jedem Website hinzufügen werden dann automatisch die VIEWS angelegt so dass jedes Addon dann an die gleichen Daten kommt.

• Addons müssen die aktuellen Rex-Vars unterstützen (s.u.).
• Addons werden dann in den Einstellungen unter "Zu reinstallierende Addons" eingetragen.
• Bei jedem Website hinzufügen werden diese dann automatisch mit dem Tabellenprefix für die neue Website reinstalliert und können so für jede Website unterschiedliche Daten speichern.

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';
}

Es gibt 4 Extension Points über die man eigenen Code ausführen kann, z.B. um einen MySQL VIEW anzulegen:

• WEBSITE_BEFORE_CREATED - Wird aufgerufen bevor eine Website erzeugt wird.
• WEBSITE_AFTER_CREATED - Wird aufgerufen nachdem eine Website erzeugt wurde.
• WEBSITE_BEFORE_DESTROYED - Wird aufgerufen bevor eine Website zerstört/gelöscht wird.
• WEBSITE_AFTER_DESTROYED - Wird aufgerufen nachdem eine Website zerstört/gelöscht wurde.

Codebeispiel:

rex_register_extension('WEBSITE_AFTER_CREATED', function($params) {
	global $REX;

	$sql = $params['subject']['sql_object']; // sql object used to perform db operations 
	$log = $params['subject']['log_object']; // logfile object
	$websiteId = $params['subject']['website_id']; // website id of new website
	$tablePrefix = $params['subject']['table_prefix']; // table prefix of new website
	$generatedDir = $params['subject']['generated_dir']; // generated dir of new website
	$mediaDir = $params['subject']['media_dir']; // media dir of new website

	rex_website_manager_utils::logQuery($log, $sql, 'HERE SQL STATEMENT WITH ' . $newTablePrefix . ' USAGE');
});

• SEO42 ab v4.1.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
• ClearCache ab v1.0.0 https://github.com/RexDude/clearcache
• Rex Multiupload ab v3.2.0 https://github.com/nightstomp/rex_multiupload

• Der Website Manager bindet automatisch seine installierten und aktvierten Plugins in das Addon-Menü ein.
• Es wird ausserdem automatisch die Sprachdatei des Plugins eingebunden. Im Plugin selbst muss man also nichts weiter tun.

• Läuft nur mit REDAXO 4.5+
• AddOn-Ordner lautet: website_manager
• Installieren Sie nur die nötigsten AddOns!
• Log-Files werden unter /include/data/addons/website_manager/log/ angelegt mit Debug-Informationen, wenn man eine Website hinzufügt oder entfernt. Fehlermeldungen tauchen in dem Fall nur in den Log-Files auf!
• 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, genauso wie das SEO42 und Slice Status AddOn. Zusätzliche AddOns/PlugIns kann man in den Einstellungen unter "Zu reinstallierende Addons" eingetragen sofern man wünscht dass diese pro Website ihren eigenen Datenbestand anlegen. Beispiel-Addons: 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.
• Bestimmte Einstellungen dürfen nicht mehr geändert werden und werden deaktiviert angezeigt sobald man mehr als eine Website angelegt hat.
• Das Theme-Plugin (nicht mehr mitgeliefert) 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 eine 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 "Eigene Benutzerrechte ignorieren" 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. Oder wenn es Probleme mit den Benutzerrechten gibt ;)
• SEO42 4.0+ speichert pro neue Website eine eigene Settings-Datei ab die die Standardeinstellungen des Addons enthält. Evtl. muss man hier per Custom-Code eine Aktualisierung durchführen (z.B. Werte setzen oder die ganze Settings-Datei der Master-Website kopieren).

siehe CHANGELOG.md

siehe UPDATE.md

siehe LICENSE.md

polarpixel, gharlan, dergel, olien, riotweb, skerbis, alexplusde, nightstomp und alle die vergessen wurden ;)

• 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/
• jQuery UI: http://jqueryui.com/