Added is_searchable and made published accept datetime cut-off parameter.

Author: tim-schilling

blog/admin.py

@@ -11,8 +11,15 @@
 
 @admin.register(Entry)
 class EntryAdmin(admin.ModelAdmin):
-    list_display = ("headline", "pub_date", "is_active", "is_published", "author")
-    list_filter = ("is_active",)
+    list_display = (
+        "headline",
+        "pub_date",
+        "is_active",
+        "is_published",
+        "is_searchable",
+        "author",
+    )
+    list_filter = ("is_active", "is_searchable")
     exclude = ("summary_html", "body_html")
     prepopulated_fields = {"slug": ("headline",)}
     raw_id_fields = ["social_media_card"]

blog/migrations/0006_entry_is_searchable.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.2 on 2025-07-24 07:21
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('blog', '0005_entry_social_media_card'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='entry',
+            name='is_searchable',
+            field=models.BooleanField(help_text='Tick to make this entry allow this entry to appear in the Django documentation search.', null=True),
+        ),
+    ]

blog/migrations/0007_set_is_searchable.py

@@ -0,0 +1,19 @@
+# Generated by Django 5.2 on 2025-07-24 07:22
+
+from django.db import migrations
+
+
+def set_is_searchable(apps, schema_editor):
+    Entry = apps.get_model("blog", "Entry")
+    # If this is large, this should be split into batched updates
+    Entry.objects.filter(is_searchable__isnull=True).update(is_searchable=False)
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('blog', '0006_entry_is_searchable'),
+    ]
+
+    operations = [
+        migrations.RunPython(set_is_searchable, reverse_code=migrations.RunPython.noop, elidable=True),
+    ]

blog/migrations/0008_alter_entry_is_searchable.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.2 on 2025-07-24 07:22
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('blog', '0007_set_is_searchable'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='entry',
+            name='is_searchable',
+            field=models.BooleanField(default=False, help_text='Tick to make this entry allow this entry to appear in the Django documentation search.'),
+        ),
+    ]

blog/models.py

@@ -31,12 +31,17 @@ def _md_slugify(value, separator):
 
 
 class EntryQuerySet(models.QuerySet):
-    def published(self):
-        return self.active().filter(pub_date__lte=timezone.now())
+    def published(self, pub_date=None):
+        if pub_date is None:
+            pub_date = timezone.now()
+        return self.active().filter(pub_date__lte=pub_date)
 
     def active(self):
         return self.filter(is_active=True)
 
+    def searchable(self):
+        return self.filter(is_searchable=True)
+
 
 class ContentFormat(models.TextChoices):
     REST = "reST", "reStructuredText"
@@ -126,6 +131,13 @@ class Entry(models.Model):
         ),
         default=False,
     )
+    is_searchable = models.BooleanField(
+        default=False,
+        help_text=_(
+            "Tick to make this entry allow this entry to appear in the "
+            "Django documentation search."
+        ),
+    )
     pub_date = models.DateTimeField(
         verbose_name=_("Publication date"),
         help_text=_(

blog/tests.py

@@ -64,6 +64,31 @@ def test_manager_published(self):
             ["past active"],
             transform=lambda entry: entry.headline,
         )
+        self.assertQuerySetEqual(
+            Entry.objects.published(self.tomorrow),
+            ["future active", "past active"],
+            transform=lambda entry: entry.headline,
+        )
+
+    def test_manager_searchable(self):
+        """
+        Make sure that the Entry manager's `searchable` method works
+        """
+        Entry.objects.create(
+            pub_date=self.yesterday,
+            is_searchable=False,
+            headline="not searchable",
+            slug="a",
+        )
+        Entry.objects.create(
+            pub_date=self.yesterday, is_searchable=True, headline="searchable", slug="b"
+        )
+
+        self.assertQuerySetEqual(
+            Entry.objects.searchable(),
+            ["searchable"],
+            transform=lambda entry: entry.headline,
+        )
 
     def test_docutils_safe(self):
         """