initial commit

apps/core/models.py

@@ -0,0 +1,177 @@
+from django.db import models
+
+
+class SiteBranding(models.Model):
+    OBJECT_FIT_COVER = "cover"
+    OBJECT_FIT_CONTAIN = "contain"
+    OBJECT_FIT_CHOICES = [
+        (OBJECT_FIT_COVER, "Cover (fill square, may crop)"),
+        (OBJECT_FIT_CONTAIN, "Contain (fit inside square)"),
+    ]
+
+    icon = models.ImageField(
+        upload_to="branding/",
+        blank=True,
+        null=True,
+        help_text="Logo shown in the site header and footer. Leave empty to use the default static icon.",
+    )
+    icon_alt = models.CharField(
+        max_length=200,
+        blank=True,
+        help_text="Alt text for the brand icon (decorative icons can stay empty).",
+    )
+    navbar_icon_size = models.PositiveSmallIntegerField(
+        default=26,
+        help_text="Width and height in pixels for the header icon.",
+    )
+    footer_icon_size = models.PositiveSmallIntegerField(
+        default=34,
+        help_text="Width and height in pixels for the footer icon.",
+    )
+    show_border = models.BooleanField(
+        default=False,
+        help_text="Draw a border around the brand icon.",
+    )
+    border_color = models.CharField(
+        max_length=7,
+        default="#3051ff",
+        help_text="Border color as hex (e.g. #c4b5fd).",
+    )
+    border_width = models.PositiveSmallIntegerField(
+        default=1,
+        help_text="Border width in pixels.",
+    )
+    object_fit = models.CharField(
+        max_length=10,
+        choices=OBJECT_FIT_CHOICES,
+        default=OBJECT_FIT_COVER,
+    )
+
+    class Meta:
+        verbose_name = "Site Branding"
+        verbose_name_plural = "Site Branding"
+
+    def __str__(self):
+        return "Site Branding"
+
+    @classmethod
+    def load(cls):
+        obj, _ = cls.objects.get_or_create(pk=1)
+        return obj
+
+    def icon_style(self, size_px):
+        parts = [
+            f"width:{size_px}px",
+            f"height:{size_px}px",
+            f"object-fit:{self.object_fit}",
+        ]
+        if self.show_border:
+            parts.append(f"border:{self.border_width}px solid {self.border_color}")
+        return ";".join(parts)
+
+    @property
+    def navbar_icon_style(self):
+        return self.icon_style(self.navbar_icon_size)
+
+    @property
+    def footer_icon_style(self):
+        return self.icon_style(self.footer_icon_size)
+
+
+class SiteContact(models.Model):
+    support_email = models.EmailField(
+        blank=True,
+        help_text="Shown in the footer and on the contact page. Hidden when empty.",
+    )
+    discord_url = models.URLField(
+        blank=True,
+        help_text="Discord invite link. Hidden when empty.",
+    )
+    discord_label = models.CharField(
+        max_length=100,
+        blank=True,
+        help_text="Button label (e.g. Join Discord). Defaults to “Join Discord” when empty.",
+    )
+    office_address = models.TextField(
+        blank=True,
+        help_text="Physical address; one line per row. Hidden when empty.",
+    )
+    email_card_title = models.CharField(
+        max_length=200,
+        blank=True,
+        help_text="Contact page email card heading. Defaults to “Email Support”.",
+    )
+    email_card_description = models.CharField(
+        max_length=500,
+        blank=True,
+        help_text="Short text under the email card heading on the contact page.",
+    )
+    discord_card_title = models.CharField(
+        max_length=200,
+        blank=True,
+        help_text="Contact page Discord card heading. Defaults to “Discord Community”.",
+    )
+    discord_card_description = models.CharField(
+        max_length=500,
+        blank=True,
+        help_text="Short text under the Discord card heading on the contact page.",
+    )
+    office_card_title = models.CharField(
+        max_length=200,
+        blank=True,
+        help_text="Contact page office card heading. Defaults to “Office”.",
+    )
+
+    class Meta:
+        verbose_name = "Site Contact"
+        verbose_name_plural = "Site Contact"
+
+    def __str__(self):
+        return "Site Contact"
+
+    @classmethod
+    def load(cls):
+        obj, _ = cls.objects.get_or_create(pk=1)
+        return obj
+
+    @property
+    def discord_label_display(self):
+        return self.discord_label.strip() or "Join Discord"
+
+    @property
+    def office_address_lines(self):
+        if not self.office_address.strip():
+            return []
+        return [line.strip() for line in self.office_address.splitlines() if line.strip()]
+
+    @property
+    def has_support_email(self):
+        return bool(self.support_email)
+
+    @property
+    def has_discord(self):
+        return bool(self.discord_url)
+
+    @property
+    def has_office_address(self):
+        return bool(self.office_address_lines)
+
+    @property
+    def has_footer_contact(self):
+        return self.has_support_email or self.has_office_address
+
+    @property
+    def has_contact_sidebar(self):
+        return self.has_support_email or self.has_discord or self.has_office_address
+
+    @property
+    def email_card_title_display(self):
+        return self.email_card_title.strip() or "Email Support"
+
+    @property
+    def discord_card_title_display(self):
+        return self.discord_card_title.strip() or "Discord Community"
+
+    @property
+    def office_card_title_display(self):
+        return self.office_card_title.strip() or "Office"