{"title":"Come implementare un backend per template personalizzato","version":"6.1","locale":"it","docname":"howto/custom-template-backend","url":"/it/6.1/howto/custom-template-backend/","canonical":"https://djangodocs.dev/it/6.1/howto/custom-template-backend/","summary":"Ecco come implementare un backend di template custom per utilizzare un altro sistema di template.","html":"

Come implementare un backend per template personalizzatoLink to this heading#

\n
\n

Backend personalizzatiLink to this heading#

\n

Ecco come implementare un backend di template custom per utilizzare un altro sistema di template. Un backend di template è una classe che eredita da django.template.backends.base.BaseEngine. Deve implementare get_template() ed opzionalmente from_string(). Ecco un esempio di template library fittizia foobar:

\n
Code
from django.template import TemplateDoesNotExist, TemplateSyntaxError\nfrom django.template.backends.base import BaseEngine\nfrom django.template.backends.utils import csrf_input_lazy, csrf_token_lazy\n\nimport foobar\n\n\nclass FooBar(BaseEngine):\n    # Name of the subdirectory containing the templates for this engine\n    # inside an installed application.\n    app_dirname = "foobar"\n\n    def __init__(self, params):\n        params = params.copy()\n        options = params.pop("OPTIONS").copy()\n        super().__init__(params)\n\n        self.engine = foobar.Engine(**options)\n\n    def from_string(self, template_code):\n        try:\n            return Template(self.engine.from_string(template_code))\n        except foobar.TemplateCompilationFailed as exc:\n            raise TemplateSyntaxError(exc.args)\n\n    def get_template(self, template_name):\n        try:\n            return Template(self.engine.get_template(template_name))\n        except foobar.TemplateNotFound as exc:\n            raise TemplateDoesNotExist(exc.args, backend=self)\n        except foobar.TemplateCompilationFailed as exc:\n            raise TemplateSyntaxError(exc.args)\n\n\nclass Template:\n    def __init__(self, template):\n        self.template = template\n\n    def render(self, context=None, request=None):\n        if context is None:\n            context = {}\n        if request is not None:\n            context["request"] = request\n            context["csrf_input"] = csrf_input_lazy(request)\n            context["csrf_token"] = csrf_token_lazy(request)\n        return self.template.render(context)\n
\n

Vedi DEP 182 per maggiori informazioni.

\n
\n
\n

Integrazione per il debug di engine customLink to this heading#

\n

La pagina di debug di Django ha hook che forniscono informazioni dettagliate quando si verifica un template error. I motori di template personalizzati possono utilizzare questi hook per aumentare le informazioni di traceback visualizzate dagli utenti. Sono disponibili i seguenti hook:

\n
\n

Postmortem sul templateLink to this heading#

\n

il postmortem appare quando viene sollevato TemplateDoesNotExist. Fa una lista dei motori di template e dei loader che sono stati usati quando si cercava un determinato template. Per esempio, se sono configurati due motori Django, il postmortem apparrà così:

\n\"/it/6.1/_images/postmortem.png\"\n

I motori personalizzati possono popolare il postmortem passando gli argomenti backend e tried quando sollevano TemplateDoesNotExist.I backend che usano il postmortem dovrebbero specificare una origine sull’oggetto di template.

\n
\n
\n

Informazione su linea contestualeLink to this heading#

\n

Se viene generato un errore durante il parsing o il rendering del template, Django è in grado di mostrare la riga in cui è presente l’errore. Ad esempio:

\n\"/it/6.1/_images/template-lines.png\"\n

I motori personalizzati possono popolare questa informazione impostando un attributo template_debug sulle eccezioni sollevate durante il parsing ed il rendering. Questo attributo è un dict con i seguenti valori:

\n\n

Dato il template di errore qui sopra, template_debug sarà simile a:

\n
Code
{\n    "name": "/path/to/template.html",\n    "message": "Invalid block tag: 'syntax'",\n    "source_lines": [\n        (1, "some\\n"),\n        (2, "lines\\n"),\n        (3, "before\\n"),\n        (4, "Hello {% syntax error %} {{ world }}\\n"),\n        (5, "some\\n"),\n        (6, "lines\\n"),\n        (7, "after\\n"),\n        (8, ""),\n    ],\n    "line": 4,\n    "before": "Hello ",\n    "during": "{% syntax error %}",\n    "after": " {{ world }}\\n",\n    "total": 9,\n    "bottom": 9,\n    "top": 1,\n}\n
\n
\n
\n

Origin API ed integrazione di terze partiLink to this heading#

\n

Django templates have an Origin object available\nthrough the template.origin attribute. This enables debug information to be\ndisplayed in the template postmortem, as well as\nin 3rd-party libraries, like the Django Debug Toolbar.

\n

I motori personalizzati possono fornire la propria informazione template.origin creando un oggetto che specifica i seguenti attributi:

\n\n
\n
","rootId":"how-to-implement-a-custom-template-backend","toc":[{"title":"Backend personalizzati","anchor":"custom-backends","children":[]},{"title":"Integrazione per il debug di engine custom","anchor":"debug-integration-for-custom-engines","children":[{"title":"Postmortem sul template","anchor":"template-postmortem","children":[]},{"title":"Informazione su linea contestuale","anchor":"contextual-line-information","children":[]},{"title":"Origin API ed integrazione di terze parti","anchor":"origin-api-and-3rd-party-integration","children":[]}]}],"breadcrumbs":[{"docname":"howto/index","title":"How-to guides","url":"/it/6.1/howto/"}],"prev":{"docname":"howto/overriding-templates","title":"Come sovrascrivere i templates","url":"/it/6.1/howto/overriding-templates/"},"next":{"docname":"howto/custom-template-tags","title":"Come creare tag di template e filtri personalizzati","url":"/it/6.1/howto/custom-template-tags/"},"formats":{"html":"/it/6.1/howto/custom-template-backend/","markdown":"/it/6.1/howto/custom-template-backend.md","json":"/it/6.1/howto/custom-template-backend.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/howto/custom-template-backend.txt","official":"https://docs.djangoproject.com/it/6.1/howto/custom-template-backend/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}