- Mon Aug 18, 2014 12:45 pm
#5158
Skin System - Wie funktioniert es
Mit dem TS3MusicBot Update 3.9.5 kam die Möglichkeit Skins zu erstellen und zu verwenden.
Wie funktioniert das ganze?
Es ist recht simpel. Mit dem Skin System können Dateien (außer .htm und .js Dateien) von dem original Webinterface überschrieben werden.
Das Skin System überprüft zuerst ob ein Skin gesetzt wurde. Wurde ein skin gesetzt, werden angefragte Dateien (in diesem Fall Bilder und style.css) zuerst innerhalb des Skin Ordners angefragt. Exestieren die Dateien nicht im Skin System, werden die originalen Dateien des Webinterfaces verwendet.
Beispiel:
Sie erstellen einen neuen Skin mit dem Namen 'test'. Dazu erstellen sie einen neuen Ordner namens 'test' im TS3MusicBot/skins/ Ordner. Als nächstes erstellen sie in dem neu erstellten Ordner 'test' eine neue Datei mit dem Namen 'version' mit folgendem Inhalt:
Anschließend editieren sie die TS3MusicBot/skins/skin.conf Datei und setze den Namen des Skins aktiv:
Jetzt sind sie bereit zum skinnen!
Sie haben nun folgende Ordnerstruktur: TS3MusicBot/skins/test/ .
Die originale style.css ist hier zu finden:
TS3MusicBot/system/webinterface/css/style.css
Wenn sie diese Datei überschreiben wollen, muss ebenso eine style.css hier zu finden sein:
TS3MusicBot/skins/test/css/style.css
Das selbe funktioniert auch mit Bildern. Beispielsweise möchten sie jetzt das "NO COVER" Bild von dem Player an der rechten Seite ändern:
Das original Bild liegt hier:
TS3MusicBot/system/webinterface/images/no_cover.png
Sie ändern es mit einem neuen in:
TS3MusicBot/skins/test/images/no_cover.png
Mit diesem neuen Feature kann das komplette Webinterface neu gestaltet werden. Die Hauptfunktionen des Webinterfaces bleiben somit unberührt und kann weiterhin von uns in Zukunft aktualisiert und erweitert werden, ohne das ein Skin dadurch zerstört wird.
Wenn sie ihren erstellten Skin auch für andere zur Verfügung stehen soll, posten sie ihren Skin (mit Download Link als .ZIP Archiv, Vorschau Bild und einer kleinen Beschreibung) in das Forum.
Mit dem TS3MusicBot Update 3.9.5 kam die Möglichkeit Skins zu erstellen und zu verwenden.
Wie funktioniert das ganze?
Es ist recht simpel. Mit dem Skin System können Dateien (außer .htm und .js Dateien) von dem original Webinterface überschrieben werden.
Das Skin System überprüft zuerst ob ein Skin gesetzt wurde. Wurde ein skin gesetzt, werden angefragte Dateien (in diesem Fall Bilder und style.css) zuerst innerhalb des Skin Ordners angefragt. Exestieren die Dateien nicht im Skin System, werden die originalen Dateien des Webinterfaces verwendet.
Beispiel:
Sie erstellen einen neuen Skin mit dem Namen 'test'. Dazu erstellen sie einen neuen Ordner namens 'test' im TS3MusicBot/skins/ Ordner. Als nächstes erstellen sie in dem neu erstellten Ordner 'test' eine neue Datei mit dem Namen 'version' mit folgendem Inhalt:
Code: Select all
Das gibt die Version des Skins an. Der TS3MusicBot prüft nach Updates des Skins, wenn der Skinname auch im "Skin Browser" des TS3MusicBots zu finden ist. Ist eine neuere Skin Version im Skin Brwoser verfügbar, zeigt der TS3MusicBot automatisch einen Hinweis an, dass ein Update des Skins verfügbar ist.0.0.1
Anschließend editieren sie die TS3MusicBot/skins/skin.conf Datei und setze den Namen des Skins aktiv:
Code: Select all
Kann auch über die Settings Seite des TS3MusicBotwebinterfaces geändert werden.skin=test
Jetzt sind sie bereit zum skinnen!
Sie haben nun folgende Ordnerstruktur: TS3MusicBot/skins/test/ .
Die originale style.css ist hier zu finden:
TS3MusicBot/system/webinterface/css/style.css
Wenn sie diese Datei überschreiben wollen, muss ebenso eine style.css hier zu finden sein:
TS3MusicBot/skins/test/css/style.css
Das selbe funktioniert auch mit Bildern. Beispielsweise möchten sie jetzt das "NO COVER" Bild von dem Player an der rechten Seite ändern:
Das original Bild liegt hier:
TS3MusicBot/system/webinterface/images/no_cover.png
Sie ändern es mit einem neuen in:
TS3MusicBot/skins/test/images/no_cover.png
Mit diesem neuen Feature kann das komplette Webinterface neu gestaltet werden. Die Hauptfunktionen des Webinterfaces bleiben somit unberührt und kann weiterhin von uns in Zukunft aktualisiert und erweitert werden, ohne das ein Skin dadurch zerstört wird.
Wenn sie ihren erstellten Skin auch für andere zur Verfügung stehen soll, posten sie ihren Skin (mit Download Link als .ZIP Archiv, Vorschau Bild und einer kleinen Beschreibung) in das Forum.