Собственные страницы (подробно)

Raerek · 04.02.16

В следующем примере я покажу, как можно создать в меню навигации форума дополнительные кнопки, ведущие на страницы с произвольным контентом.
Созданные кнопки будут работать так же, как и основные, т.е. при переходе будут подсвечиваться и иметь свое суб-меню, а контент страниц будет правильно интегрирован в шаблон форума.

ВНИМАНИЕ! Не занимайтесь бездумным копипастом! Будьте внимательны и тогда всё получится.

И так, начнем.
Для начала переведем форум в режим отладки. для этого добавим в файл /library/config.php строчку:

Код:

$config['debug'] = true;

Теперь создадим необходимые для работы папки и файлы.
Или скачайте архив CustomNavTabs.zip из вложения в теме с обсуждением ресурса и распакуйте в папку library.
Листинг:

Код:

library/CustomNavTabs/ControllerPublic/Chat.php
library/CustomNavTabs/Listeners/Navigation.php
library/CustomNavTabs/Route/Prefix/Extra.php

Содержимое файла library/CustomNavTabs/ControllerPublic/Chat.php

PHP:

<?php

class CustomNavTabs_ControllerPublic_Chat extends XenForo_ControllerPublic_Abstract
{
    public function actionIndex()
    {
        $visitor = XenForo_Visitor::getInstance();
        $sessionModel = $this->getModelFromCache('XenForo_Model_Session');

        $onlineUsers = $sessionModel->getSessionActivityQuickList(
            $visitor->toArray(),
            array('cutOff' => array('>', $sessionModel->getOnlineStatusTimeout())),
            ($visitor['user_id'] ? $visitor->toArray() : null)
        );

        $boardTotals = $this->getModelFromCache('XenForo_Model_DataRegistry')->get('boardTotals');
        if (!$boardTotals)
            $boardTotals = $this->getModelFromCache('XenForo_Model_Counters')->rebuildBoardTotalsCounter();

        $viewParams = array(
            'onlineUsers' => $onlineUsers,
            'boardTotals' => $boardTotals
        );

        return $this->responseView('CustomNavTabs_ViewPublic_Chat', 'extra_chat', $viewParams);
    }
    public static function getSessionActivityDetailsForList(array $activities)
    {
        return new XenForo_Phrase('viewing_chat_content');
    }
}

CustomNavTabs_ControllerPublic_Chat - должно соответствовать пути к данному файлу.
CustomNavTabs_ViewPublic_Chat - конец строки _Chat должен соответсвовать имени данного файла
'extra_chat' - имя шаблона для вывода контента
'viewing_chat_content' - имя фразы, отвечающей для страницы "Сейчас на форуме"

Содержимое файла library/CustomNavTabs/Listeners/Navigation.php

PHP:

<?php

class CustomNavTabs_Listeners_Navigation
{
    public static function navtabs(array &$extraTabs, $selectedTabId)
    {
        $extraTabs['extra/chat/'] = array(
            'title' => new XenForo_Phrase('chat_nav_tab'),
            'href' => XenForo_Link::buildPublicLink('full:extra/chat/'),
            'selected' => ($selectedTabId == 'pages'),
            'position' =>  'middle',
            'selected' =>  ($selectedTabId == 'extra/chat/'),
            'linksTemplate' => 'extra_chat_sublinks',
        );
    }
}

CustomNavTabs_Listeners_Navigation - должно соответствовать пути к данному файлу.
'chat_nav_tab' - имя фразы, отвечающей за название создаваемой вкладки в меню.
'href' - путь до создаваемой страницы
'position' - позиция в меню. Возможны варианты home, end или middle.
'extra_chat_sublinks' - имя шаблона дополнительных ссылок ниже вкладок, false - без ссылок.

Содержимое файла library/CustomNavTabs/Route/Prefix/Extra.php

PHP:

<?php

class CustomNavTabs_Route_Prefix_Extra implements XenForo_Route_Interface
{
    public function match($routePath, Zend_Controller_Request_Http $request, XenForo_Router $router)
    {
        $urlComponents = explode('/', $routePath);
        $subPrefix = strtolower(array_shift($urlComponents));

        switch($subPrefix)
        {
            case 'chat':
                $controllerName = 'CustomNavTabs_ControllerPublic_Chat';
                $routeName = 'extra/chat/';
                break;
            default:
                $controllerName = 'CustomNavTabs_ControllerPublic_Chat';
                $routeName = 'extra/chat/';
                break;
        }

        return $router->getRouteMatch($controllerName, 'index', $routeName, $routePath);
    }
}

CustomNavTabs_Route_Prefix_Extra - должно соответствовать пути к данному файлу.
CustomNavTabs_ControllerPublic_Chat - должно соответствовать пути к файлу library/CustomNavTabs/ControllerPublic/Chat.php

С файлами закончили. Теперь перейдем в админку форума.

Создадим новое дополнение (ссылка