* @copyright Since 2007 PrestaShop SA and Contributors * @license https://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0) */ /** * Class AttributeGroupCore. */ class AttributeGroupCore extends ObjectModel { /** @var string|string[] Name */ public $name; /** @var bool Whether the attribute group is a color group */ public $is_color_group; /** @var int Position */ public $position; /** @var string Group type */ public $group_type; /** @var string|string[] Public Name */ public $public_name; /** * @see ObjectModel::$definition */ public static $definition = [ 'table' => 'attribute_group', 'primary' => 'id_attribute_group', 'multilang' => true, 'fields' => [ 'is_color_group' => ['type' => self::TYPE_BOOL, 'validate' => 'isBool'], 'group_type' => ['type' => self::TYPE_STRING, 'required' => true], 'position' => ['type' => self::TYPE_INT, 'validate' => 'isInt'], /* Lang fields */ 'name' => ['type' => self::TYPE_STRING, 'lang' => true, 'validate' => 'isGenericName', 'required' => true, 'size' => 128], 'public_name' => ['type' => self::TYPE_STRING, 'lang' => true, 'validate' => 'isGenericName', 'required' => true, 'size' => 64], ], ]; /** @var array Web service parameters */ protected $webserviceParameters = [ 'objectsNodeName' => 'product_options', 'objectNodeName' => 'product_option', 'fields' => [], 'associations' => [ 'product_option_values' => [ 'resource' => 'product_option_value', 'fields' => [ 'id' => [], ], ], ], ]; /** * Adds current AttributeGroup as a new Object to the database. * * @param bool $autoDate Automatically set `date_upd` and `date_add` column * @param bool $nullValues Whether we want to use NULL values instead of empty quotes values * * @return bool Whether the AttributeGroup has been successfully added * * @throws PrestaShopDatabaseException * @throws PrestaShopException */ public function add($autoDate = true, $nullValues = false) { $this->is_color_group = $this->group_type == 'color'; if ($this->position <= 0) { $this->position = AttributeGroup::getHigherPosition() + 1; } $return = parent::add($autoDate, true); Hook::exec('actionAttributeGroupSave', ['id_attribute_group' => $this->id]); return $return; } /** * Updates the current object in the database. * * @param bool $nullValues Whether we want to use NULL values instead of empty quotes values * * @return bool Whether the AttributeGroup has been succesfully updated * * @throws PrestaShopDatabaseException * @throws PrestaShopException */ public function update($nullValues = false) { $this->is_color_group = $this->group_type == 'color'; $return = parent::update($nullValues); Hook::exec('actionAttributeGroupSave', ['id_attribute_group' => $this->id]); return $return; } /** * Clean dead combinations * A combination is considered dead when its Attribute ID cannot be found. * * @return bool Whether the dead combinations have been successfully deleted */ public static function cleanDeadCombinations() { $attributeCombinations = Db::getInstance()->executeS(' SELECT pac.`id_attribute`, pa.`id_product_attribute` FROM `' . _DB_PREFIX_ . 'product_attribute` pa LEFT JOIN `' . _DB_PREFIX_ . 'product_attribute_combination` pac ON (pa.`id_product_attribute` = pac.`id_product_attribute`) '); $toRemove = []; foreach ($attributeCombinations as $attributeCombination) { if ((int) $attributeCombination['id_attribute'] == 0) { $toRemove[] = (int) $attributeCombination['id_product_attribute']; } } $return = true; if (!empty($toRemove)) { foreach ($toRemove as $remove) { $combination = new Combination($remove); $return &= $combination->delete(); } } return $return; } /** * Deletes current AttributeGroup from database. * * @return bool True if delete was successful * * @throws PrestaShopException */ public function delete() { if (!$this->hasMultishopEntries() || Shop::getContext() == Shop::CONTEXT_ALL) { /* Select children in order to find linked combinations */ $attributeIds = Db::getInstance()->executeS( ' SELECT `id_attribute` FROM `' . _DB_PREFIX_ . 'attribute` WHERE `id_attribute_group` = ' . (int) $this->id ); if ($attributeIds === false) { return false; } /* Removing attributes to the found combinations */ $toRemove = []; foreach ($attributeIds as $attribute) { $toRemove[] = (int) $attribute['id_attribute']; } if (!empty($toRemove) && Db::getInstance()->execute(' DELETE FROM `' . _DB_PREFIX_ . 'product_attribute_combination` WHERE `id_attribute` IN (' . implode(', ', $toRemove) . ')') === false) { return false; } /* Remove combinations if they do not possess attributes anymore */ if (!AttributeGroup::cleanDeadCombinations()) { return false; } /* Also delete related attributes */ if (count($toRemove)) { if (!Db::getInstance()->execute(' DELETE FROM `' . _DB_PREFIX_ . 'attribute_lang` WHERE `id_attribute` IN (' . implode(',', $toRemove) . ')') || !Db::getInstance()->execute(' DELETE FROM `' . _DB_PREFIX_ . 'attribute_shop` WHERE `id_attribute` IN (' . implode(',', $toRemove) . ')') || !Db::getInstance()->execute('DELETE FROM `' . _DB_PREFIX_ . 'attribute` WHERE `id_attribute_group` = ' . (int) $this->id)) { return false; } } $this->cleanPositions(); } $return = parent::delete(); if ($return) { Hook::exec('actionAttributeGroupDelete', ['id_attribute_group' => $this->id]); } return $return; } /** * Get all attributes for a given language / group. * * @param int $idLang Language ID * @param int $idAttributeGroup AttributeGroup ID * * @return array Attributes */ public static function getAttributes($idLang, $idAttributeGroup) { if (!Combination::isFeatureActive()) { return []; } return Db::getInstance()->executeS(' SELECT * FROM `' . _DB_PREFIX_ . 'attribute` a ' . Shop::addSqlAssociation('attribute', 'a') . ' LEFT JOIN `' . _DB_PREFIX_ . 'attribute_lang` al ON (a.`id_attribute` = al.`id_attribute` AND al.`id_lang` = ' . (int) $idLang . ') WHERE a.`id_attribute_group` = ' . (int) $idAttributeGroup . ' ORDER BY `position` ASC '); } /** * Get all attributes groups for a given language. * * @param int $idLang Language id * * @return array Attributes groups */ public static function getAttributesGroups($idLang) { if (!Combination::isFeatureActive()) { return []; } return Db::getInstance()->executeS(' SELECT DISTINCT agl.`name`, ag.*, agl.* FROM `' . _DB_PREFIX_ . 'attribute_group` ag ' . Shop::addSqlAssociation('attribute_group', 'ag') . ' LEFT JOIN `' . _DB_PREFIX_ . 'attribute_group_lang` agl ON (ag.`id_attribute_group` = agl.`id_attribute_group` AND `id_lang` = ' . (int) $idLang . ') ORDER BY `name` ASC '); } /** * Delete several objects from database. * * @param array $selection Array with AttributeGroup IDs * * @return bool Deletion result */ public function deleteSelection($selection) { /* Also delete Attributes */ foreach ($selection as $value) { $obj = new AttributeGroup($value); if (!$obj->delete()) { return false; } } return true; } /** * Set the values of the current AttributeGroup for the webservice. * * @param array $values * * @return bool Whether the update was successful */ public function setWsProductOptionValues($values) { $ids = []; foreach ($values as $value) { $ids[] = (int) ($value['id']); } if (!empty($ids)) { Db::getInstance()->execute( ' DELETE FROM `' . _DB_PREFIX_ . 'attribute` WHERE `id_attribute_group` = ' . (int) $this->id . ' AND `id_attribute` NOT IN (' . implode(',', $ids) . ')' ); } $ok = true; foreach ($values as $value) { $result = Db::getInstance()->execute( ' UPDATE `' . _DB_PREFIX_ . 'attribute` SET `id_attribute_group` = ' . (int) $this->id . ' WHERE `id_attribute` = ' . (int) $value['id'] ); if ($result === false) { $ok = false; } } return $ok; } /** * Get values of current AttributeGroup instance for the webservice. * * @return array|false|mysqli_result|PDOStatement|resource|null */ public function getWsProductOptionValues() { $result = Db::getInstance()->executeS( ' SELECT a.id_attribute AS id FROM `' . _DB_PREFIX_ . 'attribute` a ' . Shop::addSqlAssociation('attribute', 'a') . ' WHERE a.id_attribute_group = ' . (int) $this->id ); return $result; } /** * Move a group attribute. * * @param bool $direction Up (1) or Down (0) * @param int|null $position * * @return bool Update result */ public function updatePosition($direction, $position) { if (!$res = Db::getInstance()->executeS( ' SELECT ag.`position`, ag.`id_attribute_group` FROM `' . _DB_PREFIX_ . 'attribute_group` ag WHERE ag.`id_attribute_group` = ' . (int) Tools::getValue('id_attribute_group', 1) . ' ORDER BY ag.`position` ASC' )) { return false; } foreach ($res as $groupAttribute) { if ((int) $groupAttribute['id_attribute_group'] == (int) $this->id) { $movedGroupAttribute = $groupAttribute; } } if (!isset($movedGroupAttribute) || !isset($position)) { return false; } // < and > statements rather than BETWEEN operator // since BETWEEN is treated differently according to databases return Db::getInstance()->execute( ' UPDATE `' . _DB_PREFIX_ . 'attribute_group` SET `position`= `position` ' . ($direction ? '- 1' : '+ 1') . ' WHERE `position` ' . ($direction ? '> ' . (int) $movedGroupAttribute['position'] . ' AND `position` <= ' . (int) $position : '< ' . (int) $movedGroupAttribute['position'] . ' AND `position` >= ' . (int) $position) ) && Db::getInstance()->execute(' UPDATE `' . _DB_PREFIX_ . 'attribute_group` SET `position` = ' . (int) $position . ' WHERE `id_attribute_group`=' . (int) $movedGroupAttribute['id_attribute_group']); } /** * Reorder group attribute position * Call it after deleting a group attribute. * * @return bool $return */ public static function cleanPositions() { $return = true; Db::getInstance()->execute('SET @i = -1', false); $return = Db::getInstance()->execute( ' UPDATE `' . _DB_PREFIX_ . 'attribute_group` SET `position` = @i:=@i+1 ORDER BY `position`' ); return $return; } /** * Get the highest AttributeGroup position. * * @return int $position Position */ public static function getHigherPosition() { $sql = 'SELECT MAX(`position`) FROM `' . _DB_PREFIX_ . 'attribute_group`'; $position = Db::getInstance()->getValue($sql); return (is_numeric($position)) ? $position : -1; } }