* @copyright Since 2007 PrestaShop SA and Contributors * @license https://opensource.org/licenses/AFL-3.0 Academic Free License 3.0 (AFL-3.0) */ if (!defined('_PS_VERSION_')) { exit; } class statsbestcustomers extends ModuleGrid { private $html; private $query; private $columns; private $default_sort_column; private $default_sort_direction; private $empty_message; private $paging_message; public function __construct() { $this->name = 'statsbestcustomers'; $this->tab = 'administration'; $this->version = '2.0.4'; $this->author = 'PrestaShop'; $this->need_instance = 0; parent::__construct(); $this->default_sort_column = 'totalMoneySpent'; $this->default_sort_direction = 'DESC'; $this->empty_message = $this->trans('Empty recordset returned', [], 'Modules.Statsbestcustomers.Admin'); $this->paging_message = $this->trans('Displaying %1$s of %2$s', ['{0} - {1}', '{2}'], 'Admin.Global'); $currency = new Currency((int) Configuration::get('PS_CURRENCY_DEFAULT')); $this->columns = [ [ 'id' => 'lastname', 'header' => $this->trans('Last Name', [], 'Admin.Global'), 'dataIndex' => 'lastname', 'align' => 'center', ], [ 'id' => 'firstname', 'header' => $this->trans('First Name', [], 'Admin.Global'), 'dataIndex' => 'firstname', 'align' => 'center', ], [ 'id' => 'email', 'header' => $this->trans('Email', [], 'Admin.Global'), 'dataIndex' => 'email', 'align' => 'center', ], [ 'id' => 'totalVisits', 'header' => $this->trans('Visits', [], 'Admin.Shopparameters.Feature'), 'dataIndex' => 'totalVisits', 'align' => 'center', ], [ 'id' => 'totalValidOrders', 'header' => $this->trans('Valid orders', [], 'Modules.Statsbestcustomers.Admin'), 'dataIndex' => 'totalValidOrders', 'align' => 'center', ], [ 'id' => 'totalMoneySpent', 'header' => $this->trans('Money spent', [], 'Modules.Statsbestcustomers.Admin') . ' (' . Tools::safeOutput($currency->iso_code) . ')', 'dataIndex' => 'totalMoneySpent', 'align' => 'center', ], ]; $this->displayName = $this->trans('Best customers', [], 'Modules.Statsbestcustomers.Admin'); $this->description = $this->trans('Enrich your stats, add a list of the best customers to the dashboard.', [], 'Modules.Statsbestcustomers.Admin'); $this->ps_versions_compliancy = ['min' => '1.7.1.0', 'max' => _PS_VERSION_]; } public function install() { return parent::install() && $this->registerHook('displayAdminStatsModules'); } public function hookDisplayAdminStatsModules($params) { $engine_params = [ 'id' => 'id_customer', 'title' => $this->displayName, 'columns' => $this->columns, 'defaultSortColumn' => $this->default_sort_column, 'defaultSortDirection' => $this->default_sort_direction, 'emptyMessage' => $this->empty_message, 'pagingMessage' => $this->paging_message, ]; if (Tools::getValue('export')) { $this->csvExport($engine_params); } $this->html = '
' . $this->displayName . '

' . $this->trans('Guide', [], 'Admin.Global') . '

' . $this->trans('Develop clients\' loyalty', [], 'Modules.Statsbestcustomers.Admin') . '

' . $this->trans('Keeping a client can be more profitable than gaining a new one. That is one of the many reasons it is necessary to cultivate customer loyalty.', [], 'Modules.Statsbestcustomers.Admin') . '
' . $this->trans('Word of mouth is also a means for getting new, satisfied clients. A dissatisfied customer can hurt your e-reputation and obstruct future sales goals.', [], 'Modules.Statsbestcustomers.Admin') . '
' . $this->trans('In order to achieve this goal, you can organize:', [], 'Modules.Statsbestcustomers.Admin') . ' ' . $this->trans('These operations encourage clients to buy products and visit your online store more regularly.', [], 'Modules.Statsbestcustomers.Admin') . '
' . $this->engine($engine_params) . ' ' . $this->trans('CSV Export', [], 'Admin.Global') . ' '; return $this->html; } public function getData() { $this->query = ' SELECT SQL_CALC_FOUND_ROWS DISTINCT c.`id_customer`, c.`lastname`, c.`firstname`, c.`email`, COUNT(co.`id_connections`) as totalVisits, IFNULL(( SELECT ROUND(SUM(IFNULL(op.`amount`, 0) / cu.conversion_rate), 2) FROM `' . _DB_PREFIX_ . 'orders` o LEFT JOIN `' . _DB_PREFIX_ . 'order_payment` op ON o.reference = op.order_reference LEFT JOIN `' . _DB_PREFIX_ . 'currency` cu ON o.id_currency = cu.id_currency WHERE o.id_customer = c.id_customer AND o.invoice_date BETWEEN ' . $this->getDate() . ' AND o.valid ), 0) as totalMoneySpent, IFNULL(( SELECT COUNT(*) FROM `' . _DB_PREFIX_ . 'orders` o WHERE o.id_customer = c.id_customer AND o.invoice_date BETWEEN ' . $this->getDate() . ' AND o.valid ), 0) as totalValidOrders FROM `' . _DB_PREFIX_ . 'customer` c INNER JOIN `' . _DB_PREFIX_ . 'orders` o ON o.`id_customer` = c.`id_customer` LEFT JOIN `' . _DB_PREFIX_ . 'guest` g ON c.`id_customer` = g.`id_customer` LEFT JOIN `' . _DB_PREFIX_ . 'connections` co ON g.`id_guest` = co.`id_guest` AND co.date_add BETWEEN ' . $this->getDate() . ' WHERE o.date_add BETWEEN ' . $this->getDate() . ' ' . Shop::addSqlRestriction(Shop::SHARE_CUSTOMER, 'c') . ' GROUP BY c.`id_customer`, c.`lastname`, c.`firstname`, c.`email`, o.`id_order`'; if (Validate::IsName($this->_sort)) { $this->query .= ' ORDER BY `' . bqSQL($this->_sort) . '`'; if (isset($this->_direction) && Validate::isSortDirection($this->_direction)) { $this->query .= ' ' . $this->_direction; } } if (($this->_start === 0 || Validate::IsUnsignedInt($this->_start)) && Validate::IsUnsignedInt($this->_limit)) { $this->query .= ' LIMIT ' . (int) $this->_start . ', ' . (int) $this->_limit; } $this->_values = Db::getInstance((bool) _PS_USE_SQL_SLAVE_)->executeS($this->query); $this->_totalCount = (int) Db::getInstance((bool) _PS_USE_SQL_SLAVE_)->getValue('SELECT FOUND_ROWS()'); } }