Add an admin action to remove orphaned tags

CHANGELOG.rst

@@ -4,6 +4,8 @@ Changelog
 (Unreleased)
 ~~~~~~~~~~~~
 
+* Add an admin command to remove orphaned tags
+
 6.1.0 (2024-09-29)
 ~~~~~~~~~~~~~~~~~~
 

taggit/admin.py

@@ -19,7 +19,7 @@ class TagAdmin(admin.ModelAdmin):
     ordering = ["name", "slug"]
     search_fields = ["name"]
     prepopulated_fields = {"slug": ["name"]}
-    actions = ["render_tag_form"]
+    actions = ["render_tag_form", "remove_orphaned_tags_action"]
 
     def get_urls(self):
         urls = super().get_urls()
@@ -84,3 +84,14 @@ def merge_tags_view(self, request):
             "selected_tag_ids": selected_tag_ids,
         }
         return render(request, "admin/taggit/merge_tags_form.html", context)
+
+    @admin.action(description="Remove orphaned tags")
+    def remove_orphaned_tags_action(self, request, queryset):
+        try:
+            orphaned_tags = queryset.objects.orphaned()
+            count, _ = orphaned_tags.delete()
+            self.message_user(
+                request, f"Successfully removed {count} orphaned tags.", level="success"
+            )
+        except Exception as e:
+            self.message_user(request, f"An error occurred: {e}", level="error")

taggit/management/commands/remove_orphaned_tags.py

@@ -7,6 +7,6 @@ class Command(BaseCommand):
     help = "Remove orphaned tags"
 
     def handle(self, *args, **options):
-        orphaned_tags = Tag.objects.filter(taggit_taggeditem_items=None)
+        orphaned_tags = Tag.objects.orphaned()
         count = orphaned_tags.delete()
         self.stdout.write(f"Successfully removed {count} orphaned tags")

taggit/models.py

@@ -105,7 +105,16 @@ def slugify(self, tag, i=None):
         return slug
 
 
+class TagQuerySet(models.QuerySet):
+
+    def orphaned(self):
+        return self.filter(taggit_taggeditem_items=None)
+
+
 class Tag(TagBase):
+
+    objects = NaturalKeyManager.from_queryset(TagQuerySet)()
+
     class Meta:
         verbose_name = _("tag")
         verbose_name_plural = _("tags")