.. _installation:

============
Installation
============

| Since the PHP configuration of YetiForce CRM and TYPO3 are not fully compatible,
  it is recommended to install YetiForce CRM and TYPO3 on two separate, different servers.
| Specifically, there are two directives that do not coincide:

* disable_functions: PHP shell_exec, exec, system, passthru, popen functions
  should be disabled in YetiForce CRM, while they should be enabled for TYPO3
* opcache.save_comments: should be active for YetiForce CRM, while it should be disabled for TYPO3

| While the second one, opcache.save_comments, affects only in terms of performance,
  the first one, disable_functions, concerns a security issue for YetiForce CRM.

TYPO3 CMS side
==============

1. Install TYPO3 CMS
   `Download TYPO3 <https://get.typo3.org/>`_

2. Install `YetiForce Customer Portal` extension

   * Extension Manager
      In TYPO3 backend, open the :guilabel:`Extension Manager` module (*Admin Tools>Extensions*)
      and select, on top, :guilabel:`Get extensions`.
      Search for *yfportal*, import and install.
   * TER (TYPO3 Extension Repository)
      Download the zip file from
      `https://extensions.typo3.org/extension/yfportal <https://extensions.typo3.org/extension/yfportal>`_
      and upload by :guilabel:`Extension Manager`
   * Composer
      run :code:`composer require davide-alghi/typo3-yfportal`

YetiForce CRM side
==================

* PAD Extensions Manager (first time installation only)
   | Download the `PAD Extensions Manager <https://www.penguinable.com/products/pad-extensions-manager>`_
   | Follow instructions on `User Guide <https://www.penguinable.com/fileadmin/penguinable/Templates/Documents/userguides/PADExtensionsManager/Installation%20and%20configuration/Index.html#installation-and-configuration>`_
* PAD Customer Portal
   | Download the extension `PAD Customer Portal <https://www.penguinable.com/products/pad-customer-portal>`_
   | and upload by :guilabel:`Standard modules / Modules – Installation` -> :guilabel:`Install from file` button