Просмотр исходного текста страницы Макрос укорачивания URL

 [[category:Написание кастомных макросов]]
 [[category:Верстка в XSLT]]
 [[category:Верстка в TPL]]
<p>
Данный макрос будет укорачивать переданный ему URL с помощью сервиса [http://www.tinyurl.com tinyurl.com]. Этот сервис не делает самый короткий URL, но его плюсом является то, что он не требует регистрации.
</p>
<p>
Тело макроса нужно будет разместить в файле "/classes/modules/content/__custom.php" после строки "//TODO: Write here your own macroses".
</p>
<p style="text-align: right">
'''Листинг 1. Код макроса'''
</p>
<source lang="php">
/*
  @param String
    $url - URL для укорачивания
 */
public function getTinyUrl($url) {
  if($url)  
    return file_get_contents("http://tinyurl.com/api-create.php?url=".$url);
}
</source>
<p>
После того, как код макроса написан, необходимо добавить для него резрешение. Для этого создаём файл "permissions.custom.php" в той же папке, где находится "__custom.php", и пишем в нём следующий текст:
</p>
<p style="text-align: right">
'''Листинг 2. Добавление разрешения'''
</p>
<source lang="php">
<?php
  $permissions = Array(
    'content' => 
      Array('getTinyUrl')
  );
?>
</source>
<p>
Теперь можно использовать макрос. Вот примеры его использования в TPL и XSLT шаблонизаторах:
</p>
<p style="text-align: right">
'''Листинг 3. Использование макроса в TPL'''
</p>
<source lang="php">
%content getTinyUrl('http://www.umi-cms.ru/product/system/usability/')%
</source>
<p style="text-align: right">
'''Листинг 4. Использование макроса в XSLT'''
</p>
<source lang="html4strict">
<xsl:variable name="tinyurl" 
              select="document('udata://content/getTinyUrl/(http://www.umi-cms.ru/product/system/usability/)/)/udata" />
<a href="{$tinyurl}">UMI.CMS Usability</a>
</source>