[Статья] Создание собственного раздела меню в кабинете пользователя

04-22-2012, 08:33 PM

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

Создаем файл содержания
Пример файла exemlpemenu1.php (файл во вложении)

PHP Code:

<?php // ####################### SET PHP ENVIRONMENT ########################### error_reporting(E_ALL & ~E_NOTICE & ~8192); // #################### DEFINE IMPORTANT CONSTANTS ####################### //define('GET_EDIT_TEMPLATES', 'editsignature,updatesignature'); define('THIS_SCRIPT', 'exemlpemenu1'); define('CSRF_PROTECTION', true); // ################### PRE-CACHE TEMPLATES AND DATA ###################### // get special phrase groups $phrasegroups = array('user', 'timezone', 'posting', 'cprofilefield', 'cppermission'); // get special data templates from the datastore $specialtemplates = array( 'smiliecache', 'bbcodecache', 'banemail', 'ranks', 'noavatarperms' ); // pre-cache templates used by all actions $globaltemplates = array( 'USERCP_SHELL' ); // ######################### REQUIRE BACK-END ############################ require_once('./global.php'); require_once(DIR . '/includes/functions_user.php'); global $vbulletin, $vbphrase, $db; // ####################################################################### // ######################## START MAIN SCRIPT ############################ // ####################################################################### // set shell template name $shelltemplatename = 'USERCP_SHELL'; $templatename = ''; // initialise onload event $onload = ''; // start the navbar $navbits = array('usercp.php' . $vbulletin->session->vars['sessionurl_q'] => $vbphrase['user_control_panel']); IF(empty($_REQUEST['do'])) { $_REQUEST['do'] == 'position1'; } IF($_REQUEST['do'] == 'position1') { $exemplemenu1positioncontent = 'Пример содержания страницы позиции № 01 в разделе № 01 меню'; // draw cp nav bar construct_usercp_nav('menu_01_item_01'); // $navbits[''] = $vbphrase['название страницы']; $navbits[''] = 'Пример содержания страницы позиции № 01 в разделе № 01 меню'; $templatename = 'exemplemenu1_template'; } IF($_REQUEST['do'] == 'position2') { $exemplemenu1positioncontent = 'Пример содержания страницы позиции № 02 в разделе № 01 меню'; // draw cp nav bar construct_usercp_nav('menu_01_item_02'); // $navbits[''] = $vbphrase['название страницы']; $navbits[''] = 'Пример содержания страницы позиции № 02 в разделе № 01 меню'; $templatename = 'exemplemenu1_template'; } IF($_REQUEST['do'] == 'position3') { $exemplemenu1positioncontent = 'Пример содержания страницы позиции № 03 в разделе № 01 меню'; // draw cp nav bar construct_usercp_nav('menu_01_item_03'); // $navbits[''] = $vbphrase['название страницы']; $navbits[''] = 'Пример содержания страницы позиции № 03 в разделе № 01 меню'; $templatename = 'exemplemenu1_template'; } IF($_REQUEST['do'] == 'position4') { $exemplemenu1positioncontent = 'Пример содержания страницы позиции № 04 в разделе № 01 меню'; // draw cp nav bar construct_usercp_nav('menu_01_item_04'); // $navbits[''] = $vbphrase['название страницы']; $navbits[''] = 'Пример содержания страницы позиции № 04 в разделе № 01 меню'; $templatename = 'exemplemenu1_template'; } IF($_REQUEST['do'] == 'position5') { $exemplemenu1positioncontent = 'Пример содержания страницы позиции № 05 в разделе № 01 меню'; // draw cp nav bar construct_usercp_nav('menu_01_item_05'); // $navbits[''] = $vbphrase['название страницы']; $navbits[''] = 'Пример содержания страницы позиции № 05 в разделе № 01 меню'; $templatename = 'exemplemenu1_template'; } // ############################################################################# // spit out final HTML if we have got this far if ($templatename != '') { // make navbar $navbits = construct_navbits($navbits); eval('$navbar = "' . fetch_template('navbar') . '";'); ($hook = vBulletinHook::fetch_hook('exemlpemenu1_usercp_complete')) ? eval($hook) : false; // shell template eval('$HTML = "' . fetch_template($templatename) . '";'); eval('print_output("' . fetch_template($shelltemplatename) . '");'); } else { // make navbar $navbits = construct_navbits($navbits); eval('$navbar = "' . fetch_template('navbar') . '";'); ($hook = vBulletinHook::fetch_hook('exemlpemenu1_usercp_complete')) ? eval($hook) : false; eval('print_output("' . fetch_template($shelltemplatename) . '");'); } ?>

