Make election styling configurable by adding nomination kinds (#3030)

Author: JacobCoffee

apps/nominations/admin.py

@@ -3,13 +3,23 @@
 from django.contrib import admin
 from django.db.models.functions import Lower
 
-from apps.nominations.models import Election, Nomination, Nominee
+from apps.nominations.models import Election, ElectionKind, Nomination, Nominee
+
+
+@admin.register(ElectionKind)
+class ElectionKindAdmin(admin.ModelAdmin):
+    """Admin interface for managing election kinds and their accent colors."""
+
+    list_display = ("name", "accent_color", "slug")
+    readonly_fields = ("slug",)
 
 
 @admin.register(Election)
 class ElectionAdmin(admin.ModelAdmin):
     """Admin interface for managing elections."""
 
+    list_display = ("name", "kind", "date", "slug")
+    list_filter = ("kind",)
     readonly_fields = ("slug",)
 
 

apps/nominations/migrations/0003_election_kind.py

@@ -0,0 +1,46 @@
+# Generated by Django 5.2.13 on 2026-06-24 15:33
+
+import colorfield.fields
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("nominations", "0002_auto_20190514_1435"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="ElectionKind",
+            fields=[
+                ("id", models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name="ID")),
+                ("name", models.CharField(max_length=100, unique=True)),
+                ("slug", models.SlugField(blank=True, max_length=120, null=True, unique=True)),
+                (
+                    "accent_color",
+                    colorfield.fields.ColorField(
+                        default="#0073b7",
+                        help_text="Accent color used to theme this kind's pages.",
+                        image_field=None,
+                        max_length=25,
+                        samples=None,
+                    ),
+                ),
+            ],
+            options={
+                "ordering": ["name"],
+            },
+        ),
+        migrations.AddField(
+            model_name="election",
+            name="kind",
+            field=models.ForeignKey(
+                blank=True,
+                null=True,
+                on_delete=django.db.models.deletion.SET_NULL,
+                related_name="elections",
+                to="nominations.electionkind",
+            ),
+        ),
+    ]

apps/nominations/models.py

@@ -2,6 +2,7 @@
 
 import datetime
 
+from colorfield.fields import ColorField
 from django.db import models
 from django.db.models.signals import post_save
 from django.dispatch import receiver
@@ -13,12 +14,48 @@
 from apps.users.models import User
 from fastly.utils import purge_url
 
+DEFAULT_ACCENT_COLOR = "#0073b7"
+
+
+class ElectionKind(models.Model):
+    """An admin-managed category of election (Board, Packaging Council, ...).
+
+    Each kind carries an accent color used to visually distinguish its
+    election pages. New kinds can be added in the Django admin without
+    code changes.
+    """
+
+    name = models.CharField(max_length=100, unique=True)
+    slug = models.SlugField(max_length=120, unique=True, blank=True, null=True)
+    accent_color = ColorField(default=DEFAULT_ACCENT_COLOR, help_text="Accent color used to theme this kind's pages.")
+
+    class Meta:
+        """Meta configuration for ElectionKind."""
+
+        ordering = ["name"]
+
+    def __str__(self):
+        """Return the kind name."""
+        return self.name
+
+    def save(self, *args, **kwargs):
+        """Generate slug from name before saving."""
+        self.slug = slugify(self.name)
+        super().save(*args, **kwargs)
+
 
 class Election(models.Model):
     """A PSF board election with nomination open/close dates."""
 
     name = models.CharField(max_length=100)
     date = models.DateField()
+    kind = models.ForeignKey(
+        ElectionKind,
+        null=True,
+        blank=True,
+        on_delete=models.SET_NULL,
+        related_name="elections",
+    )
     nominations_open_at = models.DateTimeField(blank=True, null=True)
     nominations_close_at = models.DateTimeField(blank=True, null=True)
     description = MarkupField(escape_html=False, markup_type="markdown", blank=False, null=True)
@@ -39,6 +76,11 @@ def save(self, *args, **kwargs):
         self.slug = slugify(self.name)
         super().save(*args, **kwargs)
 
+    @property
+    def accent_color(self):
+        """Return the CSS accent color for this election's kind."""
+        return self.kind.accent_color if self.kind else DEFAULT_ACCENT_COLOR
+
     @property
     def nominations_open(self):
         """Return True if the current time is within the nomination window."""

apps/nominations/templates/nominations/_theme.html

@@ -0,0 +1,20 @@
+{% comment %}
+Per-election theming. Expects `election` in context (pass via
+`{% include "nominations/_theme.html" with election=object.election %}`
+where only the nomination object is available). Colors key headings
+with the election's accent so Board vs. Packaging Council pages are
+visually distinct. See Election.accent_color / the ElectionKind model.
+{% endcomment %}
+{% if election %}
+<style>
+    :root {
+        --election-accent: {{ election.accent_color }};
+    }
+    /* Scoped to #content; this <style> only renders on themed election
+       pages, so these selectors never leak to the rest of the site. */
+    #content h1,
+    #content .page-title {
+        color: var(--election-accent);
+    }
+</style>
+{% endif %}

apps/nominations/templates/nominations/election_detail.html

@@ -4,6 +4,8 @@
 
 {% block page_title %}Elections | {{ SITE_INFO.site_name }}{% endblock %}
 
+{% block head %}{% include "nominations/_theme.html" %}{% endblock %}
+
 {% block content_attributes %}with-left-sidebar{% endblock %}
 
 

apps/nominations/templates/nominations/nomination_accept_form.html

@@ -6,6 +6,7 @@
 {% endblock %}
 
 {% block body_attributes %}class="nominations nominations_view"{% endblock %}
+{% block head %}{% include "nominations/_theme.html" %}{% endblock %}
 {% block left_sidebar %}{% endblock %}
 {% block content_attributes %}{% endblock %}
 

apps/nominations/templates/nominations/nomination_detail.html

@@ -6,6 +6,7 @@
 {% endblock %}
 
 {% block body_attributes %}class="nominations nominations_view"{% endblock %}
+{% block head %}{% include "nominations/_theme.html" with election=nomination.election %}{% endblock %}
 {% block left_sidebar %}{% endblock %}
 {% block content_attributes %}{% endblock %}
 

apps/nominations/templates/nominations/nomination_form.html

@@ -10,6 +10,7 @@
 {% endblock %}
 
 {% block body_attributes %}class="nominations nominations_form"{% endblock %}
+{% block head %}{% include "nominations/_theme.html" %}{% endblock %}
 {% block left_sidebar %}{% endblock %}
 {% block content_attributes %}{% endblock %}
 

apps/nominations/templates/nominations/nominee_detail.html

@@ -7,6 +7,7 @@
 {% endblock %}
 
 {% block body_attributes %}class="nominations nominations_view"{% endblock %}
+{% block head %}{% include "nominations/_theme.html" %}{% endblock %}
 {% block left_sidebar %}{% endblock %}
 {% block content_attributes %}{% endblock %}
 

apps/nominations/templates/nominations/nominee_list.html

@@ -11,6 +11,7 @@
 {% block content_attributes %}{% endblock %}
 
 {% block head %}
+{% include "nominations/_theme.html" %}
 <style>
 details
 {