django-unfold 0.29.1__tar.gz → 0.31.0__tar.gz

{django_unfold-0.29.1 → django_unfold-0.31.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: django-unfold
-Version: 0.29.1
+Version: 0.31.0
 Summary: Modern Django admin theme for seamless interface development
 Home-page: https://unfoldadmin.com
 License: MIT
@@ -33,7 +33,7 @@ Description-Content-Type: text/markdown
 ![Code Style - Ruff](https://img.shields.io/badge/code%20style-ruff-30173D.svg?style=for-the-badge)
 ![Pre Commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=for-the-badge)
 
-Unfold is theme for Django admin incorporating most common practises for building full-fledged admin areas. It is designed to work at the top of default administration provided by Django.
+Unfold is a theme for Django admin incorporating most common practices for building full-fledged admin areas. It is designed to work on top of default administration provided by Django.
 
 - **Unfold:** demo site is available at [unfoldadmin.com](https://unfoldadmin.com?utm_medium=github&utm_source=unfold)
 - **Formula:** repository with demo implementation at [github.com/unfoldadmin/formula](https://github.com/unfoldadmin/formula)
@@ -45,7 +45,7 @@ Did you decide to start using Unfold but you don't have time to make the switch
 
 ## Features <!-- omit from toc -->
 
-- **Visual**: provides new user interface based on Tailwind CSS framework
+- **Visual**: provides a new user interface based on Tailwind CSS framework
 - **Sidebar:** simplifies definition of custom sidebar navigation with icons
 - **Dark mode:** supports both light and dark mode versions
 - **Configuration:** most of the basic options can be changed in settings.py
@@ -55,14 +55,16 @@ Did you decide to start using Unfold but you don't have time to make the switch
 - **Array widget:** built-in widget for `django.contrib.postgres.fields.ArrayField`
 - **Filters:** custom dropdown, numeric, datetime, and text fields
 - **Dashboard:** custom components for rapid dashboard development
+- **Inline tabs:** group inlines into tab navigation in the change form
 - **Model tabs:** define custom tab navigations for models
-- **Fieldset tabs:** merge several fielsets into tabs in change form
-- **Colors:** possibility to override default color scheme
-- **Changeform modes:** display fields in changeform in compressed mode
+- **Fieldset tabs:** merge several fieldsets into tabs in the change form
+- **Colors:** possibility to override the default color scheme
+- **Changeform modes:** display fields in the change form in compressed mode
 - **Third party packages:** default support for multiple popular applications
 - **Environment label**: distinguish between environments by displaying a label
 - **Nonrelated inlines**: displays nonrelated model as inline in changeform
 - **Parallel admin**: support for default admin in parallel with Unfold. [Admin migration guide](https://unfoldadmin.com/blog/migrating-django-admin-unfold/?utm_medium=github&utm_source=unfold)
+- **Favicons**: built-in support for configuring various site favicons
 - **VS Code**: project configuration and development container is included
 
 ## Table of contents <!-- omit from toc -->
@@ -111,7 +113,7 @@ Did you decide to start using Unfold but you don't have time to make the switch
 
 ## Installation
 
-The installation process is minimal. Everything what is needed after installation is to put new application at the beginning of **INSTALLED_APPS**. Default admin configuration in urls.py can stay as it is and there are no changes required.
+The installation process is minimal. Everything that is needed after installation is to put new application at the beginning of **INSTALLED_APPS**. The default admin configuration in urls.py can stay as it is, and no changes are required.
 
 ```python
 # settings.py
@@ -170,17 +172,24 @@ class CustomAdminClass(ModelAdmin):
 
 from django.contrib import admin
 from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
+from django.contrib.auth.admin import GroupAdmin as BaseGroupAdmin
 from django.contrib.auth.models import User
 
 from unfold.admin import ModelAdmin
 
 
 admin.site.unregister(User)
+admin.site.unregister(Group)
 
 
 @admin.register(User)
 class UserAdmin(BaseUserAdmin, ModelAdmin):
     pass
+
+
+@admin.register(Group)
+class GroupAdmin(BaseGroupAdmin, ModelAdmin):
+    pass
 ```
 
 ## Configuration
@@ -209,6 +218,14 @@ UNFOLD = {
         "dark": lambda request: static("logo-dark.svg"),  # dark mode
     },
     "SITE_SYMBOL": "speed",  # symbol from icon set
+    "SITE_FAVICONS": [
+        {
+            "rel": "icon",
+            "sizes": "32x32",
+            "type": "image/svg+xml",
+            "href": lambda request: static("favicon.svg"),
+        },
+    ],
     "SHOW_HISTORY": True, # show/hide "History" button, default: True
     "SHOW_VIEW_ON_SITE": True, # show/hide "View on site" button, default: True
     "ENVIRONMENT": "sample_app.environment_callback",
@@ -255,6 +272,7 @@ UNFOLD = {
             {
                 "title": _("Navigation"),
                 "separator": True,  # Top border
+                "collapsible": True,  # Collapsible group of links
                 "items": [
                     {
                         "title": _("Dashboard"),
@@ -345,6 +363,12 @@ class CustomAdminClass(ModelAdmin):
     # Display submit button in filters
     list_filter_submit = False
 
+    # Display changelist in fullwidth
+    list_fullwidth = False
+
+    # Position horizontal scrollbar in changelist at the top
+    list_horizontal_scrollbar_top = False
+
     # Custom actions
     actions_list = []  # Displayed above the results list
     actions_row = []  # Displayed in a table row in results list
@@ -438,7 +462,7 @@ class UserAdmin(ModelAdmin):
     actions_detail = ["change_detail_action_block"]
     actions_submit_line = ["submit_line_action_activate"]
 
-    @action(description=_("Save & Activate"))
+    @action(description=_("Save & Activate"), permissions=["submit_line_action_activate"])
     def submit_line_action_activate(self, request: HttpRequest, obj: User):
         """
         If instance is modified in any way, it also needs to be saved,
@@ -450,6 +474,9 @@ class UserAdmin(ModelAdmin):
         obj.is_active = True
         obj.save()
 
+    def has_submit_line_action_activate_permission(self, request: HttpRequest, object_id: Union[str, int]):
+        pass
+
     @action(description=_("Import"), url_path="import")
     def changelist_global_action_import(self, request: HttpRequest):
         """
@@ -474,7 +501,7 @@ class UserAdmin(ModelAdmin):
         """
         return redirect(f"https://example.com/{object_id}")
 
-    @action(description=_("Detail"), url_path="detail-action", attrs={"target": "_blank"})
+    @action(description=_("Detail"), url_path="detail-action", attrs={"target": "_blank"}, permissions=["change_detail_action_block"])
     def change_detail_action_block(self, request: HttpRequest, object_id: int):
         """
         Handler for detail action.
@@ -489,6 +516,10 @@ class UserAdmin(ModelAdmin):
         return redirect(
             reverse_lazy("admin:users_user_change", args=(object_id,))
         )
+
+
+    def has_change_detail_action_block_permission(self, request: HttpRequest, object_id: Union[str, int]):
+        pass
 ```
 
 ### Action with form example
@@ -511,10 +542,10 @@ class SomeForm(forms.Form):
 @register(User)
 class UserAdmin(ModelAdmin):
     actions_detail = ["change_detail_action_block"]
-    form = SomeForm(request.POST or None)
 
     @action(description=_("Detail"))
     def change_detail_action_block(self, request: HttpRequest, object_id: int) -> str:
+        form = SomeForm(request.POST or None)
         user = User.objects.get(pk=object_id)
 
         if request.method == "POST" and form.is_valid():
@@ -560,7 +591,7 @@ Text input field which allows filtering by the free string submitted by the user
 
 `FieldTextFilter` requires just a model field name and the filter will make `__icontains` search on this field. There are no other things to configure so the integration in `list_filter` will be just one new row looking like `("model_field_name", FieldTextFilter)`.
 
-In the case of the `TextFilter`, it is needed the write a whole new class inheriting from `TextFilter` with a custom implementation of the `queryset` method and the `parameter_name` attribute. This attribute will be a representation of the search query parameter name in URI. The benefit of the `TextFilter` is the possibility of writing complex queries.
+In the case of the `TextFilter`, it is needed to write a whole new class inheriting from `TextFilter` with a custom implementation of the `queryset` method and the `parameter_name` attribute. This attribute will be a representation of the search query parameter name in URI. The benefit of the `TextFilter` is the possibility of writing complex queries.
 
 ```python
 from django.contrib import admin
@@ -595,7 +626,7 @@ class MyAdmin(ModelAdmin):
 
 Dropdown filters will display a select field with a list of options. Unfold contains two types of dropdowns: `ChoicesDropdownFilter` and `RelatedDropdownFilter`.
 
-The difference between them is that `ChoicesDropdownFilter` will collect a list of options based on the `choices` attribute of the model field so most commonly it will be used in combination with `CharField` with specified `choices`.  On the other side, `RelatedDropdownFilter` needs a one-to-many or many-to-many foreign key to display options.
+The difference between them is that `ChoicesDropdownFilter` will collect a list of options based on the `choices` attribute of the model field so most commonly it will be used in combination with `CharField` with specified `choices`.  On the other hand, `RelatedDropdownFilter` needs a one-to-many or many-to-many foreign key to display options.
 
 **Note:** At the moment Unfold does not implement a dropdown with an autocomplete functionality, so it is important not to use dropdowns displaying large datasets.
 
@@ -904,6 +935,19 @@ class MyModelAdmin(ModelAdmin):
     )
 ```
 
+Inlines can be grouped into tab navigation by specifying `tab` attribute in the inline class.
+
+```python
+# admin.py
+
+from unfold.admin import TabularInline
+
+
+class MyInline(TabularInline):
+    model = User
+    tab = True
+```
+
 ## Third party packages
 
 ### django-celery-beat
@@ -973,11 +1017,11 @@ class ClockedScheduleAdmin(BaseClockedScheduleAdmin, ModelAdmin):
 
 ### django-guardian
 
-Adding support for django-guardian is quote straightforward in Unfold, just add `unfold.contrib.guardian` to `INSTALLED_APPS` at the beggining of the file. This action will override all templates coming from the django-guardian. Please note that **Object permissions** link is available in top right dropdown navigation.
+Adding support for django-guardian is quite straightforward in Unfold, just add `unfold.contrib.guardian` to `INSTALLED_APPS` at the beginning of the file. This action will override all templates coming from the django-guardian. Please note that **Object permissions** link is available in top right dropdown navigation.
 
 ### django-import-export
 
-1. Add `unfold.contrib.import_export` to `INSTALLED_APPS` at the beggining of the file. This action will override all templates coming from the application.
+1. Add `unfold.contrib.import_export` to `INSTALLED_APPS` at the beginning of the file. This action will override all templates coming from the application.
 2. Change `import_form_class` and `export_form_class` in ModelAdmin which is inheriting from `ImportExportModelAdmin`. This chunk of code is responsible for adding proper styling to form elements.
 
 ```python
@@ -1049,7 +1093,7 @@ This application is supported in Unfold by default. It is not needed to add any
 
 ### django-simple-history
 
-To make this application work, add `unfold.contrib.simple_history` into `settings.py` in `INSTALLED_APPS` variable before right after `unfold`. This app should ensure that templates coming from django-simple-history are overriden by Unfold.
+To make this application work, add `unfold.contrib.simple_history` into `settings.py` in `INSTALLED_APPS` variable before right after `unfold`. This app should ensure that templates coming from django-simple-history are overridden by Unfold.
 
 ## User Admin Form
 
@@ -1130,7 +1174,7 @@ npx tailwindcss -o your_project/static/css/styles.css --watch --minify
 
 ### Overriding template
 
-Create `templates/admin/index.html` in your project and paste the base template below into it. By default, all your custom styles here are not compiled because CSS classes are located in your specific project. Here it is needed to set up the Tailwind for your project and all requried instructions are located in [Project Level Tailwind Stylesheet](#project-level-tailwind-stylesheet) chapter.
+Create `templates/admin/index.html` in your project and paste the base template below into it. By default, all your custom styles here are not compiled because CSS classes are located in your specific project. Here it is needed to set up the Tailwind for your project and all required instructions are located in [Project Level Tailwind Stylesheet](#project-level-tailwind-stylesheet) chapter.
 
 ```html+django
 {% extends 'unfold/layouts/base_simple.html' %}
@@ -1252,7 +1296,7 @@ Below you can find a more complex example which is using multiple components and
 
 ### Pre-commit
 
-Before adding any source code, it is recommended to have pre-commit installed on your local computer to check for all potential issues when comitting the code.
+Before adding any source code, it is recommended to have pre-commit installed on your local computer to check for all potential issues when committing the code.
 
 ```bash
 pip install pre-commit
@@ -1272,7 +1316,7 @@ To add a new feature or fix the easiest approach is to use django-unfold in comb
 
 ### Compiling Tailwind
 
-At the moment project contains package.json with all dependencies required to compile new CSS file. Tailwind configuration file is set to check all html, js and py files for Tailwind's classeses occurrences.
+At the moment project contains package.json with all dependencies required to compile new CSS file. Tailwind configuration file is set to check all html, js and py files for Tailwind's classes occurrences.
 
 ```bash
 npm install
@@ -1282,7 +1326,7 @@ npm run tailwind:watch # run after each change in code
 npm run tailwind:build # run once
 ```
 
-Some components like datepickers, calendars or selectors in admin was not possible to style by overriding html templates so their default styles are overriden in **styles.css**.
+Some components like datepickers, calendars or selectors in admin was not possible to style by overriding html templates so their default styles are overridden in **styles.css**.
 
 **Note:** most of the custom styles located in style.css are created via `@apply some-tailwind-class;` as is not possible to manually add CSS class to element which are for example created via jQuery.
 

{django_unfold-0.29.1 → django_unfold-0.31.0}/README.md

@@ -9,7 +9,7 @@
 ![Code Style - Ruff](https://img.shields.io/badge/code%20style-ruff-30173D.svg?style=for-the-badge)
 ![Pre Commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=for-the-badge)
 
-Unfold is theme for Django admin incorporating most common practises for building full-fledged admin areas. It is designed to work at the top of default administration provided by Django.
+Unfold is a theme for Django admin incorporating most common practices for building full-fledged admin areas. It is designed to work on top of default administration provided by Django.
 
 - **Unfold:** demo site is available at [unfoldadmin.com](https://unfoldadmin.com?utm_medium=github&utm_source=unfold)
 - **Formula:** repository with demo implementation at [github.com/unfoldadmin/formula](https://github.com/unfoldadmin/formula)
@@ -21,7 +21,7 @@ Did you decide to start using Unfold but you don't have time to make the switch
 
 ## Features <!-- omit from toc -->
 
-- **Visual**: provides new user interface based on Tailwind CSS framework
+- **Visual**: provides a new user interface based on Tailwind CSS framework
 - **Sidebar:** simplifies definition of custom sidebar navigation with icons
 - **Dark mode:** supports both light and dark mode versions
 - **Configuration:** most of the basic options can be changed in settings.py
@@ -31,14 +31,16 @@ Did you decide to start using Unfold but you don't have time to make the switch
 - **Array widget:** built-in widget for `django.contrib.postgres.fields.ArrayField`
 - **Filters:** custom dropdown, numeric, datetime, and text fields
 - **Dashboard:** custom components for rapid dashboard development
+- **Inline tabs:** group inlines into tab navigation in the change form
 - **Model tabs:** define custom tab navigations for models
-- **Fieldset tabs:** merge several fielsets into tabs in change form
-- **Colors:** possibility to override default color scheme
-- **Changeform modes:** display fields in changeform in compressed mode
+- **Fieldset tabs:** merge several fieldsets into tabs in the change form
+- **Colors:** possibility to override the default color scheme
+- **Changeform modes:** display fields in the change form in compressed mode
 - **Third party packages:** default support for multiple popular applications
 - **Environment label**: distinguish between environments by displaying a label
 - **Nonrelated inlines**: displays nonrelated model as inline in changeform
 - **Parallel admin**: support for default admin in parallel with Unfold. [Admin migration guide](https://unfoldadmin.com/blog/migrating-django-admin-unfold/?utm_medium=github&utm_source=unfold)
+- **Favicons**: built-in support for configuring various site favicons
 - **VS Code**: project configuration and development container is included
 
 ## Table of contents <!-- omit from toc -->
@@ -87,7 +89,7 @@ Did you decide to start using Unfold but you don't have time to make the switch
 
 ## Installation
 
-The installation process is minimal. Everything what is needed after installation is to put new application at the beginning of **INSTALLED_APPS**. Default admin configuration in urls.py can stay as it is and there are no changes required.
+The installation process is minimal. Everything that is needed after installation is to put new application at the beginning of **INSTALLED_APPS**. The default admin configuration in urls.py can stay as it is, and no changes are required.
 
 ```python
 # settings.py
@@ -146,17 +148,24 @@ class CustomAdminClass(ModelAdmin):
 
 from django.contrib import admin
 from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
+from django.contrib.auth.admin import GroupAdmin as BaseGroupAdmin
 from django.contrib.auth.models import User
 
 from unfold.admin import ModelAdmin
 
 
 admin.site.unregister(User)
+admin.site.unregister(Group)
 
 
 @admin.register(User)
 class UserAdmin(BaseUserAdmin, ModelAdmin):
     pass
+
+
+@admin.register(Group)
+class GroupAdmin(BaseGroupAdmin, ModelAdmin):
+    pass
 ```
 
 ## Configuration
@@ -185,6 +194,14 @@ UNFOLD = {
         "dark": lambda request: static("logo-dark.svg"),  # dark mode
     },
     "SITE_SYMBOL": "speed",  # symbol from icon set
+    "SITE_FAVICONS": [
+        {
+            "rel": "icon",
+            "sizes": "32x32",
+            "type": "image/svg+xml",
+            "href": lambda request: static("favicon.svg"),
+        },
+    ],
     "SHOW_HISTORY": True, # show/hide "History" button, default: True
     "SHOW_VIEW_ON_SITE": True, # show/hide "View on site" button, default: True
     "ENVIRONMENT": "sample_app.environment_callback",
@@ -231,6 +248,7 @@ UNFOLD = {
             {
                 "title": _("Navigation"),
                 "separator": True,  # Top border
+                "collapsible": True,  # Collapsible group of links
                 "items": [
                     {
                         "title": _("Dashboard"),
@@ -321,6 +339,12 @@ class CustomAdminClass(ModelAdmin):
     # Display submit button in filters
     list_filter_submit = False
 
+    # Display changelist in fullwidth
+    list_fullwidth = False
+
+    # Position horizontal scrollbar in changelist at the top
+    list_horizontal_scrollbar_top = False
+
     # Custom actions
     actions_list = []  # Displayed above the results list
     actions_row = []  # Displayed in a table row in results list
@@ -414,7 +438,7 @@ class UserAdmin(ModelAdmin):
     actions_detail = ["change_detail_action_block"]
     actions_submit_line = ["submit_line_action_activate"]
 
-    @action(description=_("Save & Activate"))
+    @action(description=_("Save & Activate"), permissions=["submit_line_action_activate"])
     def submit_line_action_activate(self, request: HttpRequest, obj: User):
         """
         If instance is modified in any way, it also needs to be saved,
@@ -426,6 +450,9 @@ class UserAdmin(ModelAdmin):
         obj.is_active = True
         obj.save()
 
+    def has_submit_line_action_activate_permission(self, request: HttpRequest, object_id: Union[str, int]):
+        pass
+
     @action(description=_("Import"), url_path="import")
     def changelist_global_action_import(self, request: HttpRequest):
         """
@@ -450,7 +477,7 @@ class UserAdmin(ModelAdmin):
         """
         return redirect(f"https://example.com/{object_id}")
 
-    @action(description=_("Detail"), url_path="detail-action", attrs={"target": "_blank"})
+    @action(description=_("Detail"), url_path="detail-action", attrs={"target": "_blank"}, permissions=["change_detail_action_block"])
     def change_detail_action_block(self, request: HttpRequest, object_id: int):
         """
         Handler for detail action.
@@ -465,6 +492,10 @@ class UserAdmin(ModelAdmin):
         return redirect(
             reverse_lazy("admin:users_user_change", args=(object_id,))
         )
+
+
+    def has_change_detail_action_block_permission(self, request: HttpRequest, object_id: Union[str, int]):
+        pass
 ```
 
 ### Action with form example
@@ -487,10 +518,10 @@ class SomeForm(forms.Form):
 @register(User)
 class UserAdmin(ModelAdmin):
     actions_detail = ["change_detail_action_block"]
-    form = SomeForm(request.POST or None)
 
     @action(description=_("Detail"))
     def change_detail_action_block(self, request: HttpRequest, object_id: int) -> str:
+        form = SomeForm(request.POST or None)
         user = User.objects.get(pk=object_id)
 
         if request.method == "POST" and form.is_valid():
@@ -536,7 +567,7 @@ Text input field which allows filtering by the free string submitted by the user
 
 `FieldTextFilter` requires just a model field name and the filter will make `__icontains` search on this field. There are no other things to configure so the integration in `list_filter` will be just one new row looking like `("model_field_name", FieldTextFilter)`.
 
-In the case of the `TextFilter`, it is needed the write a whole new class inheriting from `TextFilter` with a custom implementation of the `queryset` method and the `parameter_name` attribute. This attribute will be a representation of the search query parameter name in URI. The benefit of the `TextFilter` is the possibility of writing complex queries.
+In the case of the `TextFilter`, it is needed to write a whole new class inheriting from `TextFilter` with a custom implementation of the `queryset` method and the `parameter_name` attribute. This attribute will be a representation of the search query parameter name in URI. The benefit of the `TextFilter` is the possibility of writing complex queries.
 
 ```python
 from django.contrib import admin
@@ -571,7 +602,7 @@ class MyAdmin(ModelAdmin):
 
 Dropdown filters will display a select field with a list of options. Unfold contains two types of dropdowns: `ChoicesDropdownFilter` and `RelatedDropdownFilter`.
 
-The difference between them is that `ChoicesDropdownFilter` will collect a list of options based on the `choices` attribute of the model field so most commonly it will be used in combination with `CharField` with specified `choices`.  On the other side, `RelatedDropdownFilter` needs a one-to-many or many-to-many foreign key to display options.
+The difference between them is that `ChoicesDropdownFilter` will collect a list of options based on the `choices` attribute of the model field so most commonly it will be used in combination with `CharField` with specified `choices`.  On the other hand, `RelatedDropdownFilter` needs a one-to-many or many-to-many foreign key to display options.
 
 **Note:** At the moment Unfold does not implement a dropdown with an autocomplete functionality, so it is important not to use dropdowns displaying large datasets.
 
@@ -880,6 +911,19 @@ class MyModelAdmin(ModelAdmin):
     )
 ```
 
+Inlines can be grouped into tab navigation by specifying `tab` attribute in the inline class.
+
+```python
+# admin.py
+
+from unfold.admin import TabularInline
+
+
+class MyInline(TabularInline):
+    model = User
+    tab = True
+```
+
 ## Third party packages
 
 ### django-celery-beat
@@ -949,11 +993,11 @@ class ClockedScheduleAdmin(BaseClockedScheduleAdmin, ModelAdmin):
 
 ### django-guardian
 
-Adding support for django-guardian is quote straightforward in Unfold, just add `unfold.contrib.guardian` to `INSTALLED_APPS` at the beggining of the file. This action will override all templates coming from the django-guardian. Please note that **Object permissions** link is available in top right dropdown navigation.
+Adding support for django-guardian is quite straightforward in Unfold, just add `unfold.contrib.guardian` to `INSTALLED_APPS` at the beginning of the file. This action will override all templates coming from the django-guardian. Please note that **Object permissions** link is available in top right dropdown navigation.
 
 ### django-import-export
 
-1. Add `unfold.contrib.import_export` to `INSTALLED_APPS` at the beggining of the file. This action will override all templates coming from the application.
+1. Add `unfold.contrib.import_export` to `INSTALLED_APPS` at the beginning of the file. This action will override all templates coming from the application.
 2. Change `import_form_class` and `export_form_class` in ModelAdmin which is inheriting from `ImportExportModelAdmin`. This chunk of code is responsible for adding proper styling to form elements.
 
 ```python
@@ -1025,7 +1069,7 @@ This application is supported in Unfold by default. It is not needed to add any
 
 ### django-simple-history
 
-To make this application work, add `unfold.contrib.simple_history` into `settings.py` in `INSTALLED_APPS` variable before right after `unfold`. This app should ensure that templates coming from django-simple-history are overriden by Unfold.
+To make this application work, add `unfold.contrib.simple_history` into `settings.py` in `INSTALLED_APPS` variable before right after `unfold`. This app should ensure that templates coming from django-simple-history are overridden by Unfold.
 
 ## User Admin Form
 
@@ -1106,7 +1150,7 @@ npx tailwindcss -o your_project/static/css/styles.css --watch --minify
 
 ### Overriding template
 
-Create `templates/admin/index.html` in your project and paste the base template below into it. By default, all your custom styles here are not compiled because CSS classes are located in your specific project. Here it is needed to set up the Tailwind for your project and all requried instructions are located in [Project Level Tailwind Stylesheet](#project-level-tailwind-stylesheet) chapter.
+Create `templates/admin/index.html` in your project and paste the base template below into it. By default, all your custom styles here are not compiled because CSS classes are located in your specific project. Here it is needed to set up the Tailwind for your project and all required instructions are located in [Project Level Tailwind Stylesheet](#project-level-tailwind-stylesheet) chapter.
 
 ```html+django
 {% extends 'unfold/layouts/base_simple.html' %}
@@ -1228,7 +1272,7 @@ Below you can find a more complex example which is using multiple components and
 
 ### Pre-commit
 
-Before adding any source code, it is recommended to have pre-commit installed on your local computer to check for all potential issues when comitting the code.
+Before adding any source code, it is recommended to have pre-commit installed on your local computer to check for all potential issues when committing the code.
 
 ```bash
 pip install pre-commit
@@ -1248,7 +1292,7 @@ To add a new feature or fix the easiest approach is to use django-unfold in comb
 
 ### Compiling Tailwind
 
-At the moment project contains package.json with all dependencies required to compile new CSS file. Tailwind configuration file is set to check all html, js and py files for Tailwind's classeses occurrences.
+At the moment project contains package.json with all dependencies required to compile new CSS file. Tailwind configuration file is set to check all html, js and py files for Tailwind's classes occurrences.
 
 ```bash
 npm install
@@ -1258,7 +1302,7 @@ npm run tailwind:watch # run after each change in code
 npm run tailwind:build # run once
 ```
 
-Some components like datepickers, calendars or selectors in admin was not possible to style by overriding html templates so their default styles are overriden in **styles.css**.
+Some components like datepickers, calendars or selectors in admin was not possible to style by overriding html templates so their default styles are overridden in **styles.css**.
 
 **Note:** most of the custom styles located in style.css are created via `@apply some-tailwind-class;` as is not possible to manually add CSS class to element which are for example created via jQuery.
 

{django_unfold-0.29.1 → django_unfold-0.31.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "django-unfold"
-version = "0.29.1"
+version = "0.31.0"
 description = "Modern Django admin theme for seamless interface development"
 license = "MIT"
 readme = "README.md"

{django_unfold-0.29.1 → django_unfold-0.31.0}/src/unfold/admin.py

@@ -1,6 +1,6 @@
 import copy
 from functools import update_wrapper
-from typing import Any, Callable, Dict, List, Optional, Tuple
+from typing import Any, Callable, Dict, List, Optional, Tuple, Union
 
 from django import forms
 from django.contrib.admin import ModelAdmin as BaseModelAdmin
@@ -148,6 +148,7 @@ class ModelAdminMixin:
             else:
                 kwargs["widget"] = UnfoldAdminSelectWidget()
 
+        if "choices" not in kwargs:
             kwargs["choices"] = db_field.get_choices(
                 include_blank=db_field.blank, blank_choice=[("", _("Select value"))]
             )
@@ -227,7 +228,10 @@ class ModelAdmin(ModelAdminMixin, BaseModelAdmin):
     actions_submit_line = ()
     custom_urls = ()
     add_fieldsets = ()
+    list_horizontal_scrollbar_top = False
     list_filter_submit = False
+    list_fullwidth = False
+    compressed_fields = False
     readonly_preprocess_fields = {}
     checks_class = UnfoldModelAdminChecks
 
@@ -253,7 +257,10 @@ class ModelAdmin(ModelAdminMixin, BaseModelAdmin):
         return super().get_fieldsets(request, obj)
 
     def _filter_unfold_actions_by_permissions(
-        self, request: HttpRequest, actions: List[UnfoldAction]
+        self,
+        request: HttpRequest,
+        actions: List[UnfoldAction],
+        object_id: Optional[Union[int, str]] = None,
     ) -> List[UnfoldAction]:
         """Filter out any Unfold actions that the user doesn't have access to."""
         filtered_actions = []
@@ -261,12 +268,22 @@ class ModelAdmin(ModelAdminMixin, BaseModelAdmin):
             if not hasattr(action.method, "allowed_permissions"):
                 filtered_actions.append(action)
                 continue
+
             permission_checks = (
                 getattr(self, f"has_{permission}_permission")
                 for permission in action.method.allowed_permissions
             )
-            if any(has_permission(request) for has_permission in permission_checks):
-                filtered_actions.append(action)
+
+            if object_id:
+                if any(
+                    has_permission(request, object_id)
+                    for has_permission in permission_checks
+                ):
+                    filtered_actions.append(action)
+            else:
+                if any(has_permission(request) for has_permission in permission_checks):
+                    filtered_actions.append(action)
+
         return filtered_actions
 
     def get_actions_list(self, request: HttpRequest) -> List[UnfoldAction]:
@@ -280,9 +297,11 @@ class ModelAdmin(ModelAdminMixin, BaseModelAdmin):
         """
         return [self.get_unfold_action(action) for action in self.actions_list or []]
 
-    def get_actions_detail(self, request: HttpRequest) -> List[UnfoldAction]:
+    def get_actions_detail(
+        self, request: HttpRequest, object_id: int
+    ) -> List[UnfoldAction]:
         return self._filter_unfold_actions_by_permissions(
-            request, self._get_base_actions_detail()
+            request, self._get_base_actions_detail(), object_id
         )
 
     def _get_base_actions_detail(self) -> List[UnfoldAction]:
@@ -302,9 +321,11 @@ class ModelAdmin(ModelAdminMixin, BaseModelAdmin):
         """
         return [self.get_unfold_action(action) for action in self.actions_row or []]
 
-    def get_actions_submit_line(self, request: HttpRequest) -> List[UnfoldAction]:
+    def get_actions_submit_line(
+        self, request: HttpRequest, object_id: int
+    ) -> List[UnfoldAction]:
         return self._filter_unfold_actions_by_permissions(
-            request, self._get_base_actions_submit_line()
+            request, self._get_base_actions_submit_line(), object_id
         )
 
     def _get_base_actions_submit_line(self) -> List[UnfoldAction]:
@@ -402,7 +423,7 @@ class ModelAdmin(ModelAdminMixin, BaseModelAdmin):
 
         actions = []
         if object_id:
-            for action in self.get_actions_detail(request):
+            for action in self.get_actions_detail(request, object_id):
                 actions.append(
                     {
                         "title": action.description,
@@ -416,7 +437,7 @@ class ModelAdmin(ModelAdminMixin, BaseModelAdmin):
 
         extra_context.update(
             {
-                "actions_submit_line": self.get_actions_submit_line(request),
+                "actions_submit_line": self.get_actions_submit_line(request, object_id),
                 "actions_detail": actions,
             }
         )
@@ -483,7 +504,7 @@ class ModelAdmin(ModelAdminMixin, BaseModelAdmin):
     ) -> None:
         super().save_model(request, obj, form, change)
 
-        for action in self.get_actions_submit_line(request):
+        for action in self.get_actions_submit_line(request, obj.pk):
             if action.action_name not in request.POST:
                 continue
 

{django_unfold-0.29.1 → django_unfold-0.31.0}/src/unfold/contrib/filters/templates/unfold/filters/filters_numeric_slider.html

@@ -9,11 +9,11 @@
 
         {% if choice.min is not None and choice.max is not None and choice.step %}
             <div class="admin-numeric-filter-slider-tooltips">
-                <span class="admin-numeric-filter-slider-tooltip-from border cursor-not-allowed flex flex-grow flex-row items-center mr-auto rounded-md shadow-sm px-3 py-2 w-full dark:bg-gray-900 dark:border-gray-700 dark:text-gray-400">
+                <span class="admin-numeric-filter-slider-tooltip-from border cursor-not-allowed flex flex-grow flex-row items-center mr-auto rounded-md shadow-sm px-3 py-2 w-full dark:bg-gray-900 dark:border-gray-700 dark:text-gray-300">
                     {{ choice.value_from }}
                 </span>
 
-                <span class="admin-numeric-filter-slider-tooltip-to border cursor-not-allowed flex flex-grow flex-row items-center rounded-md shadow-sm px-3 py-2 w-full dark:bg-gray-900 dark:border-gray-700 dark:text-gray-400">
+                <span class="admin-numeric-filter-slider-tooltip-to border cursor-not-allowed flex flex-grow flex-row items-center rounded-md shadow-sm px-3 py-2 w-full dark:bg-gray-900 dark:border-gray-700 dark:text-gray-300">
                     {{ choice.value_to }}
                 </span>
             </div>
@@ -25,7 +25,7 @@
                 {{ choice.form.as_p }}
             </div>
         {% else %}
-            <div class="admin-numeric-filter-slider-error dark:text-gray-400">
+            <div class="admin-numeric-filter-slider-error dark:text-gray-300">
                 <p>
                     {% trans 'Not enough data.' %}
                 </p>