django-user-media 0.10

A reusable app to graceously handle files that your users might upload, such as profile pictures, foto albums etc...

  Add it to your Download Basket!

 Add it to your Watch List!


Rate it!
send us
an update
MIT/X Consortium License 
Martin Brochhaus
ROOT \ Internet \ Django Plugins
django-user-media is a Django reusable app to graceously handle files that your users might upload, such as profile pictures, foto albums etc...

Almost all modern web apps allow their users to upload content such as audio, video or images. This raises a number of issues if that content should not be visible to the whole world by default.

If you have a UserProfile model and add an ImageField to it, you need to come up with a good idea on how to save those images. It is probably not a good idea to keep the original filenames as they might disturb your server's file system and open doors for hackers, who might try to brute-force against your /media/user_profiles/ in the hope to steal some valuable files.

Since it seems inevitable to implement a function for Django's FileField's upload_to attribute I thought that this might be a candidate for a reusable app.

This project is experimental. We are using it on two completely different live projects and will hopefully come up with an implementation that is so generic that it can safely be used by anyone.

Since we are dealing with files here and not only with a database, backwards incompatible changes might turn out to be a pain in the ass to deploy on your production sites. You have been warned.


To get the latest stable release from PyPi:

 pip install django-user-media

To get the latest commit from GitHub:

 pip install -e git://

Add the app to your INSTALLED_APPS:


Hook the app into your main

urlpatterns += patterns('',
 url(r'umedia/', include('user_media.urls')),

Run the south migrations to create the app's database tables:

 ./ migrate user_media


Let's assume that you have a UserProfile model and you want to add an avatar field to that model.

First you might want to add a GenericRelation to your UserProfile model:

from django.contrib.contenttypes import generic

class UserProfile(models.Model):
 user = models.ForeignKey('auth.User')

 avatar = generic.GenericRelation(

Now you will be able to get all uploaded images that belong to a UserProfile by doing this:

profile = UserProfile.objects.get(pk=1)
images = profile.avatar.filter(user=profile.user)

It makes sense to add a convenience method to your UserProfile model:

class UserProfile(models.Model):
 def get_avatar(self):
 return self.avatar.filter(user=self.user)

In your templates you can now provide a link to the image creation view like this (assuming that your UserProfile object is called object in the template's context):

{% load url from future %}
< a href="{% url "user_media_create_image" content_type="userprofile" %}" >Upload your picture< /a >

Note that userprofile is the model name that the ContentType of your UserProfile model would return. You can figure this out with ./ shell for example:

$ ./ shell
In [1]: from django.contrib.contenttypes.models import ContentType
In [2]: from your_app.models import UserProfile
In [3]: ContentType.objects.get_for_model(UserProfile).model
Out [1]: u'userprofile'

When visiting that link, the user should see an image upload form. You might want to override that template (user_media/usermediaimage_form.html). After uploading the image the view should redirect back to the absolute url of your UserProfile. If you want to redirect to another URL, you can provide a next URL parameter via POST or GET:

Upload your picture

Now you should have all building blocks that you need to add links or buttons to your templates that call the views of this application. On your UserProfile detail view you could display the avatar, if available:

{% if object.get_avatar %}
 < img src="{{ MEDIA_URL }}{{ object.get_avatar.0.image }}" / >
{% endif %}

Or in your UserProfile update view you could display a link to upload a new image or to delete the existing image:

{% if form.instance.get_avatar %}
 < p >< img src="{{ MEDIA_URL }}{{ form.instance.get_avatar.0.image }}" / >< /p >
 < a href="{% url "user_media_image_delete" %}" >Delete picture< /a >
{% else %}
 < a href="{% url "user_media_image_create" content_type="userprofile" %}" >Add profile picture< /a >
{% endif %}

The delete link in this example will render the user_media/usermediaimage_confirm_delete.html template, which you might want to override in your project.

Last updated on July 16th, 2012


#image uploader #foto albums #Django #image #uploader #class

Add your review!