feat(model): add FilePathField for static file (logo) path

ref to fabiocaccamo#355

admin_interface/admin.py

@@ -58,6 +58,7 @@ class ThemeAdmin(admin.ModelAdmin):
                     "logo_max_height",
                     "logo_color",
                     "logo_visible",
+                    "static_logo_path",
                 ),
             },
         ),

admin_interface/migrations/0031_theme_static_logo_path.py

@@ -0,0 +1,24 @@
+# Generated by Django 5.0.3 on 2024-03-19 22:29
+
+import admin_interface.models
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("admin_interface", "0030_theme_collapsible_stacked_inlines_and_more"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="theme",
+            name="static_logo_path",
+            field=models.FilePathField(
+                blank=True,
+                match="^.*\\.(jpg|jpeg|png|svg)$",
+                max_length=255,
+                path=admin_interface.models.static_logo_directory_path,
+                verbose_name="static logo",
+            ),
+        ),
+    ]

admin_interface/models.py

@@ -5,10 +5,16 @@
 from django.dispatch import receiver
 from django.utils.encoding import force_str
 from django.utils.translation import gettext_lazy as _
+from django.conf import settings
+import os
 
 from .cache import del_cached_active_theme
 
 
+def static_logo_directory_path():
+    return settings.LOCAL_FILE_DIR
+
+
 class ThemeQuerySet(models.QuerySet):
     def get_active(self):
         objs_active_qs = self.filter(active=True)
@@ -62,6 +68,14 @@ class Theme(models.Model):
         verbose_name=_("visible"),
     )
 
+    static_logo_path = models.FilePathField(
+        path=static_logo_directory_path,
+        blank=True,
+        verbose_name=_("static logo"),
+        match=r"^.*\.(jpg|jpeg|png|svg)$",
+        max_length=255,
+    )
+
     logo = models.FileField(
         upload_to="admin-interface/logo/",
         blank=True,
@@ -401,10 +415,26 @@ class Theme(models.Model):
 
     objects = ThemeQuerySet.as_manager()
 
+    @property
+    def static_logo_relative_url(self):
+        return os.path.relpath(self.static_logo_path, settings.STATIC_ROOT)
+
     def set_active(self):
         self.active = True
         self.save()
 
+    def save(self, *args, **kwargs):
+        if self.static_logo_path:
+            # clear cache if static logo path has changed
+            try:
+                obj = Theme.objects.get(pk=self.pk)
+                if obj.static_logo_path != self.static_logo_path:
+                    del_cached_active_theme()
+            except Theme.DoesNotExist:
+                pass
+
+        super().save(*args, **kwargs)
+
     class Meta:
         app_label = "admin_interface"
         verbose_name = _("Theme")