mirror of
https://github.com/Oreolek/ifhub.club.git
synced 2024-06-28 20:45:00 +03:00
529 lines
17 KiB
PHP
529 lines
17 KiB
PHP
<?php
|
||
/*
|
||
* LiveStreet CMS
|
||
* Copyright © 2013 OOO "ЛС-СОФТ"
|
||
*
|
||
* ------------------------------------------------------
|
||
*
|
||
* Official site: www.livestreetcms.com
|
||
* Contact e-mail: office@livestreetcms.com
|
||
*
|
||
* GNU General Public License, version 2:
|
||
* http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
|
||
*
|
||
* ------------------------------------------------------
|
||
*
|
||
* @link http://www.livestreetcms.com
|
||
* @copyright 2013 OOO "ЛС-СОФТ"
|
||
* @author Maxim Mzhelskiy <rus.engine@gmail.com>
|
||
*
|
||
*/
|
||
|
||
/**
|
||
* Модуль Geo - привязка объектов к географии (страна/регион/город)
|
||
* Терминология:
|
||
* объект - который привязываем к гео-объекту
|
||
* гео-объект - географический объект(страна/регион/город)
|
||
*
|
||
* @package application.modules.geo
|
||
* @since 1.0
|
||
*/
|
||
class ModuleGeo extends Module
|
||
{
|
||
/**
|
||
* Объект маппера
|
||
*
|
||
* @var ModuleGeo_MapperGeo
|
||
*/
|
||
protected $oMapper;
|
||
/**
|
||
* Объект текущего пользователя
|
||
*
|
||
* @var ModuleUser_EntityUser|null
|
||
*/
|
||
protected $oUserCurrent;
|
||
/**
|
||
* Список доступных типов объектов
|
||
* На данный момент доступен параметр allow_multi=>1 - указывает на возможность создавать несколько связей для одного объекта
|
||
*
|
||
* @var array
|
||
*/
|
||
protected $aTargetTypes = array(
|
||
'user' => array(),
|
||
);
|
||
/**
|
||
* Список доступных типов гео-объектов
|
||
*
|
||
* @var array
|
||
*/
|
||
protected $aGeoTypes = array(
|
||
'country',
|
||
'region',
|
||
'city',
|
||
);
|
||
|
||
/**
|
||
* Инициализация
|
||
*
|
||
*/
|
||
public function Init()
|
||
{
|
||
$this->oMapper = Engine::GetMapper(__CLASS__);
|
||
$this->oUserCurrent = $this->User_GetUserCurrent();
|
||
}
|
||
|
||
/**
|
||
* Возвращает список типов объектов
|
||
*
|
||
* @return array
|
||
*/
|
||
public function GetTargetTypes()
|
||
{
|
||
return $this->aTargetTypes;
|
||
}
|
||
|
||
/**
|
||
* Добавляет в разрешенные новый тип
|
||
* @param string $sTargetType Тип владельца
|
||
* @param array $aParams Параметры
|
||
* @return bool
|
||
*/
|
||
public function AddTargetType($sTargetType, $aParams = array())
|
||
{
|
||
if (!array_key_exists($sTargetType, $this->aTargetTypes)) {
|
||
$this->aTargetTypes[$sTargetType] = $aParams;
|
||
return true;
|
||
}
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Проверяет разрешен ли данный тип
|
||
*
|
||
* @param string $sTargetType Тип владельца
|
||
* @return bool
|
||
*/
|
||
public function IsAllowTargetType($sTargetType)
|
||
{
|
||
return in_array($sTargetType, array_keys($this->aTargetTypes));
|
||
}
|
||
|
||
/**
|
||
* Проверяет разрешен ли данный гео-тип
|
||
*
|
||
* @param string $sGeoType Тип владельца
|
||
* @return bool
|
||
*/
|
||
public function IsAllowGeoType($sGeoType)
|
||
{
|
||
return in_array($sGeoType, $this->aGeoTypes);
|
||
}
|
||
|
||
/**
|
||
* Проверка объекта
|
||
*
|
||
* @param string $sTargetType Тип владельца
|
||
* @param int $iTargetId ID владельца
|
||
* @return bool
|
||
*/
|
||
public function CheckTarget($sTargetType, $iTargetId)
|
||
{
|
||
if (!$this->IsAllowTargetType($sTargetType)) {
|
||
return false;
|
||
}
|
||
$sMethod = 'CheckTarget' . func_camelize($sTargetType);
|
||
if (method_exists($this, $sMethod)) {
|
||
return $this->$sMethod($iTargetId);
|
||
}
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Проверка на возможность нескольких связей
|
||
*
|
||
* @param string $sTargetType Тип владельца
|
||
* @return bool
|
||
*/
|
||
public function IsAllowTargetMulti($sTargetType)
|
||
{
|
||
if ($this->IsAllowTargetType($sTargetType)) {
|
||
if (isset($this->aTargetTypes[$sTargetType]['allow_multi']) and $this->aTargetTypes[$sTargetType]['allow_multi']) {
|
||
return true;
|
||
}
|
||
}
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Добавляет связь объекта с гео-объектом в БД
|
||
*
|
||
* @param ModuleGeo_EntityTarget $oTarget Объект связи с владельцем
|
||
* @return ModuleGeo_EntityTarget|bool
|
||
*/
|
||
public function AddTarget($oTarget)
|
||
{
|
||
if ($this->oMapper->AddTarget($oTarget)) {
|
||
return $oTarget;
|
||
}
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Создание связи
|
||
*
|
||
* @param ModuleGeo_EntityGeo $oGeoObject
|
||
* @param string $sTargetType Тип владельца
|
||
* @param int $iTargetId ID владельца
|
||
* @return bool|ModuleGeo_EntityTarget
|
||
*/
|
||
public function CreateTarget($oGeoObject, $sTargetType, $iTargetId)
|
||
{
|
||
/**
|
||
* Проверяем объект на валидность
|
||
*/
|
||
if (!$this->CheckTarget($sTargetType, $iTargetId)) {
|
||
return false;
|
||
}
|
||
/**
|
||
* Проверяем есть ли уже у этого объекта другие связи
|
||
*/
|
||
$aTargets = $this->GetTargets(array('target_type' => $sTargetType, 'target_id' => $iTargetId), 1, 1);
|
||
if ($aTargets['count']) {
|
||
if ($this->IsAllowTargetMulti($sTargetType)) {
|
||
/**
|
||
* Разрешено несколько связей
|
||
* Проверяем есть ли уже связь с данным гео-объектом, если есть то возвращаем его
|
||
*/
|
||
$aTargetSelf = $this->GetTargets(array(
|
||
'target_type' => $sTargetType,
|
||
'target_id' => $iTargetId,
|
||
'geo_type' => $oGeoObject->getType(),
|
||
'geo_id' => $oGeoObject->getId()
|
||
), 1, 1);
|
||
if (isset($aTargetSelf['collection'][0])) {
|
||
return $aTargetSelf['collection'][0];
|
||
}
|
||
} else {
|
||
/**
|
||
* Есть другие связи и несколько связей запрещено - удаляем имеющиеся связи
|
||
*/
|
||
$this->DeleteTargets(array('target_type' => $sTargetType, 'target_id' => $iTargetId));
|
||
}
|
||
}
|
||
/**
|
||
* Создаем связь
|
||
*/
|
||
$oTarget = Engine::GetEntity('ModuleGeo_EntityTarget');
|
||
$oTarget->setGeoType($oGeoObject->getType());
|
||
$oTarget->setGeoId($oGeoObject->getId());
|
||
$oTarget->setTargetType($sTargetType);
|
||
$oTarget->setTargetId($iTargetId);
|
||
if ($oGeoObject->getType() == 'city') {
|
||
$oTarget->setCountryId($oGeoObject->getCountryId());
|
||
$oTarget->setRegionId($oGeoObject->getRegionId());
|
||
$oTarget->setCityId($oGeoObject->getId());
|
||
} elseif ($oGeoObject->getType() == 'region') {
|
||
$oTarget->setCountryId($oGeoObject->getCountryId());
|
||
$oTarget->setRegionId($oGeoObject->getId());
|
||
} elseif ($oGeoObject->getType() == 'country') {
|
||
$oTarget->setCountryId($oGeoObject->getId());
|
||
}
|
||
return $this->AddTarget($oTarget);
|
||
}
|
||
|
||
/**
|
||
* Возвращает список связей по фильтру
|
||
*
|
||
* @param array $aFilter Фильтр
|
||
* @param int $iCurrPage Номер страницы
|
||
* @param int $iPerPage Количество элементов на страницу
|
||
* @return array('collection'=>array,'count'=>int)
|
||
*/
|
||
public function GetTargets($aFilter, $iCurrPage, $iPerPage)
|
||
{
|
||
return array(
|
||
'collection' => $this->oMapper->GetTargets($aFilter, $iCount, $iCurrPage, $iPerPage),
|
||
'count' => $iCount
|
||
);
|
||
}
|
||
|
||
/**
|
||
* Возвращает первый объект связи по объекту
|
||
*
|
||
* @param string $sTargetType Тип владельца
|
||
* @param int $iTargetId ID владельца
|
||
* @return null|ModuleGeo_EntityTarget
|
||
*/
|
||
public function GetTargetByTarget($sTargetType, $iTargetId)
|
||
{
|
||
$aTargets = $this->GetTargets(array('target_type' => $sTargetType, 'target_id' => $iTargetId), 1, 1);
|
||
if (isset($aTargets['collection'][0])) {
|
||
return $aTargets['collection'][0];
|
||
}
|
||
return null;
|
||
}
|
||
|
||
/**
|
||
* Возвращает список связей для списка объектов одного типа.
|
||
*
|
||
* @param string $sTargetType Тип владельца
|
||
* @param array $aTargetId Список ID владельцев
|
||
* @return array В качестве ключей используется ID объекта, в качестве значений массив связей этого объекта
|
||
*/
|
||
public function GetTargetsByTargetArray($sTargetType, $aTargetId)
|
||
{
|
||
if (!is_array($aTargetId)) {
|
||
$aTargetId = array($aTargetId);
|
||
}
|
||
if (!count($aTargetId)) {
|
||
return array();
|
||
}
|
||
$aResult = array();
|
||
$aTargets = $this->GetTargets(array('target_type' => $sTargetType, 'target_id' => $aTargetId), 1,
|
||
count($aTargetId));
|
||
if ($aTargets['count']) {
|
||
foreach ($aTargets['collection'] as $oTarget) {
|
||
$aResult[$oTarget->getTargetId()][] = $oTarget;
|
||
}
|
||
}
|
||
return $aResult;
|
||
}
|
||
|
||
/**
|
||
* Удаляет связи по фильтру
|
||
*
|
||
* @param array $aFilter Фильтр
|
||
* @return bool|int
|
||
*/
|
||
public function DeleteTargets($aFilter)
|
||
{
|
||
return $this->oMapper->DeleteTargets($aFilter);
|
||
}
|
||
|
||
/**
|
||
* Удаление всех связей объекта
|
||
*
|
||
* @param string $sTargetType Тип владельца
|
||
* @param int $iTargetId ID владельца
|
||
* @return bool|int
|
||
*/
|
||
public function DeleteTargetsByTarget($sTargetType, $iTargetId)
|
||
{
|
||
return $this->DeleteTargets(array('target_type' => $sTargetType, 'target_id' => $iTargetId));
|
||
}
|
||
|
||
/**
|
||
* Возвращает список стран по фильтру
|
||
*
|
||
* @param array $aFilter Фильтр
|
||
* @param array $aOrder Сортировка
|
||
* @param int $iCurrPage Номер страницы
|
||
* @param int $iPerPage Количество элементов на страницу
|
||
* @return array('collection'=>array,'count'=>int)
|
||
*/
|
||
public function GetCountries($aFilter, $aOrder, $iCurrPage, $iPerPage)
|
||
{
|
||
return array(
|
||
'collection' => $this->oMapper->GetCountries($aFilter, $aOrder, $iCount, $iCurrPage, $iPerPage),
|
||
'count' => $iCount
|
||
);
|
||
}
|
||
|
||
/**
|
||
* Возвращает список регионов по фильтру
|
||
*
|
||
* @param array $aFilter Фильтр
|
||
* @param array $aOrder Сортировка
|
||
* @param int $iCurrPage Номер страницы
|
||
* @param int $iPerPage Количество элементов на страницу
|
||
* @return array('collection'=>array,'count'=>int)
|
||
*/
|
||
public function GetRegions($aFilter, $aOrder, $iCurrPage, $iPerPage)
|
||
{
|
||
return array(
|
||
'collection' => $this->oMapper->GetRegions($aFilter, $aOrder, $iCount, $iCurrPage, $iPerPage),
|
||
'count' => $iCount
|
||
);
|
||
}
|
||
|
||
/**
|
||
* Возвращает список городов по фильтру
|
||
*
|
||
* @param array $aFilter Фильтр
|
||
* @param array $aOrder Сортировка
|
||
* @param int $iCurrPage Номер страницы
|
||
* @param int $iPerPage Количество элементов на страницу
|
||
* @return array('collection'=>array,'count'=>int)
|
||
*/
|
||
public function GetCities($aFilter, $aOrder, $iCurrPage, $iPerPage)
|
||
{
|
||
return array(
|
||
'collection' => $this->oMapper->GetCities($aFilter, $aOrder, $iCount, $iCurrPage, $iPerPage),
|
||
'count' => $iCount
|
||
);
|
||
}
|
||
|
||
/**
|
||
* Возвращает страну по ID
|
||
*
|
||
* @param int $iId ID страны
|
||
* @return ModuleGeo_EntityCountry|null
|
||
*/
|
||
public function GetCountryById($iId)
|
||
{
|
||
$aRes = $this->GetCountries(array('id' => $iId), array(), 1, 1);
|
||
if (isset($aRes['collection'][0])) {
|
||
return $aRes['collection'][0];
|
||
}
|
||
return null;
|
||
}
|
||
|
||
/**
|
||
* Возвращает регион по ID
|
||
*
|
||
* @param int $iId ID региона
|
||
* @return ModuleGeo_EntityRegion|null
|
||
*/
|
||
public function GetRegionById($iId)
|
||
{
|
||
$aRes = $this->GetRegions(array('id' => $iId), array(), 1, 1);
|
||
if (isset($aRes['collection'][0])) {
|
||
return $aRes['collection'][0];
|
||
}
|
||
return null;
|
||
}
|
||
|
||
/**
|
||
* Возвращает регион по ID
|
||
*
|
||
* @param int $iId ID города
|
||
* @return ModuleGeo_EntityCity|null
|
||
*/
|
||
public function GetCityById($iId)
|
||
{
|
||
$aRes = $this->GetCities(array('id' => $iId), array(), 1, 1);
|
||
if (isset($aRes['collection'][0])) {
|
||
return $aRes['collection'][0];
|
||
}
|
||
return null;
|
||
}
|
||
|
||
/**
|
||
* Возвращает гео-объект
|
||
*
|
||
* @param string $sType Тип гео-объекта
|
||
* @param int $iId ID гео-объекта
|
||
* @return ModuleGeo_EntityGeo|null
|
||
*/
|
||
public function GetGeoObject($sType, $iId)
|
||
{
|
||
$sType = strtolower($sType);
|
||
if (!$this->IsAllowGeoType($sType)) {
|
||
return null;
|
||
}
|
||
switch ($sType) {
|
||
case 'country':
|
||
return $this->GetCountryById($iId);
|
||
break;
|
||
case 'region':
|
||
return $this->GetRegionById($iId);
|
||
break;
|
||
case 'city':
|
||
return $this->GetCityById($iId);
|
||
break;
|
||
default:
|
||
return null;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Возвращает первый гео-объект для объекта
|
||
*
|
||
* @param string $sTargetType Тип владельца
|
||
* @param int $iTargetId ID владельца
|
||
* @return ModuleGeo_EntityCity|ModuleGeo_EntityCountry|ModuleGeo_EntityRegion|null
|
||
*/
|
||
public function GetGeoObjectByTarget($sTargetType, $iTargetId)
|
||
{
|
||
$aTargets = $this->GetTargets(array('target_type' => $sTargetType, 'target_id' => $iTargetId), 1, 1);
|
||
if (isset($aTargets['collection'][0])) {
|
||
$oTarget = $aTargets['collection'][0];
|
||
return $this->GetGeoObject($oTarget->getGeoType(), $oTarget->getGeoId());
|
||
}
|
||
return null;
|
||
}
|
||
|
||
/**
|
||
* Возвращает список стран сгруппированных по количеству использований в данном типе объектов
|
||
*
|
||
* @param string $sTargetType Тип владельца
|
||
* @param int $iLimit Количество элементов
|
||
* @return array
|
||
*/
|
||
public function GetGroupCountriesByTargetType($sTargetType, $iLimit)
|
||
{
|
||
return $this->oMapper->GetGroupCountriesByTargetType($sTargetType, $iLimit);
|
||
}
|
||
|
||
/**
|
||
* Возвращает список городов сгруппированных по количеству использований в данном типе объектов
|
||
*
|
||
* @param string $sTargetType Тип владельца
|
||
* @param int $iLimit Количество элементов
|
||
* @return array
|
||
*/
|
||
public function GetGroupCitiesByTargetType($sTargetType, $iLimit)
|
||
{
|
||
return $this->oMapper->GetGroupCitiesByTargetType($sTargetType, $iLimit);
|
||
}
|
||
|
||
/**
|
||
* Возвращает список использованых стран для типа
|
||
*
|
||
* @param string $sTargetType Тип владельца
|
||
* @return array
|
||
*/
|
||
public function GetCountriesUsedByTargetType($sTargetType)
|
||
{
|
||
return $this->oMapper->GetCountriesUsedByTargetType($sTargetType);
|
||
}
|
||
|
||
/**
|
||
* Возвращает список использованых регионов для типа
|
||
*
|
||
* @param int $iCountryId
|
||
* @param string $sTargetType Тип владельца
|
||
* @return array
|
||
*/
|
||
public function GetRegionsUsedByTargetType($iCountryId, $sTargetType)
|
||
{
|
||
return $this->oMapper->GetRegionsUsedByTargetType($iCountryId, $sTargetType);
|
||
}
|
||
|
||
/**
|
||
* Возвращает список использованых городов для типа
|
||
*
|
||
* @param int $iRegionId
|
||
* @param string $sTargetType Тип владельца
|
||
* @return array
|
||
*/
|
||
public function GetCitiesUsedByTargetType($iRegionId, $sTargetType)
|
||
{
|
||
return $this->oMapper->GetCitiesUsedByTargetType($iRegionId, $sTargetType);
|
||
}
|
||
|
||
/**
|
||
* Проверка объекта с типом "user"
|
||
* Название метода формируется автоматически
|
||
*
|
||
* @param int $iTargetId ID пользователя
|
||
* @return bool
|
||
*/
|
||
public function CheckTargetUser($iTargetId)
|
||
{
|
||
if ($oUser = $this->User_GetUserById($iTargetId)) {
|
||
return true;
|
||
}
|
||
return false;
|
||
}
|
||
} |