Metadata-Version: 2.1
Name: django-tours
Version: 0.0.6
Summary: Django app to display tours with shepherdjs
Author-email: Wilmer Martinez <info@wilmermartinez.dev>
Project-URL: Homepage, https://github.com/wilmerm/django-tours
Project-URL: Issues, https://github.com/wilmerm/django-tours/issues
Project-URL: Repository, https://github.com/wilmerm/django-tours
Keywords: django,tours,shepherdjs
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Environment :: Web Environment
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Natural Language :: Spanish
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.0
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Framework :: Django :: 3
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Framework :: Django :: 3.2
Classifier: Framework :: Django :: 4
Classifier: Framework :: Django :: 4.0
Classifier: Framework :: Django :: 4.1
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Django>=3.2

# django-tours

Django app to display tours with shepherdjs

![Python Logo](https://www.python.org/static/community_logos/python-logo.png "Sample inline image")

## Instalation

```bash
pip install django-tours
```

## Use

### Add to installed applications

```py
# settings.py

INSTALLED_APPS = [
    # ...
    'tours',
    # ...
]
```

### Optional configuration:

**If you want to set default variables, you can add the following in your settings.py file:**

```py
# settings.py

DEFAULT_SHEPHERD_JS = 'https://cdn.jsdelivr.net/npm/shepherd.js@latest/dist/js/shepherd.min.js'
DEFAULT_SHEPHERD_CSS = 'https://cdn.jsdelivr.net/npm/shepherd.js@latest/dist/css/shepherd.css'
```

### Add the URLs

```py
urlpatterns = [
    # ...
    path('tours/', include('tours.urls')),
    # ...
]
```

### Run the migrations

```py
python manage.py migrate
```

### Load tours into the template

```django
{% load tours %}

{% load_tours request %}
```

## Licence

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

## Proyect Status

This project is under development

## Contribution 💗

If you find value in this project and would like to show your support, please consider making a donation via PayPal:

[Donate on PayPal](https://paypal.me/martinezwilmer?country.x=DO&locale.x=es_XC)

Your generosity helps us to continue improving and maintaining this project. We appreciate every contribution, however small. Thanks for being part of our community!
