feat(helm): custom template support with helm charts

[swarnat]

Because I don't feel comfortable to host this application without a link called "Imprint", so I added support to provide custom templates also within helm charts. Sometimes this is checked very detailed in Germany.

The only topic, I'm not fully sure about, is the directory, where they should be stored. Currently I overwrite the templates within /venv/lib/python3.11/site-packages/umap/templates/umap/
This feels not correct.

I added examples within values.yaml.

Every template can be overwritten within values.yaml like this:

  templates:
    footer.html: |
      Custom footer
    
    header.html: |
      Custom Header
    
    content_footer.html: |
        {% load i18n %}

        <footer>
          <a href="https://wiki.openstreetmap.org/wiki/UMap" class="branding">uMap</a>
          <span>{% trans "An OpenStreetMap project" %}
          ({% trans "version" %} <a href="https://docs.umap-project.org/en/stable/changelog/">{{ UMAP_VERSION }}</a>)</span>
          {% if UMAP_HOST_INFOS.url and UMAP_HOST_INFOS.name %}<span>{% trans "Hosted by" %} <a href="{{ UMAP_HOST_INFOS.url }}">{{ UMAP_HOST_INFOS.name }}</a></span>{% endif %}
          {% if UMAP_HOST_INFOS.email %}<a href="mailto:{{ UMAP_HOST_INFOS.email }}">{% trans "Contact" %}</a>{% endif %}
          {% if UMAP_HELP_URL %}<a href="{{ UMAP_HELP_URL }}">{% trans "Help" %}</a>{% endif %}
          <a href="https://domain.com/imprint">Imprint</a>
          {% get_language_info_list for LANGUAGES as languages %}
          <form action="{% url "set_language" %}" method="post" class="i18n_switch">
            {% csrf_token %}
            <select name="language" onchange="this.form.submit()">
              {% for language in languages %}
                <option value="{{ language.code }}"
                        {% if language.code == LANGUAGE_CODE %}selected="selected"{% endif %}>
                  {{ language.name_local }} ({{ language.code }})
                </option>
              {% endfor %}
            </select>
          </form>
        </footer>

btw: Great application! Helped me a lot within last weeks. 👍

[davidbgk]

This feels not correct.

Indeed 😉

The correct way would be to store your templates in whatever directory (with optional inheritance from uMap's ones to avoid repeating the structure, not necessary for the footer) and then set your UMAP_CUSTOM_TEMPLATES setting to link to your custom template dir.

It's documented here https://docs.umap-project.org/en/stable/config/customize/ but feel free to improve that documentation, it's clear to us because we know Django's logic but beginner eyes are the best in these cases.