* @copyright 2007-2019 PrestaShop SA and Contributors * @license https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0) * International Registered Trademark & Property of PrestaShop SA */ /** * Class StateCore. */ class StateCore extends ObjectModel { /** @var int Country id which state belongs */ public $id_country; /** @var int Zone id which state belongs */ public $id_zone; /** @var string 2 letters iso code */ public $iso_code; /** @var string Name */ public $name; /** @var bool Status for delivery */ public $active = true; /** * @see ObjectModel::$definition */ public static $definition = array( 'table' => 'state', 'primary' => 'id_state', 'fields' => array( 'id_country' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId', 'required' => true), 'id_zone' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId', 'required' => true), 'iso_code' => array('type' => self::TYPE_STRING, 'validate' => 'isStateIsoCode', 'required' => true, 'size' => 7), 'name' => array('type' => self::TYPE_STRING, 'validate' => 'isGenericName', 'required' => true, 'size' => 32), 'active' => array('type' => self::TYPE_BOOL, 'validate' => 'isBool'), ), ); protected $webserviceParameters = array( 'fields' => array( 'id_zone' => array('xlink_resource' => 'zones'), 'id_country' => array('xlink_resource' => 'countries'), ), ); public static function getStates($idLang = false, $active = false) { return Db::getInstance(_PS_USE_SQL_SLAVE_)->executeS(' SELECT `id_state`, `id_country`, `id_zone`, `iso_code`, `name`, `active` FROM `' . _DB_PREFIX_ . 'state` ' . ($active ? 'WHERE active = 1' : '') . ' ORDER BY `name` ASC'); } /** * Get a state name with its ID. * * @param int $idState Country ID * * @return string State name */ public static function getNameById($idState) { if (!$idState) { return false; } $cacheId = 'State::getNameById_' . (int) $idState; if (!Cache::isStored($cacheId)) { $result = Db::getInstance(_PS_USE_SQL_SLAVE_)->getValue( ' SELECT `name` FROM `' . _DB_PREFIX_ . 'state` WHERE `id_state` = ' . (int) $idState ); Cache::store($cacheId, $result); return $result; } return Cache::retrieve($cacheId); } /** * Get State ID with its name. * * @param string $state State ID * * @return int state id */ public static function getIdByName($state) { if (empty($state)) { return false; } $cacheId = 'State::getIdByName_' . pSQL($state); if (!Cache::isStored($cacheId)) { $result = (int) Db::getInstance()->getValue(' SELECT `id_state` FROM `' . _DB_PREFIX_ . 'state` WHERE `name` = \'' . pSQL($state) . '\' '); Cache::store($cacheId, $result); return $result; } return Cache::retrieve($cacheId); } /** * Get a state id with its iso code. * * @param string $isoCode Iso code * * @return int state id */ public static function getIdByIso($isoCode, $idCountry = null) { return Db::getInstance()->getValue(' SELECT `id_state` FROM `' . _DB_PREFIX_ . 'state` WHERE `iso_code` = \'' . pSQL($isoCode) . '\' ' . ($idCountry ? 'AND `id_country` = ' . (int) $idCountry : '')); } /** * Delete a state only if is not in use. * * @return bool */ public function delete() { if (!$this->isUsed()) { // Database deletion $result = Db::getInstance()->delete($this->def['table'], '`' . $this->def['primary'] . '` = ' . (int) $this->id); if (!$result) { return false; } // Database deletion for multilingual fields related to the object if (!empty($this->def['multilang'])) { Db::getInstance()->delete(bqSQL($this->def['table']) . '_lang', '`' . $this->def['primary'] . '` = ' . (int) $this->id); } return $result; } else { return false; } } /** * Check if a state is used. * * @return bool */ public function isUsed() { return $this->countUsed() > 0; } /** * Returns the number of utilisation of a state. * * @return int count for this state */ public function countUsed() { $result = Db::getInstance(_PS_USE_SQL_SLAVE_)->getValue( ' SELECT COUNT(*) FROM `' . _DB_PREFIX_ . 'address` WHERE `' . $this->def['primary'] . '` = ' . (int) $this->id ); return $result; } /** * Get states by Country ID. * * @param int $idCountry Country ID * @param bool $active true if the state must be active * * @return array|false|mysqli_result|PDOStatement|resource|null */ public static function getStatesByIdCountry($idCountry, $active = false) { if (empty($idCountry)) { die(Tools::displayError()); } return Db::getInstance()->executeS( ' SELECT * FROM `' . _DB_PREFIX_ . 'state` s WHERE s.`id_country` = ' . (int) $idCountry . ($active ? ' AND s.active = 1' : '') ); } /** * Has Counties. * * @param int $idState * * @return int */ public static function hasCounties($idState) { return count(County::getCounties((int) $idState)); } /** * Get Zone ID. * * @param int $idState State ID * * @return false|string|null */ public static function getIdZone($idState) { if (!Validate::isUnsignedId($idState)) { die(Tools::displayError()); } return Db::getInstance(_PS_USE_SQL_SLAVE_)->getValue( ' SELECT `id_zone` FROM `' . _DB_PREFIX_ . 'state` WHERE `id_state` = ' . (int) $idState ); } /** * @param array $idsStates State IDs * @param int $idZone Zone ID * * @return bool */ public function affectZoneToSelection($idsStates, $idZone) { // cast every array values to int (security) $idsStates = array_map('intval', $idsStates); return Db::getInstance()->execute(' UPDATE `' . _DB_PREFIX_ . 'state` SET `id_zone` = ' . (int) $idZone . ' WHERE `id_state` IN (' . implode(',', $idsStates) . ') '); } }