Merge pull request #21 from SmartBase-SK/develop

triv: #24416 extended filter documentation

Author: LuboZ

docs/table/filters.mdx

@@ -59,7 +59,12 @@ class ProductSBAdmin(SBAdmin):
 </Tabs>
 
 # Advanced Filters
-To enable advance filters you have to set filter version in your `SBAdminRoleConfiguration`
+Advanced Filters allow you to create powerful queries across different fields for more precise data filtering.
+
+![Advanced filters sbadmin](/img/screenshots/advanced_filters2.png)
+
+### Enable Advanced Filters globally
+To enable advance filters globally, you have to set filter version in your `SBAdminRoleConfiguration`
 
 <Tabs groupId="2">
 <TabItem value="code" label="Code">
@@ -75,3 +80,14 @@ class SBAdminConfiguration(SBAdminConfigurationBase):
 
 </Tabs>
 
+### Enable Advanced Filters only for selected views
+You can enable Andvanced Filters for view by setting `filters_version = FilterVersions.FILTERS_VERSION_2` parameter in your SBAdmin view.
+
+```python title="catalog/sb_admin.py"
+@admin.register(Purchase, site=sb_admin_site)
+class PurchaseSBAdmin(SBAdmin):
+    model = Purchase
+    filters_version = FilterVersions.FILTERS_VERSION_2
+    ...
+
+```

docs/tree_widget.mdx

@@ -123,3 +123,53 @@ class ProductCategoryTreeInline(SBAdminFakeInlineMixin, SBAdminTableInline):
 ```
 
 You can learn more about Fake Inlines in [🔗Fake inlines section](/docs/detail/fake_inlines).
+
+
+###  Tree Filter Widget
+The Tree Filter Widget enables users to filter data using hierarchical structures such as categories, departments etc...
+
+![TreeWidget filter sbadmin](/img/screenshots/tree_widget_filter.png)
+
+### 💡 Example: Category Tree Filter for Product SBAdmin View
+
+#### 1. Create widget
+Create a filter-specific widget by combining the base tree widget and SBAdminTreeFilterWidget:
+
+```python title="catalog/sb_admin_widgets.py"
+class CategoryTreeFilterWidget(CategoryTreeWidget, SBAdminTreeFilterWidget):
+    template_name = "sb_admin/filter_widgets/tree_select_filter.html"
+```
+
+
+#### 2. Add the Filter to Your Admin
+Use the custom widget in a SBAdminField in your admin class to enable tree-based filtering:
+
+```python title="catalog/sb_admin.py"
+python title="catalog/sb_admin.py"
+@admin.register(Product, site=sb_admin_site)
+class ProductSBAdmin(SBAdmin):
+    model = Product
+    sbadmin_list_display = (
+         # ... Other fields
+        SBAdminField(
+            name="categories",
+            title="Categories",
+            annotate="categories__name",
+            filter_widget=CategoryTreeFilterWidget(
+                search_query_lambda=lambda request, qs, model, search_term, language_code: qs.filter(
+                    name__icontains=search_term
+                ),
+                filter_query_lambda=lambda request, filter_value: Q(
+                    is_active=True
+                ),
+            ),
+        ),
+    )
+```
+
+#### ⚙️ Key Options
+- `multiselect`: True for multiple selections, False for single.
+- `value_field`: Typically `"path"` for `MP_Node` trees.
+- `search_query_lambda`: Optional search support inside the tree.
+- `filter_query_lambda`: Filter values in widget.
+