Как создать Action

Экшен – динамический элемент, который внедряется в текст страницы. Для вызова экшена пишут {{имяэкшена параметр1="значение 1" параметр2=знач2}}. Параметров может быть сколько угодно.

Физически экшен представляет собой один файл имяэкшена.php. В этом файле доступны все функции ядра – обращаться через $this->. Параметры, указанные в вызове, передаются в экшен как переменные $параметр1, $параметр2, а так же в массиве $vars, где упорядоченны так, как расставлены в вызове экшена.

Простейший экшен, который приветствует пользователя (если он вошёл в систему) выглядит так:
hello.php


<?php
$user = $this->GetUser();
if ($user){
    $username = $this->GetUserName();
    echo "Привет, $username!";
}else{
    echo "Войдите в систему, чтобы мы Вас поприветствовали";
}
?>

Такой экшен вызывается без параметров – просто {{hello}}

И наконец о том, где располагаются экшены.
В принципе, экшен, который вы пишете для своего сайта, можно положить в любую папку actions и он будет работать (кроме тех случаев, когда расширение не установлено). Однако мы настоятельно не рекомендуем этого делать – так вы нарушите архитектуру системы.
Если экшен будет использоваться только на одном сайте и вряд ли будет полезен на любом другом, то его лучше разместить в папке sites/<имя сайта>/actions. Все экшены из этой папке будут доступны только на сайте <имя сайта>.
Если экшен необходимо использовать на нескольких сайтах, то лучше «обернуть» его в расширение и проинсталлировать это расширение. Кроме того, если вы сделали реально полезный экшен, то мы будем благодарны, если вы пришлёте его нам – возможно он будет включен в сборку!
Не рекомендуется класть свои экшены в папку actions корневого каталога – там должны быть только те экшены, которые идут в стандартной поставке (ведь вряд ли кому-то придёт в голову устанавливать World of Warcraft в папку Windows).

Вам оказалась полезна эта статья? Если не трудно – дайте свою оценку тому, насколько предложенный здесь материал вам помог=)

Комментарии:

Нет комментариев, будьте первым!

Добавить комментарий: