Historique de la page
...
Sv translation | |||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||
IntroductionBy default, BlueMind lets you customize the homepage logo. To replace the default homepage by a customized page, you have to write an HPS extension.
PrerequisitesA test installation of BlueMind in the latest available version. PrincipleTo edit the BlueMind homepage and replace it by your own custom version, you have to write an HPS extension that will overload the official homepage's template and resources. Initialising the extensionNaming the extensionYou have to give your extension a name. This name can use the [a-z] characters and "." (period).
Creating a structure for the extensionConnect as the root user on the BlueMind test installation, then:
Defining your homepageThe homepage essentially contains two types of data:
HTML The page's HTML code has to be put into the file named
In addition, the template's
ResourcesHomepage resources -- images, CSS sheets... -- have to be placed into the You can reference the resources from this repository into the HTML code. E.g. to insert the
You can find default resources in our git repository: https://forge.bluemind.net/stash/projects/BM/repos/bluemind-public/browse/ui/webmodules/net.bluemind.webmodules.loginapp/web-resources Building and installing the extension
Log in as root on the BlueMind test installation, then:
Then log into BlueMind, your custom homepage should be displayed instead of the standard BlueMind homepage.
NotesExampleThe code for the my.sample.loginpage plugin described in this documentation is available at: https://github.com/bluemind-net/loginapp-plugin-sample/tree/master/my.sample.loginpage. To test it:
| |||||||||||||||||||||||||||||||||||||
Sv translation | |||||||||||||||||||||||||||||||||||||
|
Avertissement |
---|
Diese Methode wird als Beispiel angegeben. Bei Updates muss die Erweiterung eventuell an die neue Version von BlueMind angepasst werden. Wenn eine solche Erweiterung in Ihrer Installation vorhanden ist, raten wir dringend, ihr Verhalten auf einer Vorproduktionsplattform mit der Version von BlueMind zu testen, die Sie in Produktion nehmen möchten. |
Voraussetzungen
Eine Testinstallation von BlueMind wurde auf die neueste verfügbare Version aktualisiert.
Prinzip
Die Modifikation der BlueMind-Startseite erfolgt durch das Schreiben einer HPS-Erweiterung, die die offizielle Startseiten-Vorlage und die Ressourcen außer Kraft setzt, um eine eigene Startseite zu definieren.
Initialisieren der Erweiterung
Definition des Erweiterungsnamens
Sie müssen einen Namen für Ihre Erweiterung festlegen. Dieser Name kann aus den Zeichen [a-z] und . (Punkt) bestehen.
Remarque |
---|
Im Rest dieser Dokumentation haben wir den Namen my.sample.loginpagegewählt. Vergessen Sie nicht, ihn durch den für Ihre Erweiterung gewählten Namen zu ersetzen. |
Erstellen der Erweiterungsstruktur
Melden Sie sich als Root-Benutzer auf der BlueMind-Testinstallation an und:
führen Sie die folgenden Befehle aus:
Bloc de code language bash mkdir /root/my.sample.loginpage cd /root/my.sample.loginpage mkdir META-INF templates web-resources
erstellen Sie die Datei
/root/my.sample.loginpage/META-INF/MANIFEST.MF mit dem Inhalt:
Bloc de code Manifest-Version: 1.0 Bundle-ManifestVersion: 2 Bundle-Name: my.sample.loginpage Bundle-SymbolicName: my.sample.loginpage Bundle-Version: 1.0.0 Bundle-Vendor: bluemind.net Fragment-Host: net.bluemind.webmodules.loginapp Bundle-RequiredExecutionEnvironment: JavaSE-1.8
Remarque Denken Sie daran, die Zeilen
Bundle-Name
undBundle-SymbolicName
entsprechend dem für Ihre Erweiterung gewählten Namen anzupassen
Definieren Sie Ihre Startseite
Die Startseite besteht im Wesentlichen aus 2 Datentypen:
- HTML-Code Seite in Form einer Vorlage
- Den von Ihrer Seite referenzierten Ressourcen (Bilder, CSS...)
HTML
Der HTML-Code der Seite muss in der Datei templates/login.xml
platziert werden. Diese Modelldatei wird von BlueMind analysiert und die Daten werden dynamisch in die Datei eingefügt.
Diese Vorlage muss im Abschnitt <body>
den Code des ursprünglichen Authentifizierungsformulars enthalten. Um die neueste Version dieses Codes zu erhalten, gehen Sie zur Seite login.xml in unserem Git-Repository und kopieren Sie die folgenden Abschnitte:
- den Abschnitt
von <#if authErrorMsg??>
bis</#if>
(inklusive Tags) - den Abschnitt des eigentlichen Formulars: von
<form>
bis</form>
(inklusive Tags)
Darüber hinaus muss dem Tag </body>
des Modells Folgendes vorangestellt werden:
Bloc de code |
---|
${jsRuntime} |
Ressourcen
Die Ressourcen Ihrer Startseite, z.B. wie Bilder, CSS-Sheets... - müssen im Ordner web-resources
abgelegt werden.
Sie können im HTML-Code direkt auf Ressourcen aus diesem Verzeichnis verweisen. Zum Beispiel, um die Ressource web-resources/sample.jpg
aus der Vorlage templates/login.xml
einzufügen:
Bloc de code |
---|
<img src="sample.jpg>Sample image</img> |
Astuce | ||
---|---|---|
Wenn Sie einen Ordnerbaum erstellen, verwenden Sie die relative Notation, um auf sie zu verweisen, wobei
NB: Beachten Sie, dass die Baumstruktur nicht mit '/' beginnt, was auf das Stammverzeichnis der Website verweisen würde |
Sie finden die Standard-Ressourcen in unserem Git-Repository: https://forge.bluemind.net/stash/projects/BM/repos/bluemind-public/browse/ui/webmodules/net.bluemind.webmodules.loginapp/web-resources
Generieren und installieren Sie die ErweiterungMelden Sie sich als Root-Benutzer auf der BlueMind-Testinstallation an und:
die Erweiterung generieren:
Bloc de code cd /root/my.sample.loginpage /usr/lib/jvm/bm-jdk/bin/jar cvfm /root/my.sample.loginpage_1.0.0.jar META-INF/MANIFEST.MF .
die Erweiterung installieren:
Bloc de code cd /usr/share/bm-hps/extensions mkdir my.sample.loginpage mv /root/my.sample.loginpage_1.0.0.jar my.sample.loginpage/
den HPS-Dienst neu starten:
Bloc de code /etc/init.d/bm-hps stop rm -rf /var/lib/bm-hps /etc/init.d/bm-hps start
Nach der Anmeldung in BlueMind muss anstelle der Standard-BlueMind-Seite Ihre Seite angezeigt werden.
Avertissement |
---|
Wird die Seite nicht angezeigt, erzwingen Sie eine Aktualisierung, indem Sie die Shift-Taste gedrückt halten, während Sie die Seite neu laden. Sie können einen Browser im privaten Browsing-Modus verwenden, um mögliche Cache-Effekte zu vermeiden. |
Hinweise
Beispiel
Der Code des in dieser Dokumentation beschriebenen my.sample.loginpage-Plugins ist auf dieser Seite verfügbar: https://github.com/bluemind-net/loginapp-plugin-sample/tree/master/my.sample.loginpage
Um sie zu testen:
- laden Sie die generierte Erweiterung über dieses Link herunter: https://github.com/bluemind-net/loginapp-plugin-sample/raw/master/build/my.sample.loginpage_1.0.0.jar
- beachten Sie die Schritte 2 und 3 des Abschnitts Erweiterung generieren und installieren
Info |
---|
Der Inhalt der generierten Erweiterung kann direkt von einer Software aus geändert werden, die das Zip-Komprimierungsformat unterstützt (z.B. Winzip). Sie können die Vorlagendatei |