django-attachments 1.11

In contrib.admin:

django-attachments provides a inline object to add a list of attachments to any kind of model in your admin app.

Simply add AttachmentInlines to the admin options of your model. Example:

from django.contrib import admin
from attachments.admin import AttachmentInlines

class MyEntryOptions(admin.ModelAdmin):
    inlines = (AttachmentInlines,)

In your frontend templates:

First of all, load the attachments_tags in every template you want to use it:

{% load attachments_tags %}

django-attachments comes with some templatetags to add or delete attachments for your model objects in your frontend.

1. get_attachments_for [object]: Fetches the attachments for the given model instance. You can optionally define a variable name in which the attachment list is stored in the template context (this is required in Django 1.8). If you do not define a variable name, the result is printed instead.

   {% get_attachments_for entry as attachments_list %}

2. attachments_count [object]: Counts the attachments for the given model instance and returns an int:

   {% attachments_count entry %}

3. attachment_form: Renders a upload form to add attachments for the given model instance. Example:

   {% attachment_form [object] %}

   It returns an empty string if the current user is not logged in.

4. attachment_delete_link: Renders a link to the delete view for the given attachment. Example:

   {% for att in attachments_list %}
       {{ att }} {% attachment_delete_link att %}
   {% endfor %}

   This tag automatically checks for permission. It returns only a html link if the give n attachment’s creator is the current logged in user or the user has the delete_foreign_attachments permission.

v1.11 (2023-04-20)

• Return form errors as JSON from add_attachment() view when the X-Return-Form-Errors request header is present. Response code is 400 - BAD REQUEST because this is a client error.

v1.10 (2023-04-14)

• Support custom form validators via AppConfig.attachment_validators

• Remove quotes from “attachment_list” (Aaron C. de Bruyn)

• Add a URL for matching objects with a UUID4 primary key. Fix Issue #94 (Aaron C. de Bruyn)

• Document settings supported by django-attachments

• Document how to make a new release. Closes Issue #78

• Start testing with GitHub Actions

• Drop testing with end-of-life versions of Django

• Add testing with Django 4.0 and 4.1, Python 3.9 and 3.10 and switch the default Python version used to 3.10

• Add testing w/ Python 3.11 - supported only on Django 4.1 for now

v1.9.1 (2021-04-30)

• Rebuild the previous version but don’t ship a left-over migration file

v1.9 (2021-04-29) – removed from PyPI

• Configure PK explicitly to AutoField for Django 3.2+, see https://docs.djangoproject.com/en/3.2/releases/3.2/#customizing-type-of-auto-created-primary-keys

• Start testing with Django 3.2

• Fix typo in README (Jesaja Everling)

• Enable syntax highlighting in README (Basil S)

v1.8 (2020-09-03)

• Alter object_id from TextField() to CharField(max_length=64), and keep the db_index argument. This resolves the issues on MariaDB/MySQL.

v1.7 (2020-08-31) - broken on MariaDB/MySQL

• Add DB index to object_id, created and modified fields.

• Add delete_stale_attachments command to remove attachments for which the corresponding object has been deleted.

• Add Attachment.attach_to() method for moving attachments between different objects.

• Django 3.1 compatibility and tests.

v1.6 (2020-08-17)

• Primary keys of related objects other than Integers (such as UUIDs) are now supported.

v1.5 (2019-12-08)

• Dropped support for Python 3.4.

• Added suport for Python 3.8.

• Django 3.0 compatibility and tests.

• Django 2.2 compatibility and tests.

v1.4.1 (2019-07-22)

• The templatetags now allow an optional next parameter.

v1.4 (2019-02-14)

• Dropped Support for Django <=1.10.

• Fixed ‘next’ URL argument redirect.

v1.3.1 (2019-01-24):

• Django 2.1 and Python 3.7 support.

• General code cleanup.

v1.3 (2018-01-09):

• Added a missing database migration.

• New templatetag attachments_count.

• New setting DELETE_ATTACHMENTS_FROM_DISK to delete attachment files if the attachment model is deleted.

• New setting FILE_UPLOAD_MAX_SIZE to deny file uploads exceeding this value.

v1.2 (2017-12-15):

• Django 1.11 and 2.0 compatibility and tests.

v1.1 (2017-03-18):

• Django 1.10 compatibility and tests.

• Python 3.6 compatibility and tests.

• Fixes problems where models have a foreign key named something other than “id”.

v1.0.1 (2016-06-12):

• Added finnish translation.

• Minor test suite improvements.

v1.0 (2016-03-19):

• General code cleanup to keep compatibility with the latest Django (currently 1.8 upwards) as well as Python3. Introduced full testsuite.

• Backwards incompatible: The attachment views now use a urlpattern namespace so you need to adjust the urlpattern:

  url(r'^attachments/', include('attachments.urls', namespace='attachments')),

• Backwards incompatible: The quotes around the as variable name

  must be removed:

  {% get_attachments_for entry as "my_entry_attachments" %}
  
  becomes
  
  {% get_attachments_for entry as my_entry_attachments %}

• Possibly backwards incompatible: The old version had bugs around

  permissions and were not enforcing it in all places. From now on the related permissions add_attachment and delete_attachment must been applied to all related users.

v0.3.1 (2009-07-29):

• Added a note to the README that you should secure your static files.

v0.3 (2009-07-22):

• This version adds more granular control about user permissons. You need to explicitly add permissions to users who should been able to upload, delete or delete foreign attachments.

  This might be backwards incompatible as you did not need to assign add/delete permissions before!