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="#c4b5fd", 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"