* @copyright Since 2007 PrestaShop SA and Contributors * @license https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0) */ /** * Class MessageCore. */ class MessageCore extends ObjectModel { public $id; /** @var string message content */ public $message; /** @var int Cart ID (if applicable) */ public $id_cart; /** @var int Order ID (if applicable) */ public $id_order; /** @var int Customer ID (if applicable) */ public $id_customer; /** @var int Employee ID (if applicable) */ public $id_employee; /** @var bool Message is not displayed to the customer */ public $private; /** @var string Object creation date */ public $date_add; /** * @see ObjectModel::$definition */ public static $definition = [ 'table' => 'message', 'primary' => 'id_message', 'fields' => [ 'message' => ['type' => self::TYPE_STRING, 'validate' => 'isCleanHtml', 'required' => true, 'size' => 4194303], 'id_cart' => ['type' => self::TYPE_INT, 'validate' => 'isUnsignedId'], 'id_order' => ['type' => self::TYPE_INT, 'validate' => 'isUnsignedId'], 'id_customer' => ['type' => self::TYPE_INT, 'validate' => 'isUnsignedId'], 'id_employee' => ['type' => self::TYPE_INT, 'validate' => 'isUnsignedId'], 'private' => ['type' => self::TYPE_BOOL, 'validate' => 'isBool'], 'date_add' => ['type' => self::TYPE_DATE, 'validate' => 'isDate'], ], ]; protected $webserviceParameters = [ 'fields' => [ 'id_cart' => [ 'xlink_resource' => 'carts', ], 'id_order' => [ 'xlink_resource' => 'orders', ], 'id_customer' => [ 'xlink_resource' => 'customers', ], 'id_employee' => [ 'xlink_resource' => 'employees', ], ], ]; /** * Return the last message from cart. * * @param int $idCart Cart ID * * @return array Message */ public static function getMessageByCartId($idCart) { return Db::getInstance()->getRow( ' SELECT * FROM `' . _DB_PREFIX_ . 'message` WHERE `id_cart` = ' . (int) $idCart ); } /** * Return messages from Order ID. * * @param int $idOrder Order ID * @param bool $private return WITH private messages * * @return array Messages */ public static function getMessagesByOrderId($idOrder, $private = false, Context $context = null) { if (!Validate::isBool($private)) { die(Tools::displayError('Parameter "private" is invalid.')); } if (!$context) { $context = Context::getContext(); } return Db::getInstance()->executeS(' SELECT m.*, c.`firstname` AS cfirstname, c.`lastname` AS clastname, e.`firstname` AS efirstname, e.`lastname` AS elastname, (COUNT(mr.id_message) = 0 AND m.id_customer != 0) AS is_new_for_me FROM `' . _DB_PREFIX_ . 'message` m LEFT JOIN `' . _DB_PREFIX_ . 'customer` c ON m.`id_customer` = c.`id_customer` LEFT JOIN `' . _DB_PREFIX_ . 'message_readed` mr ON mr.`id_message` = m.`id_message` AND mr.`id_employee` = ' . (isset($context->employee) ? (int) $context->employee->id : '\'\'') . ' LEFT OUTER JOIN `' . _DB_PREFIX_ . 'employee` e ON e.`id_employee` = m.`id_employee` WHERE id_order = ' . (int) $idOrder . ' ' . (!$private ? ' AND m.`private` = 0' : '') . ' GROUP BY m.id_message ORDER BY m.date_add DESC '); } /** * Return messages from Cart ID. * * @param int $idCart Cart ID * @param bool $private return WITH private messages * @param Context|null $context * * @return array Messages */ public static function getMessagesByCartId($idCart, $private = false, Context $context = null) { if (!Validate::isBool($private)) { die(Tools::displayError('Parameter "private" is invalid.')); } if (!$context) { $context = Context::getContext(); } return Db::getInstance()->executeS(' SELECT m.*, c.`firstname` AS cfirstname, c.`lastname` AS clastname, e.`firstname` AS efirstname, e.`lastname` AS elastname, (COUNT(mr.id_message) = 0 AND m.id_customer != 0) AS is_new_for_me FROM `' . _DB_PREFIX_ . 'message` m LEFT JOIN `' . _DB_PREFIX_ . 'customer` c ON m.`id_customer` = c.`id_customer` LEFT JOIN `' . _DB_PREFIX_ . 'message_readed` mr ON (mr.id_message = m.id_message AND mr.id_employee = ' . (int) $context->employee->id . ') LEFT OUTER JOIN `' . _DB_PREFIX_ . 'employee` e ON e.`id_employee` = m.`id_employee` WHERE id_cart = ' . (int) $idCart . ' ' . (!$private ? ' AND m.`private` = 0' : '') . ' GROUP BY m.id_message ORDER BY m.date_add DESC '); } /** * Registered a message 'readed'. * * @param int $idMessage Message ID * @param int $idEmployee Employee ID * * @return bool */ public static function markAsReaded($idMessage, $idEmployee) { if (!Validate::isUnsignedId($idMessage)) { die(Tools::displayError('Message ID is invalid.')); } if (!Validate::isUnsignedId($idEmployee)) { die(Tools::displayError('Employee ID is invalid.')); } $result = Db::getInstance()->execute(' INSERT INTO ' . _DB_PREFIX_ . 'message_readed (id_message , id_employee , date_add) VALUES (' . (int) $idMessage . ', ' . (int) $idEmployee . ', NOW()); '); return $result; } }