Просмотр исходного текста страницы Расширяем возможности макроса content redirect

 [[category:Написание кастомных макросов]]
 [[category:Верстка в XSLT]]
 [[category:Верстка в TPL]]
'''Актуально для версии 2.9'''

<p>
'''Задача''':
</p>
<p>
Расширить возможности макроса content redirect(): добавить возможность редиректа с задержкой и открытием URL в новом окне/вкладке.
</p>
<p>
'''Решение''':
</p>
<p>
Данные возможности можно реализовать с помощью небольшого javascript скрипта. Его мы и будем возвращать в макросе. Макрос назовём "redirectEx". Текст макроса размещаем в файле "/classes/modules/content/__custom.php", сразу после строки "//TODO: Write your macroses here".
</p>
<p style="text-align: right">
'''Листинг 1. Код макроса'''
</p>
<source lang="php">
  /*
    @title
      Макрос совершает редирект с помощью javascript на указанный URL с возмжностью
      задержки и открытия URL в новом окне. Если у пользоваеля отключён
      javascript, то применяется тег meta.
      Примечание: Т.к. в теге meta нет опции для открытия URL в новом окне, то
      при отключёном javascript эта опция макроса также не будет работать.
    @param
      String $url - URL для редиректа
    @param
      Integer $delay - задержка в милисекундах (0 по умолчанию)
    @param
      Boolean $new_window - открыть в новом окне? (false по умолчанию)
    @return
      Текст скрипта для редиректа
  */
  public function redirectEx($url = "", $delay = 0, $new_window = false) {
    if(isset($url)) {
      $src = '';
      if($new_window == false) {
        $src = "window.location.href='".$url."'";
      } else {
        $src = "window.open('".$url."')";
      }

      $script = '';
      $noscript = '';
      if($delay == 0) {
        $script = '<script type="text/javascript">'.$src.'</script>';
        $noscript = '<noscript><meta http-equiv="refresh" content="url='.$url.'"></noscript>';
      } else {
        $script = '<script type="text/javascript">window.setTimeout("'.$src.'", '.$delay.');</script>';
        $noscript = '<noscript><meta http-equiv="refresh" content="'.($delay/1000).'; url='.$url.'"></noscript>';
      }

      $result = $script.$noscript;
      return $result;
    }
  }
</source>
<p>
Также нужно задать разрешения для макроса. Создаём в той же папке файл "permissions.custom.php" и в нём настраиваем разрешения:
</p>
<p style="text-align: right">
'''Листинг 2. Установка разрешений'''
</p>
<source lang="php">
  $permissions = Array(
      'content' => Array('redirectEx')
  );
</source>
<table align="center" width="100%">
<tr>
<td style="border: 1px dotted black; padding: 20px;">
'''Важно'''.
<br />
<p>
Поскольку в случае отключённого javascript используется тег meta, необходимо размещать данный макрос между тегами <head> и </head>.
</p>
</td>
</tr>
</table>
<p>
Примеры использования макроса:
</p>
<p style="text-align: right">
'''Листинг 3. Использование макроса в TPL'''
</p>
<source lang="html4strict">
  <head>
    ...

    %content redirectEx('http://www.umi-cms.ru', 2000, 1)%

    ...
  </head>
</source>
<p style="text-align: right">
'''Листинг 4. Использование макроса в XSLT'''
</p>
<source lang="html4strict">
  <head>
    ...

    <xsl:value-of select="document('udata://content/redirectEx/(http://www.umi-cms.ru)/2000/1/')/udata" disable-output-escaping="yes" />

    ...
  </head>
</source>
<p>
В примере редирект будет произведён через 2 секунды и URL будет открыт в новой вкладке.
</p>