Модель может реализовывать сложную многократно используемую функциональность с помощью поведений. Поведения модели - это практичный способ изменять стандартные действия F0FModel. Модель работает с использованием стандартной системы событий Joomla.

До и После определённых действий (onBefore* / onAfter*) модель вызывает событие, которое размножается на каждое зарегистрированное поведение данной модели. Поведения в свою очередь, регистрируясь на эти события, могут изменять содержание той или иной операции.

Можно регистрировать несколько поведений на одну модель, они могут добавляться по умолчанию или генерироваться на лету уже после создания модели.

В FOF уже предусмотрено некоторое количество стандартных поведений, которые могут быть использованы любым объектом F0FModel. Связанные с поведениями классы в настоящее время находятся в папке model/behavior фреймворка FOF.

FOF поставляется с некоторым количеством встроенных поведений модели. Эти поведения используются для реализации базового функционала. В целях повышения производительности изначально к модели подключено только поведение filters. Далее в этом разделе будет показано что делает каждое поведение.

В каждом конкретном случае можно комбинировать различные поведения.

Есть 5 способов добавить поведение в модель:

1. Использовать свойство модели default_behaviors. Это массив с именами поведений, которые должны быть загружены при создании модели. По умолчанию массив содержит только поведение filters. Можно переопределить это свойство в декларации класса модели:
   

   class FoobarModelTodos extends F0FModel {
       protected $default_behaviors = array('filters', 'access', 'enabled');
   }

2. Передать список поведений в параметре $config конструктора класса модели:
   

   class FoobarModelTodos extends F0FModel {
       public function __construct($config = array()) {
           if (!isset($config['behaviors'])) {
               $config['behaviors'] = array('filters', 'access', 'enabled');
           }
           parent::__construct($config);
       }
   }

3. Передать список поведений в параметре config при создании экземпляра модели:
   

   $model = F0FModel::getTmpInstance('Todos', 'FoobarModel', array(
       'behaviors' => array('filters', 'access', 'enabled'))
   );

4. Динамически добавить нужные поведения используя метод addBehavior
   

   class FoobarModelTodos extends F0FModel {
       public function __construct($config = array()) {
           parent::__construct($config);
           if ($iWantToAddIt) {
               $this->addBehavior('enabled');
           }
       }
   }

5. Добавить поведения в представление, используя fof.xml
   

   <?xml version="1.0" encoding="utf-8"?>
   <fof>
       <frontend>
           <view name="todos">
               <config>
                   <option name="behaviors">filter,access,enabled</option>
               </config>
           </view>
       </frontend>
   </fof>

Можно создать новое поведение для своего компонента. Название поведения имеет очень большое значение, т.к. FOF будет искать поведение по его имени.

Если есть желание добавить поведение bar в компонент foo, FOF будет искать это поведение в следующем порядке:

1. Сначала будет попытка найти ComponentnameModelViewnameBehaviorName (например, FoobarModelTodosBar)
   Внимание, Viewname должно быть во множественном числе.
2. Затем будет попытка найти ComponentnameModelBehaviorName (например, FoobarModelBar)
3. Затем F0FModelBehaviorBehaviorName (например, F0FModelBehaviorBar)

Это позволяет создавать поведения как для конкретной модели, так и для компонента в целом.

Кроме того возможно переопределить существующее поведение. Например, для того, чтобы переопределить поведение enabled достаточно создать класс под названием FoobarModelBehaviorEnabled).

Важно. Поведения автоматически не загружаются, поэтому необходимо предусмотреть либо свой загрузчик, либо загружать классы поведений в конструкторе модели перед вызовом метода parent::__construct(…).

В каждое поведение модели можно добавить логику работы с использованием следующих методов:

/**
 * Это событие вызывается перед сохранением данных в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 * @param   array     &$data   Данные для сохранения
 *
 * @return  void
 */
public function onBeforeSave(&$model, &$data)
{
}

/**
 * Это событие вызывается перед удалением записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onBeforeDelete(&$model)
{
}

/**
 * Это событие вызывается перед копирование записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onBeforeCopy(&$model)
{
}

/**
 * Это событие вызывается перед публикацией записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onBeforePublish(&$model)
{
}

/**
 * Это событие вызывается перед изменением счётчика переходов на запись в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onBeforeHit(&$model)
{
}

/**
 * Это событие вызывается перед перемещением записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onBeforeMove(&$model)
{
}

/**
 * Это событие вызывается перед изменением порядкового номера записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onBeforeReorder(&$model)
{
}

/**
 * Это событие вызывается перед построением запроса для получения списка записей
 * в модели
 *
 * @param   F0FModel        &$model  Модель, вызывающая данное событие
 * @param   JDatabaseQuery  &$query  Запрос, который строится
 *
 * @return  void
 */
