Metadata-Version: 2.1
Name: django_simple_plausible
Version: 0.0.5
Summary: A simple Django package to render Plausible Analytics html tag
Home-page: https://github.com/T-101/django-simple-plausible
Author: T-101
License: UNKNOWN
Description: ## Django Simple Plausible
        
        A dead simple package to add Plausible Analytics html tag to your HTML. Tested with Python 2.7 and 3.8. Tested with Django 1.11 and 3.2.
        
        ### Usage
        
        1. Install package: `pip install django_simple_plausible`
        
        2. Add `django_simple_plausible` to your `INSTALLED_APPS` in settings.py
        
        3. ADD `PLAUSIBLE_SITES` and `PLAUSIBLE_SCRIPT_URL` keys and values to your settings.py. Or enter the corresponding values as template tag parameters, as shown below.
        ```
        ...
        
        PLAUSIBLE_SITES = "example.com"
        PLAUSIBLE_SCRIPT_URL = "https://example.com/js/plausible.js"
        
        ...
        ```
        
        4. add the following template tags to your site html:
        ```
        {% load plausible %}
        {% plausible %}
        ```
        
        ---
        
        ### Configuring details
        
        - `PLAUSIBLE_SITES` can be a comma separated list without spaces, if you want to use that feature of Plausible
        
        ```
        PLAUSIBLE_SITES = "example.com,yoursite.com"
        ```
        
        - `PLAUSIBLE_SCRIPT_ASYNC_TAG` is an optional setting. It can be used to render the script tag with the `async` attribute instead of `defer`
        
        ```
        PLAUSIBLE_SCRIPT_ASYNC_TAG = True
        ```
        - Systemwide settings can be overridden giving the template tag some optional parameters:
        
        ```
        {% plausible plausible_sites="mysite.com" script_url="https://mysite.com/plausible.js" async_tag=True %}
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Framework :: Django
Classifier: Environment :: Web Environment
Requires-Python: >=2.7
Description-Content-Type: text/markdown
