prestashop-module/retailcrm/lib/RetailcrmTools.php
Neur0toxine 8a3f87ce81
ability to enable or disable job manager runs via client request
* ability to enable or disable job manager runs via client request
* ability to run all jobs via cli
2020-05-18 14:48:03 +03:00

484 lines
15 KiB
PHP

<?php
/**
* MIT License
*
* Copyright (c) 2020 DIGITAL RETAIL TECHNOLOGIES SL
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
* SOFTWARE.
*
* 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 http://www.prestashop.com for more information.
*
* @author DIGITAL RETAIL TECHNOLOGIES SL <mail@simlachat.com>
* @copyright 2020 DIGITAL RETAIL TECHNOLOGIES SL
* @license https://opensource.org/licenses/MIT The MIT License
*
* Don't forget to prefix your containers with your own identifier
* to avoid any conflicts with others containers.
*/
class RetailcrmTools
{
/**
* @var int
*/
static $currentStatusCode;
/**
* Returns true if corporate customers are enabled in settings
*
* @return bool
*/
public static function isCorporateEnabled()
{
return (bool)Configuration::get(RetailCRM::ENABLE_CORPORATE_CLIENTS);
}
/**
* Returns true if customer is corporate
*
* @param Customer $customer
*
* @return bool
*/
public static function isCustomerCorporate(Customer $customer)
{
$addresses = $customer->getAddresses((int)Configuration::get('PS_LANG_DEFAULT'));
foreach ($addresses as $address) {
if (($address instanceof Address && !empty($address->company))
|| (is_array($address) && !empty($address['company']))
) {
return true;
}
}
return false;
}
/**
* Returns true if order is corporate
*
* @param Order $order
*
* @return bool
*/
public static function isOrderCorporate(Order $order)
{
if (empty($order->id_address_invoice)) {
return false;
}
$address = new Address($order->id_address_invoice);
return $address instanceof Address && !empty($address->company);
}
/**
* Returns 'true' if provided date string is valid
*
* @param $date
* @param string $format
*
* @return bool
*/
public static function verifyDate($date, $format = "Y-m-d")
{
return $date !== "0000-00-00" && (bool)date_create_from_format($format, $date);
}
/**
* Split a string to id
*
* @param string $ids string with id
*
* @return array|string
*/
public static function partitionId($ids)
{
$ids = explode(',', $ids);
$ranges = array();
foreach ($ids as $idx => $uid) {
if (strpos($uid, '-')) {
$range = explode('-', $uid);
$ranges = array_merge($ranges, range($range[0], $range[1]));
unset($ids[$idx]);
}
}
$ids = implode(',', array_merge($ids, $ranges));
$ids = explode(',', $ids);
return $ids;
}
/**
* Converts CMS address to CRM address
*
* @param $address
* @param array $customer
* @param array $order
* @deprecated Replaced with RetailcrmAddressBuilder
*
* @return array
*/
public static function addressParse($address, &$customer = array(), &$order = array())
{
if (!isset($customer)) {
$customer = array();
}
if (!isset($order)) {
$order = array();
}
if ($address instanceof Address) {
$postcode = $address->postcode;
$city = $address->city;
$addres_line = sprintf("%s %s", $address->address1, $address->address2);
$countryIso = Country::getIsoById($address->id_country);
$vat = $address->vat_number;
}
if (!empty($postcode)) {
$customer['address']['index'] = $postcode;
$order['delivery']['address']['index'] = $postcode;
}
if (!empty($city)) {
$customer['address']['city'] = $city;
$order['delivery']['address']['city'] = $city;
}
if (!empty($addres_line)) {
$customer['address']['text'] = $addres_line;
$order['delivery']['address']['text'] = $addres_line;
}
if (!empty($countryIso)) {
$order['countryIso'] = $countryIso;
$customer['address']['countryIso'] = $countryIso;
}
$phones = static::getPhone($address, $customer, $order);
$order = array_merge($order, $phones['order']);
$customer = array_merge($customer, $phones['customer']);
return array(
'order' => RetailcrmTools::clearArray($order),
'customer' => RetailcrmTools::clearArray($customer),
'vat' => isset($vat) && !empty($vat) ? $vat : ''
);
}
public static function getPhone($address, &$customer = array(), &$order = array())
{
if (!isset($customer)) {
$customer = array();
}
if (!isset($order)) {
$order = array();
}
if (!empty($address->phone_mobile)) {
$order['phone'] = $address->phone_mobile;
$customer['phones'][] = array('number'=> $address->phone_mobile);
}
if (!empty($address->phone)) {
$order['additionalPhone'] = $address->phone;
$customer['phones'][] = array('number'=> $address->phone);
}
if (!isset($order['phone']) && !empty($order['additionalPhone'])) {
$order['phone'] = $order['additionalPhone'];
unset($order['additionalPhone']);
}
$phonesArray = array('customer' => $customer, 'order' => $order);
return $phonesArray;
}
/**
* Validate crm address
*
* @param $address
*
* @return bool
*/
public static function validateCrmAddress($address)
{
if (preg_match("/https:\/\/(.*).retailcrm.(pro|ru|es)/", $address) === 1) {
return true;
}
return false;
}
public static function getDate($file)
{
if (file_exists($file)) {
$result = file_get_contents($file);
} else {
$result = date('Y-m-d H:i:s', strtotime('-1 days', strtotime(date('Y-m-d H:i:s'))));
}
return $result;
}
public static function explodeFIO($string)
{
$result = array();
$parse = (!$string) ? false : explode(" ", $string, 3);
switch (count($parse)) {
case 1:
$result['firstName'] = $parse[0];
break;
case 2:
$result['firstName'] = $parse[1];
$result['lastName'] = $parse[0];
break;
case 3:
$result['firstName'] = $parse[1];
$result['lastName'] = $parse[0];
$result['patronymic'] = $parse[2];
break;
default:
return false;
}
return $result;
}
/**
* Returns externalId for order
*
* @param Cart $cart
*
* @return string
*/
public static function getCartOrderExternalId(Cart $cart)
{
return sprintf('pscart_%d', $cart->id);
}
/**
* Unset empty fields
*
* @param array $arr input array
* @param callable|null $filterFunc
*
* @return array
* @todo Don't filter out false & all methods MUST NOT use false as blank value.
*/
public static function clearArray(array $arr, $filterFunc = null)
{
if (!is_array($arr)) {
return $arr;
}
$result = array();
foreach ($arr as $index => $node) {
$result[$index] = (is_array($node))
? self::clearArray($node)
: $node;
if ($result[$index] == ''
|| $result[$index] === null
|| (is_array($result[$index]) && count($result[$index]) < 1)
) {
unset($result[$index]);
}
}
if (is_callable($filterFunc)) {
return array_filter($result, $filterFunc);
}
return array_filter($result);
}
/**
* Returns true if PrestaShop in debug mode or _RCRM_MODE_DEV_ const defined to true.
* Add define('_RCRM_MODE_DEV_', true); to enable extended logging (dev mode) ONLY for retailCRM module.
* In developer mode module will log every JobManager run and every request and response from retailCRM API.
*
* @return bool
*/
public static function isDebug()
{
return (defined('_PS_MODE_DEV_') && _PS_MODE_DEV_ == true)
|| (defined('_RCRM_MODE_DEV_') && _RCRM_MODE_DEV_ == true);
}
/**
* Generates placeholder email
*
* @param string $name
*
* @return string
*/
public static function createPlaceholderEmail($name)
{
return substr(md5($name), 0, 15) . '@example.com';
}
/**
* Returns API client proxy if connection is configured.
* Returns null if connection is not configured.
*
* @return \RetailcrmProxy|\RetailcrmApiClientV5|null
*/
public static function getApiClient()
{
$apiUrl = Configuration::get(RetailCRM::API_URL);
$apiKey = Configuration::get(RetailCRM::API_KEY);
if (!empty($apiUrl) && !empty($apiKey)) {
return new RetailcrmProxy($apiUrl, $apiKey, RetailcrmLogger::getLogFile());
}
return null;
}
public static function isWebJobsEnabled()
{
return '0' !== Configuration::getGlobalValue(RetailCRM::ENABLE_WEB_JOBS);
}
/**
* Merge new address to customer, preserves old phone numbers.
*
* @param array $customer
* @param array $address
*
* @return array
*/
public static function mergeCustomerAddress($customer, $address)
{
$customerPhones = isset($customer['phones']) ? $customer['phones'] : array();
$addressPhones = isset($address['phones']) ? $address['phones'] : array();
$squashedCustomerPhones = array_filter(array_map(function ($val) {
return isset($val['number']) ? $val['number'] : null;
}, $customerPhones));
foreach ($addressPhones as $newPhone) {
if (empty($newPhone['number'])) {
continue;
}
if (!in_array($newPhone['number'], $squashedCustomerPhones)) {
$customerPhones[] = $newPhone;
}
}
return array_merge($customer, $address, array('phones' => $customerPhones));
}
/**
* http_response_code polyfill
*
* @param null $code
*
* @return int|null
*/
public static function http_response_code($code = null)
{
if (function_exists('http_response_code')) {
$code = http_response_code($code);
} else {
if ($code !== NULL) {
switch ($code) {
case 100: $text = 'Continue'; break;
case 101: $text = 'Switching Protocols'; break;
case 200: $text = 'OK'; break;
case 201: $text = 'Created'; break;
case 202: $text = 'Accepted'; break;
case 203: $text = 'Non-Authoritative Information'; break;
case 204: $text = 'No Content'; break;
case 205: $text = 'Reset Content'; break;
case 206: $text = 'Partial Content'; break;
case 300: $text = 'Multiple Choices'; break;
case 301: $text = 'Moved Permanently'; break;
case 302: $text = 'Moved Temporarily'; break;
case 303: $text = 'See Other'; break;
case 304: $text = 'Not Modified'; break;
case 305: $text = 'Use Proxy'; break;
case 400: $text = 'Bad Request'; break;
case 401: $text = 'Unauthorized'; break;
case 402: $text = 'Payment Required'; break;
case 403: $text = 'Forbidden'; break;
case 404: $text = 'Not Found'; break;
case 405: $text = 'Method Not Allowed'; break;
case 406: $text = 'Not Acceptable'; break;
case 407: $text = 'Proxy Authentication Required'; break;
case 408: $text = 'Request Time-out'; break;
case 409: $text = 'Conflict'; break;
case 410: $text = 'Gone'; break;
case 411: $text = 'Length Required'; break;
case 412: $text = 'Precondition Failed'; break;
case 413: $text = 'Request Entity Too Large'; break;
case 414: $text = 'Request-URI Too Large'; break;
case 415: $text = 'Unsupported Media Type'; break;
case 500: $text = 'Internal Server Error'; break;
case 501: $text = 'Not Implemented'; break;
case 502: $text = 'Bad Gateway'; break;
case 503: $text = 'Service Unavailable'; break;
case 504: $text = 'Gateway Time-out'; break;
case 505: $text = 'HTTP Version not supported'; break;
default:
exit('Unknown http status code "' . htmlentities($code) . '"');
break;
}
$protocol = (isset($_SERVER['SERVER_PROTOCOL']) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0');
header($protocol . ' ' . $code . ' ' . $text);
} else {
$code = !empty(static::$currentStatusCode) ? static::$currentStatusCode : 200;
}
}
return $code;
}
/**
* Starts JobManager with list of pre-registered jobs
*
* @throws \Exception
*/
public static function startJobManager()
{
RetailcrmJobManager::startJobs(array(
'RetailcrmAbandonedCartsEvent' => null,
'RetailcrmIcmlEvent' => new \DateInterval('PT4H'),
'RetailcrmSyncEvent' => new \DateInterval('PT7M'),
'RetailcrmInventoriesEvent' => new \DateInterval('PT15M')
));
}
}