No categories assigned

Installing and configuring PhantomJS on Windows

< Setup:Installation Guide‎ | System Preparation‎ | Windows
icon required-pro.png
PhantomJS is a so-called headless browser that can render screenshots of web pages. This is required for the web page preview in Advanced Search and the Recent Changes Overview in your BlueSpice installation. These are functionalities of BlueSpice pro. For this purpose, the steps listed here are reqired for BlueSpice pro.


In Internet Explorer, open the official website of the project (1). Click "Install" (2).

PhantomJS Download 01

Download the appropriate ZIP archive for Windows.

PhantomJS Download 02

Please note that the download on your Windows Server with Internet Explorer will only work if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft.

In this guide, we use PhantomJS version 2.1.1 as an example. You can download the latest version at the time of installation.

Installing PhantomJS

PhantomJS does not need to go through a setup process. Unpack the downloaded ZIP archive. In the folder phantomjs-3.1.1-windows\bin you will find the executable file phantomjs.exe.

Simply move tit to C:\bluespice\bin .

{{Template:Hint|text=This guide is based on the folder structure recommended by us [[Setup:Installation Guide/Advanced/Windows Folder Structure|recommended by us]. For this reason, the default path to the folder C:\bluespice\bin is set here. If you have other requirements, you must adapt these paths accordingly.}}

Configuring BlueSpice

BlueSpice must have knowledge of the location of phantomjs.exe. After the BlueSpice installation, proceed as follows:

  1. Open the folder of your BlueSpice installation
  2. Switch to the subfolder settings.d
  3. In this subfolder, create a new file named 090-PhantomJS.php
  4. Fill this file with the following content:

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

Finishing the system preparation

If you have completed all steps successfully, you can now continue with installing BlueSpice.