====== Installing Additional Server Modules ======

The following add-on modules are available for SoSci Survey:

  * Descriptive data analysis
  * Automated data export
  * Single Sign-On (for preparation see [[:en:server:sso-shibboleth]])

The modules are subject to a charge and can be downloaded as ZIP files after ordering at [[https://www.soscisurvey.de/download/|www.soscisurvey.de/download/]].

  - Unpack the ZIP file; it contains two directories (''modules'' and ''plugins'').
  - Copy the directories including their content into the SoSci Survey installation directory. Directories of the same name already exist there; their content is supplemented.
  - Open SoSci Survey in the browser and select **Server Management** -> **Server Settings** -> **Configuration**
    - Retrieve the server license updated with the add-on module by entering the license key in the tab //Server// at the bottom in the section //Software license server// and saving ({{:button.save.png?nolink|Save symbol}}).
    - Select the tab //Plugins// and click the button //Activate components// under //Installed program components//.

The respective module should then appear with a check mark in the list //Installed program components//. If this is not the case, please check whether there is an error message (**Server Maintenance** -> **Error Log**) and contact info@soscisurvey.de directly.


===== Descriptive Data Analysis =====

The module "Descriptive data analysis" also allows creating PDF files ([[:en:results:report]]). For the PDF creation to work, two additional packages are required.

==== TCPDF ====

Please download the open source package TCPDF from [[https://github.com/tecnickcom/TCPDF/]] as a ZIP file ([[https://github.com/tecnickcom/TCPDF/archive/refs/heads/main.zip|Download]]), and unpack the ZIP file into the following directory below the SoSci Survey installation directory:

''/plugins/tcpdf/''

When unpacking the ZIP file, an additional directory may be created. Please make sure that the content of the ZIP file is stored as follows, without an additional directory:

''/plugins/tcpdf/tcpdf.php''

==== FPDI ====

Please download FPDI from [[https://github.com/Setasign/FPDI]] as a ZIP file ([[https://github.com/Setasign/FPDI/archive/refs/heads/master.zip|Download]]), and unpack the ZIP file into the directory

''/plugins/fpdi/''

Please make sure that the content of the ZIP file is stored as follows (only with the additional directory ''src''):

''/plugins/fpdi/src/autoload.php''