Metadata-Version: 2.4
Name: wagtail-sb-socialnetworks
Version: 0.8.0
Summary: Social Networks settings for wagtail sites.
Keywords: cms,django,dynova,socialnetworks,softbutterfly,wagtail
Author: Dynova Development Team, zodiacfireworks
Author-email: Dynova Development Team <dev@dynova.io>, zodiacfireworks <martin.vuelta@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django :: 4
Classifier: Framework :: Django :: 5
Classifier: Framework :: Django :: 6
Classifier: Framework :: Wagtail :: 5
Classifier: Framework :: Wagtail :: 6
Classifier: Framework :: Wagtail :: 7
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: django>=4.2
Requires-Dist: wagtail>=5.2
Maintainer: zodiacfireworks
Maintainer-email: zodiacfireworks <martin.vuelta@gmail.com>
Requires-Python: >=3.11.0, <4.0.0
Project-URL: Bug Tracker, https://gitlab.com/softbutterfly/open-source/wagtail-sb-socialnetworks/-/issues
Project-URL: Changelog, https://gitlab.com/softbutterfly/open-source/wagtail-sb-socialnetworks/-/blob/v0.8.0/CHANGELOG.md
Project-URL: Documentation, https://softbutterfly.gitlab.io/open-source/wagtail-sb-socialnetworks
Project-URL: Download, https://gitlab.com/softbutterfly/open-source/wagtail-sb-socialnetworks/-/archive/v0.8.0/wagtail-sb-socialnetworks-v0.8.0.tar.gz
Project-URL: Homepage, https://gitlab.com/softbutterfly/open-source/wagtail-sb-socialnetworks
Project-URL: Issues, https://gitlab.com/softbutterfly/open-source/wagtail-sb-socialnetworks/-/issues
Project-URL: Repository, https://gitlab.com/softbutterfly/open-source/wagtail-sb-socialnetworks
Description-Content-Type: text/markdown

# Wagtail SB Social Networks

**Social Networks settings for Wagtail sites.**

![Community-Project][repository:banner]

![PyPI - Supported versions][pypi:badge:python]
![PyPI - Package version][pypi:badge:version]
![PyPI - Downloads][pypi:badge:downloads]
![PyPI - License][pypi:badge:license]
[![Codacy Grade Badge][codacy:grade]][codacy:dashboard]
[![Codacy Coverage Badge][codacy:coverage]][codacy:dashboard]
[![Gitlab Pipeline Status][repository:pipeline]][repository:commits]

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

```bash
pip install wagtail-sb-socialnetworks
```

### Using uv

```bash
uv add wagtail-sb-socialnetworks
```

## 🚀 Usage

Add the app to your `INSTALLED_APPS` in `settings.py`:

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

Run migrations:

```bash
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:

```html
{% load wagtailsettings_tags %}
{% get_settings %}

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

## 🛠️ Development

Check out our [Contribution Guide](./CONTRIBUTING.md) 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](./CHANGELOG.md) for a history of changes.

## 👥 Contributors

See our [list of contributors][repository:contributors].

## 📄 License

This project is licensed under the Apache License 2.0. See the
[LICENSE](./LICENSE) file for details.

[repository:banner]: https://gitlab.com/softbutterfly/open-source/open-source-office/-/raw/master/assets/dynova/dynova-open-source--banner--community-project.png
[repository:pipeline]: https://gitlab.com/softbutterfly/open-source/wagtail-sb-socialnetworks/badges/master/pipeline.svg
[repository:commits]: https://gitlab.com/softbutterfly/open-source/wagtail-sb-socialnetworks/-/commits/master
[repository:contributors]: https://gitlab.com/softbutterfly/open-source/wagtail-sb-socialnetworks/-/graphs/develop

[pypi:badge:python]: https://img.shields.io/pypi/pyversions/wagtail-sb-socialnetworks
[pypi:badge:version]: https://img.shields.io/pypi/v/wagtail-sb-socialnetworks
[pypi:badge:downloads]: https://img.shields.io/pypi/dm/wagtail-sb-socialnetworks
[pypi:badge:license]: https://img.shields.io/pypi/l/wagtail-sb-socialnetworks

[codacy:grade]: https://app.codacy.com/project/badge/Grade/329484ea99434c708f5c8dbd611f3d35
[codacy:coverage]: https://app.codacy.com/project/badge/Coverage/329484ea99434c708f5c8dbd611f3d35
[codacy:dashboard]: https://app.codacy.com/gl/softbutterfly/wagtail-sb-socialnetworks/dashboard
