Es gibt viele Möglichkeiten, wie SHOMUGO erweitert oder modifiziert werden kann. Allerdings können einige Wege zu verschiedenen Problemen führen, wie z.B. verlorene Änderungen und Bugs nach dem Upgrade, sowie Inkompatibilität von Add-ons. Um uns allen das Leben zu erleichtern, bitten wir Dich, die hier aufgeführten Regeln zu befolgen:

Hinweis: Nur ausgewählte Benutzer erhalten Zugriff auf unser Entwicklungssystem. Dies ist KEIN Standard-Feature! Solltest Du Interesse haben, so kontaktiere uns bitte.

Ändere keine Hauptdateien

SHOMUGO basiert auf einer Open-Source-Software. Das bedeutet, dass Du, sofern Dir der Code aufliegt, jede Datei öffnen und ihre Programmierung betrachten kannst. Alle Dateien, die standardmäßig in SHOMUGO verankert sind, heißen Hauptdateien bzw. Kerndateien.

Da der Quellcode offen liegt, könntest Du ganz einfach das System besser an Deine Bedürfnisse anpassen, indem Du die Kerndateien änderst… aber das solltest nicht tun. Stattdessen schlagen wir vor, Änderungen indirekt vorzunehmen (z.B. als separate Add-ons).

Warum sollte ich die Kerndateien nicht ändern?

Wenn SHOMUGO auf eine neue Version upgedatet wird, dann hat das eine unmittelbare Auswirkung auf alle Hauptdateien bzw. Kerndateien. Sind dort Änderungen vorgenommen dann hat das folgende Auswirkungen:

• Wir die betroffene Kerndatei vom Upgrade überschrieben, dann sind Deine Änderungen verloren
• Wird eine andere Kerndatei geändert, die Du aber indirekt in Deiner Modifikation ansprichst, dann werden Fehler (Bugs) auftreten, die niemand so schnell identifizieren und beheben kann

Die Dinge können auch ohne ein Upgrade problematisch werden. Nehmen wir an, Du hast eine geänderte Kerndatei und ein Add-on eines Drittanbieters funktioniert nicht richtig, obwohl es mit der aktuellen SHOMUGO Version funktionieren sollte. Normalerweise werden dann andere AddOns deaktiviert, um den Fehler einzugrenzen. Da dies jedoch keine Auswirkungen hat, muss man auch die Änderungen an den Kerndateien rückgängig machen. Das kann umständlich, fehleranfällig und langwierig werden.

Nimm Deine Änderungen indirekt vor

SHOMUGO bietet Möglichkeiten, Änderungen vorzunehmen, ohne die Kerndateien zu modifizieren:

• Verwende Hooks um eigene AddOns zu installieren und die Funktionen zu erweitern
• Kopiere Themes um auf Standard-Theme-Funktionen zurückzugreifen und Ansichten zu erweitern

Verwende Add-ons und Hooks

Wenn Du Funktionen hinzufügen oder ändern musst, können diese als separates Add-on implementiert werden. Wenn Du ein Add-on erstellst, kkannst Du Hooks verwenden, um den Code in den Kerndateien indirekt hinzuzufügen oder zu ändern. Hier sind die Vorteile dieses Ansatzes:

• Alle Dateien eines AddOns werden separat gespeichert und können übersichtlich verwaltet werden
• Änderungen können mit wenigen Klicks aktiviert/deaktiviert werden