django-unfold 0.61.0__tar.gz → 0.63.0__tar.gz

{django_unfold-0.61.0 → django_unfold-0.63.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: django-unfold
-Version: 0.61.0
+Version: 0.63.0
 Summary: Modern Django admin theme for seamless interface development
 License: MIT
 Keywords: django,admin,tailwind,theme
@@ -59,11 +59,11 @@ Unfold Studio lets you visually customize your Django admin without writing code
 
 ## Fresh Features & Enhancements
 
+- **django-constance**: Official support with a completely new design and UX improvements
 - **Paginated inlines:** Break down large record sets into pages within inlines for better admin performance
 - **Conditional fields:** Show or hide fields dynamically based on the values of other fields in the form
 - **Infinite paginator:** Efficiently handle large datasets with seamless pagination that reduces server load
 - **Checkbox & radio filters:** Enhanced filter options with checkbox and radio interfaces for intuitive filtering
-- **Site dropdown:** Configurable dropdown menu in the header area for managing custom navigation links
 
 ## Core Features & Capabilities
 
@@ -74,6 +74,7 @@ Unfold Studio lets you visually customize your Django admin without writing code
 - **Advanced filters**: Features custom dropdowns, autocomplete, numeric, datetime, and text field filters.
 - **Dashboard tools**: Includes helpers for building custom dashboard pages.
 - **UI components**: Offers reusable interface components such as cards, buttons, and charts.
+- **Crispy forms**: Custom template pack for django-crispy-forms to style forms with Unfold's design system
 - **WYSIWYG editor**: Built-in support for WYSIWYG editing through Trix.
 - **Array widget:** Built-in widget for `django.contrib.postgres.fields.ArrayField`
 - **Inline tabs:** Group inlines into tab navigation in the change form
@@ -96,8 +97,20 @@ Unfold Studio lets you visually customize your Django admin without writing code
 - **Dependencies:** Built entirely on `django.contrib.admin`.
 - **VS Code:** Project configuration and development container included.
 
+## Third-party package support
+
+- [django-guardian](https://github.com/django-guardian/django-guardian) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-guardian/)
+- [django-import-export](https://github.com/django-import-export/django-import-export) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-import-export/)
+- [django-simple-history](https://github.com/jazzband/django-simple-history) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-simple-history/)
+- [django-constance](https://github.com/jazzband/django-constance) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-constance/)
+- [django-celery-beat](https://github.com/celery/django-celery-beat) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-celery-beat/)
+- [django-modeltranslation](https://github.com/deschler/django-modeltranslation) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-modeltranslation/)
+- [django-money](https://github.com/django-money/django-money) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-money/)
+- [django-location-field](https://github.com/caioariede/django-location-field) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-location-field/)
+
 ## Credits
 
+- **Tailwind**: [Tailwind CSS](https://github.com/tailwindlabs/tailwindcss) - Licensed under the [MIT License](https://opensource.org/licenses/MIT).
 - **Icons**: [Material Symbols](https://github.com/google/material-design-icons) - Licensed under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
 - **Font**: [Inter](https://github.com/rsms/inter) - Licensed under the [SIL Open Font License 1.1](https://scripts.sil.org/OFL).
 - **Charts**: [Chart.js](https://github.com/chartjs/Chart.js) - Licensed under the [MIT License](https://opensource.org/licenses/MIT).

{django_unfold-0.61.0 → django_unfold-0.63.0}/README.md

@@ -35,11 +35,11 @@ Unfold Studio lets you visually customize your Django admin without writing code
 
 ## Fresh Features & Enhancements
 
+- **django-constance**: Official support with a completely new design and UX improvements
 - **Paginated inlines:** Break down large record sets into pages within inlines for better admin performance
 - **Conditional fields:** Show or hide fields dynamically based on the values of other fields in the form
 - **Infinite paginator:** Efficiently handle large datasets with seamless pagination that reduces server load
 - **Checkbox & radio filters:** Enhanced filter options with checkbox and radio interfaces for intuitive filtering
-- **Site dropdown:** Configurable dropdown menu in the header area for managing custom navigation links
 
 ## Core Features & Capabilities
 
@@ -50,6 +50,7 @@ Unfold Studio lets you visually customize your Django admin without writing code
 - **Advanced filters**: Features custom dropdowns, autocomplete, numeric, datetime, and text field filters.
 - **Dashboard tools**: Includes helpers for building custom dashboard pages.
 - **UI components**: Offers reusable interface components such as cards, buttons, and charts.
+- **Crispy forms**: Custom template pack for django-crispy-forms to style forms with Unfold's design system
 - **WYSIWYG editor**: Built-in support for WYSIWYG editing through Trix.
 - **Array widget:** Built-in widget for `django.contrib.postgres.fields.ArrayField`
 - **Inline tabs:** Group inlines into tab navigation in the change form
@@ -72,8 +73,20 @@ Unfold Studio lets you visually customize your Django admin without writing code
 - **Dependencies:** Built entirely on `django.contrib.admin`.
 - **VS Code:** Project configuration and development container included.
 
+## Third-party package support
+
+- [django-guardian](https://github.com/django-guardian/django-guardian) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-guardian/)
+- [django-import-export](https://github.com/django-import-export/django-import-export) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-import-export/)
+- [django-simple-history](https://github.com/jazzband/django-simple-history) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-simple-history/)
+- [django-constance](https://github.com/jazzband/django-constance) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-constance/)
+- [django-celery-beat](https://github.com/celery/django-celery-beat) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-celery-beat/)
+- [django-modeltranslation](https://github.com/deschler/django-modeltranslation) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-modeltranslation/)
+- [django-money](https://github.com/django-money/django-money) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-money/)
+- [django-location-field](https://github.com/caioariede/django-location-field) - [Integration guide](https://unfoldadmin.com/docs/integrations/django-location-field/)
+
 ## Credits
 
+- **Tailwind**: [Tailwind CSS](https://github.com/tailwindlabs/tailwindcss) - Licensed under the [MIT License](https://opensource.org/licenses/MIT).
 - **Icons**: [Material Symbols](https://github.com/google/material-design-icons) - Licensed under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
 - **Font**: [Inter](https://github.com/rsms/inter) - Licensed under the [SIL Open Font License 1.1](https://scripts.sil.org/OFL).
 - **Charts**: [Chart.js](https://github.com/chartjs/Chart.js) - Licensed under the [MIT License](https://opensource.org/licenses/MIT).

{django_unfold-0.61.0 → django_unfold-0.63.0}/pyproject.toml

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

django_unfold-0.63.0/src/unfold/contrib/constance/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class ConstanceConfig(AppConfig):
+    name = "unfold.contrib.constance"
+    label = "unfold_constance"

django_unfold-0.63.0/src/unfold/contrib/constance/settings.py

@@ -0,0 +1,32 @@
+UNFOLD_CONSTANCE_ADDITIONAL_FIELDS = {
+    str: [
+        "django.forms.CharField",
+        {
+            "widget": "unfold.widgets.UnfoldAdminTextInputWidget",
+        },
+    ],
+    int: [
+        "django.forms.IntegerField",
+        {
+            "widget": "unfold.widgets.UnfoldAdminIntegerFieldWidget",
+        },
+    ],
+    bool: [
+        "django.forms.BooleanField",
+        {
+            "widget": "unfold.widgets.UnfoldBooleanSwitchWidget",
+        },
+    ],
+    "file_field": [
+        "django.forms.fields.FileField",
+        {
+            "widget": "unfold.widgets.UnfoldAdminFileFieldWidget",
+        },
+    ],
+    "image_field": [
+        "django.forms.fields.ImageField",
+        {
+            "widget": "unfold.widgets.UnfoldAdminImageFieldWidget",
+        },
+    ],
+}

django_unfold-0.63.0/src/unfold/contrib/constance/templates/admin/constance/change_list.html

@@ -0,0 +1,70 @@
+{% extends "admin/base_site.html" %}
+
+{% load admin_list static i18n %}
+
+{% block extrahead %}
+    {% url 'admin:jsi18n' as jsi18nurl %}
+    <script type="text/javascript" src="{{ jsi18nurl|default:'../../jsi18n/' }}"></script>
+    {{ block.super }}
+    {{ media.js }}
+    <script type="text/javascript" src="{% static 'admin/js/constance.js' %}"></script>
+{% endblock %}
+
+{% block breadcrumbs %}
+    <div class="px-4">
+        <div class="container mb-6 mx-auto -my-3 lg:mb-12">
+            <ul class="flex flex-wrap">
+                {% url 'admin:index' as link %}
+                {% trans 'Home' as name %}
+                {% include 'unfold/helpers/breadcrumb_item.html' with link=link name=name %}
+
+                {% url 'admin:app_list' app_label=opts.app_label as link %}
+                {% include 'unfold/helpers/breadcrumb_item.html' with link=link name=opts.app_config.verbose_name %}
+
+                {% include 'unfold/helpers/breadcrumb_item.html' with link='' name=opts.verbose_name_plural|capfirst %}
+            </ul>
+        </div>
+    </div>
+{% endblock %}
+
+
+{% block content %}
+    <div id="content-main" class="constance">
+        <div id="changelist" class="flex flex-col gap-8 w-full">
+            <form id="changelist-form" action="" method="post" enctype="multipart/form-data" novalidate class="flex flex-col gap-8 w-full">
+                {% csrf_token %}
+
+                {% include "unfold/helpers/form_errors.html" with errors=form.non_field_errors %}
+
+                {% for field in form.hidden_fields %}
+                    {{ field }}
+                {% endfor %}
+
+                {% if fieldsets %}
+                    <div class="border border-base-200 rounded-default overflow-x-auto simplebar-horizontal-scrollbar-top dark:border-base-800" data-simplebar data-simplebar-auto-hide="false">
+                        <table class="w-full border-collapse">
+                            {% for fieldset in fieldsets %}
+                                {% with config_values=fieldset.config_values %}
+                                    {% include "admin/constance/includes/results_list.html" %}
+                                {% endwith %}
+                            {% endfor %}
+
+                            <tfoot>
+                                <tr>
+                                    <td class="border-t border-base-200 px-3 py-2 dark:border-base-800" colspan="100%">
+                                        <div class="flex justify-end">
+                                            {% trans "Save" as title %}
+                                            {% include "unfold/helpers/submit.html" with title=title %}
+                                        </div>
+                                    </td>
+                                </tr>
+                            </tfoot>
+                        </table>
+                    </div>
+                {% else %}
+                    {% include "admin/constance/includes/results_list.html" %}
+                {% endif %}
+            </form>
+        </div>
+    </div>
+{% endblock %}

django_unfold-0.63.0/src/unfold/contrib/constance/templates/admin/constance/includes/results_list.html

@@ -0,0 +1,71 @@
+{% load admin_list static i18n %}
+
+<tbody {% if fieldset.collapse %} x-data="{ rowsOpen: false }" {% endif %}>
+    <tr {% if fieldset.collapse %} x-on:click="rowsOpen = !rowsOpen" {% endif %} class="{% if fieldset.collapse %}cursor-pointer{% endif %}">
+        <th class="bg-base-50 border-t border-base-200 font-semibold px-3 py-2 text-left text-font-important-light dark:text-font-important-dark dark:border-base-800 dark:bg-white/[.04] {% if forloop.first %}border-t-0{% endif %}" colspan="100%">
+            {{ fieldset.title }}
+
+            {% if fieldset.collapse %}
+                <span class="material-symbols-outlined float-right select-none transition-all" title="{% trans "Collapse" %}" x-bind:class="rowsOpen ? 'rotate-180' : ''">
+                    expand_more
+                </span>
+            {% endif %}
+        </th>
+    </tr>
+
+    <tr class="border-t border-base-200 dark:border-base-800 *:font-semibold *:px-3 *:py-2 *:text-left *:text-font-important-light dark:*:text-font-important-dark" {% if fieldset.collapse %}x-show="rowsOpen"{% endif %}>
+        <th>{% trans "Name" %}</th>
+        <th>{% trans "Value" %}</th>
+        <th>{% trans "Default" %}</th>
+        <th>{% trans "Code" %}</th>
+        <th>{% trans "Modified" %}</th>
+        <th></th>
+    </tr>
+
+    {% for item in config_values %}
+        <tr class="border-t border-base-200 h-[55px] *:px-3 *:py-2 *:align-middle dark:border-base-800" {% if fieldset.collapse %}x-show="rowsOpen"{% endif %}>
+            <th class="font-normal text-left">
+                {{ item.help_text|linebreaksbr }}
+            </th>
+
+            <td class="{% if item.form_field.errors %}group errors{% endif %}">
+                {{ item.form_field }}
+
+                {% include "unfold/helpers/form_errors.html" with errors=item.form_field.errors %}
+            </td>
+
+            <td>
+                {% if item.default %}
+                    {% include "unfold/helpers/label.html" with text=item.default %}
+                {% else %}
+                    -
+                {% endif %}
+            </td>
+
+            <td>
+                <a class="item-name item-anchor" href="#{{ item.name|slugify }}" tabindex="-1" id="{{ item.name|slugify }}" title="Link to this setting">
+                    {% include "unfold/helpers/label.html" with text=item.name type="info" %}
+                </a>
+            </td>
+
+            <td>
+                {% include "unfold/helpers/boolean.html" with value=item.modified %}
+            </td>
+
+            <td class="w-px">
+                {% if not item.is_file %}
+                    <a href="#"
+                       tabindex="-1"
+                       class="flex items-center gap-1 reset-link whitespace-nowrap"
+                       data-default="{% spaceless %}{% if item.is_checkbox %}{% if item.raw_default %} true {% else %} false {% endif %}{% elif item.is_date %}{{ item.raw_default|date:"U" }}{% elif item.is_datetime %}{{ item.raw_default|date:"U" }}{% else %}{{ item.default }}{% endif %}{% endspaceless %}"
+                       data-field-type="{% spaceless %}{% if item.is_checkbox %}checkbox{% elif item.is_datetime %}datetime{% elif item.is_date %}date{% endif %}{% endspaceless %}"
+                       data-field-id="{{ item.form_field.auto_id }}">
+                        <span class="material-symbols-outlined text-base-400 hover:text-base-700  dark:border-base-700 dark:text-base-500 dark:hover:text-base-200" title="{% trans "Reset to default" %}">
+                            refresh
+                        </span>
+                    </a>
+                {% endif %}
+            </td>
+        </tr>
+    {% endfor %}
+</tbody>

{django_unfold-0.61.0 → django_unfold-0.63.0}/src/unfold/contrib/forms/widgets.py

@@ -33,14 +33,25 @@ WYSIWYG_CLASSES = [
 class ArrayWidget(MultiWidget):
     template_name = "unfold/forms/array.html"
 
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
+    def __init__(
+        self,
+        widget_class: Optional[type[Widget]] = None,
+        *args: Any,
+        **kwargs: Any,
+    ) -> None:
         if "choices" in kwargs:
             self.choices = kwargs["choices"]
 
+        if widget_class is not None:
+            self.widget_class = widget_class
+
         widgets = [self.get_widget_instance()]
         super().__init__(widgets)
 
     def get_widget_instance(self) -> Any:
+        if hasattr(self, "widget_class"):
+            return self.widget_class()
+
         if hasattr(self, "choices"):
             return UnfoldAdminSelectWidget(choices=self.choices)
 

{django_unfold-0.61.0 → django_unfold-0.63.0}/src/unfold/fields.py

@@ -139,7 +139,7 @@ class UnfoldAdminReadonlyField(helpers.AdminReadonlyField):
                     result_repr = display_for_field(value, f, self.empty_value_display)
                     return conditional_escape(result_repr)
                 elif isinstance(f, models.URLField):
-                    return format_html(
+                    return value and format_html(
                         '<a href="{}" class="text-primary-600 dark:text-primary-500">{}</a>',
                         value,
                         value,

{django_unfold-0.61.0 → django_unfold-0.63.0}/src/unfold/static/admin/js/inlines.js

@@ -310,7 +310,7 @@
   };
 
   // Tabular inlines ---------------------------------------------------------
-  $.fn.tabularFormset = function (selector, options) {
+  $.fn.tabularFormset = function (selector, options, callback = null) {
     const $rows = $(this);
 
     const reinitDateTimeShortCuts = function () {
@@ -370,11 +370,15 @@
       addButton: options.addButton,
     });
 
+    if (typeof callback === "function") {
+      callback();
+    }
+
     return $rows;
   };
 
   // Stacked inlines ---------------------------------------------------------
-  $.fn.stackedFormset = function (selector, options) {
+  $.fn.stackedFormset = function (selector, options, callback = null) {
     const $rows = $(this);
     const updateInlineLabel = function (row) {
       $(selector)
@@ -449,26 +453,47 @@
       addButton: options.addButton,
     });
 
+    if (typeof callback === "function") {
+      callback();
+    }
+
     return $rows;
   };
 
+  $(window).on("htmx:afterSettle", function (event) {
+    if (event.target.classList.contains("js-inline-admin-formset")) {
+      initInlines($(event.target), function () {
+        if (typeof DateTimeShortcuts !== "undefined") {
+          $(".datetimeshortcuts").remove();
+          DateTimeShortcuts.init();
+        }
+
+        $(event.target).find(".admin-autocomplete").djangoAdminSelect2();
+      });
+    }
+  });
+
   $(document).ready(function () {
     $(".js-inline-admin-formset").each(function () {
-      const data = $(this).data(),
-        inlineOptions = data.inlineFormset;
-      let selector;
-      switch (data.inlineType) {
-        case "stacked":
-          selector = inlineOptions.name + "-group .inline-related";
-          $(selector).stackedFormset(selector, inlineOptions.options);
-          break;
-        case "tabular":
-          selector =
-            inlineOptions.name +
-            "-group .tabular.inline-related tbody:last > tr.form-row";
-          $(selector).tabularFormset(selector, inlineOptions.options);
-          break;
-      }
+      initInlines(this);
     });
   });
+
+  function initInlines(el, callback = null) {
+    const data = $(el).data(),
+      inlineOptions = data.inlineFormset;
+    let selector;
+    switch (data.inlineType) {
+      case "stacked":
+        selector = inlineOptions.name + "-group .inline-related";
+        $(selector).stackedFormset(selector, inlineOptions.options, callback);
+        break;
+      case "tabular":
+        selector =
+          inlineOptions.name +
+          "-group .tabular.inline-related tbody:last > tr.form-row";
+        $(selector).tabularFormset(selector, inlineOptions.options, callback);
+        break;
+    }
+  }
 }