Metadata-Version: 2.4
Name: djaodjin-extended-templates
Version: 0.5.2
Summary: DjaoDjin's Template wrappers for HTML email and PDF templates
Author-email: The DjaoDjin Team <help@djaodjin.com>
Maintainer-email: The DjaoDjin Team <help@djaodjin.com>
License: BSD-2-Clause
Project-URL: repository, https://github.com/djaodjin/djaodjin-extended-templates
Project-URL: documentation, https://djaodjin-extended-templates.readthedocs.io/
Project-URL: changelog, https://github.com/djaodjin/djaodjin-extended-templates/changelog
Keywords: django,templates,email,pdf
Classifier: Framework :: Django
Classifier: Environment :: Web Environment
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: BSD License
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: beautifulsoup4>=4.3.2
Requires-Dist: Django>=1.11
Requires-Dist: djangorestframework>=3.3.1
Requires-Dist: django-storages>=1.14
Requires-Dist: djaodjin-deployutils>=0.14.1
Requires-Dist: Jinja2>=2.8
Requires-Dist: premailer>=2.9.2
Requires-Dist: requests>=2.22.0
Requires-Dist: WeasyPrint>=0.42
Dynamic: license-file

djaodjin-extended-templates is a Django application that adds missing features
for managing Django templates.

Major Features:

- Live editing of HTML templates
- Build .css from .scss on page load
- HTML email templates
- PDF templates
- Media assets gallery
- Upload theme packages


Development
===========

**Attention!** (2024-10-01) Renamed `master` branch to `main`
(see [GitHub Renaming the default branch from master](https://github.com/github/renaming)).

After cloning the repository, create a virtualenv environment, install
the prerequisites, create the database then run the testsite webapp.

<pre><code>
    $ python -m venv .venv
    $ source .venv/bin/activate
    $ pip install -r testsite/requirements.txt
    $ make vendor-assets-prerequisites

    $ make initdb

    $ python manage.py runserver

    # Browse http://localhost:8000/
    # Start edit live templates

</code></pre>

Configure the settings to connect to your e-mail server,
then run the sendtestemail command.

    credentials:
      EMAIL_HOST_USER =
      EMAIL_HOST_PASSWORD =
    site.conf:
      EMAIL_HOST    =
      EMAIL_PORT    =
      EMAIL_USE_TLS =
      DEFAULT_FROM_EMAIL =

Then run the ``sendtestemail`` command and look for an e-mail delivered to you
in HTML format.

    $ python manage.py sendtestemail __your_email_address__


Note that you will need to link ``podofo-flatform.cc`` with [podofo](http://podofo.sourceforge.net/)
version 0.9.3. Version 0.9.1 as shipped with many RedHat systems will link
with no error but the outputed PDF will be blank.

Release Notes
=============

Tested with

- **Python:** 3.12, **Django:** 5.2 ([LTS](https://www.djangoproject.com/download/))
- **Python:** 3.14, **Django:** 6.0 (next)
- **Python:** 3.10, **Django:** 4.2 (legacy)
- **Python:** 3.9, **Django:** 3.2 (legacy)

0.5.2

  * fixes permanent_location for S3 and FileSystem storages
  * supports accessiblity in djaodjin-style-editor

[previous release notes](changelog)
