* @copyright 2007-2014 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;
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 = 'analytics_stats';
$this->version = '1.4.1';
$this->author = 'PrestaShop';
$this->need_instance = 0;
parent::__construct();
$this->default_sort_column = 'totalMoneySpent';
$this->default_sort_direction = 'DESC';
$this->empty_message = $this->l('Empty recordset returned');
$this->paging_message = sprintf($this->l('Displaying %1$s of %2$s'), '{0} - {1}', '{2}');
$currency = new Currency(Configuration::get('PS_CURRENCY_DEFAULT'));
$this->columns = array(
array(
'id' => 'lastname',
'header' => $this->l('Last Name'),
'dataIndex' => 'lastname',
'align' => 'center'
),
array(
'id' => 'firstname',
'header' => $this->l('First Name'),
'dataIndex' => 'firstname',
'align' => 'center'
),
array(
'id' => 'email',
'header' => $this->l('Email'),
'dataIndex' => 'email',
'align' => 'center'
),
array(
'id' => 'totalVisits',
'header' => $this->l('Visits'),
'dataIndex' => 'totalVisits',
'align' => 'center'
),
array(
'id' => 'totalValidOrders',
'header' => $this->l('Valid orders'),
'dataIndex' => 'totalValidOrders',
'align' => 'center'
),
array(
'id' => 'totalMoneySpent',
'header' => $this->l('Money spent').' ('.Tools::safeOutput($currency->iso_code).')',
'dataIndex' => 'totalMoneySpent',
'align' => 'center'
)
);
$this->displayName = $this->l('Best customers');
$this->description = $this->l('Adds a list of the best customers to the Stats dashboard.');
$this->ps_versions_compliancy = array('min' => '1.6', 'max' => _PS_VERSION_);
}
public function install()
{
return (parent::install() && $this->registerHook('AdminStatsModules'));
}
public function hookAdminStatsModules($params)
{
$engine_params = array(
'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->l('Guide').'
'.$this->l('Develop clients\' loyalty').'
'.$this->l('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.').'
'.$this->l('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.').'
'.$this->l('In order to achieve this goal, you can organize:').'
- '.$this->l('Punctual operations: commercial rewards (personalized special offers, product or service offered), non commercial rewards (priority handling of an order or a product), pecuniary rewards (bonds, discount coupons, payback).').'
- '.$this->l('Sustainable operations: loyalty points or cards, which not only justify communication between merchant and client, but also offer advantages to clients (private offers, discounts).').'
'.$this->l('These operations encourage clients to buy products and visit your online store more regularly.').'
'.$this->engine($engine_params).'
'.$this->l('CSV Export').'
';
return $this->html;
}
public function getData()
{
$this->query = '
SELECT SQL_CALC_FOUND_ROWS 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
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`
WHERE co.date_add BETWEEN '.$this->getDate()
.Shop::addSqlRestriction(Shop::SHARE_CUSTOMER, 'c').
'GROUP BY c.`id_customer`, c.`lastname`, c.`firstname`, c.`email`';
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(_PS_USE_SQL_SLAVE_)->executeS($this->query);
$this->_totalCount = Db::getInstance(_PS_USE_SQL_SLAVE_)->getValue('SELECT FOUND_ROWS()');
}
}