Feature: app branding (#5357)

src/paperless/config.py

@@ -8,13 +8,11 @@ from paperless.models import ApplicationConfiguration
 
 
 @dataclasses.dataclass
-class OutputTypeConfig:
+class BaseConfig:
     """
     Almost all parsers care about the chosen PDF output format
     """
 
-    output_type: str = dataclasses.field(init=False)
-
     @staticmethod
     def _get_config_instance() -> ApplicationConfiguration:
         app_config = ApplicationConfiguration.objects.all().first()
@@ -24,6 +22,15 @@ class OutputTypeConfig:
             app_config = ApplicationConfiguration.objects.all().first()
         return app_config
 
+
+@dataclasses.dataclass
+class OutputTypeConfig(BaseConfig):
+    """
+    Almost all parsers care about the chosen PDF output format
+    """
+
+    output_type: str = dataclasses.field(init=False)
+
     def __post_init__(self) -> None:
         app_config = self._get_config_instance()
 
@@ -86,3 +93,19 @@ class OcrConfig(OutputTypeConfig):
                 user_args = {}
 
         self.user_args = user_args
+
+
+@dataclasses.dataclass
+class GeneralConfig(BaseConfig):
+    """
+    General application settings that require global scope
+    """
+
+    app_title: str = dataclasses.field(init=False)
+    app_logo: str = dataclasses.field(init=False)
+
+    def __post_init__(self) -> None:
+        app_config = self._get_config_instance()
+
+        self.app_title = app_config.app_title or None
+        self.app_logo = app_config.app_logo.url if app_config.app_logo else None

src/paperless/migrations/0002_applicationconfiguration_app_logo_and_more.py

@@ -0,0 +1,33 @@
+# Generated by Django 4.2.9 on 2024-01-12 05:33
+
+from django.db import migrations
+from django.db import models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("paperless", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="applicationconfiguration",
+            name="app_logo",
+            field=models.FileField(
+                blank=True,
+                null=True,
+                upload_to="",
+                verbose_name="Application logo",
+            ),
+        ),
+        migrations.AddField(
+            model_name="applicationconfiguration",
+            name="app_title",
+            field=models.CharField(
+                blank=True,
+                max_length=48,
+                null=True,
+                verbose_name="Application title",
+            ),
+        ),
+    ]

src/paperless/models.py

@@ -1,3 +1,4 @@
+from django.core.validators import FileExtensionValidator
 from django.core.validators import MinValueValidator
 from django.db import models
 from django.utils.translation import gettext_lazy as _
@@ -166,6 +167,23 @@ class ApplicationConfiguration(AbstractSingletonModel):
         null=True,
     )
 
+    app_title = models.CharField(
+        verbose_name=_("Application title"),
+        null=True,
+        blank=True,
+        max_length=48,
+    )
+
+    app_logo = models.FileField(
+        verbose_name=_("Application logo"),
+        null=True,
+        blank=True,
+        validators=[
+            FileExtensionValidator(allowed_extensions=["jpg", "png", "gif", "svg"]),
+        ],
+        upload_to="logo/",
+    )
+
     class Meta:
         verbose_name = _("paperless application settings")
 

src/paperless/serialisers.py

@@ -132,6 +132,11 @@ class ApplicationConfigurationSerializer(serializers.ModelSerializer):
             data["language"] = None
         return super().run_validation(data)
 
+    def update(self, instance, validated_data):
+        if instance.app_logo and "app_logo" in validated_data:
+            instance.app_logo.delete()
+        return super().update(instance, validated_data)
+
     class Meta:
         model = ApplicationConfiguration
         fields = "__all__"

src/paperless/settings.py

@@ -367,6 +367,7 @@ STORAGES = {
     "staticfiles": {
         "BACKEND": _static_backend,
     },
+    "default": {"BACKEND": "django.core.files.storage.FileSystemStorage"},
 }
 
 _CELERY_REDIS_URL, _CHANNELS_REDIS_URL = _parse_redis_url(
@@ -999,6 +1000,9 @@ ENABLE_UPDATE_CHECK = os.getenv("PAPERLESS_ENABLE_UPDATE_CHECK", "default")
 if ENABLE_UPDATE_CHECK != "default":
     ENABLE_UPDATE_CHECK = __get_boolean("PAPERLESS_ENABLE_UPDATE_CHECK")
 
+APP_TITLE = os.getenv("PAPERLESS_APP_TITLE", None)
+APP_LOGO = os.getenv("PAPERLESS_APP_LOGO", None)
+
 ###############################################################################
 # Machine Learning                                                            #
 ###############################################################################

src/paperless/urls.py

@@ -1,3 +1,5 @@
+import os
+
 from django.conf import settings
 from django.conf.urls import include
 from django.contrib import admin
@@ -8,6 +10,7 @@ from django.utils.translation import gettext_lazy as _
 from django.views.decorators.csrf import csrf_exempt
 from django.views.decorators.csrf import ensure_csrf_cookie
 from django.views.generic import RedirectView
+from django.views.static import serve
 from rest_framework.authtoken import views
 from rest_framework.routers import DefaultRouter
 
@@ -181,6 +184,12 @@ urlpatterns = [
             url=settings.STATIC_URL + "frontend/en-US/assets/%(path)s",
         ),
     ),
+    # App logo
+    re_path(
+        r"^logo(?P<path>.*)$",
+        serve,
+        kwargs={"document_root": os.path.join(settings.MEDIA_ROOT, "logo")},
+    ),
     # TODO: with localization, this is even worse! :/
     # login, logout
     path("accounts/", include("django.contrib.auth.urls")),