Umicms - Вклад участника [ru]

Уменьшение вложенности товаров

2018-06-29T14:57:26Z

Lesnik512: internal link

'''Актуально для версии 18.'''

Часто для улучшения ранжирования в поисковых системах нужно уменьшать вложенность страниц. Например переместить товары на второй уровень, при этом сохранив структуру каталога.

Изначально для данной задачи использовал [http://dev.docs.umi-cms.ru/shablony_i_makrosy/xslt-shablonizator_umi_cms/formirovanie_dannyh_na_servere_protokol_umap/ протокол Umap], но решение было не очень гибкое.

Недавно нашел более удачное решение, которое и привожу.

Для начала нужно перехватывать событие systemPrepare, которое вызывается уже после анализа URL и до генерации глобальных переменных.

Перехват события (файл events.php в папке classes/modules/catalog в директории шаблона, или custom_events.php в системной папке модуля):
<source lang="php">
new umiEventListener('systemPrepare', 'catalog', 'short_links');
</source>

Права на доступ к макросу (permissions.php или permissions_custom.php):
<source lang="php">
$permissions = array(
'view' => array('short_links')
);
</source>

Сама функция с комментариями:
<source lang="php">
// импортируем Service в самом начале файла
use UmiCms\Service;
//...
public function short_links(iUmiEventPoint $oEventPoint) {
if ($oEventPoint->getMode() === "before") {
// парсим url в массив
$path_parts = Service::Request()->getPathParts();

// у нас ссылки вида /product/{$alt-name}/
// и соответственно здесь проверяется, соответствует ли ссылка данному шаблону
@list($part1, $alt_name, $part3) = $path_parts;
if ($part3 or $part1 !== 'product' or !$alt_name)
return true;

// ищем объект каталога по alt-name
$pages = new selector('pages');
$pages->types('hierarchy-type')->name('catalog', 'object');
$pages->option('return')->value('id');
$pages->where('alt_name')->equals($alt_name);
$page_id = $pages->first();
$page_id = $page_id ? @$page_id['id'] : false;
if (!$page_id)
return true;

// переопределяем данные, чтобы сгенерировалась нужная страница
$cmsController = cmsController::getInstance();
$cmsController->setCurrentElementId($page_id);
$cmsController->setCurrentModule('catalog');
$cmsController->setCurrentMethod('object');
}
return true;
}
</source>

Для корректной работы нужно еще избавиться от товаров с одинаковым alt-name. Об этом с статье [[Поиск товаров с одинаковым alt-name]]

[[category:Решение проблем и ошибок]]

Поиск товаров с одинаковым alt-name

2018-06-29T14:56:11Z

Lesnik512: Новая страница: «'''Актуально для версии 18.''' Это продолжение статьи "Уменьшение вложенности товаров". Д…»

'''Актуально для версии 18.'''

Это продолжение статьи "[[Уменьшение вложенности товаров]]".

Для корректной работы статьи нужно избавиться от товаров с одинаковым alt-name. Сделать это можно вот таким скриптом:

<source lang="php">
define("CURRENT_WORKING_DIR", str_replace("\\", "/", $dirname = dirname(__FILE__)));
require CURRENT_WORKING_DIR . '/libs/root-src/standalone.php';

// здесь можно заменить catalog и object на данные необходимого иерархического типа данных, например news и item — для страниц новостей.
$type_id = umiHierarchyTypesCollection::getInstance()->getTypeByName('catalog', 'object')->getId();

$hierarchy = umiHierarchy::getInstance();
$connection = ConnectionPool::getInstance()->getConnection('core');

// прямым запросов к базе ищем дубли по alt-name
$result = $connection->query("SELECT GROUP_CONCAT(id SEPARATOR ', ') id, COUNT(*) c FROM `cms3_hierarchy` WHERE `type_id` = $type_id GROUP BY alt_name HAVING c > 1");

// распечатываем ссылки на страницы
while($row = mysqli_fetch_assoc($result)) {
foreach (explode(',', $row['id']) as $id) {
$page = $hierarchy->getElement($id);
echo "<a href=\"/admin/catalog/edit/{$page->getId()}/\">{$page->getName()}</a><br />\n";
}
echo "\n";
}
</source>

Кладем скрипт в корень сайта и вызываем из браузера. Корректируем страницы до тех пор, пока дублей не останется.

[[category:Написание кастомных макросов]]

Уменьшение вложенности товаров

2018-06-29T14:33:21Z

Lesnik512: Новая страница: «'''Актуально для версии 18.''' Часто для улучшения ранжирования в поисковых системах нужно…»

'''Актуально для версии 18.'''

Часто для улучшения ранжирования в поисковых системах нужно уменьшать вложенность страниц. Например переместить товары на второй уровень, при этом сохранив структуру каталога.

Изначально для данной задачи использовал [http://dev.docs.umi-cms.ru/shablony_i_makrosy/xslt-shablonizator_umi_cms/formirovanie_dannyh_na_servere_protokol_umap/ протокол Umap], но решение было не очень гибкое.

Недавно нашел более удачное решение, которое и привожу.

Для начала нужно перехватывать событие systemPrepare, которое вызывается уже после анализа URL и до генерации глобальных переменных.

Перехват события (файл events.php в папке classes/modules/catalog в директории шаблона, или custom_events.php в системной папке модуля):
<source lang="php">
new umiEventListener('systemPrepare', 'catalog', 'short_links');
</source>

Права на доступ к макросу (permissions.php или permissions_custom.php):
<source lang="php">
$permissions = array(
'view' => array('short_links')
);
</source>

Сама функция с комментариями:
<source lang="php">
// импортируем Service в самом начале файла
use UmiCms\Service;
//...
public function short_links(iUmiEventPoint $oEventPoint) {
if ($oEventPoint->getMode() === "before") {
// парсим url в массив
$path_parts = Service::Request()->getPathParts();

// у нас ссылки вида /product/{$alt-name}/
// и соответственно здесь проверяется, соответствует ли ссылка данному шаблону
@list($part1, $alt_name, $part3) = $path_parts;
if ($part3 or $part1 !== 'product' or !$alt_name)
return true;

// ищем объект каталога по alt-name
$pages = new selector('pages');
$pages->types('hierarchy-type')->name('catalog', 'object');
$pages->option('return')->value('id');
$pages->where('alt_name')->equals($alt_name);
$page_id = $pages->first();
$page_id = $page_id ? @$page_id['id'] : false;
if (!$page_id)
return true;

// переопределяем данные, чтобы сгенерировалась нужная страница
$cmsController = cmsController::getInstance();
$cmsController->setCurrentElementId($page_id);
$cmsController->setCurrentModule('catalog');
$cmsController->setCurrentMethod('object');
}
return true;
}
</source>

[[category:Решение проблем и ошибок]]

Удаление изображения при удалении страницы

2018-06-17T08:23:34Z

Lesnik512: Новая страница: «'''Актуально для версии 18.''' Назначаем обработчик события: <source lang="php"> new umiEventListener('systemDeleteElem…»

'''Актуально для версии 18.'''

Назначаем обработчик события:

<source lang="php">
new umiEventListener('systemDeleteElement', 'catalog', 'onRemoveItem');
</source>

Задаем права доступа к макросу:

<source lang="php">
$permissions = array('view' => array('onRemoveItem'));
</source>

Непосредственно обработчик:

<source lang="php">
/**Удаление изображений при удалении страницы
* @param iUmiEventPoint $oEventPoint
* @return bool
*/
public function onRemoveItem(iUmiEventPoint $oEventPoint) {
if ($oEventPoint->getMode() === "after") {
$element = $oEventPoint->getRef("element");
$photo = @ $element->getValue('photo');
if ($photo instanceof umiImageFile)
$photo->delete();
}
return true;
}
</source>

[[category:Написание кастомных макросов]]

Получить соседние страницы

2018-06-17T07:53:20Z

Lesnik512: Новая страница: «'''Актуально для версии 18.''' Из коробки есть макросы %system getNext()% и %system getPrevious()%. Привожу прим…»

'''Актуально для версии 18.'''

Из коробки есть макросы %system getNext()% и %system getPrevious()%.

Привожу пример объединенного сокращенного макроса. Принимает только один параметр: id страницы или путь.

Использую для сокращения количества запросов.

<source lang="php">
public function get_neighbours($path = '') {
$element_id = def_module::analyzeRequiredPath($path);
$element = $element_id ? umiHierarchy::getInstance()->getElement($element_id) : false;

if(!$element)
return '';

$pages = new selector('pages');
$pages->types('hierarchy-type')->id($element->getTypeId());
$pages->where('hierarchy')->page($element->getParentId())->level(1);
$pages->order('ord');
$pages->option('return')->value('id');

$next = false;
$prev = false;
$is_matched = false;

foreach($pages->result() as $page) {
$id = $page['id'];
if($is_matched) {
$next = $id;
break;
}
if($id == $element_id)
$is_matched = true;
if (!$is_matched)
$prev = $id;
}

return [
'prev_id' => $prev,
'prev_link' => umiHierarchy::getInstance()->getPathById($prev),
'next_id' => $next,
'next_link' => umiHierarchy::getInstance()->getPathById($next)
];
}
</source>

Пример запроса:

https://somesite.ru/udata:/news/get_neighbours/456

Пример xml-ответа:

<source lang="xml">
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="news" method="get_neighbours" generation-time="0.035878">
<prev_id>454</prev_id>
<prev_link>/news/lollipop-popular-android/</prev_link>
<next_id>457</next_id>
<next_link>/news/microsoft-surface-3-i-surface-pro-4-cases/</next_link>
</udata>
</source>

[[category:Написание кастомных макросов]]

Постраничная карта сайта

2018-06-15T19:36:31Z

Lesnik512: Новая страница: «'''Актуально для версии 18.''' На страницах с больших количеством страниц может понадобится …»

'''Актуально для версии 18.'''

На страницах с больших количеством страниц может понадобится сделать постраничную карту сайта с заданным ограниченным количеством ссылок на странице.

Ниже приводится код основного макрома и двух вспомогательных.

<source lang="php">
class content_custom extends def_module {
public $sitemap_count_down;
public $sitemap_offset;
public $sitemap_iterator = 0;

/**Постраничный вывод карты сайта
* @param int $limit количество ссылок на странице
* @param int $expire время жизни кеша в секундах
* @return array
* @throws selectorException
*/
public function sitemap_pages($limit=500, $expire=7200) {
$page = (int) getRequest('p');

$block_arr = array();
$this->sitemap_count_down = $limit;
$this->sitemap_offset = $page * $this->sitemap_count_down;

$children_count = $this->sitemap_children_count(0);

if ($this->sitemap_offset > $children_count)
return $block_arr['items'] = 'none';

// кеширование данных карты сайта в файлы
$folder = CURRENT_WORKING_DIR . '/sys-temp/sitemap-cache/';
if(!is_dir($folder))
mkdir($folder, 0777, true);
$data_path = $folder . 'map' . $page . '.html';
$mtime = is_file($data_path) ? filemtime($data_path) : false;
if($mtime && (time() < ($mtime + $expire)))
$block_arr['items']['nodes:item'] = json_decode(file_get_contents($data_path),true);
else {
$block_arr['items']['nodes:item'] = $this->sitemap_children(0);
file_put_contents($data_path, json_encode($block_arr['items']['nodes:item']));
}

$block_arr['total'] = $children_count;
$block_arr['per_page'] = 500;
return $block_arr;
}

/**Рекурсивная функция для генерации данных карты сайта
* @param int $page_id id страницы
* @return array
* @throws selectorException
*/
public function sitemap_children($page_id) {
$hierarchy = umiHierarchy::getInstance();
$pages = new selector('pages');
$pages->where('hierarchy')->page($page_id)->level(1);
$pages->where('robots_deny')->notequals(1);
$pages->where('is_active')->equals(1);
$pages->where('is_visible')->equals(1);
$pages->order('ord');

$items = array();

foreach ($pages as $page) {
/** @var umiHierarchyElement $page */
if (!isset($this->sitemap_iterator))
$this->sitemap_iterator = 0;
if (!$this->sitemap_count_down)
break;
$children_count = $this->sitemap_children_count($page->getId()) + 1;
if ($this->sitemap_offset >= $children_count) {
$this->sitemap_offset -= $children_count;
$this->sitemap_iterator += $children_count;
} else {
$this->sitemap_iterator++;
if ($this->sitemap_offset > 0) {
$this->sitemap_offset--;
$item_arr = array();
}
else {
$this->sitemap_count_down--;
$item_arr = array(
'@i' => $this->sitemap_iterator,
'@link' => $page->link,
'@name' => $page->getName(),
);
}
if (($children_count>1) && $this->sitemap_count_down)
$item_arr['items']['nodes:item'] = $this->sitemap_children($page->getId());
$items[] = $item_arr;
}
$hierarchy->unloadElement($page->getId());
}
return $items;
}

/**Количество активных и видимых подстраниц на неограниченную вложенность
* @param int $page_id id страницы
* @return bool|int
*/
public function sitemap_children_count($page_id) {
$hierarchy = umiHierarchy::getInstance();
return $hierarchy->getChildrenCount($page_id, false, false);
}
}
</source>

Права доступа к методам класса:

<source lang="php">
$permissions = Array(
'content' => array('sitemap_pages', 'sitemap_children', 'sitemap_children_count')
);
</source>

Пример шаблона на php-шаблонизаторе:

<source lang="php">
$p = getRequest('p');
$sitemap = $this->macros('content', 'sitemap_pages', array());
function renderMap($map) {
$result = '';
if(isset($map['items']['nodes:item'])) {
$result .= '<ul>';
foreach($map['items']['nodes:item'] as $item) {
$result .= '<li>';
if (isset($item['@link'])) $result .= "<a href=\"{$item['@link']}\">{$item['@name']}</a>";
$result .= renderMap($item);
$result .= '</li>';
}
$result .= '</ul>';
}
return $result;
}
?>
<div class="b-sitemap">
<?=renderMap($sitemap)?>
</div>
<?=@($sitemap['total'] > $sitemap['per_page']) ? $this->render($this->macros('system','numpages', array($sitemap['total'], $sitemap['per_page'])), 'library/numpages') : ''
</source>

[[category:Написание кастомных макросов]]

Кастомный макрос на основе выборки через selector

2018-06-13T16:48:36Z

Lesnik512: Новая страница: «'''Актуально для версии 18.''' Стандартные макросы для выборки данных содержать в себе довол…»

'''Актуально для версии 18.'''

Стандартные макросы для выборки данных содержать в себе довольно много функциональности, которая может совсем не использоваться, а каких то функций или данных может наоборот не хватать.

В последнее время стараюсь избегать использования стандартных макросов в пользу небольших самописных. Ниже пример с комментариями из реального проекта.

<source lang="php">
/**Постраничный вывод объектов каталога
* @param int $parentId id раздела для поиска страниц
* @param bool $limit количество объектов на странице
* @param array $fields массив с дополнительными полями, которые нужны
* @return array
* @throws selectorException
*/
public function getObjects($parentId = 0, $limit = false, $fields = array()) {
$limit = ($limit) ? $limit : $this->module->per_page;
$currentPage = (int) getRequest('p');
$offset = $currentPage * $limit;
if (!is_array($fields)) $fields = explode(',',$fields);

// объединяем общий список полей с переданным через параметр $fields
$fields = array_merge(array('id', 'name', 'alt_name'), $fields);

$hierarchy = umiHierarchy::getInstance();
$pages = new selector('pages');
$pages->types('hierarchy-type')->name('catalog', 'object');
$pages->where('hierarchy')->page($parentId)->level(2);

// selector вернет вместо объектов umiHierarchyElement ассоциативный массив
$pages->option('return')->value($fields);
$pages->order('ord')->asc();
$pages->limit($offset, $limit);

$result = array();
$total = $pages->length();
foreach($pages->result as $page) {
$item = $page;
$item['link'] = $hierarchy->getPathById($item['id']);
$result['nodes:page'][] = $item;
}
$result['total'] = $total;
$result['per_page'] = $limit;
return $result;
}
</source>

Метод работает в php- и xslt-шаблонизаторах.

[[category:Написание кастомных макросов]]

404 статус для существующих страниц

2018-06-12T09:10:45Z

Lesnik512:

'''Актуально для версии 18.'''

Для некоторых страниц, например для страниц настроек или комментариев, может понадобиться выводить 404 страницу.

В исходном коде системы есть стандартная точка вызова systemPrepare, описание которой я не нашел в документации. На мой взгляд это самое удачное место для внедрения кастомного обработчика.

Перехватка события (файл events.php в папке classes/modules/content шаблона, или custom_events.php в системной папке модуля):

<source lang="php">
new umiEventListener('systemPrepare', 'content', 'after_system_prepared');
</source>

Права на доступ к макросу (permissions.php или permissions_custom.php):

<source lang="php">
$permissions= Array(
'content' => array('after_system_prepared')
);
</source>

Сам макрос (в class.php или custom.php):
<source lang="php">
public function after_system_prepared(iUmiEventPoint $oEventPoint) {
if ($oEventPoint->getMode() === "after") {
$cmsController = cmsController::getInstance();

$page_id = $cmsController->getCurrentElementId();
if (!$page_id or !$this->isStatus404($page_id))
return true;

// задаем данные, как для несуществующей страницы
$cmsController->setCurrentElementId(false);
$cmsController->setCurrentModule('content');
$cmsController->setCurrentMethod('content');
}
return true;
}
</source>

В методе isStatus404 определяем, какие страницы скрываются от отображения на сайте:

<source lang="php">
public function isStatus404($pageId = false) {
if (!$pageId)
return true;

$hierarchy = umiHierarchy::getInstance();
$page = $hierarchy->getElement($pageId);
$status = (bool) $page->getValue('status404');
if ($status)
return true;

$parents = $hierarchy->getAllParents($pageId);
$pages = new selector('pages');
$pages->where('id')->equals($parents);
$pages->option('return')->value('status404');
foreach ($pages->result as $item) {
if ($item['status404'])
return true;
}
return false;
}
</source>

В данном случае у типа данных "Раздел сайта" есть поле status404, при включении которого будет скрываться данная страница и все ее подстраницы.

Также будет логичным скрыть такие страницы из xml-карты сайта. Для этого можно воспользоваться [http://wiki.umisoft.ru/Карта_сайта_xml:_кастомизация_обновления этой статьей].

[[category:Решение проблем и ошибок]]

Карта сайта xml: кастомизация обновления

2018-06-12T09:10:11Z

Lesnik512:

'''Актуально для версии 18.'''

'''Статья предоставлена партнером UMI.CMS [https://www.umi-cms.ru/find_webdevs/shiriev_artur_venerovich/ Артуром Шириевым]'''

Может понадобиться управлять механизмом обновления некоторых страниц карты сайта.
Не так давно появилась новая стандартная точка вызова before_update_sitemap, которой нет в документации.

Механизм назначения обработчика подробно описан в разделе [http://api.docs.umi-cms.ru/razrabotka_nestandartnogo_funkcionala/sobytijnaya_model_umicms/ Событийная модель UMI.CMS]

Точки вызова before_update_sitemap:
Вызывается при подготовке глобальных переменных
режим: before
параметры:
(int) id - id страницы
параметры-ссылки:
(bool) &robots_deny - запрет для отображения в карте сайта
(string) &link - ссылка страницы

Пример обработчика:
<source lang="php">
public function update_sitemap(iUmiEventPoint $oEventPoint) {
if ($oEventPoint->getMode() === "before") {
$link = &$oEventPoint->getRef('link');
$robots_deny = &$oEventPoint->getRef('robots_deny');
@$page_id = &$oEventPoint->getParam('id');
$page = $page_id ? umiHierarchy::getInstance()->getElement($page_id) : false;
if (!$page instanceof umiHierarchyElement) return true;
// исключаем из карты сайта все комментарии
if ($page->getModule() == 'comments') $robots_deny = true;

// кастомный метод для определения, для каких страниц нужно отдавать 404-страницу
if ($this->isStatus404($page_id)) $robots_deny = true;

// на сайте используются модифицированные адреса объектов каталога
if ($page->getMethod() == 'object') {
$link = '{your_domain}' . $page->getAltName() . '/';
}
}
return true;
}
</source>

Пример метода isStatus404 описан в [http://wiki.umisoft.ru/404_статус_для_существующих_страниц этой статьей].

[[category:Написание кастомных макросов]]

404 статус для существующих страниц

2018-06-12T09:09:21Z

Lesnik512:

[[category:Решение проблем и ошибок]]

'''Актуально для версии 18.'''

Для некоторых страниц, например для страниц настроек или комментариев, может понадобиться выводить 404 страницу.

В исходном коде системы есть стандартная точка вызова systemPrepare, описание которой я не нашел в документации. На мой взгляд это самое удачное место для внедрения кастомного обработчика.

Перехватка события (файл events.php в папке classes/modules/content шаблона, или custom_events.php в системной папке модуля):

<source lang="php">
new umiEventListener('systemPrepare', 'content', 'after_system_prepared');
</source>

Права на доступ к макросу (permissions.php или permissions_custom.php):

<source lang="php">
$permissions= Array(
'content' => array('after_system_prepared')
);
</source>

Сам макрос (в class.php или custom.php):
<source lang="php">
public function after_system_prepared(iUmiEventPoint $oEventPoint) {
if ($oEventPoint->getMode() === "after") {
$cmsController = cmsController::getInstance();

$page_id = $cmsController->getCurrentElementId();
if (!$page_id or !$this->isStatus404($page_id))
return true;

// задаем данные, как для несуществующей страницы
$cmsController->setCurrentElementId(false);
$cmsController->setCurrentModule('content');
$cmsController->setCurrentMethod('content');
}
return true;
}
</source>

В методе isStatus404 определяем, какие страницы скрываются от отображения на сайте:

<source lang="php">
public function isStatus404($pageId = false) {
if (!$pageId)
return true;

$hierarchy = umiHierarchy::getInstance();
$page = $hierarchy->getElement($pageId);
$status = (bool) $page->getValue('status404');
if ($status)
return true;

$parents = $hierarchy->getAllParents($pageId);
$pages = new selector('pages');
$pages->where('id')->equals($parents);
$pages->option('return')->value('status404');
foreach ($pages->result as $item) {
if ($item['status404'])
return true;
}
return false;
}
</source>

В данном случае у типа данных "Раздел сайта" есть поле status404, при включении которого будет скрываться данная страница и все ее подстраницы.

Также будет логичным скрыть такие страницы из xml-карты сайта. Для этого можно воспользоваться [http://wiki.umisoft.ru/Карта_сайта_xml:_кастомизация_обновления этой статьей].

404 статус для существующих страниц

2018-06-12T09:07:06Z

Lesnik512: Новая страница: « category:Решение проблем и ошибок '''Актуально для версии 18.''' Для некоторых страниц, наприм…»

[[category:Решение проблем и ошибок]]

'''Актуально для версии 18.'''

Для некоторых страниц, например для страниц настроек или комментариев, может понадобиться выводить 404 страницу.

В исходном коде системы есть стандартная точка вызова systemPrepare, описание которой я не нашел в документации. На мой взгляд это самое удачное место для внедрения кастомного обработчика.

Перехватка события (файл events.php в папке classes/modules/content шаблона, или custom_events.php в системной папке модуля):

<source lang="php">
new umiEventListener('systemPrepare', 'content', 'after_system_prepared');
</source>

Права на доступ к макросу (permissions.php или permissions_custom.php):

<source lang="php">
$permissions= Array(
'content' => array('after_system_prepared')
);
</source>

Сам макрос (в class.php или custom.php):
<source lang="php">
public function after_system_prepared(iUmiEventPoint $oEventPoint) {
if ($oEventPoint->getMode() === "after") {
$cmsController = cmsController::getInstance();

$page_id = $cmsController->getCurrentElementId();
if (!$page_id or !$this->isStatus404($page_id))
return true;

// задаем данные, как для несуществующей страницы
$cmsController->setCurrentElementId(false);
$cmsController->setCurrentModule('content');
$cmsController->setCurrentMethod('content');
}
return true;
}
</source>

В методе isStatus404 определяем, какие страницы скрываются от отображения на сайте:

<source lang="php">
public function isStatus404($pageId = false) {
if (!$pageId)
return true;

$hierarchy = umiHierarchy::getInstance();
$page = $hierarchy->getElement($pageId);
$status = (bool) $page->getValue('status404');
if ($status)
return true;

$parents = $hierarchy->getAllParents($pageId);
$pages = new selector('pages');
$pages->where('id')->equals($parents);
$pages->option('return')->value('status404');
foreach ($pages->result as $item) {
if ($item['status404'])
return true;
}
return false;
}
</source>

В данном случае у типа данных "Раздел сайта" есть поле status404, при включении которого будет скрываться данная страница и все ее подстраницы.

Также будет логичным скрыть такие страницы из xml-карты сайта. Для этого можно воспользоваться [http://wiki.umisoft.ru/%D0%9A%D0%B0%D1%80%D1%82%D0%B0_%D1%81%D0%B0%D0%B9%D1%82%D0%B0_xml:_%D0%BA%D0%B0%D1%81%D1%82%D0%BE%D0%BC%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F_%D0%BE%D0%B1%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F этой статьей].

Ajax и php-шаблонизатор

2018-06-11T16:47:36Z

Lesnik512: Новая страница: « category:Написание кастомных макросов '''Актуально для версии 18 и php-шаблонизатора.''' В доку…»

[[category:Написание кастомных макросов]]

'''Актуально для версии 18 и php-шаблонизатора.'''

В документации не нашел, как подружить php-шаблонизатор и ajax.

Привожу пример метода для ajax-подгрузки новостей.

<source lang="php">
public function getGallery($parentId = 0, $limit = false, $is_ajax = 0) {
$module = $this->module ? $this->module : $this;
$limit = ($limit) ? $limit : $module->per_page;
$currentPage = (int) getRequest('p');
$offset = $currentPage * $limit;

$pages = new selector('pages');
$pages->types('hierarchy-type')->name('news', 'item');
$pages->where('hierarchy')->page($parentId)->level(2);
$pages->order('ord');
$pages->limit($offset, $limit);

$result = array();
$total = $pages->length();
$result['nodes:page'] = array();
foreach($pages->result as $page) {
$result['nodes:page'][] = $page;
}
$result['total'] = $total;
$result['per_page'] = $limit;
$result['stop'] = (int) (($offset + count($result['nodes:page'])) == $total);
$result['category'] = $parentId;

// кусок, отвечающий за рендер
if ($is_ajax) {
$currentTemplater = cmsController::getInstance()->getCurrentTemplater();
$templatesSource = $currentTemplater->getTemplatesSource();
$templater = new umiTemplaterPHP($templatesSource);
$buffer = OutputBuffer::current('HTTPOutputBuffer');
$buffer->push($templater->render($result, 'news/inc/gallery'));
$buffer->end();
}

return $result;
}
</source>

В данном примере используется шаблон news/inc/gallery.
Лучше не передавать его снаружи из-за соображений безопасности. Либо делать это с большой осторожностью.

Пример вызова: http://localhost/news/getGallery/{page_id}/{page_number}/1/

Если в параметре $is_ajax истинное значение, то рендерится html.
Т.е. данный метод можно также использовать, как обычный макрос.

Оборачивание каждого символа в тег

2018-06-10T13:19:35Z

Lesnik512: Новая страница: « category:Верстка в XSLT '''Актуально для xslt-шаблонизатора''' Часто бывает нужно обернуть кажду…»

[[category:Верстка в XSLT]]

'''Актуально для xslt-шаблонизатора'''

Часто бывает нужно обернуть каждую цифру числа в какой-нибудь тег, например для анимации расличных счетчиков.

Сделать такое можно с помощью рекурсивного вызова внутри шаблона. Ниже пример реализации на XSLT:

<source lang="xml">
<xsl:template name="wrap-each-character">
<xsl:param name="string"/>
<xsl:if test="string-length($string) > 0">
<span><xsl:value-of select="substring($string,1,1)"/></span>
<xsl:call-template name="wrap-each-character">
<xsl:with-param name="string" select="substring($string,2)"/>
</xsl:call-template>
</xsl:if>
</xsl:template>
</source>

Тег span можно заменить на любой другой тег, который нужен.

Скрытие xml и json данных на umi-cms для неавторизованных пользователей

2018-06-10T12:08:39Z

Lesnik512: Новая страница: « category:Решение проблем и ошибок '''Актуально для версии 18.''' == Ограничение доступа к REST-пр…»

[[category:Решение проблем и ошибок]]

'''Актуально для версии 18.'''

== Ограничение доступа к REST-протоколам ==

Чтобы ограничить доступ к REST-протоколам udata, upage, uobject, usel и прочим, достаточно внести изменения в файл config.ini в корне сайта.

Например для доступа без ограничения к протоколу udata используется параметр:

<source lang="ini">
udata.http.allow = "1"
</source>

Чтобы ограничить, нужно заменить этот параметр на

<source lang="ini">
uobject.http.permissions = ""
</source>

Список возможных опций:

* admin - доступно только администраторам сайта (администратор - пользователь, имеющий доступ к администрированию хотя бы одного модуля).
* sv - доступно только супервайзерам.
* auth - доступно только авторизованным пользователям.

Для остальных протоколов используются аналогичные параметры. Пример с одного моего личного сайта:

<source lang="ini">
uobject.http.permissions = "admin"
udata.http.permissions = "admin"
upage.http.permissions = "admin"
</source>

==Ограничение доступа к xml и json данным ({url}.xml или {url}.json)==

К сожалению для решения данной задачи нет параметров в config.ini.

Для решения задачи нужно перехватывать событие отправки страницы в буфер, т.е. до отправки данных пользователю.

Для начала нужно в файле config.ini включить отслеживание этого события:

<source lang="ini">
buffer-send-event-enable = "1"
</source>

Перехватка события (файл events.php в папке classes/modules/content шаблона, или custom_events.php в системной папке модуля):

<source lang="php">
new umiEventListener('systemBufferSend', 'content', 'object_redirect');
</source>

Права на доступ к макросу (permissions.php или permissions_custom.php):

<source lang="php">
$permissions= Array(
'content' => array('object_redirect')
);
</source>

Сам макрос (в class.php или custom.php, закрывает доступ для всех, кроме суперюзера):
<source lang="php">
public function object_redirect(iUmiEventPoint $oEventPoint) {
if ($oEventPoint->getMode() === "before") {
$buffer = outputBuffer::current();
$hierarchy = umiHierarchy::getInstance();
$path = getServer('REQUEST_URI');
$permsCol = permissionsCollection::getInstance();
$isSV = $permsCol->isSv();
if (strpos($path, '.xml') !== false && !strpos($path, 'sitemap.xml') && !$isSV) {
$path = str_replace('.xml','',$path);
$buffer->status('301 Moved Permanently');
$buffer->redirect($path);
}
if (strpos($path, '.json') !== false && !$isSV) {
$path = str_replace('.json','',$path);
$buffer->status('301 Moved Permanently');
$buffer->redirect($path);
}
}
return true;
}
</source>

Карта сайта xml: кастомизация обновления

2018-06-04T18:29:18Z

Lesnik512: Новая страница: « category:Написание кастомных макросов Может понадобиться управлять механизмом обновлени…»

[[category:Написание кастомных макросов]]

Может понадобиться управлять механизмом обновления некоторых страниц карты сайта.
Не так давно появилась новая стандартная точка вызова before_update_sitemap, которой нет в документации.

Механизм назначения обработчика подробно описан в разделе [http://api.docs.umi-cms.ru/razrabotka_nestandartnogo_funkcionala/sobytijnaya_model_umicms/ Событийная модель UMI.CMS]

Точки вызова before_update_sitemap:
Вызывается при подготовке глобальных переменных
режим: before
параметры:
(int) id - id страницы
параметры-ссылки:
(bool) &robots_deny - запрет для отображения в карте сайта
(string) &link - ссылка страницы

Пример обработчика:

public function update_sitemap(iUmiEventPoint $oEventPoint) {
if ($oEventPoint->getMode() === "before") {
$link = &$oEventPoint->getRef('link');
$robots_deny = &$oEventPoint->getRef('robots_deny');
@$page_id = &$oEventPoint->getParam('id');
$page = $page_id ? umiHierarchy::getInstance()->getElement($page_id) : false;
if (!$page instanceof umiHierarchyElement) return true;
//
// исключаем из карты сайта все комментарии
if ($page->getModule() == 'comments') $robots_deny = true;
//
// на сайте используются модифицированные адреса объектов каталога
if ($page->getMethod() == 'object') {
$link = '{your_domain}' . $page->getAltName() . '/';
}
}
return true;
}