nopCommerce Dokumentace

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;
   }
}