Merge pull request #7882 from abpframework/maliming/toolbars-navigation-docs

Update Navigation-Menu and Toolbars.

docs/en/UI/AspNetCore/Navigation-Menu.md

@@ -104,6 +104,7 @@ There are more options of a menu item (the constructor of the `ApplicationMenuIt
 * `target` (`string`): Target of the menu item. Can be `null` (default), "\_*blank*", "\_*self*", "\_*parent*", "\_*top*" or a frame name for web applications.
 * `elementId` (`string`): Can be used to render the element with a specific HTML `id` attribute.
 * `cssClass` (`string`): Additional string classes for the menu item.
+* `RequiredPermissionName` (`string`): The required permission name, this menu item will be removed if this permission is not granted.
 
 ### Authorization
 
@@ -120,6 +121,25 @@ if (await context.IsGrantedAsync("MyPermissionName"))
 }
 ````
 
+For the authorization, you can use `RequiredPermissionName` as a shortcut. It is also more performant, ABP optimizes the permission check for all the items.
+
+````csharp
+context.Menu.AddItem(
+    new ApplicationMenuItem("MyProject.Crm", l["Menu:CRM"])
+        .AddItem(new ApplicationMenuItem(
+            name: "MyProject.Crm.Customers", 
+            displayName: l["Menu:Customers"], 
+            url: "/crm/customers",
+            requiredPermissionName: "MyProject.Crm.Customers")
+        ).AddItem(new ApplicationMenuItem(
+            name: "MyProject.Crm.Orders", 
+            displayName: l["Menu:Orders"],
+            url: "/crm/orders",
+            requiredPermissionName: "MyProject.Crm.Orders")
+        )
+);
+````
+
 > You can use `context.AuthorizationService` to directly access to the `IAuthorizationService`.
 
 ### Resolving Dependencies

docs/en/UI/AspNetCore/Toolbars.md

@@ -52,6 +52,21 @@ public class MyToolbarContributor : IToolbarContributor
 }
 ````
 
+You can use the [authorization](../../Authorization.md) to decide whether to add a `ToolbarItem`.
+
+````csharp
+if (await context.IsGrantedAsync("MyPermissionName"))
+{
+    //...add Toolbar items
+}
+````
+
+You can use `RequiredPermissionName` as a shortcut. It is also more performant, ABP optimizes the permission check for all the items.
+
+````csharp
+context.Toolbar.Items.Insert(0, new ToolbarItem(typeof(NotificationViewComponent), requiredPermissionName: "MyPermissionName"));
+````
+
 This class adds the `NotificationViewComponent` as the first item in the `Main` toolbar.
 
 Finally, you need to add this contributor to the `AbpToolbarOptions`, in the `ConfigureServices` of your [module](../../Module-Development-Basics.md):
@@ -71,4 +86,4 @@ That's all, you will see the notification icon on the toolbar when you run the a
 
 ## IToolbarManager
 
-`IToolbarManager` is used to render the toolbar. It returns the toolbar items by a toolbar name. This is generally used by the [themes](Theming.md) to render the toolbar on the layout.
+`IToolbarManager` is used to render the toolbar. It returns the toolbar items by a toolbar name. This is generally used by the [themes](Theming.md) to render the toolbar on the layout.