Расширяем возможности макроса content redirect

Материал из Umicms
Версия от 05:09, 22 мая 2012; Kalexey (обсуждение | вклад) (Новая страница: « category:Написание кастомных макросов <p> '''Задача''': </p> <p> Расширить возможности макроса conte…»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к:навигация, поиск

Задача:

Расширить возможности макроса content redirect(): добавить возможность редиректа с задержкой и открытием URL в новом окне/вкладке.

Решение:

Данные возможности можно реализовать с помощью небольшого javascript скрипта. Его мы и будем возвращать в макросе. Макрос назовём "redirectEx". Текст макроса размещаем в файле "/classes/modules/content/__custom.php", сразу после строки "//TODO: Write your macroses here".

  /*
    @title
      Макрос совершает редирект с помощью javascript на указанный URL с возмжностью
      задержки и открытия URL в новом окне. Если у пользоваеля отключён
      javascript, то применяется тег meta.
      Примечание: Т.к. в теге meta нет опции для открытия URL в новом окне, то
      при отключёном javascript эта опция макроса также не будет работать.
    @param
      $url - URL для редиректа
    @param
      $delay - задержка в милисекундах (0 по умолчанию)
    @param
      $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;
    }
  }

Также нужно задать разрешения для макроса. Создаём в той же папке файл "permissions.custom.php" и в нём настраиваем разрешения:

  $permissions = Array(
      'content' => Array('redirectEx')
  );

Важно.

Поскольку в случае отключённого javascript используется тег meta, необходимо размещать данный макрос между тегами <head> и </head>.

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

  <head>
    ...

    %content redirectEx('http://www.google.ru', 2000, 1)%

    ...
  </head>

В данном приме