+ * Добавление места разположения
+ *
+ * @param array $options
+ * string 'name' - наименование места расположения
+ * string|NULL 'region' - наименование региона/подразделения
+ * integer|NULL 'region_id' - идентификатор региона/подразделения
+ * @return integer|boolean - идентификатор записи места расположения или FALSE
+ */
+ public static function addIfNeed($options)
+ {
+ $result = [
+ 'id' => FALSE,
+ 'error' => Yii::t('locations', 'Locations: Key field missing "location" and "region": ') . print_r($options, TRUE),
+ ];
+ if (is_array($options) && isset($options[ 'location' ]) && (isset($options[ 'region' ]) || isset($options[ 'region_id' ])))
+ {
+ if (isset($options[ 'region' ]))
+ {
+ $region = RegionsController::addIfNeed($options);
+ }
+ else
+ {
+ $region[ 'id' ] = $options[ 'region_id' ];
+ }
+ if ($region[ 'id' ] !== FALSE) {
+ // Ищем расположение, совпадающее по наименованию и региону/подразделению
+ $model = Locations::find()
+ ->where([ 'like', 'name', $options[ 'location' ]])
+ ->andWhere([ 'region_id' => $region[ 'id' ]])
+ ->all();
+ if (count($model) > 0)
+ {
+ // Если нашли, возвращаем идентификатор записи
+ $result[ 'id' ] = $model[0]->id;
+ $result[ 'error' ] = '';
+ }
+ else
+ {
+ // Не нашли, пробуем добавить место расположения
+ $model = new Locations();
+ $model->name = $options[ 'location' ];
+ $model->region_id = $region[ 'id' ];
+ if($model->validate() && $model->save())
+ {
+ // Если удалось сохранить, вернём идентификатор места расположения
+ $result[ 'id' ] = $model->id;
+ $result[ 'error' ] = '';
+ }
+ else
+ {
+ $result[ 'error' ] = Yii::t('locations', 'Error to create location "{location}": ', $options) . print_r($model->errors, TRUE);
+ }
+ }
+ }
+ else
+ {
+ $result[ 'error' ] .= '<br />' . $region[ 'error' ];
+ }
+ }
+ return $result; // Записать не удалось, вернём FALSE
+ }
+
+ /**
+ * Список всех мест/размещений.