Override default templates

If you wish to override the default templates (you probably will), this is how to do it.

The following paths are being used by the template tags and views

The search path is as follows (in this order):

1. “attachments/app_label/model/<template name>.html”
2. “attachments/app_label/<template name>.html”
3. “attachments/model/<template name>.html”
4. “attachments/<template name>.html”

where app_label is the app_label of the model which the attachment should be related to (in our case demosite), and the model is the model which the attachment should be related to (in our case shape).

This means that you can create a different form (if you choose to) for

• Each of your models (in one or more) of your apps
• A form for all your models in one or more apps
• One form for all your models across your entire project that shares a name
• Or just use a single form for your entire project

form.html

Used by:

• files.views.AttachmentCreateView
• files.templatetags.attachments.render_attachment_form()
• files.templatetags.attachments.get_attachment_form()

Template used to render an upload form when adding a new attachment to some object.

edit_form.html

Used by:

• files.views.AttachmentEditView
• files.templatetags.attachments.render_attachment_editform()
• files.templatetags.attachments.get_attachment_editform()

Template used to render an edit form for an existing attachment.

list.html

Used by:

• files.templatetags.attachments.render_attachment_list()
• files.templatetags.attachments.get_attachment_list()

Render a list of attachments.

view.html

Used by:

• files.views.AttachmentDetailView

Template for viewing the details of the attachment.

delete.html

Used by:

• files.views.AttachmentDeleteView

Template used to show the “Really delete this attachment?”, and eventually post to the DeleteAttachmentView which performs the delete action.

deleted.html

Used by:

• files.views.AttachmentDeleteView

After deleting an attachment, redirects to this template unless a next value is provided.

400-debug.html

A standard 400 error page used if settings.DEBUG = True Not used in production mode.