Files
2019-11-17 19:14:07 +01:00

192 lines
5.4 KiB
PHP

<?php
/**
* 2007-2016 PrestaShop
*
* NOTICE OF LICENSE
*
* This source file is subject to the Academic Free License (AFL 3.0)
* that is bundled with this package in the file LICENSE.txt.
* It is also available through the world-wide-web at this URL:
* http://opensource.org/licenses/afl-3.0.php
* If you did not receive a copy of the license and are unable to
* obtain it through the world-wide-web, please send an email
* to license@prestashop.com so we can send you a copy immediately.
*
* DISCLAIMER
*
* Do not edit or add to this file if you wish to upgrade PrestaShop to newer
* versions in the future. If you wish to customize PrestaShop for your
* needs please refer to http://www.prestashop.com for more information.
*
* @author PrestaShop SA <contact@prestashop.com>
* @copyright 2007-2016 PrestaShop SA
* @license http://opensource.org/licenses/afl-3.0.php Academic Free License (AFL 3.0)
* International Registered Trademark & Property of PrestaShop SA
*/
if (!defined('_PS_VERSION_'))
exit;
require_once __DIR__.'/vendor/autoload.php';
use \OnBoarding\OnBoarding;
use PrestaShop\PrestaShop\Adapter\SymfonyContainer;
/**
* OnBoarding module entry class.
*/
class Welcome extends Module
{
const CLASS_NAME = 'AdminWelcome';
/**
* @var OnBoarding
*/
private $onBoarding;
/**
* Module's constructor.
*/
public function __construct()
{
$this->name = 'welcome';
$this->version = '5.1.0';
$this->author = 'PrestaShop';
parent::__construct();
$this->displayName = $this->trans('Welcome', array(), 'Modules.Welcome.Admin');
$this->description = $this->trans('Help the user to create his first product.', array(), 'Modules.Welcome.Admin');
$this->ps_versions_compliancy = [
'min' => '1.7.4.0',
'max' => _PS_VERSION_,
];
// If the symfony container is not available this constructor will fail
// This can happen during the upgrade process
if (null == SymfonyContainer::getInstance()) {
return;
}
if (Module::isInstalled($this->name)) {
$this->onBoarding = new OnBoarding(
$this->getTranslator(),
$this->smarty,
$this,
SymfonyContainer::getInstance()->get('router')
);
if (Tools::getIsset('resetonboarding')) {
$this->onBoarding->setShutDown(false);
$this->onBoarding->setCurrentStep(0);
}
}
}
/**
* Module installation.
*
* @return bool Success of the installation
*/
public function install()
{
return parent::install()
&& $this->installTab()
&& $this->registerHook('displayAdminNavBarBeforeEnd')
&& $this->registerHook('displayAdminAfterHeader')
&& $this->registerHook('displayBackOfficeHeader');
}
public function installTab()
{
$tab = new Tab();
$tab->active = 1;
$tab->class_name = static::CLASS_NAME;
$tab->name = array();
foreach (Language::getLanguages(true) as $lang) {
$tab->name[$lang['id_lang']] = "Welcome";
}
$tab->module = $this->name;
return $tab->add();
}
public function uninstallTab()
{
$id_tab = (int)Tab::getIdFromClassName(static::CLASS_NAME);
if ($id_tab) {
$tab = new Tab($id_tab);
return $tab->delete();
} else {
return false;
}
}
/**
* Uninstall the module.
*
* @return bool Success of the uninstallation
*/
public function uninstall()
{
$this->onBoarding->setCurrentStep(0);
$this->uninstallTab();
return parent::uninstall();
}
/**
* Hook called when the backoffice header is displayed.
*/
public function hookDisplayBackOfficeHeader()
{
if (!$this->onBoarding->isFinished()) {
$this->context->controller->addCSS($this->_path.'public/module.css', 'all');
$this->context->controller->addJS($this->_path.'public/module.js', 'all');
}
}
/**
* Hook called after the header of the backoffice.
*/
public function hookDisplayAdminAfterHeader()
{
if (!$this->onBoarding->isFinished()) {
$this->onBoarding->showModuleContent();
}
}
/**
* Hook called before the end of the nav bar.
*/
public function hookDisplayAdminNavBarBeforeEnd()
{
if (!$this->onBoarding->isFinished()) {
$this->onBoarding->showModuleContentForNavBar($this->context->link);
}
}
/**
* Execute an API like action for the OnBoarding.
*
* @param string $action Action to perform
* @param mixed $value Value to assign to the action
*
* @throws Exception
*/
public function apiCall($action, $value)
{
switch ($action) {
case 'setCurrentStep':
if (!$this->onBoarding->setCurrentStep($value)) {
throw new Exception('The current step cannot be saved.');
}
break;
case 'setShutDown':
if (!$this->onBoarding->setShutDown($value)) {
throw new Exception('The shut down status cannot be saved.');
}
break;
}
}
}