* @copyright 2007-2018 PrestaShop SA
* @license https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
* International Registered Trademark & Property of PrestaShop SA
*/
class HelperCore
{
public $currentIndex;
public $table = 'configuration';
public $identifier;
public $token;
public $toolbar_btn;
public $ps_help_context;
public $title;
public $show_toolbar = true;
public $context;
public $toolbar_scroll = false;
public $bootstrap = false;
/**
* @var Module
*/
public $module;
/** @var string Helper tpl folder */
public $base_folder;
/** @var string Controller tpl folder */
public $override_folder;
/**
* @var Smarty_Internal_Template base template object
*/
protected $tpl;
/**
* @var string base template name
*/
public $base_tpl = 'content.tpl';
public $tpl_vars = array();
public function __construct()
{
$this->context = Context::getContext();
}
public function setTpl($tpl)
{
$this->tpl = $this->createTemplate($tpl);
}
/**
* Create a template from the override file, else from the base file.
*
* @param string $tpl_name filename
*
* @return Smarty_Internal_Template
*/
public function createTemplate($tpl_name)
{
if ($this->override_folder) {
if ($this->context->controller instanceof ModuleAdminController) {
$override_tpl_path = $this->context->controller->getTemplatePath() . $this->override_folder . $this->base_folder . $tpl_name;
} elseif ($this->module) {
$override_tpl_path = _PS_MODULE_DIR_ . $this->module->name . '/views/templates/admin/_configure/' . $this->override_folder . $this->base_folder . $tpl_name;
} else {
if (file_exists($this->context->smarty->getTemplateDir(1) . $this->override_folder . $this->base_folder . $tpl_name)) {
$override_tpl_path = $this->context->smarty->getTemplateDir(1) . $this->override_folder . $this->base_folder . $tpl_name;
} elseif (file_exists($this->context->smarty->getTemplateDir(0) . 'controllers' . DIRECTORY_SEPARATOR . $this->override_folder . $this->base_folder . $tpl_name)) {
$override_tpl_path = $this->context->smarty->getTemplateDir(0) . 'controllers' . DIRECTORY_SEPARATOR . $this->override_folder . $this->base_folder . $tpl_name;
}
}
} elseif ($this->module) {
$override_tpl_path = _PS_MODULE_DIR_ . $this->module->name . '/views/templates/admin/_configure/' . $this->base_folder . $tpl_name;
}
if (isset($override_tpl_path) && file_exists($override_tpl_path)) {
return $this->context->smarty->createTemplate($override_tpl_path, $this->context->smarty);
} else {
return $this->context->smarty->createTemplate($this->base_folder . $tpl_name, $this->context->smarty);
}
}
/**
* default behaviour for helper is to return a tpl fetched.
*
* @return string
*/
public function generate()
{
$this->tpl->assign($this->tpl_vars);
return $this->tpl->fetch();
}
/**
* @deprecated 1.5.0
*/
public static function renderAdminCategorieTree(
$translations,
$selected_cat = array(),
$input_name = 'categoryBox',
$use_radio = false,
$use_search = false,
$disabled_categories = array(),
$use_in_popup = false
) {
Tools::displayAsDeprecated();
$helper = new Helper();
if (isset($translations['Root'])) {
$root = $translations['Root'];
} elseif (isset($translations['Home'])) {
$root = array('name' => $translations['Home'], 'id_category' => 1);
} else {
throw new PrestaShopException('Missing root category parameter.');
}
return $helper->renderCategoryTree($root, $selected_cat, $input_name, $use_radio, $use_search, $disabled_categories, $use_in_popup);
}
/**
* @param array $root array with the name and ID of the tree root category, if null the Shop's root category will be used
* @param array $selected_cat array of selected categories
*
* @usage
* Format
* Array( [0] => 1, [1] => 2)
* OR
* Array([1] => Array([id_category] => 1, [name] => Home page))
*
* @param string $input_name name of input
* @param bool $use_radio use radio tree or checkbox tree
* @param bool $use_search display a find category search box
* @param array $disabled_categories
*
* @return string
*/
public function renderCategoryTree(
$root = null,
$selected_cat = array(),
$input_name = 'categoryBox',
$use_radio = false,
$use_search = false,
$disabled_categories = array()
) {
$translator = Context::getContext()->getTranslator();
$translations = array(
'selected' => $translator->trans('Selected', array(), 'Admin.Global'),
'Collapse All' => $translator->trans('Collapse All', array(), 'Admin.Actions'),
'Expand All' => $translator->trans('Expand All', array(), 'Admin.Actions'),
'Check All' => $translator->trans('Check All', array(), 'Admin.Actions'),
'Uncheck All' => $translator->trans('Uncheck All', array(), 'Admin.Actions'),
'search' => $translator->trans('Find a category', array(), 'Admin.Actions'),
);
if (Tools::isSubmit('id_shop')) {
$id_shop = Tools::getValue('id_shop');
} elseif (Context::getContext()->shop->id) {
$id_shop = Context::getContext()->shop->id;
} elseif (!Shop::isFeatureActive()) {
$id_shop = Configuration::get('PS_SHOP_DEFAULT');
} else {
$id_shop = 0;
}
$shop = new Shop($id_shop);
$root_category = Category::getRootCategory(null, $shop);
$disabled_categories[] = (int) Configuration::get('PS_ROOT_CATEGORY');
if (!$root) {
$root = array('name' => $root_category->name, 'id_category' => $root_category->id);
}
if (!$use_radio) {
$input_name = $input_name . '[]';
}
if ($use_search) {
$this->context->controller->addJs(_PS_JS_DIR_ . 'jquery/plugins/autocomplete/jquery.autocomplete.js');
}
$html = '
';
$html .= '
';
$home_is_selected = false;
if (is_array($selected_cat)) {
foreach ($selected_cat as $cat) {
if (is_array($cat)) {
$disabled = in_array($cat['id_category'], $disabled_categories);
if ($cat['id_category'] != $root['id_category']) {
$html .= '';
} else {
$home_is_selected = true;
}
} else {
$disabled = in_array($cat, $disabled_categories);
if ($cat != $root['id_category']) {
$html .= '';
} else {
$home_is_selected = true;
}
}
}
}
$root_input = '';
if ($root['id_category'] != (int) Configuration::get('PS_ROOT_CATEGORY') || (Tools::isSubmit('ajax') && Tools::getValue('action') == 'getCategoriesFromRootCategory')) {
$root_input = '
';
}
$html .= '
';
if ($use_search) {
$html .= '';
}
return $html;
}
/**
* use translations files to replace english expression.
*
* @deprecated use Context::getContext()->getTranslator()->trans($id, $parameters, $domain, $locale); instead
*
* @param mixed $string term or expression in english
* @param string $class
* @param bool $addslashes if set to true, the return value will pass through addslashes(). Otherwise, stripslashes().
* @param bool $htmlentities if set to true(default), the return value will pass through htmlentities($string, ENT_QUOTES, 'utf-8')
*
* @return string the translation if available, or the english default text
*/
protected function l($string, $class = 'AdminTab', $addslashes = false, $htmlentities = true)
{
// if the class is extended by a module, use modules/[module_name]/xx.php lang file
$current_class = get_class($this);
if (Module::getModuleNameFromClass($current_class)) {
return Translate::getModuleTranslation(Module::$classInModule[$current_class], $string, $current_class);
}
return Translate::getAdminTranslation($string, get_class($this), $addslashes, $htmlentities);
}
/**
* Render a form with potentials required fields.
*
* @param string $class_name
* @param string $identifier
* @param array $table_fields
*
* @return string
*/
public function renderRequiredFields($class_name, $identifier, $table_fields)
{
$rules = call_user_func_array(array($class_name, 'getValidationRules'), array($class_name));
$required_class_fields = array($identifier);
foreach ($rules['required'] as $required) {
$required_class_fields[] = $required;
}
/** @var ObjectModel $object */
$object = new $class_name();
$res = $object->getFieldsRequiredDatabase();
$required_fields = array();
foreach ($res as $row) {
$required_fields[(int) $row['id_required_field']] = $row['field_name'];
}
$this->tpl_vars = array(
'table_fields' => $table_fields,
'irow' => 0,
'required_class_fields' => $required_class_fields,
'required_fields' => $required_fields,
'current' => $this->currentIndex,
'token' => $this->token,
);
$tpl = $this->createTemplate('helpers/required_fields.tpl');
$tpl->assign($this->tpl_vars);
return $tpl->fetch();
}
public function renderModulesList($modules_list)
{
$this->tpl_vars = array(
'modules_list' => $modules_list,
'modules_uri' => __PS_BASE_URI__ . basename(_PS_MODULE_DIR_),
);
// The translations for this are defined by AdminModules, so override the context for the translations
$override_controller_name_for_translations = Context::getContext()->override_controller_name_for_translations;
Context::getContext()->override_controller_name_for_translations = 'AdminModules';
$tpl = $this->createTemplate('helpers/modules_list/list.tpl');
$tpl->assign($this->tpl_vars);
$html = $tpl->fetch();
// Restore the previous context
Context::getContext()->override_controller_name_for_translations = $override_controller_name_for_translations;
return $html;
}
/**
* Render shop list.
*
* @deprecated deprecated since 1.6.1.0 use HelperShop->getRenderedShopList
*
* @return string
*/
public static function renderShopList()
{
Tools::displayAsDeprecated('Use HelperShop->getRenderedShopList instead');
if (!Shop::isFeatureActive() || Shop::getTotalShops(false, null) < 2) {
return null;
}
$tree = Shop::getTree();
$context = Context::getContext();
// Get default value
$shop_context = Shop::getContext();
if ($shop_context == Shop::CONTEXT_ALL || ($context->controller->multishop_context_group == false && $shop_context == Shop::CONTEXT_GROUP)) {
$value = '';
} elseif ($shop_context == Shop::CONTEXT_GROUP) {
$value = 'g-' . Shop::getContextShopGroupID();
} else {
$value = 's-' . Shop::getContextShopID();
}
// Generate HTML
$url = $_SERVER['REQUEST_URI'] . (($_SERVER['QUERY_STRING']) ? '&' : '?') . 'setShopContext=';
$shop = new Shop(Shop::getContextShopID());
// $html = ' '.$shop->name.'';
$html = '';
return $html;
}
}