# django-sites-extra [![PyPi license](https://img.shields.io/pypi/l/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)
[![PyPi status](https://img.shields.io/pypi/status/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)
[![PyPi version](https://img.shields.io/pypi/v/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)
[![PyPi python version](https://img.shields.io/pypi/pyversions/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)
[![PyPi downloads](https://img.shields.io/pypi/dm/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)
[![PyPi downloads](https://img.shields.io/pypi/dw/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)
[![PyPi downloads](https://img.shields.io/pypi/dd/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)
## GitHub ![GitHub release](https://img.shields.io/github/tag/DLRSP/django-sites-extra.svg) ![GitHub release](https://img.shields.io/github/release/DLRSP/django-sites-extra.svg)
## Test [![codecov.io](https://codecov.io/github/DLRSP/django-sites-extra/coverage.svg?branch=main)](https://codecov.io/github/DLRSP/django-sites-extra?branch=main) [![pre-commit.ci status](https://results.pre-commit.ci/badge/github/DLRSP/django-sites-extra/main.svg)](https://results.pre-commit.ci/latest/github/DLRSP/django-sites-extra/main) [![gitthub.com](https://github.com/DLRSP/django-sites-extra/actions/workflows/ci.yaml/badge.svg)](https://github.com/DLRSP/django-sites-extra/actions/workflows/ci.yaml)
## Check Demo Project
* Check the demo repo on [GitHub](https://github.com/DLRSP/example/tree/django-sites-extra)
## Requirements
- Python 3.8+ supported.
- Django 3.2+ supported.
## Setup
1. Install from **pip**:
```shell
pip install django-sites-extra
```
2. Modify `settings.py` by adding the app to `INSTALLED_APPS`:
```python
INSTALLED_APPS = [
# ...
"sites_extra",
# ...
]
```
3. Execute Django's command `migrate` inside your project's root:
```shell
python manage.py migrate
Running migrations:
Applying sites_extra.0001_initial... OK
```
4. Modify `settings.py` by adding the app's context processor to `TEMPLATES`:
```python
TEMPLATES = [
{
# ...
"OPTIONS": {
"context_processors": [
# ...
"sites_extra.context_processors.info",
# ...
],
},
},
]
```
5. Optionally, but sugguested, the Django's Current Site middleware is enabled inside `settings.py`:
```python
MIDDLEWARE = (
# ...
"django.contrib.sites.middleware.CurrentSiteMiddleware",
# ...
)
```
## Run Example Project
```shell
git clone --depth=50 --branch=django-sites-extra https://github.com/DLRSP/example.git DLRSP/example
cd DLRSP/example
python manage.py runserver
```
Now browser the app @ http://127.0.0.1:8000
Raw data
{
"_id": null,
"home_page": "https://github.com/DLRSP/django-sites-extra",
"name": "django-sites-extra",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "django",
"author": "DLRSP",
"author_email": "dlrsp.dev@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/2f/98/5ff5f0a67a7f4fdab99b883ed064b8aa9077e74d157da0e176a8c4dd43d8/django-sites-extra-0.1.2.tar.gz",
"platform": null,
"description": "# django-sites-extra [![PyPi license](https://img.shields.io/pypi/l/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)\n\n[![PyPi status](https://img.shields.io/pypi/status/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)\n[![PyPi version](https://img.shields.io/pypi/v/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)\n[![PyPi python version](https://img.shields.io/pypi/pyversions/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)\n[![PyPi downloads](https://img.shields.io/pypi/dm/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)\n[![PyPi downloads](https://img.shields.io/pypi/dw/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)\n[![PyPi downloads](https://img.shields.io/pypi/dd/django-sites-extra.svg)](https://pypi.python.org/pypi/django-sites-extra)\n\n## GitHub ![GitHub release](https://img.shields.io/github/tag/DLRSP/django-sites-extra.svg) ![GitHub release](https://img.shields.io/github/release/DLRSP/django-sites-extra.svg)\n\n## Test [![codecov.io](https://codecov.io/github/DLRSP/django-sites-extra/coverage.svg?branch=main)](https://codecov.io/github/DLRSP/django-sites-extra?branch=main) [![pre-commit.ci status](https://results.pre-commit.ci/badge/github/DLRSP/django-sites-extra/main.svg)](https://results.pre-commit.ci/latest/github/DLRSP/django-sites-extra/main) [![gitthub.com](https://github.com/DLRSP/django-sites-extra/actions/workflows/ci.yaml/badge.svg)](https://github.com/DLRSP/django-sites-extra/actions/workflows/ci.yaml)\n\n## Check Demo Project\n* Check the demo repo on [GitHub](https://github.com/DLRSP/example/tree/django-sites-extra)\n\n## Requirements\n- Python 3.8+ supported.\n- Django 3.2+ supported.\n\n## Setup\n1. Install from **pip**:\n ```shell\n pip install django-sites-extra\n ```\n2. Modify `settings.py` by adding the app to `INSTALLED_APPS`:\n ```python\n INSTALLED_APPS = [\n # ...\n \"sites_extra\",\n # ...\n ]\n ```\n3. Execute Django's command `migrate` inside your project's root:\n ```shell\n python manage.py migrate\n Running migrations:\n Applying sites_extra.0001_initial... OK\n ```\n4. Modify `settings.py` by adding the app's context processor to `TEMPLATES`:\n ```python\n TEMPLATES = [\n {\n # ...\n \"OPTIONS\": {\n \"context_processors\": [\n # ...\n \"sites_extra.context_processors.info\",\n # ...\n ],\n },\n },\n ]\n ```\n5. Optionally, but sugguested, the Django's Current Site middleware is enabled inside `settings.py`:\n ```python\n MIDDLEWARE = (\n # ...\n \"django.contrib.sites.middleware.CurrentSiteMiddleware\",\n # ...\n )\n ```\n## Run Example Project\n\n```shell\ngit clone --depth=50 --branch=django-sites-extra https://github.com/DLRSP/example.git DLRSP/example\ncd DLRSP/example\npython manage.py runserver\n```\n\nNow browser the app @ http://127.0.0.1:8000\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Django application to extend the standard \"sites\" framework with extra utils.",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/DLRSP/django-sites-extra"
},
"split_keywords": [
"django"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "02ea63c91a62ccbd4ce9fd0f689f7d8e79fb77c41433612658133217ee047831",
"md5": "db1cfab3059e648d6d6ad5e3df7ee8f0",
"sha256": "934577cbec4fe95b152e4dab6df12b004cad7dd6aa057461744feea9a6f228a3"
},
"downloads": -1,
"filename": "django_sites_extra-0.1.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "db1cfab3059e648d6d6ad5e3df7ee8f0",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.8",
"size": 6448,
"upload_time": "2024-04-05T21:11:35",
"upload_time_iso_8601": "2024-04-05T21:11:35.525541Z",
"url": "https://files.pythonhosted.org/packages/02/ea/63c91a62ccbd4ce9fd0f689f7d8e79fb77c41433612658133217ee047831/django_sites_extra-0.1.2-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2f985ff5f0a67a7f4fdab99b883ed064b8aa9077e74d157da0e176a8c4dd43d8",
"md5": "1dc0a19fd665a67e5b45cd5e8c2c6c5b",
"sha256": "2852a42fdb78a7f03db036048f27261d233573117a526b535e8c840f0e36fc42"
},
"downloads": -1,
"filename": "django-sites-extra-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "1dc0a19fd665a67e5b45cd5e8c2c6c5b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 26354,
"upload_time": "2024-04-05T21:11:36",
"upload_time_iso_8601": "2024-04-05T21:11:36.472131Z",
"url": "https://files.pythonhosted.org/packages/2f/98/5ff5f0a67a7f4fdab99b883ed064b8aa9077e74d157da0e176a8c4dd43d8/django-sites-extra-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-05 21:11:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "DLRSP",
"github_project": "django-sites-extra",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "django-sites-extra"
}