Jak přidat položku menu do administrace z pluginu (pro verzi 4.80 a vyšší)
Pro přidání položek menu použijte událost AdminMenuCreatedEvent. Můžete použít následující ukázku kódu, kterou přidejte do souboru *.cs svého pluginu.
Do této metody můžete také vložit libovolnou bezpečnostní logiku (ACL). Například ověřit, zda má aktuální zákazník oprávnění „Spravovat pluginy“ (Manage plugins).
public class EventConsumer: IConsumer<AdminMenuCreatedEvent>
{
private readonly IPermissionService _permissionService;
public EventConsumer(IPermissionService permissionService)
{
_permissionService = permissionService;
}
public Task HandleEventAsync(AdminMenuCreatedEvent eventMessage)
{
if (!await _permissionService.AuthorizeAsync(StandardPermission.Configuration.MANAGE_PLUGINS))
return;
eventMessage.RootMenuItem.InsertBefore("Local plugins",
new AdminMenuItem
{
SystemName = "YourCustomSystemName",
Title = "Plugin Title",
Url = eventMessage.GetMenuItemUrl("CONTROLLER_NAME", "ACTION_NAME"),
IconClass = "far fa-dot-circle",
Visible = true,
});
return Task.CompletedTask;
}
}
Poznámka
V nopCommerce verze 4.70 a nižší se menu administrace sestavuje ze souboru sitemap.config, který se nachází ve složce ~/Areas/Admin.
Chcete-li dosáhnout téhož, můžete použít následující ukázkový kód, který je potřeba přidat do souboru *.cs vašeho pluginu. Nejprve v hlavní třídě pluginu implementujte rozhraní IAdminMenuPlugin.
public class CustomPlugin : BasePlugin, IAdminMenuPlugin
{
public Task ManageSiteMapAsync(SiteMapNode rootNode)
{
var menuItem = new SiteMapNode()
{
SystemName = "YourCustomSystemName",
Title = "Plugin Title",
ControllerName = "ControllerName",
ActionName = "List",
IconClass = "far fa-dot-circle",
Visible = true,
RouteValues = new RouteValueDictionary() { { "area", AreaNames.Admin } },
};
var pluginNode = rootNode.ChildNodes.FirstOrDefault(x => x.SystemName == "Third party plugins");
if(pluginNode != null)
pluginNode.ChildNodes.Add(menuItem);
else
rootNode.ChildNodes.Add(menuItem);
return Task.CompletedTask;
}
}