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

Пример написания манифеста для модуля

2018-04-26T11:00:59Z

Ekaterina.ermohina:

[[category:Вопросы и уроки разработки сайтов на UMI.CMS]]

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

Начиная с 16 версии в UMI.CMS появились [[http://api.docs.umi-cms.ru/razrabotka_nestandartnogo_funkcionala/manifesty/ манифесты]].

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

Например, сам модуль будет называться mailer.
Структура файлов у нас будет следующая:
<source lang="php">
/classes/components/mailer/manifest/install.xml
/classes/components/mailer/manifest/update.xml
/classes/components/mailer/manifest/actions/SendMail.php
</source>
В файл install.xml мы добавим следующий код:
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<manifest>
<route>
<transaction name="send_mail_on_install">
<action name="\UmiCms\Manifest\Mail\SendMail" />
</transaction>
</route>
</manifest>
</source>

В файл update.xml добавляем код:
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<manifest>
<route>
<transaction name="send_mail_on_update">
<action name="\UmiCms\Manifest\Mail\SendMail" />
</transaction>
</route>
</manifest>
</source>

В файл SendMail.php добавим:
<source lang="php">
<?php
namespace UmiCms\Manifest\Mail;

class SendMailAction extends \Action
{
public function __construct($name, array $params = []) {
parent::__construct($name, $params);
}

public function execute()
{
$lMail = new \umiMail;
$lMail->addRecipient("recipient@example.com", "Testing");
$lMail->setFrom("from@example.com", "Testing");
$lMail->setSubject("Обновление CMS");
$lMail->setPriorityLevel("highest");
$lMail->setContent("Обновление завершено");
$lMail->commit();
$lMail->send();

return $this;
}

public function rollback()
{
return $this;
}
}
</source>

В данном файле в строке <source lang="php">$lMail->addRecipient("recipient@example.com", "Testing");</source> recipient@example.com необходимо заменить на адрес получателя,
а в строке <source lang="php">$lMail->setFrom("from@example.com", "Testing");</source> from@example.com заменить на заголовок From письма.

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

Для этого создадим файл manifest_checker.php в корне сайта и добавим в него следующий код:

<source lang="php">
<?php
include 'standalone.php';

$manifest = \UmiCms\Service::ManifestFactory()
->createByModule('update', ‘mail’);

do {
$manifest->execute();
} while (!$manifest->isReady());

foreach ($manifest->getLog() as $message) {
echo $message, PHP_EOL;
}
</source>

Первый аргумент в методе createByModule это тип манифеста (install или update), а второй аргумент — имя вашего модуля.

После этого вызываем файл example.com/manifest_checker.php, манифесты выполняются вручную и отображаются на экране.

Подключение к нескольким базам данных

2018-04-25T10:40:59Z

Ekaterina.ermohina:

<b>Актуально для версии 2.18.</b>

Если при выполнении вашего кастомного php-кода необходимо выполнить подключение к другой базе данных для выборки необходимых данных, то это можно сделать двумя способами.
<h4><b>Способ 1. Добавить новое соединение в config.ini</b>:</h4>
Для добавления нового соединения с базой данных необходимо добавить в секцию [connections] файла config.ini данные для подключения к базе данных.
Подключение к основной базе данных системы называется "core".
Если назвать наше дополнительное подключение "other", то секция [connections] в файле config.ini будет выглядеть, например, вот так:
<source lang="ini">
[connections]
#основное подключение к бд
core.type = "mysql"
core.host = "localhost"
core.login = "umi"
core.password = "umi"
core.dbname = "umi"
core.port =
core.persistent = "0"
core.compression = "0"
core.api = "mysql"
#дополнительное подключение к бд
other.type = "mysql"
other.host = "localhost"
other.login = "umi"
other.password = "umi"
other.dbname = "other"
other.port =
other.persistent = "0"
other.compression = "0"
other.api = "mysql"
</source>
Дополнительное подключение в кастомном методе можно будет получить следующим образом:
<source lang="php">
$pool = ConnectionPool::getInstance();
$conn = $pool->getConnection("other");
</source>

<h4><b>Способ 2. Создать новое соединение в кастомном методе</b>:</h4>
С помощью класса ConnectionPool, который расположен в файле '''\classes\system\subsystems\database\ConnectionPool.php''' можно создать новое подключение.

Далее будет приведен пример кода, который осуществляет подключение к основной и второй базам данных, происходит выборка из второй базы данных, после чего на основании полученных данных создается страница типа "Новость":
<source lang="php">
$pool = ConnectionPool::getInstance();
//основная база данных
$pool->addConnection("core", "localhost", "umi", "umi", "umi");
//вторая база данных
$pool->addConnection("comfort", "localhost", "umi", "umi", "comfort");
$pool->init();

$conn = $pool->getConnection('comfort');
$sql = "SELECT alt_name FROM `cms3_hierarchy` WHERE `id` = 72";
//выполнение запроса к второй базе данных
$result = $conn->query($sql, true);
list($name) = mysql_fetch_row($result);

//Создание новости с помощью API в основной базе
$hierarchyTypes = umiHierarchyTypesCollection::getInstance();
$hierarchyType = $hierarchyTypes->getTypeByName("news", "item");
$hierarchyTypeId = $hierarchyType->getId();

$hierarchy = umiHierarchy::getInstance();

//add new element
$newElementId = $hierarchy->addElement(0, $hierarchyTypeId, $name, 'umitest');
if($newElementId === false) {
echo "Не удалось создать новую страницу";
}

//Установим права на страницу в состояние "по умолчанию"
$permissions = permissionsCollection::getInstance();
$permissions->setDefaultPermissions($newElementId);

//Получим экземпляр страницы
$newElement = $hierarchy->getElement($newElementId);

if($newElement instanceof umiHierarchyElement) {
$newElement->setValue("h1", 'umitest');
$newElement->setValue("publish_time", time());
$newElement->setIsActive(true);
$newElement->commit();

echo "Успешно создана страница с адресом: \"", $hierarchy->getPathById($newElementId), "\"";
} else {
echo "Не удалось получить экземпляр страницы #{$newElementId}.";
}
</source>
[[Категория:API]]

Подключение к нескольким базам данных

2018-04-25T10:40:35Z

Ekaterina.ermohina:

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

Если при выполнении вашего кастомного php-кода необходимо выполнить подключение к другой базе данных для выборки необходимых данных, то это можно сделать двумя способами.
<h4><b>Способ 1. Добавить новое соединение в config.ini</b>:</h4>
Для добавления нового соединения с базой данных необходимо добавить в секцию [connections] файла config.ini данные для подключения к базе данных.
Подключение к основной базе данных системы называется "core".
Если назвать наше дополнительное подключение "other", то секция [connections] в файле config.ini будет выглядеть, например, вот так:
<source lang="ini">
[connections]
#основное подключение к бд
core.type = "mysql"
core.host = "localhost"
core.login = "umi"
core.password = "umi"
core.dbname = "umi"
core.port =
core.persistent = "0"
core.compression = "0"
core.api = "mysql"
#дополнительное подключение к бд
other.type = "mysql"
other.host = "localhost"
other.login = "umi"
other.password = "umi"
other.dbname = "other"
other.port =
other.persistent = "0"
other.compression = "0"
other.api = "mysql"
</source>
Дополнительное подключение в кастомном методе можно будет получить следующим образом:
<source lang="php">
$pool = ConnectionPool::getInstance();
$conn = $pool->getConnection("other");
</source>

<h4><b>Способ 2. Создать новое соединение в кастомном методе</b>:</h4>
С помощью класса ConnectionPool, который расположен в файле '''\classes\system\subsystems\database\ConnectionPool.php''' можно создать новое подключение.

Далее будет приведен пример кода, который осуществляет подключение к основной и второй базам данных, происходит выборка из второй базы данных, после чего на основании полученных данных создается страница типа "Новость":
<source lang="php">
$pool = ConnectionPool::getInstance();
//основная база данных
$pool->addConnection("core", "localhost", "umi", "umi", "umi");
//вторая база данных
$pool->addConnection("comfort", "localhost", "umi", "umi", "comfort");
$pool->init();

$conn = $pool->getConnection('comfort');
$sql = "SELECT alt_name FROM `cms3_hierarchy` WHERE `id` = 72";
//выполнение запроса к второй базе данных
$result = $conn->query($sql, true);
list($name) = mysql_fetch_row($result);

//Создание новости с помощью API в основной базе
$hierarchyTypes = umiHierarchyTypesCollection::getInstance();
$hierarchyType = $hierarchyTypes->getTypeByName("news", "item");
$hierarchyTypeId = $hierarchyType->getId();

$hierarchy = umiHierarchy::getInstance();

//add new element
$newElementId = $hierarchy->addElement(0, $hierarchyTypeId, $name, 'umitest');
if($newElementId === false) {
echo "Не удалось создать новую страницу";
}

//Установим права на страницу в состояние "по умолчанию"
$permissions = permissionsCollection::getInstance();
$permissions->setDefaultPermissions($newElementId);

//Получим экземпляр страницы
$newElement = $hierarchy->getElement($newElementId);

if($newElement instanceof umiHierarchyElement) {
$newElement->setValue("h1", 'umitest');
$newElement->setValue("publish_time", time());
$newElement->setIsActive(true);
$newElement->commit();

echo "Успешно создана страница с адресом: \"", $hierarchy->getPathById($newElementId), "\"";
} else {
echo "Не удалось получить экземпляр страницы #{$newElementId}.";
}
</source>
[[Категория:API]]

Подключение к нескольким базам данных

2018-04-25T10:39:59Z

Ekaterina.ermohina:

Если при выполнении вашего кастомного php-кода необходимо выполнить подключение к другой базе данных для выборки необходимых данных, то это можно сделать двумя способами.
<h4><b>Способ 1. Добавить новое соединение в config.ini</b>:</h4>
Для добавления нового соединения с базой данных необходимо добавить в секцию [connections] файла config.ini данные для подключения к базе данных.
Подключение к основной базе данных системы называется "core".
Если назвать наше дополнительное подключение "other", то секция [connections] в файле config.ini будет выглядеть, например, вот так:
<source lang="ini">
[connections]
#основное подключение к бд
core.type = "mysql"
core.host = "localhost"
core.login = "umi"
core.password = "umi"
core.dbname = "umi"
core.port =
core.persistent = "0"
core.compression = "0"
core.api = "mysql"
#дополнительное подключение к бд
other.type = "mysql"
other.host = "localhost"
other.login = "umi"
other.password = "umi"
other.dbname = "other"
other.port =
other.persistent = "0"
other.compression = "0"
other.api = "mysql"
</source>
Дополнительное подключение в кастомном методе можно будет получить следующим образом:
<source lang="php">
$pool = ConnectionPool::getInstance();
$conn = $pool->getConnection("other");
</source>

<h4><b>Способ 2. Создать новое соединение в кастомном методе</b>:</h4>
С помощью класса ConnectionPool, который расположен в файле '''\classes\system\subsystems\database\ConnectionPool.php''' можно создать новое подключение.

Далее будет приведен пример кода, который осуществляет подключение к основной и второй базам данных, происходит выборка из второй базы данных, после чего на основании полученных данных создается страница типа "Новость":
<source lang="php">
$pool = ConnectionPool::getInstance();
//основная база данных
$pool->addConnection("core", "localhost", "umi", "umi", "umi");
//вторая база данных
$pool->addConnection("comfort", "localhost", "umi", "umi", "comfort");
$pool->init();

$conn = $pool->getConnection('comfort');
$sql = "SELECT alt_name FROM `cms3_hierarchy` WHERE `id` = 72";
//выполнение запроса к второй базе данных
$result = $conn->query($sql, true);
list($name) = mysql_fetch_row($result);

//Создание новости с помощью API в основной базе
$hierarchyTypes = umiHierarchyTypesCollection::getInstance();
$hierarchyType = $hierarchyTypes->getTypeByName("news", "item");
$hierarchyTypeId = $hierarchyType->getId();

$hierarchy = umiHierarchy::getInstance();

//add new element
$newElementId = $hierarchy->addElement(0, $hierarchyTypeId, $name, 'umitest');
if($newElementId === false) {
echo "Не удалось создать новую страницу";
}

//Установим права на страницу в состояние "по умолчанию"
$permissions = permissionsCollection::getInstance();
$permissions->setDefaultPermissions($newElementId);

//Получим экземпляр страницы
$newElement = $hierarchy->getElement($newElementId);

if($newElement instanceof umiHierarchyElement) {
$newElement->setValue("h1", 'umitest');
$newElement->setValue("publish_time", time());
$newElement->setIsActive(true);
$newElement->commit();

echo "Успешно создана страница с адресом: \"", $hierarchy->getPathById($newElementId), "\"";
} else {
echo "Не удалось получить экземпляр страницы #{$newElementId}.";
}
</source>
[[Категория:API]]

Не принимается лицензионный ключ

2018-02-02T10:39:11Z

Ekaterina.ermohina:

Скорее всего, у вас поменялся IP-адрес (например, вы сменили хостинг-провайдера или сервер). Обратитесь к нам со страницы поддержки (http://www.umi-cms.ru/support/) с просьбой снять привязку лицензионного ключа и активировать его на домене с новым ip, с объяснением причины сброса привязки.

Если привязка сброшена, но Ваш лицензионный ключ не принимается - попробуйте выполнить следующие действия
<br /><br />
1. '''Очистите''' содержимое папки '''кэш'''
* Папка ''"~/sys-temp/runtime-cache/"'' - для системы версии от 2.8.X
* Папка ''"~/cache/"'' или содержимое в файле ''"~/cache/engine/"'' - для системы версии 2.7.X или ниже
<br />
2. '''Проставьте права''' "755" на все директории, находящиеся в корне
<br /><br />
3. Проверьте таблицу '''cms3_domains''' (должен быть записан домен, где вводится ключ) в БД
<br /><br />
4. Установите на папки "'''/errors/'''" и "'''/sys-temp/runtime-cache/'''" права '''777''' или '''755''' (рекурсивно)
<br /><br />
5. '''Удалите''' значение (val) записи с именем (var) 'keycode', в таблице 'cms_reg'
<br /><br />
6. Если версия системы 2.8.X попробуйте '''отключить кэш''' в файле ''"config.ini"''. Оставьте в строке engine пустые кавычки
<source lang="ini">
[cache]
engine = ""
</source>
7. При ошибке о невозможности загрузить '''тесты хостинга''', проверьте есть ли еще '''свободное место''' у Вас на FTP, если есть, то попробуйте 4 пункт.

8. Если сайт работает по защищенному протоколу, в настройках браузера перейти на '''незащищенное соединение'''.

9. Проверить соответствие '''версии PHP системным требованиям'''.
* Перед каждой новой попыткой ввода ключа рекомендуем очищать папку кэш (1 пункт).

[[category:Лицензионные ключи]][[Категория:Решение проблем и ошибок]]

Повторение ранее совершенного заказа

2018-01-14T12:38:32Z

Ekaterina.ermohina:

'''Актуально для версии 2.17'''<br/><br/>
'''Задача:''' Реализовать возможность повторного оформления заказа<br/><br/>
'''Реализация:''' <br/>
В данной статье описан пример кастомного макроса, с помощью которого можно повторить ранее совершенный заказ, т.е. одним кликом перенести его в текущею корзину и оформить заказ.

С версии 14 (2.14) UMI.CMS поддерживает работу на php версии 7. Ядро поддерживает работу на любой версии php от 5.4, а для модулей есть отдельный набор реализаций, поддерживающих 7. Старый набор реализаций модулей находится в директории /classes/modules, а новый в /classes/components.

Для подключения нового набора реализаций на версиях PHP до PHP 7.*.* необходимо в файле config.ini включить опцию [http://dev.docs.umi-cms.ru/nastrojka_sistemy/dostupnye_sekcii/sekciya_system/#sel=103:1,103:3 compatible-modules]

Если вы используете новую реализацию модулей, то код метода repeatOrder необходимо добавить в файл
'''/classes/components/emarket/customMacros.php''':
<source lang="php">
public function repeatOrder() {

$permissions = permissionsCollection::getInstance();
$userId = $permissions->getUserId();
$objects = umiObjectsCollection::getInstance();
$order_id = (int) getRequest('param0');
$order = $objects->getObject($order_id);

if (!$order || $order->customer_id != $userId) {
$referer = getServer('HTTP_REFERER');
$this->module->redirect($referer);
}

$orderItems = $order->order_items;

if (is_array($orderItems)) {
$_REQUEST['no-redirect'] = 1;
$this->module->basket('remove_all');

foreach ($orderItems as $orderItemId) {

$orderItem = orderItem::get($orderItemId);

if ($orderItem) {
$element = $orderItem->getItemElement();
if ($element) {

$element_id = $element->getId();
$_REQUEST['no-redirect'] = 1;

$_REQUEST['amount'] = $orderItem->getAmount();

$options_arr = array();
foreach ($orderItem->options as $item) {
$index = $item['varchar'];
$options_arr[$index] = $item['rel'];
}

if (count($options_arr)) {
$_REQUEST['options'] = $options_arr;
}
$_REQUEST['redirect-uri'] = '';
$this->module->basket('put', 'element', $element_id);
}
}
}

}

$referer = getServer('HTTP_REFERER');
$this->module->redirect($referer);
}
</source>

Если вы используете старую реализацию модулей, то код метода repeatOrder необходимо добавить в файл
'''/classes/modules/emarket/__custom.php''':
<source lang="php">
public function repeatOrder() {
$permissions = permissionsCollection::getInstance();
$userId = $permissions->getUserId();
$objects = umiObjectsCollection::getInstance();
$order_id = (int) getRequest('param0');
$order = $objects->getObject($order_id);

if (!$order || $order->customer_id != $userId) {
$referer = getServer('HTTP_REFERER');
$this->redirect($referer);
}
$orderItems = $order->order_items;

if (is_array($orderItems)) {
$_REQUEST['no-redirect'] = 1;
$this->basket('remove_all');

foreach ($orderItems as $orderItemId) {

$orderItem = orderItem::get($orderItemId);

if ($orderItem) {
$element = $orderItem->getItemElement();
if ($element) {

$element_id = $element->getId();
$_REQUEST['no-redirect'] = 1;

$_REQUEST['amount'] = $orderItem->getAmount();

$options_arr = array();
foreach ($orderItem->options as $item) {
$index = $item['varchar'];
$options_arr[$index] = $item['rel'];
}
if (count($options_arr))
$_REQUEST['options'] = $options_arr;
$_REQUEST['redirect-uri'] = '';
$this->basket('put', 'element', $element_id);
}
}
}

}
$referer = getServer('HTTP_REFERER');
$this->redirect($referer);
}
</source>

В той же папке необходимо добавить файл '''permissions.custom.php''' следующего содержания:
<source lang="php">
<?php
$permissions = array('purchasing' => array('repeatOrder'));
?>
</source>

<h2>TPL-шаблонизатор</h2>
В шаблоне '''tpls/emarket/default.tpl''', должны быть примерно следующие блоки:
<pre>
$FORMS['personal'] = <<<END
%emarket ordersList()%
END;

$FORMS['orders_block'] = <<<END
<p>Список ваших заказов:</p>
<ul>
%items%
</ul>
END;

$FORMS['orders_block_empty'] = <<<END
<p>Заказов нет</p>
END;

$FORMS['orders_item'] = <<<END
<li>%name% <a href="/emarket/repeatOrder/%id%/">Повторить</a></li>
END;
</pre>

Когда пользователь зайдет в личный кабинет Интернет-магазина по ссылке: _http://sait.ru/emarket/personal/ , он увидит список заказов возле которых будет ссылка '''Повторить'''. Кликнув по ссылке Повторить, в текущею корзину товаров добавятся товары из ранее совершенного заказа, с сохранением количества товара и опционных свойств.
<h2>XSLT-шаблонизатор</h2>
В демонстрационном дизайне "Современный интернет-магазин" ("demodizzy") в файле \templates\demodizzy\xslt\modules\emarket\orders-list.xsl в шаблон <xsl:template match="udata[@module = 'emarket'][@method = 'order']"> для вывода ссылки на повторения ранее совершенного заказа можно воспользоваться следующей конструкцией:
<source lang="xml">
<a href="/emarket/repeatOrder/{@id}/">Повторить</a>
</source>
[[Категория:Модуль Интернет магазин]]

Как выводить Last Modified

2018-01-10T14:16:31Z

Ekaterina.ermohina:

Как выводить Last-Modified?

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

В актуальной версии системы для вывода Last-Modified используйте директиву [http://dev.docs.umi-cms.ru/nastrojka_sistemy/dostupnye_sekcii/sekciya_seo/#sel=9:1,9:3 calculate-last-modified = 1] в файле config.ini

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

Попробуйте добавить следующий код в ~/classes/modules/custom.php сразу после строки

<source lang="php">
//TODO: Write your own macroses here
</source>

<source lang="php">
public function lastMDF() {
$LastModified_unix = 1294844676; // время последнего изменения страницы
$LastModified = gmdate("D, d M Y H:i:s \G\M\T", $LastModified_unix);
$IfModifiedSince = false;
if (isset($_ENV['HTTP_IF_MODIFIED_SINCE']))
$IfModifiedSince = strtotime(substr($_ENV['HTTP_IF_MODIFIED_SINCE'], 5));
if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE']))
$IfModifiedSince = strtotime(substr($_SERVER['HTTP_IF_MODIFIED_SINCE'], 5));
if ($IfModifiedSince && $IfModifiedSince > $LastModified_unix) {
header($_SERVER['SERVER_PROTOCOL'] . ' 304 Not Modified');
exit;
}
header('Last-Modified: '. $LastModified);
$header = '<meta http-equiv="Last-Modified" content="'.gmdate("D, d M Y H:i:s").' GMT" />';
return $header;
}
</source>

Регистрировать его нигде не нужно.

Пример использования:

Вставляете следующий макрос в шаблоне .tpl в тэге <head>

<source lang="text">
%custom lastMDF()%
</source>

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

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

Как выводить Last Modified

2018-01-10T14:15:59Z

Ekaterina.ermohina:

Как выводить Last-Modified?

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

В актуальной версии системы для вывода Last-Modified используйте директиву [http://dev.docs.umi-cms.ru/nastrojka_sistemy/dostupnye_sekcii/sekciya_seo/#sel=9:1,9:3 calculate-last-modified = 1] в файле config.ini

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

Попробуйте добавить следующий код в ~/classes/modules/custom.php сразу после строки

<source lang="php">
//TODO: Write your own macroses here
</source>

<source lang="php">
public function lastMDF() {
$LastModified_unix = 1294844676; // время последнего изменения страницы
$LastModified = gmdate("D, d M Y H:i:s \G\M\T", $LastModified_unix);
$IfModifiedSince = false;
if (isset($_ENV['HTTP_IF_MODIFIED_SINCE']))
$IfModifiedSince = strtotime(substr($_ENV['HTTP_IF_MODIFIED_SINCE'], 5));
if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE']))
$IfModifiedSince = strtotime(substr($_SERVER['HTTP_IF_MODIFIED_SINCE'], 5));
if ($IfModifiedSince && $IfModifiedSince > $LastModified_unix) {
header($_SERVER['SERVER_PROTOCOL'] . ' 304 Not Modified');
exit;
}
header('Last-Modified: '. $LastModified);
$header = '<meta http-equiv="Last-Modified" content="'.gmdate("D, d M Y H:i:s").' GMT" />';
return $header;
}
</source>

Регистрировать его нигде не нужно.

Пример использования:

Вставляете следующий макрос в шаблоне .tpl в тэге <head>

<source lang="text">
%custom lastMDF()%
</source>

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

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

Как выводить Last Modified

2018-01-10T14:14:56Z

Ekaterina.ermohina:

Как выводить Last-Modified?

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

Нижеуказанный код можно использовать в старых версиях системы.
В актуальной версии системы для вывода Last-Modified используйте директиву [http://dev.docs.umi-cms.ru/nastrojka_sistemy/dostupnye_sekcii/sekciya_seo/#sel=9:1,9:3 calculate-last-modified = 1] в файле config.ini

Попробуйте добавить следующий код в ~/classes/modules/custom.php сразу после строки

<source lang="php">
//TODO: Write your own macroses here
</source>

<source lang="php">
public function lastMDF() {
$LastModified_unix = 1294844676; // время последнего изменения страницы
$LastModified = gmdate("D, d M Y H:i:s \G\M\T", $LastModified_unix);
$IfModifiedSince = false;
if (isset($_ENV['HTTP_IF_MODIFIED_SINCE']))
$IfModifiedSince = strtotime(substr($_ENV['HTTP_IF_MODIFIED_SINCE'], 5));
if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE']))
$IfModifiedSince = strtotime(substr($_SERVER['HTTP_IF_MODIFIED_SINCE'], 5));
if ($IfModifiedSince && $IfModifiedSince > $LastModified_unix) {
header($_SERVER['SERVER_PROTOCOL'] . ' 304 Not Modified');
exit;
}
header('Last-Modified: '. $LastModified);
$header = '<meta http-equiv="Last-Modified" content="'.gmdate("D, d M Y H:i:s").' GMT" />';
return $header;
}
</source>

Регистрировать его нигде не нужно.

Пример использования:

Вставляете следующий макрос в шаблоне .tpl в тэге <head>

<source lang="text">
%custom lastMDF()%
</source>

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

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

Как выводить Last Modified

2018-01-10T14:11:39Z

Ekaterina.ermohina:

Как выводить Last-Modified?

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

Нижеуказанный код устарел и представлен только как пример реализации подобного функционала.
Для вывода Last-Modified используйте директиву [http://dev.docs.umi-cms.ru/nastrojka_sistemy/dostupnye_sekcii/sekciya_seo/#sel=9:1,9:3 calculate-last-modified = 1] в файле config.ini

Попробуйте добавить следующий код в ~/classes/modules/custom.php сразу после строки

<source lang="php">
//TODO: Write your own macroses here
</source>

<source lang="php">
public function lastMDF() {
$LastModified_unix = 1294844676; // время последнего изменения страницы
$LastModified = gmdate("D, d M Y H:i:s \G\M\T", $LastModified_unix);
$IfModifiedSince = false;
if (isset($_ENV['HTTP_IF_MODIFIED_SINCE']))
$IfModifiedSince = strtotime(substr($_ENV['HTTP_IF_MODIFIED_SINCE'], 5));
if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE']))
$IfModifiedSince = strtotime(substr($_SERVER['HTTP_IF_MODIFIED_SINCE'], 5));
if ($IfModifiedSince && $IfModifiedSince > $LastModified_unix) {
header($_SERVER['SERVER_PROTOCOL'] . ' 304 Not Modified');
exit;
}
header('Last-Modified: '. $LastModified);
$header = '<meta http-equiv="Last-Modified" content="'.gmdate("D, d M Y H:i:s").' GMT" />';
return $header;
}
</source>

Регистрировать его нигде не нужно.

Пример использования:

Вставляете следующий макрос в шаблоне .tpl в тэге <head>

<source lang="text">
%custom lastMDF()%
</source>

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

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

Использование модуля GeoIP в PHP-шаблоне

2018-01-10T13:26:09Z

Ekaterina.ermohina:

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

== Общая информация ==
:Модуль [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]] возвращает данные об IP-адресе посетителя, такие, как страна, область, город, широта и долгота.

:Что бы воспользоваться данным функционалом необходимо проверить его наличие. Если, после авторизации на сайте под логином супервайзера, в модулях отсутствует иконка [[Изображение: geoip.png]] - это значит что данный модуль еще не установлен на Вашей системе.

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

== XML ==
:Если открыть исходный XML страницы, можно увидеть узел, добавленный модулем [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]]:

<source lang="xml">
<geo>
<country>Россия</country>
<region>Санкт-Петербург</region>
<city>Санкт-Петербург</city>
<latitude>59.93863</latitude>
<longitude>30.31413</longitude>
</geo>
</source>

== Примеры использования ==
:Приведу простые для восприятия примеры использования [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]] и PHP

=== Вывод на странице страны, города, широты и долготы ===
:Если в начале страницы шаблона есть теги <?php ?>, то нижеследующий код необходимо добавить между данными тегами.
Если данных тегов нет, от необходимо добавить их в начале страницы. В итоге должно получиться примерно следующим образом

<?php
$country = $variables['user']['geo']['country']; // Страна
$region = $variables['user']['geo']['region']; // Регион
$city = $variables['user']['geo']['city']; // Город
$latitude = $variables['user']['geo']['latitude']; // Широта
$longitude = $variables['user']['geo']['longitude']; // Долгота
?>

затем добавим в файл шаблона вывод данных [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]]:

<<nowiki />ul>
<<nowiki />li><?= $country?></li>
<<nowiki />li><?= $region?></li>
<<nowiki />li><?= $city?></li>
<<nowiki />li><?= $latitude?></li>
<<nowiki />li><?= $longitude?></li>
</ul>

=== Вывод текста в зависимости от страны ===
:Выведем сообщение, если IP не российский
Нижеуказанный код необходимо добавить на Вашу страницу в том месте, где Вы хотите отображать сообщение:

<?php if($country == "Россия"): ?>
<span>Приветствую вас на моём сайте!</span>
<?php else: ?>
<span>Sorry, available only from Russia</span>
<?php endif ?>

=== [[http://ru.wikipedia.org/wiki/Google_Maps GoogleMaps]] ===
:Так же можно отобразить точку на карте [[http://ru.wikipedia.org/wiki/Google_Maps GoogleMaps]], используя широту и долготу.

==== Статическая карта ====
Необходимо в начале файла, где мы ранее добавляли переменные, указать еще одну переменную:

$googleMaps = "https://maps.googleapis.com/maps/api/staticmap?center={$latitude},{$longitude}&markers={$latitude},{$longitude}&zoom=9&size=400x400";

Затем, добавить в место, где Вы хотите видеть вывод карты код:

<img alt="GoogleMaps" src=<?= $googleMaps?> />

:Вот как будет выглядеть карта:

[[Изображение: 59.950_30.316.gif]]

[[Категория:Модуль_GeoIP]]

Использование модуля GeoIP в PHP-шаблоне

2018-01-10T12:44:15Z

Ekaterina.ermohina: Новая страница: «'''Актуально для версии 2.17''' == Общая информация == :Модуль [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/…»

Использование модуля GeoIP в XSLT-шаблоне

2018-01-10T12:25:50Z

Ekaterina.ermohina:

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

== Общая информация ==
:Модуль [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]] возвращает данные об IP-адресе посетителя, такие, как страна, область, город, широта и долгота.

:Что бы воспользоваться данным функционалом необходимо проверить его наличие. Если, после авторизации на сайте под логином супервайзера, в модулях отсутствует иконка [[Изображение: geoip.png]] - это значит что данный модуль еще не установлен на Вашей системе.

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

== XML ==
:Если открыть исходный XML страницы, можно увидеть узел, добавленный модулем [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]]:

<source lang="xml">
<geo>
<country>Россия</country>
<region>Санкт-Петербург</region>
<city>Санкт-Петербург</city>
<latitude>59.93863</latitude>
<longitude>30.31413</longitude>
</geo>
</source>

== Примеры использования ==
:Приведу простые для восприятия примеры использования [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]] и XSLT

=== Вывод на странице страны и города ===
:Выведем в отдельном блоке страну и город пользователя. В файле \templates\demodizzy\xslt\layouts\default.xsl добавим вызов шаблона:

<source lang="xml">
<xsl:apply-templates select="result/user/geo" />
</source>

и после основного шаблона добавим шаблон вызова [[http://help.docs.umi-cms.ru/rabota_s_modulyami/modul_geo_ip/ GeoIP]]:

<source lang="xml">
<xsl:template match="geo">
<div class="infoblock">
<ul>
<li>
<xsl:text>Страна: </xsl:text>
<xsl:value-of select="country"/>
</li>
<li>
<xsl:text>Город: </xsl:text>
<xsl:value-of select="city" />
</li>
</ul>
</div>
</xsl:template>
</source>

=== Вывод текста в зависимости от страны ===
:Выведем сообщение, если IP не российский:

<source lang="xml">
<xsl:template match="geo">
<xsl:choose>
<xsl:when test="country = 'Россия'">
<xsl:text>Приветствую вас на моём сайте!</xsl:text>
<xsl:apply-templates select="/" />
</xsl:when>
<xsl:otherwise>
<xsl:text>Sorry, available only from Russia</xsl:text>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
</source>

=== [[http://ru.wikipedia.org/wiki/Google_Maps GoogleMaps]] ===
:Так же можно отобразить точку на карте [[http://ru.wikipedia.org/wiki/Google_Maps GoogleMaps]], используя широту и долготу.

==== Статическая карта ====
<source lang="xml">
<xsl:variable name="lat" select="result/user/geo/latitude" />
<xsl:variable name="long" select="result/user/geo/longitude" />
<xsl:variable name="link" select="concat('https://maps.googleapis.com/maps/api/staticmap?center=
', $lat, ',', $long, '&markers=', $lat, ',', $long, '&zoom=9&size=400x400')" />
</source>

:Вот как будет выглядеть карта:

[[Изображение: 59.950_30.316.gif]]

[[Категория:Верстка в XSLT]][[Категория:Модуль_GeoIP]]