В общем и целом в этом файле все просто.
Для нас важны несколько элементов:
1. construct_usercp_nav('menu_01_item_01'); - эта функция дает возможность отображать текущее положение позиции меню, вызванной ссылкой exemlpemenu1.php?do=position1
2. $navbits[''] = 'Пример содержания страницы позиции № 01 в меню'; - это значение будет выведено в навигационной панели.
3. $templatename = 'exemplemenu1_template'; - это шаблон, который будет вызван для вывода желаемого содержания. Например:
  HTML Code:
```
$exemplemenu1positioncontent
```
  можно обойтись и без шаблона, но тогда результат набо вывести в переменную $HTML, в этом случае оставте переменную $templatename пустой
  
  PHP Code:
  
  $templatename = '';
4. ($hook = vBulletinHook::fetch_hook('exemlpemenu1_usercp_complete')) ? eval($hook) : false; - эта строка позволяет вывести наше новое меню при выводе нашего содержания. Для работы этой строки необходимо сделать файл типа hooks_exemlpemenu1.xml в каталоге includes/xml/

Создаем файл hooks_exemlpemenu1.xml
Содержание:

HTML Code:

<?xml version="1.0" encoding="ISO-8859-1"?>

<hooks>
	<hooktype type="exemlpemenu1">
		<hook>exemlpemenu1_usercp_complete</hook>
	</hooktype>
</hooks>

Создаем модуль вставки элементов массива.
Это необходимо для корректного отображения текущей позиции в меню.
Модуль надо повесить на хук usercp_nav_start
Содержание:

PHP Code:

$cells[] = 'menu_01_item_01'; $cells[] = 'menu_01_item_02'; $cells[] = 'menu_01_item_03'; $cells[] = 'menu_01_item_04'; $cells[] = 'menu_01_item_05';

Как видно добавленные элементы соответствуют вызову функции

PHP Code:

construct_usercp_nav('menu_01_item_01');

Создаем шаблон меню
Как пример создаем шаблон exemlpemenu1_cpuser шаблон может выглядеть так:

HTML Code:

<tbody>
  <tr><td class="thead">Название раздела</td></tr>
  <tr><td class="$navclass[menu_01_item_01]" nowrap="nowrap"><a class="smallfont" href="exemlpemenu1.php?do=position1">Первая позиция</a></td></tr>
  <tr><td class="$navclass[menu_01_item_02]" nowrap="nowrap"><a class="smallfont" href="exemlpemenu1.php?do=position2">Вторая позиция</a></td></tr>
  <tr><td class="$navclass[menu_01_item_03]" nowrap="nowrap"><a class="smallfont" href="exemlpemenu1.php?do=position3">Третья позиция</a></td></tr>
  <tr><td class="$navclass[menu_01_item_04]" nowrap="nowrap"><a class="smallfont" href="exemlpemenu1.php?do=position4">Четвертая позиция</a></td></tr>
  <tr><td class="$navclass[menu_01_item_05]" nowrap="nowrap"><a class="smallfont" href="exemlpemenu1.php?do=position5">>Пятая позиция</a></td></tr>
</tbody>

Создаем модули с одинаковым содержанием на следующих хуках:
- calendar_viewreminder_complete - для вывода при просмотре напоминаний календаря
- exemlpemenu1_usercp_complete - для вывода при просмотре своего содержания
- private_complete - для вывода при просмотре личных сообщений
- profile_complete - для вывода при просмотре профиля пользователя
- usercp_complete - для вывода при просмотре в кабинете пользователя
- usersub_editfolders - для вывода при редактировании папок подписки
- usersub_view_complete - для вывода при просмотре подписок
Содержание модуля может быть следующим:

PHP Code:

eval('$usercp_mymenu = "' . fetch_template('exemlpemenu1_cpuser') . '";'); $template_hook['usercp_navbar_bottom'] .= $usercp_mymenu;

На этом все. Ваше меню в кабинете создано и Вы сможете вывести свое сожержание при переходе по ссылке.

03-30-2013, 03:26 PM

Для 4.2, что изменить надо?

03-31-2013, 01:18 AM

whitedevilrus, заменить конструкцию вывода данных в шаблоны.
http://www.vbulletin.org/forum/showthread.php?t=228078

03-31-2013, 01:32 AM

mindframe, скопипасти плз. статейку, интересно почитать

04-09-2013, 09:57 AM

cyberdaemon, забирай.

06-17-2013, 11:36 AM

VERY GOOD