Add category_icon (#848)

Co-authored-by: Amin Alaee <[email protected]>

Author: sheldygg

docs/api_reference/model_view.md

@@ -6,6 +6,7 @@
         - name_plural
         - icon
         - category
+        - category_icon
         - column_labels
         - can_create
         - can_edit

docs/configurations.md

@@ -77,6 +77,7 @@ The metadata for the model. The options are:
 * `name_plural`: Display plural name for this model. Default value is class name + `s`.
 * `icon`: Icon to be displayed for this model in the admin. Only FontAwesome and Tabler names are supported.
 * `category`: Category name to display group of `ModelView` classes together in dropdown.
+* `category_icon`: Category icon to display.
 
 !!! example
 
@@ -86,6 +87,7 @@ The metadata for the model. The options are:
         name_plural = "Users"
         icon = "fa-solid fa-user"
         category = "accounts"
+        category_icon = "fa-solid fa-user"
     ```
 
 ## List page

sqladmin/application.py

@@ -266,7 +266,7 @@ async def test_page(self, request: Request):
 
     def _build_menu(self, view: ModelView | BaseView) -> None:
         if view.category:
-            menu = CategoryMenu(name=view.category)
+            menu = CategoryMenu(name=view.category, icon=view.category_icon)
             menu.add_child(ViewMenu(view=view, name=view.name, icon=view.icon))
             self._menu.add(menu)
         else:

sqladmin/models.py

@@ -183,6 +183,9 @@ async def test_page(self, request: Request):
     category: ClassVar[str] = ""
     """Category name to group views together."""
 
+    category_icon: ClassVar[str] = ""
+    """Display icon for category in the sidebar."""
+
 
 class ModelView(BaseView, metaclass=ModelViewMeta):
     """Base class for defining admnistrative behaviour for the model.