* @copyright 2007-2016 PrestaShop SA * @license http://opensource.org/licenses/osl-3.0.php Open Software License (OSL 3.0) * International Registered Trademark & Property of PrestaShop SA */ class FeatureCore extends ObjectModel { /** @var string Name */ public $name; public $position; /** * @see ObjectModel::$definition */ public static $definition = array( 'table' => 'feature', 'primary' => 'id_feature', 'multilang' => true, 'fields' => array( 'position' => array('type' => self::TYPE_INT, 'validate' => 'isInt'), /* Lang fields */ 'name' => array('type' => self::TYPE_STRING, 'lang' => true, 'validate' => 'isGenericName', 'required' => true, 'size' => 128), ), ); protected $webserviceParameters = array( 'objectsNodeName' => 'product_features', 'objectNodeName' => 'product_feature', 'fields' => array(), ); /** * Get a feature data for a given id_feature and id_lang * * @param int $id_lang Language id * @param int $id_feature Feature id * @return array Array with feature's data */ public static function getFeature($id_lang, $id_feature) { return Db::getInstance()->getRow(' SELECT * FROM `'._DB_PREFIX_.'feature` f LEFT JOIN `'._DB_PREFIX_.'feature_lang` fl ON ( f.`id_feature` = fl.`id_feature` AND fl.`id_lang` = '.(int)$id_lang.') WHERE f.`id_feature` = '.(int)$id_feature ); } /** * Get all features for a given language * * @param int $id_lang Language id * @return array Multiple arrays with feature's data */ public static function getFeatures($id_lang, $with_shop = true) { return Db::getInstance()->executeS(' SELECT DISTINCT f.id_feature, f.*, fl.* FROM `'._DB_PREFIX_.'feature` f '.($with_shop ? Shop::addSqlAssociation('feature', 'f') : '').' LEFT JOIN `'._DB_PREFIX_.'feature_lang` fl ON (f.`id_feature` = fl.`id_feature` AND fl.`id_lang` = '.(int)$id_lang.') ORDER BY f.`position` ASC'); } /** * Delete several objects from database * * @param array $selection Array with items to delete * @return bool Deletion result */ public function deleteSelection($selection) { /* Also delete Attributes */ foreach ($selection as $value) { $obj = new Feature($value); if (!$obj->delete()) { return false; } } return true; } public function add($autodate = true, $nullValues = false) { if ($this->position <= 0) { $this->position = Feature::getHigherPosition() + 1; } $return = parent::add($autodate, true); Hook::exec('actionFeatureSave', array('id_feature' => $this->id)); return $return; } public function delete() { /* Also delete related attributes */ Db::getInstance()->execute(' DELETE `'._DB_PREFIX_.'feature_value_lang` FROM `'._DB_PREFIX_.'feature_value_lang` JOIN `'._DB_PREFIX_.'feature_value` ON (`'._DB_PREFIX_.'feature_value_lang`.id_feature_value = `'._DB_PREFIX_.'feature_value`.id_feature_value) WHERE `'._DB_PREFIX_.'feature_value`.`id_feature` = '.(int)$this->id.' '); Db::getInstance()->execute(' DELETE FROM `'._DB_PREFIX_.'feature_value` WHERE `id_feature` = '.(int)$this->id ); /* Also delete related products */ Db::getInstance()->execute(' DELETE FROM `'._DB_PREFIX_.'feature_product` WHERE `id_feature` = '.(int)$this->id ); $return = parent::delete(); if ($return) { Hook::exec('actionFeatureDelete', array('id_feature' => $this->id)); } /* Reinitializing position */ $this->cleanPositions(); return $return; } public function update($nullValues = false) { $this->clearCache(); $result = 1; $fields = $this->getFieldsLang(); foreach ($fields as $field) { foreach (array_keys($field) as $key) { if (!Validate::isTableOrIdentifier($key)) { die(Tools::displayError()); } } $sql = 'SELECT `id_lang` FROM `'.pSQL(_DB_PREFIX_.$this->def['table']).'_lang` WHERE `'.$this->def['primary'].'` = '.(int)$this->id.' AND `id_lang` = '.(int)$field['id_lang']; $mode = Db::getInstance()->getRow($sql); $result &= (!$mode) ? Db::getInstance()->insert($this->def['table'].'_lang', $field) : Db::getInstance()->update( $this->def['table'].'_lang', $field, '`'.$this->def['primary'].'` = '.(int)$this->id.' AND `id_lang` = '.(int)$field['id_lang'] ); } if ($result) { $result &= parent::update($nullValues); if ($result) { Hook::exec('actionFeatureSave', array('id_feature' => $this->id)); } } return $result; } /** * Count number of features for a given language * * @param int $id_lang Language id * @return int Number of feature */ public static function nbFeatures($id_lang) { return Db::getInstance()->getValue(' SELECT COUNT(*) as nb FROM `'._DB_PREFIX_.'feature` ag LEFT JOIN `'._DB_PREFIX_.'feature_lang` agl ON (ag.`id_feature` = agl.`id_feature` AND `id_lang` = '.(int)$id_lang.') '); } /** * Create a feature from import * * @param int $id_feature Feature id * @param int $id_product Product id * @param array $value Feature Value */ public static function addFeatureImport($name, $position = false) { $rq = Db::getInstance()->getRow(' SELECT `id_feature` FROM '._DB_PREFIX_.'feature_lang WHERE `name` = \''.pSQL($name).'\' GROUP BY `id_feature` '); if (empty($rq)) { // Feature doesn't exist, create it $feature = new Feature(); $feature->name = array_fill_keys(Language::getIDs(), (string)$name); if ($position) { $feature->position = (int)$position; } else { $feature->position = Feature::getHigherPosition() + 1; } $feature->add(); return $feature->id; } elseif (isset($rq['id_feature']) && $rq['id_feature']) { if (is_numeric($position) && $feature = new Feature((int)$rq['id_feature'])) { $feature->position = (int)$position; if (Validate::isLoadedObject($feature)) { $feature->update(); } } return (int)$rq['id_feature']; } } public static function getFeaturesForComparison($list_ids_product, $id_lang) { if (!Feature::isFeatureActive()) { return false; } $ids = ''; foreach ($list_ids_product as $id) { $ids .= (int)$id.','; } $ids = rtrim($ids, ','); if (empty($ids)) { return false; } return Db::getInstance()->executeS(' SELECT f.*, fl.* FROM `'._DB_PREFIX_.'feature` f LEFT JOIN `'._DB_PREFIX_.'feature_product` fp ON f.`id_feature` = fp.`id_feature` LEFT JOIN `'._DB_PREFIX_.'feature_lang` fl ON f.`id_feature` = fl.`id_feature` WHERE fp.`id_product` IN ('.$ids.') AND `id_lang` = '.(int)$id_lang.' GROUP BY f.`id_feature` ORDER BY f.`position` ASC '); } /** * This metohd is allow to know if a feature is used or active * @since 1.5.0.1 * @return bool */ public static function isFeatureActive() { return Configuration::get('PS_FEATURE_FEATURE_ACTIVE'); } /** * Move a feature * @param bool $way Up (1) or Down (0) * @param int $position * @return bool Update result */ public function updatePosition($way, $position, $id_feature = null) { if (!$res = Db::getInstance()->executeS(' SELECT `position`, `id_feature` FROM `'._DB_PREFIX_.'feature` WHERE `id_feature` = '.(int)($id_feature ? $id_feature : $this->id).' ORDER BY `position` ASC' )) { return false; } foreach ($res as $feature) { if ((int)$feature['id_feature'] == (int)$this->id) { $moved_feature = $feature; } } if (!isset($moved_feature) || !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_.'feature` SET `position`= `position` '.($way ? '- 1' : '+ 1').' WHERE `position` '.($way ? '> '.(int)$moved_feature['position'].' AND `position` <= '.(int)$position : '< '.(int)$moved_feature['position'].' AND `position` >= '.(int)$position)) && Db::getInstance()->execute(' UPDATE `'._DB_PREFIX_.'feature` SET `position` = '.(int)$position.' WHERE `id_feature`='.(int)$moved_feature['id_feature'])); } /** * Reorder feature position * Call it after deleting a feature. * * @return bool $return */ public static function cleanPositions() { Db::getInstance()->execute('SET @i = -1', false); $sql = 'UPDATE `'._DB_PREFIX_.'feature` SET `position` = @i:=@i+1 ORDER BY `position` ASC'; return (bool)Db::getInstance()->execute($sql); } /** * getHigherPosition * * Get the higher feature position * * @return int $position */ public static function getHigherPosition() { $sql = 'SELECT MAX(`position`) FROM `'._DB_PREFIX_.'feature`'; $position = DB::getInstance()->getValue($sql); return (is_numeric($position)) ? $position : - 1; } }