django-uploader 0.2.1

***************
Django Uploader
***************


功能说明
============

Django Uploader 使用 `jQuery 文件上传`_ 插件，允许在Django管理后台拖放上传任意类型的文件。第三方应用程序可以编写特定文件类型的处理程序，并将它们注册到Django Uploader。当上传该类型的文件时，它将信息传递给处理程序，以便它可以创建包含该文件的新记录。

.. _jQuery 文件上传: https://blueimp.github.io/jQuery-File-Upload/



安装
============

1. 使用 `pip` 进行安装简单易行：

pip install django-uploader

2. 将 `uploader` 添加到您的 `INSTALLED_APPS` 设置中。
3. 添加上传器的urls：

url(r'^upload/', include('uploader.urls')),

4. 编写一个或多个上传处理程序。
5. 访问 /admin/uploader/upload/ 开始上传。


编写上传处理程序
=========================

.. note:: 上传处理程序不需要存在于创建记录的应用程序内部。它只需在导入的应用程序内部，以便处理程序可以被找到。

上传处理程序将一个或多个MIME类型分配给一个函数。对于给定的MIME类型，应该只有一个处理程序，尽管Uploader允许使用 `*` 进行一些重叠。例如，您可以为 `image/tiff` 和 `image/*` 及 `*/*` 提供一个处理程序。`image/tiff` 处理程序会获取任何 `.tiff` 图像，`image/*` 会获取任何其他类型的图像，而 `*/*` 处理程序会获取任何其他类型的文件。

首先，在您的应用程序中创建一个名为 `upload.py` 的文件。此文件可以包含多个不同的处理程序。当Uploader应用程序首次加载时，它将尝试从每个已安装的应用程序导入此文件。

一个基本的处理程序如下所示：

from uploader.registration import upload_handlers

def photo_handler(obj)
"""
处理从上传的图像创建SimpleModel记录。
"""
from .models import SimpleModel

new_item = SimpleModel.objects.create(
name=obj.filename,
slug=obj.filename_slug,
description='',
file=obj.file_contents
)

return new_item
photo_handler.thumbnail_attribute = 'thumb'

upload_handlers.register(['image/jpeg', 'image/png'], photo_handler)