feat: readonly file/image fields (#1591)

Author: lukasvinclav

src/unfold/fields.py

@@ -1,8 +1,11 @@
+from typing import Union
+
 from django.contrib.admin import helpers
 from django.contrib.admin.utils import lookup_field, quote
 from django.core.exceptions import ObjectDoesNotExist
 from django.db import models
 from django.db.models import (
+    FileField,
     ForeignObjectRel,
     ImageField,
     JSONField,
@@ -36,6 +39,30 @@ def label_tag(self) -> SafeText:
 
         return format_html("<label{}>{}</label>", flatatt(attrs), capfirst(label))
 
+    @property
+    def url(self) -> Union[str, bool]:
+        field, obj, model_admin = (
+            self.field["field"],
+            self.form.instance,
+            self.model_admin,
+        )
+
+        try:
+            f, attr, value = lookup_field(field, obj, model_admin)
+        except (AttributeError, ValueError, ObjectDoesNotExist):
+            return False
+
+        if not self.is_file():
+            return False
+
+        if hasattr(obj, field):
+            field_value = getattr(obj, field)
+
+            if field_value and hasattr(field_value, "url"):
+                return field_value.url
+
+        return False
+
     def is_json(self) -> bool:
         field, obj, model_admin = (
             self.field["field"],
@@ -73,6 +100,20 @@ def is_image(self) -> bool:
 
         return isinstance(f, ImageField)
 
+    def is_file(self) -> bool:
+        field, obj, model_admin = (
+            self.field["field"],
+            self.form.instance,
+            self.model_admin,
+        )
+
+        try:
+            f, attr, value = lookup_field(field, obj, model_admin)
+        except (AttributeError, ValueError, ObjectDoesNotExist):
+            return False
+
+        return isinstance(f, (ImageField, FileField))
+
     def contents(self) -> str:
         contents = self._get_contents()
         contents = self._preprocess_field(contents)

src/unfold/templates/unfold/helpers/field_readonly_value.html

@@ -1 +1 @@
-<div class="readonly break-words {% if field.is_json %}max-w-4xl{% else %}max-w-2xl{% endif %} py-2 text-sm *:rounded-default {% if not adminform.model_admin.compressed_fields and not field.is_image %}bg-base-50 border border-base-200 font-medium px-3 rounded-default shadow-xs dark:border-base-700 dark:bg-base-800{% endif %} {% if field.is_image %}inline-block [&_img]:rounded-default py-0!{% endif %}">{% if value %}{{ value }}{% elif field.contents %}{{ field.contents }}{% else %}-{% endif %}</div>
+<div class="readonly break-words {% if field.is_json %}max-w-4xl{% else %}max-w-2xl{% endif %} py-2 text-sm *:rounded-default {% if not adminform.model_admin.compressed_fields and not field.is_image %}bg-base-50 border border-base-200 font-medium px-3 rounded-default shadow-xs dark:border-base-700 dark:bg-base-800{% endif %}">{% if value %}{{ value }}{% elif field.contents %}{% if field.is_file %}{% include "unfold/helpers/field_readonly_value_file.html" %}{% else %}{{ field.contents }}{% endif %}{% else %}-{% endif %}</div>

src/unfold/templates/unfold/helpers/field_readonly_value_file.html

@@ -0,0 +1,18 @@
+{% load i18n %}
+
+{% with url=field.url %}
+    {% if not url %}
+        <span class="flex items-center">-<span>
+    {% elif field.is_image %}
+        <a href="{{ url }}" target="_blank" class="block max-w-48">
+            <img src="{{ url }}" alt="{% trans 'Image preview' %}" class="block rounded-default" />
+        </a>
+    {% else %}
+        <a href="{{ url }}" target="_blank">
+            <span class="flex items-center gap-2">
+                <span class="text-primary-600 dark:text-primary-500">{% trans "Click to download" %}</span>
+                <span class="material-symbols-outlined text-base-400 dark:text-base-500">download</span>
+            </span>
+        </a>
+    {% endif %}
+{% endwith %}