Через этот хук добавляются новые права доступа, доступные для настройки в соответствующей секции форума.
Расположение
ManagePermissions.php
call_integration_hook('integrate_load_permissions', array(&$permissionGroups, &$permissionList, &$leftPermissionGroups, &$hiddenPermissions, &$relabelPermissions));
Хук принимает пять массивов, но обязательных из них два: $permissionGroups и $permissionList. В первом содержатся группы разрешений, во втором — списки. Остальные параметры используются реже, но примеры приведу и для них, в конце статьи.
Использование
Рассмотрим пример (добавление своего разрешения в категорию «Основные права»):
<?php
if (!defined('SMF'))
die('No direct access...');
class YourModName
{
// В этой функции подключаем используемые хуки
public function hooks()
{
add_integration_function('integrate_load_permissions', __CLASS__ . '::loadPermissions#', false, __FILE__);
}
public function loadPermissions(&$permissionGroups, &$permissionList)
{
global $context;
// В массиве $context['non_guest_permissions'] содержатся права доступа, которые нельзя разрешать гостям:
$context['non_guest_permissions'][] = 'your_permission';
// Добавление вашего разрешения в категорию «Общие» в Основных правах доступа:
$permissionList['membergroup']['your_permission'] = array(false, 'general', 'view_basic_info');
// В SMF 2.0.x при просмотре прав доступа можно изменять вид отображения (простой или классический), поэтому нужно указывать параметры мода для каждого вида:
$permissionGroups['membergroup']['simple'] = array('your_mod');
$permissionGroups['membergroup']['classic'] = array('your_mod');
// Далее перечисляются все добавляемые права доступа:
$permissionList['membergroup']['your_mod_perm1'] = array(false, 'your_mod', 'your_mod');
$permissionList['membergroup']['your_mod_perm2'] = array(false, 'your_mod', 'your_mod');
$permissionList['membergroup']['your_mod_perm3'] = array(false, 'your_mod', 'your_mod');
$permissionList['membergroup']['your_mod_perm4'] = array(false, 'your_mod', 'your_mod');
$permissionList['membergroup']['your_mod_perm5'] = array(false, 'your_mod', 'your_mod');
$permissionList['membergroup']['your_mod_perm6'] = array(false, 'your_mod', 'your_mod');
}
}
Подробнее о массиве с параметрами
Если добавляемое вами разрешение универсальное (например, «Просмотр форума»), то указывайте первым атрибутом false:
... = array(false, 'forum_view');
Если же нужно разделить настройку (например, для разрешения «Редактирование профиля»), указывайте true:
... = array(true, 'profile_edit');
В последнем случае можно будет отдельно разрешить редактирование только своего профиля, только чужих профилей, или же и своего и чужих вместе.
Расширенный пример, с использованием всех параметров хука (для SMF 2.1.x):
<?php
if (!defined('SMF'))
die('No direct access...');
class YourModName
{
// В этой функции подключаем используемые хуки
public function hooks()
{
add_integration_function('integrate_load_permissions', __CLASS__ . '::loadPermissions#', false, __FILE__);
}
public function loadPermissions(&$permissionGroups, &$permissionList, &$leftPermissionGroups, &$hiddenPermissions, &$relabelPermissions)
{
global $modSettings;
// Добавление секции с вашим модом в категорию «Основные права»:
$permissionGroups['membergroup'][] = 'your_mod_section';
// Добавление нужных прав доступа в только что добавленную секцию:
$permissionList['your_mod_perm1'] = array(false, 'your_mod_section');
$permissionList['your_mod_perm2'] = array(false, 'your_mod_section');
// Добавление секции с вашим модом в категорию «Права для разделов с глобальными привилегиями»:
$permissionGroups['board'][] = 'your_mod_section';
// Добавление нужных прав доступа в только что добавленную секцию:
$permissionList['your_mod_perm3'] = array(false, 'your_mod_section');
// Перечисленные в массиве $leftPermissionGroups группы разрешений отображаются всегда в левой колонке (при классическом виде раздела прав доступа):
$leftPermissionGroups[] = 'your_mod_section';
// Можно сделать так, что если какая-то опция выключена, некоторые права доступа не будут видны:
if (empty($modSettings['your_mod_option_enabled'])) {
$hiddenPermissions[] = 'your_mod_perm1';
$hiddenPermissions[] = 'your_mod_perm2';
$hiddenPermissions[] = 'your_mod_perm3';
}
// Также можно сделать, что в зависимости от включенных параметров мода некоторые права доступа будут называться иначе:
if ($modSettings['your_mod_options'] == 1) {
$relabelPermissions['your_mod_perm1'] = 'new_name1';
$relabelPermissions['your_mod_perm2'] = 'new_name2';
} elseif ($modSettings['your_mod_options'] == 2) {
$relabelPermissions['your_mod_perm1'] = 'new_name3';
}
}
}
Не забываем подключить языковой файл с переводом добавляемых прав доступа:
<?php
// Заголовок секции
$txt['permissiongroup_your_mod_section'] = 'Название вашего мода';
// Заголовок секции при простом виде отображения (в SMF 2.0.x)
$txt['permissiongroup_simple_your_mod_section'] = 'Название вашего мода';
// Названия прав доступа
$txt['permissionname_your_mod_section_perm1'] = 'Название разрешения 1';
$txt['permissionname_your_mod_section_perm2'] = 'Название разрешения 2';
// Названия прав доступа (используются в Генераторе отчётов)
$txt['group_perms_name_your_mod_section_perm1'] = 'Название разрешения 1';
$txt['group_perms_name_your_mod_section_perm2'] = 'Название разрешения 2';
// Если используется разрешение с раздельной настройкой:
$txt['permissionname_your_mod_section_perm3_own'] = 'Разрешение 3 - для своих элементов (например, «Редактирование своей подписи»)';
$txt['permissionname_your_mod_section_perm3_any'] = 'Разрешение 3 - для всех элементов (например, «Редактирование любых подписей»)';
Итак, хук integrate_load_permissions пригодится для добавления новых прав доступа, необходимых для работы вашей модификации.