Simple tagging for the Wagtail CMS.
Project description
Wagtail Taggable
Simple tag functionality for Wagtail sites wanting curated tags without the complexity.
Change Log
- v0.0.10:
- Updated InlinePanel invocation to match requirements for Wagtail 4.2 and therefore pin Wagtail 4.2 as the minimum supported version.
Installation & Setup
Install with pip
pip install wagtail-taggable
or
poetry add wagtail-taggable
Add to Django installed apps
INSTALLED_APPS = [
#...
'wagtail_taggable',
]
Setup your tag models
Using the register_tag
decorator automatically sets up any ForeignKey
references to the decorated model to render using a chooser widget specifically for your tag model. It takes care of registering all the form widgets and urls needed to get this interface working.
@register_tag('Example')
class ExampleTag(BaseTag):
class Meta:
verbose_name = _('Example')
Optionally expose Tag models using Model Admin
from django.apps import apps
from wagtail.contrib.modeladmin.options import ModelAdmin, ModelAdminGroup
class ExampleTagModelAdmin(ModelAdmin):
@property
def model(self):
return apps.get_model('app.ExampleTag')
menu_label = 'Example'
menu_icon = 'tasks'
menu_order = 100
list_display = ('name',)
class TagsModelAdminGroup(ModelAdminGroup):
menu_label = 'Tags'
menu_icon = 'tag'
menu_order = 502
items = [
ExampleTagModelAdmin,
]
from app.admin.tags import TagsModelAdminGroup
modeladmin_register(TagsModelAdminGroup)
Use tags on page models (or any other model)
-
Define through relationship:
class ExamplePageExampleTagRelationship(models.Model): page = ParentalKey( 'app.ExamplePage', on_delete=models.CASCADE, related_name='example_tag_relationships', related_query_name='example_tag_relationship', ) example_tag = models.ForeignKey( 'app.ExampleTag', on_delete=models.CASCADE, related_name='example_page_relationships', related_query_name='example_page_relationship', )
-
Use TagsPanel to render the tags interface in the CMS for the taggable model (in this case a wagtail.Page)
class ExamplePage(Page): ... content_panels = [ TagsPanel('example_tag_relationships', heading='Example Tags'), ]
Query items based on tags
Perform queries based on tags like you would with any other related table
tagged_items = (
ExamplePage.objects
.filter(example_tag_relationship__example_tag__name='My Cool Tag')
)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for wagtail_taggable-0.0.10-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ed84610a1a1abe148759ba2945230375435e0147a21135215aab178c6ad118b6 |
|
MD5 | 0bcbffcf255ec933546de154039fb74d |
|
BLAKE2b-256 | cd293945d1a3408544f32d3b7a2cb97a95d23f023c002fa8ccc700fcdaec8b0c |