Allow Content Managers to Select which Template the Plugin will Use

Description

Have “the plugin admin interface will allow content managers to select which template the plugin will use.” (source, bottom of document) to be a true statement, or document how and where and when the plugin admin interface will allow this.

Use cases

“content managers to select which template the plugin will use”

Proposed solution

Make “the plugin admin interface […] allow content managers to select which template the plugin will use.”

Alternatives

Document how/where/when “the plugin admin interface will allow content managers to select which template the plugin will use”.

Additional information

I could only change the templates used by the blog by manually typing a path into the “TEMPLATE PREFIX:”. I could not change the templates used by “select[ing] which template the plugin will use” in “the plugin admin interface”.

Admin Interface

The path in this image does load templates from the directory specified (at …/templates/djangocms_blog/default).

settings.py

BLOG_PLUGIN_TEMPLATE_FOLDERS = (
    ('default', 'Default template'),    # i.e. `templates/djangocms_blog/default/`
    ('vertical', 'Vertical timeline'),  # i.e. `templates/djangocms_blog/vertical/`
)

I also, after adding these settings, ran python3 manage.py makemigrations and python3 manage.py migrate.

Expectation

A <select> dropdown menu form which I could select either “Default template” or “Vertical timeline”.

[wesleyboar]

I have tested the feature on my instance, by:

1. installing the repo with the fix branch
2. restarting the server
3. ensuring each plugin loads select dropdown
4. testing that select dropdown (on one plugin) does use the template from the selected plugin templates.

---

Edit: ✓ The test was successful!

[yakky]

@tacc-wbomar have a look at #605 for improved documentation regarding templates customization and feel free to suggest improvements