Задавал данный вопрос службе поддержки Битрикс, где сказали, что способ, описанный в моём вопросе, вполне работоспособен.
В итоге сделаю инсталляцию модуля следующим образом:
- (по поводу 1-ого пункта из моего решения) на первом шаге буду просить пользователя указать какой тип меню используется у него на сайте для 1-ого уровня (
ROOT_MENU_TYPE
) и какой для всех остальных уровней (CHILD_MENU_TYPE
). Для получения информации о имеющихся типах меню в системе можно воспользоваться функцией GetMenuTypes()
.
В дальнейшем по возможности прикручу метод PHPParser::ParseScript
, который посоветовала тех. поддержка Битрикс (что метод PHPParser::ParseScript
возвращает и как им пользоваться описано здесь);
- (по поводу 2-ого пункта из моего решения) как я понял использовать методы класса
WizardServices
напрямую в модуле нельзя (например, здесь, видно что завязываются на Wizard другого модуля и пишется что все эти действия необходимо производить в самом начале файла, т.е. вне класса модуля равный ID модуля). Покопавшись ещё в исходниках Битрикс обнаружил, что в модуле crm
имеется метод __AddMenuItem($menuFile, $menuItem, $siteID, $pos = -1)
, который нигде не используется в файле установки <DOCUMENT_ROOT>/bitrix/modules/crm/install/index.php
, но который использует функции модуля "Управление структурой (fileman
)". И по этому решил перенести данный метод к себе в модуль, дополнив его методом для удаления пункта меню (DeleteMenuItem
). В итоге получилось следующее:
function AddMenuItem($menuFile, $menuItem, $siteID, $pos = -1) {
if (CModule::IncludeModule("fileman")) {
$arResult = CFileMan::GetMenuArray(Application::getDocumentRoot().$menuFile);
$arMenuItems = $arResult["aMenuLinks"];
$menuTemplate = $arResult["sMenuTemplate"];
$bFound = false;
foreach($arMenuItems as $item) {
if($item[1] == $menuItem[1]) {
$bFound = true;
break;
}
}
if(!$bFound) {
if($pos < 0 || $pos >= count($arMenuItems))
$arMenuItems[] = $menuItem;
else {
for($i = count($arMenuItems); $i > $pos; $i--)
$arMenuItems[$i] = $arMenuItems[$i - 1];
$arMenuItems[$pos] = $menuItem;
}
CFileMan::SaveMenu(array($siteID, $menuFile), $arMenuItems, $menuTemplate);
}
}
}
function DeleteMenuItem($menuFile, $menuLink, $siteID) {
if (CModule::IncludeModule("fileman")) {
$arResult = CFileMan::GetMenuArray(Application::getDocumentRoot().$menuFile);
$arMenuItems = $arResult["aMenuLinks"];
$menuTemplate = $arResult["sMenuTemplate"];
foreach($arMenuItems as $key => $item) {
if($item[1] == $menuLink) unset($arMenuItems[$key]);
}
CFileMan::SaveMenu(array($siteID, $menuFile), $arMenuItems, $menuTemplate);
}
}
Пример как вызывать данные методы (у меня они используются в методах DoInstall
и DoUninstall
в классе abc_testmodule
):
class abc_testmodule extends CModule {
const PUBLIC_DIR = "abc/testmodule/";
const ROOT_MENU_TYPE = "top";
...
function DoInstall() {
...
// добавление пункта меню в публичной части
$siteInfo = $this->getSiteInfo();
$arMenuItem = array(GetMessage("ROOT_MENU_TITLE"), $siteInfo["DIR"].self::PUBLIC_DIR, array(), array(), "IsModuleInstalled('abc.testmodule')");
$this->AddMenuItem($siteInfo["DIR"].".".self::ROOT_MENU_TYPE.".menu.php", $arMenuItem, $siteInfo["LID"]);
...
}
function DoUninstall() {
...
// удаление пункта меню из публичной части
$siteInfo = $this->getSiteInfo();
$this->DeleteMenuItem($siteInfo["DIR"].".".self::ROOT_MENU_TYPE.".menu.php", $siteInfo["DIR"].self::PUBLIC_DIR, $siteInfo["LID"]);
...
}
// по заданию задано, что сайт будет всегда 1 (т.е. многосайтовость можно не поддерживать)
function getSiteInfo() {
$siteID = CSite::GetDefSite(); // s1
return CSite::GetByID($siteID)->Fetch();
}
}
(*) В дальнейшем перенесу параметры PUBLIC_DIR
и ROOT_MENU_TYPE
в настройки модуля.
.left.menu_ext.php
- dev.1c-bitrix.ru/learning/course/…ROOT_MENU_TYPE
). Для добавления пункта меню нашёл следующий методWizardServices::AddMenuItem($menuFile, $menuItem, $siteID)
(dev.1c-bitrix.ru/learning/course/…).