Add top tags page

Author: simonw

blog/tests.py

@@ -362,3 +362,18 @@ def test_og_description_escapes_quotes_tag_page(self):
             '<meta property="og:description" content="1 posts tagged ‘test’. Tag with &quot;quotes&quot;"',
             html=False,
         )
+
+    def test_top_tags_page(self):
+        for i in range(1, 12):
+            tag = Tag.objects.create(tag=f"tag{i}")
+            for j in range(i):
+                entry = EntryFactory(title=f"Entry{i}-{j}")
+                entry.tags.add(tag)
+        response = self.client.get("/top-tags/")
+        assert response.status_code == 200
+        tags_info = response.context["tags_info"]
+        self.assertEqual(len(tags_info), 10)
+        self.assertEqual(tags_info[0]["tag"].tag, "tag11")
+        self.assertFalse(any(info["tag"].tag == "tag1" for info in tags_info))
+        latest = Tag.objects.get(tag="tag11").entry_set.order_by("-created")[0].title
+        self.assertContains(response, latest)

blog/views.py

@@ -436,6 +436,43 @@ def tag_index(request):
     return render(request, "tags.html")
 
 
+def top_tags(request):
+    """Display recent headlines for the 10 most popular tags."""
+    tags = (
+        Tag.objects.annotate(
+            entry_count=models.Count(
+                "entry", filter=models.Q(entry__is_draft=False), distinct=True
+            ),
+            blogmark_count=models.Count(
+                "blogmark", filter=models.Q(blogmark__is_draft=False), distinct=True
+            ),
+            quotation_count=models.Count(
+                "quotation", filter=models.Q(quotation__is_draft=False), distinct=True
+            ),
+            note_count=models.Count(
+                "note", filter=models.Q(note__is_draft=False), distinct=True
+            ),
+        )
+        .annotate(
+            total=models.F("entry_count")
+            + models.F("blogmark_count")
+            + models.F("quotation_count")
+            + models.F("note_count")
+        )
+        .order_by("-total")[:10]
+    )
+    tags_info = [
+        {
+            "tag": tag,
+            "total": tag.total,
+            "recent_entries": tag.entry_set.filter(is_draft=False)
+            .order_by("-created")[:5],
+        }
+        for tag in tags
+    ]
+    return render(request, "top_tags.html", {"tags_info": tags_info})
+
+
 # This query gets the IDs of things that match all of the tags
 INTERSECTION_SQL = """
     SELECT %(content_table)s.id

config/urls.py

@@ -147,6 +147,7 @@ def versions(request):
     re_path(r"^favicon\.ico$", favicon_ico),
     re_path(r"^search/$", search_views.search),
     re_path(r"^about/$", blog_views.about),
+    path("top-tags/", blog_views.top_tags),
     re_path(r"^tags/$", blog_views.tag_index),
     re_path(r"^tags/(.*?)/$", blog_views.archive_tag),
     re_path(r"^tags/(.*?).atom$", blog_views.archive_tag_atom),

templates/top_tags.html

@@ -0,0 +1,15 @@
+{% extends "smallhead.html" %}
+{% block title %}Top tags{% endblock %}
+{% block primary %}
+<h2 class="archive-h2">Top tags</h2>
+{% for info in tags_info %}
+<h3><a href="{{ info.tag.get_absolute_url }}">{{ info.tag.tag }}</a> ({{ info.total }})</h3>
+<ul>
+  {% for entry in info.recent_entries %}
+  <li><a href="{{ entry.get_absolute_url }}">{{ entry.title }}</a></li>
+  {% empty %}
+  <li>No entries yet</li>
+  {% endfor %}
+</ul>
+{% endfor %}
+{% endblock %}