'feature_value', 'primary' => 'id_feature_value', 'multilang' => true, 'fields' => [ 'id_feature' => ['type' => self::TYPE_INT, 'validate' => 'isUnsignedId', 'required' => true], 'custom' => ['type' => self::TYPE_BOOL, 'validate' => 'isBool'], 'position' => ['type' => self::TYPE_INT, 'validate' => 'isInt'], /* Lang fields */ 'value' => ['type' => self::TYPE_STRING, 'lang' => true, 'validate' => 'isGenericName', 'required' => true, 'size' => FeatureValueSettings::VALUE_MAX_LENGTH], ], ]; protected $webserviceParameters = [ 'objectsNodeName' => 'product_feature_values', 'objectNodeName' => 'product_feature_value', 'fields' => [ 'id_feature' => ['xlink_resource' => 'product_features'], ], ]; /** * Get all values for a given feature. * * @param int $idFeature Feature id * * @return array Array with feature's values */ public static function getFeatureValues($idFeature) { return Db::getInstance(_PS_USE_SQL_SLAVE_)->executeS( ' SELECT * FROM `' . _DB_PREFIX_ . 'feature_value` WHERE `id_feature` = ' . (int) $idFeature ); } /** * Get all values for a given feature and language. * * @param int $idLang Language id * @param int $idFeature Feature id * * @return array Array with feature's values */ public static function getFeatureValuesWithLang($idLang, $idFeature, $custom = false) { return Db::getInstance()->executeS(' SELECT * FROM `' . _DB_PREFIX_ . 'feature_value` v LEFT JOIN `' . _DB_PREFIX_ . 'feature_value_lang` vl ON (v.`id_feature_value` = vl.`id_feature_value` AND vl.`id_lang` = ' . (int) $idLang . ') WHERE v.`id_feature` = ' . (int) $idFeature . ' ' . (!$custom ? 'AND (v.`custom` IS NULL OR v.`custom` = 0)' : '') . ' ORDER BY vl.`value` ASC '); } /** * Get all language for a given value. * * @param int $idFeatureValue Feature value id * * @return array Array with value's languages */ public static function getFeatureValueLang($idFeatureValue) { return Db::getInstance()->executeS(' SELECT * FROM `' . _DB_PREFIX_ . 'feature_value_lang` WHERE `id_feature_value` = ' . (int) $idFeatureValue . ' ORDER BY `id_lang` '); } /** * Select the good lang in tab. * * @param array $lang Array with all language * @param int $idLang Language id * * @return string String value name selected */ public static function selectLang($lang, $idLang) { foreach ($lang as $tab) { if ($tab['id_lang'] == $idLang) { return $tab['value']; } } return ''; } /** * Add FeatureValue from import. * * @param int $idFeature * @param string $value * @param int|null $idProduct * @param int|null $idLang * @param bool $custom * * @return int */ public static function addFeatureValueImport($idFeature, $value, $idProduct = null, $idLang = null, $custom = false) { $idFeatureValue = false; if (null !== $idProduct && $idProduct) { $idFeatureValue = Db::getInstance()->getValue(' SELECT fp.`id_feature_value` FROM ' . _DB_PREFIX_ . 'feature_product fp INNER JOIN ' . _DB_PREFIX_ . 'feature_value fv USING (`id_feature_value`) WHERE fp.`id_feature` = ' . (int) $idFeature . ' AND fv.`custom` = ' . (int) $custom . ' AND fp.`id_product` = ' . (int) $idProduct); if ($custom && $idFeatureValue && null !== $idLang && $idLang) { Db::getInstance()->execute(' UPDATE ' . _DB_PREFIX_ . 'feature_value_lang SET `value` = \'' . pSQL($value) . '\' WHERE `id_feature_value` = ' . (int) $idFeatureValue . ' AND `value` != \'' . pSQL($value) . '\' AND `id_lang` = ' . (int) $idLang); } } if (!$custom) { $idFeatureValue = Db::getInstance()->getValue(' SELECT fv.`id_feature_value` FROM ' . _DB_PREFIX_ . 'feature_value fv LEFT JOIN ' . _DB_PREFIX_ . 'feature_value_lang fvl ON (fvl.`id_feature_value` = fv.`id_feature_value` AND fvl.`id_lang` = ' . (int) $idLang . ') WHERE `value` = \'' . pSQL($value) . '\' AND fv.`id_feature` = ' . (int) $idFeature . ' AND fv.`custom` = 0 GROUP BY fv.`id_feature_value`'); } if ($idFeatureValue) { return (int) $idFeatureValue; } // Feature doesn't exist, create it $feature_value = new FeatureValue(); $feature_value->id_feature = (int) $idFeature; $feature_value->custom = (bool) $custom; $feature_value->value = array_fill_keys(Language::getIDs(false), $value); $feature_value->add(); return (int) $feature_value->id; } /** * Adds current FeatureValue as a new Object to the database. * * @param bool $autoDate Automatically set `date_upd` and `date_add` columns * @param bool $nullValues Whether we want to use NULL values instead of empty quotes values * * @return bool Indicates whether the FeatureValue has been successfully added * * @throws PrestaShopDatabaseException * @throws PrestaShopException */ public function add($autoDate = true, $nullValues = false) { if ($this->position <= 0) { $this->position = static::getHighestPosition($this->id_feature) + 1; } $return = parent::add($autoDate, $nullValues); if ($return) { Hook::exec('actionFeatureValueSave', ['id_feature_value' => $this->id]); } return $return; } /** * Updates the current FeatureValue in the database. * * @param bool $nullValues Whether we want to use NULL values instead of empty quotes values * * @return bool Indicates whether the FeatureValue has been successfully updated * * @throws PrestaShopDatabaseException * @throws PrestaShopException */ public function update($nullValues = false) { $return = parent::update($nullValues); if ($return) { Hook::exec('actionFeatureValueSave', ['id_feature_value' => $this->id]); } return $return; } /** * Deletes current FeatureValue from the database. * * @return bool `true` if delete was successful * * @throws PrestaShopException */ public function delete() { /* Also delete related products */ Db::getInstance()->execute( ' DELETE FROM `' . _DB_PREFIX_ . 'feature_product` WHERE `id_feature_value` = ' . (int) $this->id ); /* Reinitializing position */ $this->cleanPositions((int) $this->id_feature); $return = parent::delete(); if ($return) { Hook::exec('actionFeatureValueDelete', ['id_feature_value' => $this->id]); } return $return; } /** * Get the highest feature value position of given feature. * * @param int $idFeature * * @return int */ public static function getHighestPosition($idFeature) { $sql = 'SELECT MAX(`position`) FROM `' . _DB_PREFIX_ . 'feature_value` WHERE `id_feature` = ' . (int) $idFeature; $position = Db::getInstance()->getValue($sql); return is_numeric($position) ? $position : -1; } /** * Reorder feature values within single feature. * Use it after deleting a feature value. * * @param int $idFeature * @param bool $includeCurrentFeatureValue * * @return bool Whether the result was successfully updated */ public function cleanPositions($idFeature, $includeCurrentFeatureValue = false) { Db::getInstance()->execute('SET @i = -1', false); $sql = 'UPDATE `' . _DB_PREFIX_ . 'feature_value` SET `position` = @i:=@i+1 WHERE'; if (!$includeCurrentFeatureValue) { $sql .= ' `id_feature_value` != ' . (int) $this->id . ' AND'; } $sql .= ' `id_feature` = ' . (int) $idFeature . ' ORDER BY `position` ASC'; return Db::getInstance()->execute($sql); } }