first commit

classes/Smarty/SmartyCacheResourceMysql.php

@@ -0,0 +1,131 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Open Software License (OSL 3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/OSL-3.0
+ * 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 https://devdocs.prestashop.com/ for more information.
+ *
+ * @author    PrestaShop SA and Contributors <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
+ */
+class Smarty_CacheResource_Mysql extends Smarty_CacheResource_Custom
+{
+    /**
+     * fetch cached content and its modification time from data source.
+     *
+     * @param string $id unique cache content identifier
+     * @param string $name template name
+     * @param string $cache_id cache id
+     * @param string $compile_id compile id
+     * @param string $content cached content
+     * @param int $mtime cache modification timestamp (epoch)
+     */
+    protected function fetch($id, $name, $cache_id, $compile_id, &$content, &$mtime)
+    {
+        $row = Db::getInstance()->getRow('SELECT modified, content FROM ' . _DB_PREFIX_ . 'smarty_cache WHERE id_smarty_cache = "' . pSQL($id, true) . '"');
+        if ($row) {
+            $content = $row['content'];
+            $mtime = strtotime($row['modified']);
+        } else {
+            $content = null;
+            $mtime = null;
+        }
+    }
+
+    /**
+     * Fetch cached content's modification timestamp from data source.
+     *
+     * @note implementing this method is optional. Only implement it if modification times can be accessed faster than loading the complete cached content.
+     *
+     * @param string $id unique cache content identifier
+     * @param string $name template name
+     * @param string $cache_id cache id
+     * @param string $compile_id compile id
+     *
+     * @return int|bool timestamp (epoch) the template was modified, or false if not found
+     */
+    protected function fetchTimestamp($id, $name, $cache_id, $compile_id)
+    {
+        $value = Db::getInstance()->getValue('SELECT modified FROM ' . _DB_PREFIX_ . 'smarty_cache WHERE id_smarty_cache = "' . pSQL($id, true) . '"');
+        $mtime = strtotime($value);
+
+        return $mtime;
+    }
+
+    /**
+     * Save content to cache.
+     *
+     * @param string $id unique cache content identifier
+     * @param string $name template name
+     * @param string $cache_id cache id
+     * @param string $compile_id compile id
+     * @param int|null $exp_time seconds till expiration time in seconds or null
+     * @param string $content content to cache
+     *
+     * @return bool success
+     */
+    protected function save($id, $name, $cache_id, $compile_id, $exp_time, $content)
+    {
+        Db::getInstance()->execute('
+		REPLACE INTO ' . _DB_PREFIX_ . 'smarty_cache (id_smarty_cache, name, cache_id, content)
+		VALUES (
+			"' . pSQL($id, true) . '",
+			"' . pSQL(sha1($name)) . '",
+			"' . pSQL($cache_id, true) . '",
+			"' . pSQL($content, true) . '"
+		)');
+
+        return (bool) Db::getInstance()->Affected_Rows();
+    }
+
+    /**
+     * Delete content from cache.
+     *
+     * @param string $name template name
+     * @param string $cache_id cache id
+     * @param string $compile_id compile id
+     * @param int|null $exp_time seconds till expiration or null
+     *
+     * @return int number of deleted caches
+     */
+    protected function delete($name, $cache_id, $compile_id, $exp_time)
+    {
+        // delete the whole cache
+        if ($name === null && $cache_id === null && $compile_id === null && $exp_time === null) {
+            // returning the number of deleted caches would require a second query to count them
+            Db::getInstance()->execute('TRUNCATE TABLE ' . _DB_PREFIX_ . 'smarty_cache');
+
+            return -1;
+        }
+
+        $where = [];
+        if ($name !== null) {
+            $where[] = 'name = "' . pSQL(sha1($name)) . '"';
+        }
+        if ($exp_time !== null) {
+            $where[] = 'modified < DATE_SUB(NOW(), INTERVAL ' . (int) $exp_time . ' SECOND)';
+        }
+        if ($cache_id !== null) {
+            $where[] = '(cache_id  = "' . pSQL($cache_id, true) . '" OR cache_id LIKE "' . pSQL($cache_id . '|%', true) . '")';
+        }
+
+        Db::getInstance()->execute('DELETE FROM ' . _DB_PREFIX_ . 'smarty_cache WHERE ' . implode(' AND ', $where));
+
+        return Db::getInstance()->Affected_Rows();
+    }
+}

classes/Smarty/SmartyCustom.php

@@ -0,0 +1,301 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Open Software License (OSL 3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/OSL-3.0
+ * 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 https://devdocs.prestashop.com/ for more information.
+ *
+ * @author    PrestaShop SA and Contributors <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
+ */
+class SmartyCustomCore extends Smarty
+{
+    public function __construct()
+    {
+        parent::__construct();
+        $this->template_class = 'SmartyCustomTemplate';
+    }
+
+    /**
+     * Delete compiled template file (lazy delete if resource_name is not specified).
+     *
+     * @param string $resource_name template name
+     * @param string $compile_id compile id
+     * @param int $exp_time expiration time
+     *
+     * @return int number of template files deleted
+     */
+    public function clearCompiledTemplate($resource_name = null, $compile_id = null, $exp_time = null)
+    {
+        if ($resource_name == null) {
+            Db::getInstance()->execute('REPLACE INTO `' . _DB_PREFIX_ . 'smarty_last_flush` (`type`, `last_flush`) VALUES (\'compile\', FROM_UNIXTIME(' . time() . '))');
+
+            return 0;
+        }
+
+        return parent::clearCompiledTemplate($resource_name, $compile_id, $exp_time);
+    }
+
+    /**
+     * Mark all template files to be regenerated.
+     *
+     * @param int $exp_time expiration time
+     * @param string $type resource type
+     *
+     * @return int number of cache files which needs to be updated
+     */
+    public function clearAllCache($exp_time = null, $type = null)
+    {
+        Db::getInstance()->execute('REPLACE INTO `' . _DB_PREFIX_ . 'smarty_last_flush` (`type`, `last_flush`) VALUES (\'template\', FROM_UNIXTIME(' . time() . '))');
+
+        return $this->delete_from_lazy_cache(null, null, null);
+    }
+
+    /**
+     * Mark file to be regenerated for a specific template.
+     *
+     * @param string $template_name template name
+     * @param string $cache_id cache id
+     * @param string $compile_id compile id
+     * @param int $exp_time expiration time
+     * @param string $type resource type
+     *
+     * @return int number of cache files which needs to be updated
+     */
+    public function clearCache($template_name, $cache_id = null, $compile_id = null, $exp_time = null, $type = null)
+    {
+        return $this->delete_from_lazy_cache($template_name, $cache_id, $compile_id);
+    }
+
+    /**
+     * Check the compile cache needs to be invalidated (multi front + local cache compatible).
+     */
+    public function check_compile_cache_invalidation()
+    {
+        static $last_flush = null;
+        if (!file_exists($this->getCompileDir() . 'last_flush')) {
+            @touch($this->getCompileDir() . 'last_flush', time());
+        } elseif (defined('_DB_PREFIX_')) {
+            if ($last_flush === null) {
+                $sql = 'SELECT UNIX_TIMESTAMP(last_flush) as last_flush FROM `' . _DB_PREFIX_ . 'smarty_last_flush` WHERE type=\'compile\'';
+                $last_flush = Db::getInstance()->getValue($sql, false);
+            }
+            if ((int) $last_flush && @filemtime($this->getCompileDir() . 'last_flush') < $last_flush) {
+                @touch($this->getCompileDir() . 'last_flush', time());
+                parent::clearCompiledTemplate();
+            }
+        }
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function fetch($template = null, $cache_id = null, $compile_id = null, $parent = null, $display = false, $merge_tpl_vars = true, $no_output_filter = false)
+    {
+        $this->check_compile_cache_invalidation();
+
+        return parent::fetch($template, $cache_id, $compile_id, $parent, $display, $merge_tpl_vars, $no_output_filter);
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function createTemplate($template, $cache_id = null, $compile_id = null, $parent = null, $do_clone = true)
+    {
+        $this->check_compile_cache_invalidation();
+        if ($this->caching) {
+            $this->check_template_invalidation($template, $cache_id, $compile_id);
+        }
+
+        return parent::createTemplate($template, $cache_id, $compile_id, $parent, $do_clone);
+    }
+
+    /**
+     * Handle the lazy template cache invalidation.
+     *
+     * @param string $template template name
+     * @param string $cache_id cache id
+     * @param string $compile_id compile id
+     */
+    public function check_template_invalidation($template, $cache_id, $compile_id)
+    {
+        static $last_flush = null;
+        if (!file_exists($this->getCacheDir() . 'last_template_flush')) {
+            @touch($this->getCacheDir() . 'last_template_flush', time());
+        } elseif (defined('_DB_PREFIX_')) {
+            if ($last_flush === null) {
+                $sql = 'SELECT UNIX_TIMESTAMP(last_flush) as last_flush FROM `' . _DB_PREFIX_ . 'smarty_last_flush` WHERE type=\'template\'';
+                $last_flush = Db::getInstance()->getValue($sql, false);
+            }
+
+            if ((int) $last_flush && @filemtime($this->getCacheDir() . 'last_template_flush') < $last_flush) {
+                @touch($this->getCacheDir() . 'last_template_flush', time());
+                parent::clearAllCache();
+            } else {
+                if ($cache_id !== null && (is_object($cache_id) || is_array($cache_id))) {
+                    $cache_id = null;
+                }
+
+                if ($this->is_in_lazy_cache($template, $cache_id, $compile_id) === false) {
+                    // insert in cache before the effective cache creation to avoid nasty race condition
+                    $this->insert_in_lazy_cache($template, $cache_id, $compile_id);
+                    parent::clearCache($template, $cache_id, $compile_id);
+                }
+            }
+        }
+    }
+
+    /**
+     * Store the cache file path.
+     *
+     * @param string $filepath cache file path
+     * @param string $template template name
+     * @param string $cache_id cache id
+     * @param string $compile_id compile id
+     */
+    public function update_filepath($filepath, $template, $cache_id, $compile_id)
+    {
+        $template_md5 = md5($template);
+        $sql = 'UPDATE `' . _DB_PREFIX_ . 'smarty_lazy_cache`
+							SET filepath=\'' . pSQL($filepath) . '\'
+							WHERE `template_hash`=\'' . pSQL($template_md5) . '\'';
+
+        $sql .= ' AND cache_id="' . pSQL((string) $cache_id) . '"';
+
+        if (strlen($compile_id) > 32) {
+            $compile_id = md5($compile_id);
+        }
+        $sql .= ' AND compile_id="' . pSQL((string) $compile_id) . '"';
+        Db::getInstance()->execute($sql, false);
+    }
+
+    /**
+     * Check if the current template is stored in the lazy cache
+     * Entry in the lazy cache = no need to regenerate the template.
+     *
+     * @param string $template template name
+     * @param string $cache_id cache id
+     * @param string $compile_id compile id
+     *
+     * @return bool
+     */
+    public function is_in_lazy_cache($template, $cache_id, $compile_id)
+    {
+        static $is_in_lazy_cache = [];
+        $template_md5 = md5($template);
+
+        if (strlen($compile_id) > 32) {
+            $compile_id = md5($compile_id);
+        }
+
+        $key = md5($template_md5 . '-' . $cache_id . '-' . $compile_id);
+
+        if (isset($is_in_lazy_cache[$key])) {
+            return $is_in_lazy_cache[$key];
+        } else {
+            $sql = 'SELECT UNIX_TIMESTAMP(last_update) as last_update, filepath FROM `' . _DB_PREFIX_ . 'smarty_lazy_cache`
+							WHERE `template_hash`=\'' . pSQL($template_md5) . '\'';
+            $sql .= ' AND cache_id="' . pSQL((string) $cache_id) . '"';
+            $sql .= ' AND compile_id="' . pSQL((string) $compile_id) . '"';
+
+            $result = Db::getInstance()->getRow($sql, false);
+            // If the filepath is not yet set, it means the cache update is in progress in another process.
+            // In this case do not try to clear the cache again and tell to use the existing cache, if any
+            if ($result !== false && $result['filepath'] == '') {
+                // If the cache update is stalled for more than 1min, something should be wrong,
+                // remove the entry from the lazy cache
+                if ($result['last_update'] < time() - 60) {
+                    $this->delete_from_lazy_cache($template, $cache_id, $compile_id);
+                }
+
+                $return = true;
+            } else {
+                if ($result === false
+                    || @filemtime($this->getCacheDir() . $result['filepath']) < $result['last_update']) {
+                    $return = false;
+                } else {
+                    $return = $result['filepath'];
+                }
+            }
+            $is_in_lazy_cache[$key] = $return;
+        }
+
+        return $return;
+    }
+
+    /**
+     * Insert the current template in the lazy cache.
+     *
+     * @param string $template template name
+     * @param string $cache_id cache id
+     * @param string $compile_id compile id
+     *
+     * @return bool
+     */
+    public function insert_in_lazy_cache($template, $cache_id, $compile_id)
+    {
+        $template_md5 = md5($template);
+        $sql = 'INSERT IGNORE INTO `' . _DB_PREFIX_ . 'smarty_lazy_cache`
+							(`template_hash`, `cache_id`, `compile_id`, `last_update`)
+							VALUES (\'' . pSQL($template_md5) . '\'';
+
+        $sql .= ',"' . pSQL((string) $cache_id) . '"';
+
+        if (strlen($compile_id) > 32) {
+            $compile_id = md5($compile_id);
+        }
+        $sql .= ',"' . pSQL((string) $compile_id) . '"';
+        $sql .= ', FROM_UNIXTIME(' . time() . '))';
+
+        return Db::getInstance()->execute($sql, false);
+    }
+
+    /**
+     * Delete the current template from the lazy cache or the whole cache if no template name is given.
+     *
+     * @param string $template template name
+     * @param string $cache_id cache id
+     * @param string $compile_id compile id
+     *
+     * @return bool
+     */
+    public function delete_from_lazy_cache($template, $cache_id, $compile_id)
+    {
+        if (!$template) {
+            return Db::getInstance()->execute('TRUNCATE TABLE `' . _DB_PREFIX_ . 'smarty_lazy_cache`', false);
+        }
+
+        $template_md5 = md5($template);
+        $sql = 'DELETE FROM `' . _DB_PREFIX_ . 'smarty_lazy_cache`
+							WHERE template_hash=\'' . pSQL($template_md5) . '\'';
+
+        if ($cache_id != null) {
+            $sql .= ' AND cache_id LIKE "' . pSQL((string) $cache_id) . '%"';
+        }
+
+        if ($compile_id != null) {
+            if (strlen($compile_id) > 32) {
+                $compile_id = md5($compile_id);
+            }
+            $sql .= ' AND compile_id="' . pSQL((string) $compile_id) . '"';
+        }
+        Db::getInstance()->execute($sql, false);
+
+        return Db::getInstance()->Affected_Rows();
+    }
+}

classes/Smarty/SmartyCustomTemplate.php

@@ -0,0 +1,47 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Open Software License (OSL 3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/OSL-3.0
+ * 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 https://devdocs.prestashop.com/ for more information.
+ *
+ * @author    PrestaShop SA and Contributors <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
+ */
+class SmartyCustomTemplateCore extends Smarty_Internal_Template
+{
+    /** @var SmartyCustom|null */
+    public $smarty = null;
+
+    public function fetch($template = null, $cache_id = null, $compile_id = null, $parent = null, $display = false, $merge_tpl_vars = true, $no_output_filter = false)
+    {
+        if ($this->smarty->caching) {
+            $tpl = parent::fetch($template, $cache_id, $compile_id, $parent, $display, $merge_tpl_vars, $no_output_filter);
+            if (property_exists($this, 'cached')) {
+                $filepath = str_replace($this->smarty->getCacheDir(), '', $this->cached->filepath);
+                if ($this->smarty->is_in_lazy_cache($this->template_resource, $this->cache_id, $this->compile_id) != $filepath) {
+                    $this->smarty->update_filepath($filepath, $this->template_resource, $this->cache_id, $this->compile_id);
+                }
+            }
+
+            return $tpl;
+        } else {
+            return parent::fetch($template, $cache_id, $compile_id, $parent, $display, $merge_tpl_vars, $no_output_filter);
+        }
+    }
+}

classes/Smarty/SmartyDev.php

@@ -0,0 +1,43 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Open Software License (OSL 3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/OSL-3.0
+ * 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 https://devdocs.prestashop.com/ for more information.
+ *
+ * @author    PrestaShop SA and Contributors <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
+ */
+class SmartyDev extends Smarty
+{
+    public function __construct()
+    {
+        parent::__construct();
+        $this->template_class = 'SmartyDevTemplate';
+    }
+
+    /**
+     * {@inheritdoc}
+     */
+    public function fetch($template = null, $cache_id = null, $compile_id = null, $parent = null, $display = false, $merge_tpl_vars = true, $no_output_filter = false)
+    {
+        return "\n<!-- begin $template -->\n"
+                . parent::fetch($template, $cache_id, $compile_id, $parent, $display, $merge_tpl_vars, $no_output_filter)
+                . "\n<!-- end $template -->\n";
+    }
+}

classes/Smarty/SmartyDevTemplate.php

@@ -0,0 +1,43 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Open Software License (OSL 3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/OSL-3.0
+ * 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 https://devdocs.prestashop.com/ for more information.
+ *
+ * @author    PrestaShop SA and Contributors <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
+ */
+class SmartyDevTemplateCore extends Smarty_Internal_Template
+{
+    /** @var SmartyCustom|null */
+    public $smarty = null;
+
+    public function fetch($template = null, $cache_id = null, $compile_id = null, $parent = null, $display = false, $merge_tpl_vars = true, $no_output_filter = false)
+    {
+        if (null !== $template) {
+            $tpl = $template->template_resource;
+        } else {
+            $tpl = $this->template_resource;
+        }
+
+        return "\n<!-- begin $tpl -->\n"
+            . parent::fetch($template, $cache_id, $compile_id, $parent, $display, $merge_tpl_vars, $no_output_filter)
+            . "\n<!-- end $tpl -->\n";
+    }
+}

classes/Smarty/SmartyLazyRegister.php

@@ -0,0 +1,97 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Open Software License (OSL 3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/OSL-3.0
+ * 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 https://devdocs.prestashop.com/ for more information.
+ *
+ * @author    PrestaShop SA and Contributors <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
+ */
+/**
+ * Used to delay loading of external classes with smarty->register_plugin.
+ */
+class SmartyLazyRegister
+{
+    protected $registry = [];
+    protected static $instances = [];
+
+    /**
+     * Register a function or method to be dynamically called later.
+     *
+     * @param string|array $params function name or array(object name, method name)
+     */
+    public function register($params)
+    {
+        if (is_array($params)) {
+            $this->registry[$params[1]] = $params;
+        } else {
+            $this->registry[$params] = $params;
+        }
+    }
+
+    public function isRegistered($params)
+    {
+        if (is_array($params)) {
+            $params = $params[1];
+        }
+
+        return isset($this->registry[$params]);
+    }
+
+    /**
+     * Dynamically call static function or method.
+     *
+     * @param string $name function name
+     * @param mixed $arguments function argument
+     *
+     * @return mixed function return
+     */
+    public function __call($name, $arguments)
+    {
+        $item = $this->registry[$name];
+
+        // case 1: call to static method - case 2 : call to static function
+        if (is_array($item[1])) {
+            return call_user_func_array($item[1] . '::' . $item[0], [$arguments[0], &$arguments[1]]);
+        } else {
+            $args = [];
+
+            foreach ($arguments as $a => $argument) {
+                if ($a == 0) {
+                    $args[] = $arguments[0];
+                } else {
+                    $args[] = &$arguments[$a];
+                }
+            }
+
+            return call_user_func_array($item, $args);
+        }
+    }
+
+    public static function getInstance($smarty)
+    {
+        $hash = spl_object_hash($smarty);
+
+        if (!isset(self::$instances[$hash])) {
+            self::$instances[$hash] = new self();
+        }
+
+        return self::$instances[$hash];
+    }
+}

classes/Smarty/SmartyResourceModule.php

@@ -0,0 +1,66 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Open Software License (OSL 3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/OSL-3.0
+ * 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 https://devdocs.prestashop.com/ for more information.
+ *
+ * @author    PrestaShop SA and Contributors <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
+ */
+
+/**
+ * Override module templates easily.
+ *
+ * @since 1.7.0.0
+ */
+class SmartyResourceModuleCore extends Smarty_Resource_Custom
+{
+    public function __construct(array $paths, $isAdmin = false)
+    {
+        $this->paths = $paths;
+        $this->isAdmin = $isAdmin;
+    }
+
+    /**
+     * Fetch a template.
+     *
+     * @param string $name template name
+     * @param string $source template source
+     * @param int $mtime template modification timestamp (epoch)
+     */
+    protected function fetch($name, &$source, &$mtime)
+    {
+        foreach ($this->paths as $path) {
+            if (Tools::file_exists_cache($file = $path . $name)) {
+                if (_PS_MODE_DEV_) {
+                    $source = implode('', [
+                        '<!-- begin ' . $file . ' -->',
+                        file_get_contents($file),
+                        '<!-- end ' . $file . ' -->',
+                    ]);
+                } else {
+                    $source = file_get_contents($file);
+                }
+                $mtime = filemtime($file);
+
+                return;
+            }
+        }
+    }
+}

classes/Smarty/SmartyResourceParent.php

@@ -0,0 +1,65 @@
+<?php
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Open Software License (OSL 3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/OSL-3.0
+ * 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 https://devdocs.prestashop.com/ for more information.
+ *
+ * @author    PrestaShop SA and Contributors <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
+ */
+
+/**
+ * Override module templates easily.
+ *
+ * @since 1.7.0.0
+ */
+class SmartyResourceParentCore extends Smarty_Resource_Custom
+{
+    public function __construct(array $paths)
+    {
+        $this->paths = $paths;
+    }
+
+    /**
+     * Fetch a template.
+     *
+     * @param string $name template name
+     * @param string $source template source
+     * @param int $mtime template modification timestamp (epoch)
+     */
+    protected function fetch($name, &$source, &$mtime)
+    {
+        foreach ($this->paths as $path) {
+            if (Tools::file_exists_cache($file = $path . $name)) {
+                if (_PS_MODE_DEV_) {
+                    $source = implode('', [
+                        '<!-- begin ' . $file . ' -->',
+                        file_get_contents($file),
+                        '<!-- end ' . $file . ' -->',
+                    ]);
+                } else {
+                    $source = file_get_contents($file);
+                }
+                $mtime = filemtime($file);
+
+                return;
+            }
+        }
+    }
+}

classes/Smarty/TemplateFinder.php

@@ -0,0 +1,208 @@
+<?php
+
+/**
+ * Copyright since 2007 PrestaShop SA and Contributors
+ * PrestaShop is an International Registered Trademark & Property of PrestaShop SA
+ *
+ * NOTICE OF LICENSE
+ *
+ * This source file is subject to the Open Software License (OSL 3.0)
+ * that is bundled with this package in the file LICENSE.md.
+ * It is also available through the world-wide-web at this URL:
+ * https://opensource.org/licenses/OSL-3.0
+ * 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 https://devdocs.prestashop.com/ for more information.
+ *
+ * @author    PrestaShop SA and Contributors <contact@prestashop.com>
+ * @copyright Since 2007 PrestaShop SA and Contributors
+ * @license   https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
+ */
+
+/**
+ * Determine the best existing template.
+ *
+ * @since 1.7.0.0
+ */
+class TemplateFinderCore
+{
+    private $directories;
+    private $extension;
+    private $productListEntities = ['category', 'manufacturer', 'supplier'];
+    private $productListSearchEntities = ['search', 'price-drop', 'best-sale', 'prices-drop', 'best-sales', 'new-products'];
+    private $productEntities = ['product'];
+    private $brandListEntities = ['manufacturers', 'suppliers'];
+
+    public function __construct(array $directories, $extension)
+    {
+        $this->directories = $directories;
+        $this->extension = $extension;
+    }
+
+    public function getTemplate($template, $entity, $id, $locale)
+    {
+        $locale = (Validate::isLocale($locale)) ? $locale : '';
+
+        $templates = $this->getTemplateHierarchy($template, $entity, $id);
+
+        foreach ($this->directories as $dir) {
+            foreach ($templates as $tpl) {
+                if (!empty($locale) && is_file($dir . $locale . DIRECTORY_SEPARATOR . $tpl . $this->extension)) {
+                    return $locale . DIRECTORY_SEPARATOR . $tpl . $this->extension;
+                }
+                if (is_file($dir . $tpl . $this->extension)) {
+                    return $tpl . $this->extension;
+                }
+                if (is_file($dir . $tpl) && false !== strpos($tpl, $this->extension)) {
+                    return $tpl;
+                }
+            }
+        }
+
+        throw new PrestaShopException('No template found for ' . $template);
+    }
+
+    private function getTemplateHierarchy($template, $entity, $id)
+    {
+        $entity = basename($entity);
+        $id = (int) $id;
+
+        if (in_array($entity, $this->getProductListEntities())) {
+            $templates = [
+                'catalog/listing/' . $entity . '-' . $id,
+                'catalog/listing/' . $entity,
+                $template,
+                'catalog/listing/product-list',
+            ];
+        } elseif (in_array($entity, $this->getProductListSearchEntities())) {
+            $templates = [
+                'catalog/listing/' . $entity,
+                $template,
+                'catalog/listing/product-list',
+            ];
+        } elseif (in_array($entity, $this->getProductEntities())) {
+            $templates = [
+                'catalog/' . $entity . '-' . $id,
+                $template,
+                'catalog/product',
+            ];
+        } elseif (in_array($entity, $this->getBrandListEntities())) {
+            $templates = [
+                $template,
+                'catalog/brands',
+            ];
+        } elseif ('cms' === $entity) {
+            $templates = [
+                'cms/page-' . $id,
+                $template,
+                'cms/page',
+            ];
+        } else {
+            $templates = [$template];
+        }
+
+        return array_unique($templates);
+    }
+
+    /**
+     * Get productListEntities.
+     *
+     * @return array
+     */
+    public function getProductListEntities()
+    {
+        return $this->productListEntities;
+    }
+
+    /**
+     * Set productListEntities.
+     *
+     * @param array $productListEntities
+     *
+     * @return TemplateFinderCore
+     */
+    public function setProductListEntities($productListEntities)
+    {
+        $this->productListEntities = $productListEntities;
+
+        return $this;
+    }
+
+    /**
+     * Get productListSearch.
+     *
+     * @return array
+     */
+    public function getProductListSearchEntities()
+    {
+        return $this->productListSearchEntities;
+    }
+
+    /**
+     * Set productListSearch.
+     *
+     * @param array $productListSearch
+     *
+     * @return TemplateFinderCore
+     */
+    public function setProductListSearchEntities($productListSearchEntities)
+    {
+        $this->productListSearchEntities = $productListSearchEntities;
+
+        return $this;
+    }
+
+    /**
+     * Get productEntities.
+     *
+     * @return array
+     */
+    public function getProductEntities()
+    {
+        return $this->productEntities;
+    }
+
+    /**
+     * Set productEntities.
+     *
+     * @param array $productEntities
+     *
+     * @return TemplateFinderCore
+     */
+    public function setProductEntities($productEntities)
+    {
+        $this->productEntities = $productEntities;
+
+        return $this;
+    }
+
+    /**
+     * Get brandListEntities.
+     *
+     * @return array
+     */
+    public function getBrandListEntities()
+    {
+        return $this->brandListEntities;
+    }
+
+    /**
+     * Set brandListEntities.
+     *
+     * @param array $brandListEntities
+     *
+     * @return TemplateFinderCore
+     */
+    public function setBrandListEntities($brandListEntities)
+    {
+        $this->brandListEntities = $brandListEntities;
+
+        return $this;
+    }
+}