View source for Setup:Installation Guide/System Preparation/Windows/PhantomJS

{{DISPLAYTITLE:Installing and configuring PhantomJS on Windows}}
__TOC__

{{Template:ImportantPro|text=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.}}
==DownloadS==
In Internet Explorer, open the [https://phantomjs.org/ official website of the project] (1). Click "Install" (2).

[[File:Setup:PhantomJS-Download-01.png|center|400px|PhantomJS Download 01]]

Download the appropriate ZIP archive for Windows.

[[File:Setup:PhantomJS-Download-02.png|center|400px|PhantomJS Download 02]]


{{Template:Hint|text=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.}}
{{Template:Hint|text=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 <code>phantomjs-3.1.1-windows\bin </code> you will find the executable file <code> phantomjs.exe</code>.

Simply move tit to <code> C:\bluespice\bin </code>.

<nowiki>{{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.}}</nowiki>

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

#Open the folder of your BlueSpice installation
#Switch to the subfolder <code>settings.d</code>
#In this subfolder, create a new file named <code>090-PhantomJS.php</code>
#Fill this file with the following content:

<syntaxhighlight lang="php">
<?php

$bsgArticlePreviewCapturePhantomJSExecutable = "C:\\bluespice\\bin\\phantomjs.exe";
</syntaxhighlight>

==Finishing the system preparation==
If you have completed all steps successfully, you can now continue with [[Setup:Installation_Guide/With_Installer| installing BlueSpice]].

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/PhantomJS]]