Installation von PhantomJS

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. Hierfür sind die hier aufgeführten Schritte zwingend erforderlich.

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-2.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

Haben Sie alle Schritte erfolgreich abgeschlossen können Sie nun mit der Installation von BlueSpice fortfahren.