Wagtail SB Social Networks

Social Networks settings for Wagtail sites.

This library provides an easy and reusable way to configure and access Social Networks settings across your Wagtail sites. It uses Wagtail's site settings to let administrators input social profiles intuitively.

✨ Features

• Global Settings: Configure social media links that apply globally or per-site.
• Easy Integration: Access social networks seamlessly in your Django templates.
• Modern Stack: Built with Python 3.11+, Django 4.2+, and Wagtail 5.2+.

📋 Requirements

• Python 3.11 or higher
• Wagtail 5.2 or higher
• Django 4.2 or higher

📦 Installation

Using pip

pip install wagtail-sb-socialnetworks

Using uv

uv add wagtail-sb-socialnetworks

🚀 Usage

Add the app to your INSTALLED_APPS in settings.py:

INSTALLED_APPS = [
    # ...
    "wagtail_sb_socialnetworks",
    # ...
]

Run migrations:

python manage.py migrate

Now you can configure your social networks inside the Wagtail admin interface under Settings > Social Networks.

To access them in your templates, use the settings context processor or Wagtail's settings tag:

{% load wagtailsettings_tags %}
{% get_settings %}

<a href="{{ settings.wagtail_sb_socialnetworks.SocialNetworksSettings.facebook }}">Facebook</a>

🛠️ Development

Check out our Contribution Guide for details on setting up your development environment, running tests, and submitting pull requests.

The project uses uv for dependency management, ruff for linting, and tox for multi-environment testing.

📜 Changelog

See the CHANGELOG.md for a history of changes.

👥 Contributors

See our list of contributors.

📄 License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.