wagtailsettings 0.3.2

Installing

Install using pip:

pip install wagtailsettings

It is compatible with Wagtail 1.0 and upwards.

Add it to your INSTALLED_APPS:

INSTALLED_APPS += [
    'wagtailsettings',
]

Using

Create a model that inherits from BaseSetting, and register it using the register_setting decorator:

from wagtailsettings import BaseSetting, register_setting

@register_setting
class SocialMediaSettings(BaseSetting):
    facebook = models.URLField(
        help_text='Your Facebook page URL')
    instagram = models.CharField(
        max_length=255, help_text='Your Instagram username, without the @')
    trip_advisor = models.URLField(
        help_text='Your Trip Advisor page URL')
    youtube = models.URLField(
        help_text='Your YouTube channel or user account URL')

A ‘Social media settings’ link will appear in the Wagtail admin ‘Settings’ menu.

You can change the label used in the menu by changing the verbose_name of your model.

You can add an icon to the menu by passing an ‘icon’ argument to the register_setting decorator:

@register_setting(icon='icon-placeholder')
class SocialMediaSettings(BaseSetting):
    # ...

For a list of all available icons, please see the Wagtail style guide.

def view(request):
    social_media_settings = SocialMediaSettings.for_site(request.site)
    ...

from django.conf import global_settings
TEMPLATE_CONTEXT_PROCESSORS = global_settings.TEMPLATE_CONTEXT_PROCESSORS + (
    'django.core.context_processors.request',
    'wagtailsettings.context_processors.settings',
)

{{ settings.app_label.SocialMediaSettings.instagram }}

{% load wagtailsettings_tags %}
{% get_settings %}
{{ settings.app_label.SocialMediaSettings.instagram }}