Installation und Konfiguration von PhantomJS

Vorwort

Bei PhantomJS handelt es sich um einen sogenannten Headless-Browser, der Screenshots von Webseiten rendern kann. Dieser wird für die Webseitenvorschau in der Erweiterten Suche und der Übersicht der Letzten Änderungen in Ihrer BlueSpice-Installation benötigt.

Es handelt sich hierbei um Funktionalitäten von BlueSpice pro, setzen Sie BlueSpice free ein so können Sie auf die Installation von PhantomJS verzichten.

Download

Öffnen Sie im Internet Explorer die offizielle Webseite des Projekts (1). Klicken Sie auf "Install" (2).

Laden Sie das entsprechende ZIP-Archiv für Windows herunter.

Beachten Sie bitte, dass der Download auf Ihrem Windows Server mit Internet Explorer nur dann funktioniert, wenn Sie die Erweiterten Sicherheitseinstellungen für Internet Explorer im Servermanager entsprechend konfiguriert haben. Beachten Sie hierzu die technische Dokumentation von Microsoft.

Im Folgenden wird PhantomJS in Version 2.1.1 verwendet und dient nur beispielhaft für die jeweils aktuellste Version, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.

Installation

PhantomJS benötigt kein Durchlaufen eines Setupprozesses. Entpacken Sie das heruntergeladene ZIP-Archiv. Darin finden Sie im Ordner phantomjs-3.1.1-windows\bin die ausführbare Datei phantomjs.exe.

Verschieben Sie diese lediglich nach C:\bluespice\bin.

Diese Dokumentation geht von der von uns empfohlenen Ordnerstruktur aus. Aus diesem Grund wird an dieser Stelle der Standardpfad auf den Ordner C:\bluespice\bin festgelegt. Haben Sie individuelle Wünsche, so müssen Sie diese Pfade nach eigenem Verständnis anpassen.

Konfiguration von BlueSpice

BlueSpice muss Kenntnis vom Speicherort der phantomjs.exe haben. Nach erfolgter BlueSpice-Installation gehen Sie hierzu wie folgt vor:

1. Öffnen Sie den Ordner Ihrer BlueSpice-Installation
2. Wechseln Sie dort in den Unterordner settings.d
3. Legen Sie dort eine neue Datei mit dem Namen 090-PhantomJS.php an
4. Füllen Sie diese Datei mit folgendem Inhalt:

<?php

$bsgArticlePreviewCapturePhantomJSExecutable = "C:\\bluespice\\bin\\phantomjs.exe";

Abschluss der Systemvorbereitung

Nach erfolgreichem Abschluss dieser Schritte haben sie die Systemvorbereitung für BlueSpice erfolgreich abgeschlossen.