Просмотр исходного текста страницы Получение значений полей страницы до и после её изменения

'''Актуально для 2.9.5.'''

----
<p>В некоторых случаях может потребоваться информация о внесенных изменениях при редактировании страницы, например необходимо выполнять какие-либо действия при изменении определенного поля или может потребоваться вести логирование действий пользователя или в целях безопасности игнорировать внесение изменений в определенные поля и т.п.</p>

<p>В этих случаях нам необходимо использовать событие на изменение страницы:</p>
<source lang="text">
systemModifyElement 
 Вызывается при сохранении изменений страницы в админке
</source>
<p>Данное событие, несмотря на описание в документации, умеет работать в двух режимах '''Before''' (До) и '''After''' (После) передавая при этом ID пользователя, который редактирует страницу и ссылку на редактируемую страницу.</p>

<p>Так как для каждого режима события вызывается повторно, то чтобы сохранить  для последующего сравнения значение '''ДО''' внесенных изменений необходимо объявить '''статическую переменную''', в которой сохранить значение в режиме '''Before'''.</p>
<source lang="php" line start="1">
public function customMethod(iUmiEventPoint $e) {
    static $altNameStaticBefore;
    if ($e->getMode() == "before") {            
        $element  = $e->getRef('element');
	// получаем umiHierarchyElement, либо false, если страница не существует
	if (!$element instanceof umiHierarchyElement) {
	    return false;
	}

        $altNameStaticBefore = $element->altName;
    }
</source>
<p>Стоит заметить, что если получаемое поле принадлежит объекту, а не странице, то получать его нужно у объекта. Так, поле ''alt_name'' (псевдостатический адрес) свойственно только странице, однако поле ''name'', хотя и присутствует у получаемой страницы, но проверять данное поле на изменения необходимо у объекта.</p>
<source lang="php" line start="14">
$objId =  $element->objectId;
$elementObject = umiObjectsCollection::getInstance()->getObject($objId);
$nameStaticBefore = $elementObject->getName();
</source>
<p>Производить сравнение необходимо в режиме '''After''', вновь получая это же поле, но уже с новыми данными:</p>
<source lang="php" line start="18">
    elseif ($e->getMode() == "after") {            
        $element  = $e->getRef('element');
	// получаем umiHierarchyElement, либо false, если страница не существует
	if (!$element instanceof umiHierarchyElement) {
	    return false;
	}

        $objId =  $element->objectId;
        $elementObject = umiObjectsCollection::getInstance()->getObject($objId);
        $nameAfter = $elementObject->getName();

        if ($nameStaticBefore != $nameAfter) {
            // Here your logic
        }
    }
</source>
<p>Пример полностью:</p>
<source lang="php" line start="1">
public function customMethod(iUmiEventPoint $e) {
    static $altNameStaticBefore;
    static $nameStaticBefore;
    if ($e->getMode() == "before") {  
          
        $element  = $e->getRef('element');
	// получаем umiHierarchyElement, либо false, если страница не существует
	if (!$element instanceof umiHierarchyElement) {
	    return false;
	}

        $altNameStaticBefore = $element->altName;

        $objId =  $element->objectId;
        $elementObject = umiObjectsCollection::getInstance()->getObject($objId);
        $nameStaticBefore = $elementObject->getName();

    }   elseif ($e->getMode() == "after") {   
         
        $element  = $e->getRef('element');
	// получаем umiHierarchyElement, либо false, если страница не существует
	if (!$element instanceof umiHierarchyElement) {
	    return false;
	}

        $altNameBefore = $element->altName;

        $objId =  $element->objectId;
        $elementObject = umiObjectsCollection::getInstance()->getObject($objId);
        $nameAfter = $elementObject->getName();

        if ($altNameStaticBefore != $altNameBefore) {
            // Here your logic
        }

        if ($nameStaticBefore != $nameAfter) {
            // Here your logic
        }
    }
}
</source>
<p> Примечание: не забудьте создать в папке /classes/modules/data файл custom_events.php с объявлением события </p>
<source lang="php" line start="1">
<?php
    new umiEventListener('systemModifyElement', 'data', 'customMethod');
?>
</source>
[[Категория:Вопросы и уроки разработки сайтов на UMI.CMS]][[Категория:Написание кастомных макросов]]