public function onBeforeBuildQuery(&$model, &$query)
{
}

/**
 * Это событие вызывается после сохранения записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onAfterSave(&$model)
{
}

/**
 * Это событие вызывается после удаления записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onAfterDelete(&$model)
{
}

/**
 * Это событие вызывается после копирования записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onAfterCopy(&$model)
{
}

/**
 * Это событие вызывается после публикации записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onAfterPublish(&$model)
{
}

/**
 * Это событие вызывается после изменения порядкового номера записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onAfterHit(&$model)
{
}

/**
 * Это событие вызывается после перемещения записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onAfterMove(&$model)
{
}

/**
 * Это событие вызывается после изменения порядкового номера записи в модели
 *
 * @param   F0FModel  &$model  Модель, вызывающая данное событие
 *
 * @return  void
 */
public function onAfterReorder(&$model)
{
}

/**
 * Это событие вызывается после построения запроса для получения списка записей
 * в модели
 *
 * @param   F0FModel        &$model  Модель, вызывающая данное событие
 * @param   JDatabaseQuery  &$query  Запрос, который строится
 *
 * @return  void
 */
public function onAfterBuildQuery(&$model, &$query)
{
}

/**
 * Это событие вызывается после получения единичной записи в модели
 *
 * @param   F0FModel  &$model   Модель, вызывающая данное событие
 * @param   F0FTable  &$record  Запись, загруженная в модели
 *
 * @return  void
 */
public function onAfterGetItem(&$model, &$record)
{
}

Давайте для нашего компонента создадим поведение Published, которое будет фильтровать записи на основании полей publish_up и pulish_down.

class F0FModelBehaviorPublished extends F0FModelBehavior
{
    /**
     * Добавим фильтр записей на основании полей publish_up и publish_down после построения запроса
     *
     * @param   F0FModel        &$model  Вызываемая модель
     * @param   JDatabaseQuery  &$query  Создаваемый запрос
     *
     * @return  void
     */
    public function onAfterBuildQuery(&$model, &$query)
    {
        // Это поведение работает только для пользовательской части сайта
        if (!F0FPlatform::getInstance()->isFrontend())
        {
            return;
        }

        // Получим имя поля publish_up (поддержка псевдонимов)
        $table = $model->getTable();
        $publishUpField = $table->getColumnAlias('publish_up');

        // Получим имя поля publish_down (поддержка псевдонимов)
        $publishDownField = $table->getColumnAlias('publish_down');

        // Проверим, что поля существуют
        $publishUpExists = in_array($publishUpField, $table->getKnownFields());

        $publishDownExists = in_array($publishDownField, $table->getKnownFields());

        // Если хотя бы одного из полей нет, выходим, т.к. поведение не сможет отработать
        if (!$publishUpExists && !$publishDownExists)
        {
            return;
        }

        // Получим текущую дату
        $now = new JDate()
        $now = $now->toSql();

        $db = JFactory::getDbo();

        // Сначала фильтруем по полю publish_up
        if ($publishUpExists) {
            $query->where($db->qn($publishUpField) . ' <= ' . $db->q($now));
        }

        // Затем фильтруем по полю publish_down
        if ($publishDownExists) {
            $query->where($db->qn($publishDownField) . ' >= ' . $db->q($now));
        }
    }

    /**
     * Обнуляет результат getItem, если загруженная запись не опубликована
     *
     * @param   F0FModel  &$model   Вызываемая модель
     * @param   F0FTable  &$record  Загруженная из БД запись
     *
     * @return  void
     */
    public function onAfterGetItem(&$model, &$record)
    {
        if ($record instanceof F0FTable)
        {
            // Поведение применимо только к пользовательской части сайта
            if (!F0FPlatform::getInstance()->isFrontend())
            {
                return;
            }

            // Получим имя поля publish_up (поддержка псевдонимов)
            $publishUpField = $record->getColumnAlias('publish_up');

            // Получим имя поля publish_down (поддержка псевдонимов)
            $publishDownField = $record->getColumnAlias('publish_down');

            // Проверим, что поля существуют
            $publishUpExists = in_array($publishUpField, $record->getKnownFields());

            $publishDownExists = in_array($publishDownField, $record->getKnownFields());

            // Если хотя бы одного из полей нет, выходим, т.к. поведение не сможет отработать
            if (!$publishUpExists && !$publishDownExists)
            {
                return;
            }

            // Получим текущую дату
            $now = new JDate()
            $now = $now->toSql();

            if ($publishUpExists) {
                $publish_up = new JDate($record->$publishUpField);
                if ($publish_up > $now) {
                    $record = null;
                    return;
                }
            }

            if ($publishDownExists) {
                $publish_down = new JDate($record->$publishDownField);
                if ($publish_down < $now) {
                    $record = null;
                    return;
                }
            }
        }
    }
}