romaninsh / upload
此软件包最新版本(dev-master)没有可用的许可证信息。
dev-master
2014-03-13 11:09 UTC
This package is auto-updated.
Last update: 2024-09-14 10:13:08 UTC
README
使用敏捷工具包上传文件一直是一个挑战。文件存储和“上传”字段具有出色的功能,可以让你更简单地上传文件,但是上传字段并没有提供所有可能的功能和灵活性。
此附加组件实现了更好的上传字段。
功能
字段/上传
简单的文件上传,只上传一个文件,上传完成后显示“上传成功”
- 与上传字段兼容。简单使用不同的类
- 使用BlueImp Upload jQuery小部件而不是内置的
- 如果可用,将使用AJAX上传或作为后备使用iFrame
- 允许你定义在文件上传成功时执行的PHP钩子
- 上传完成后触发JavaScript事件(兼容性)
- 上传时显示进度条
- 取消上传后再次显示字段
- 支持文件和图片上传
- 默认显示“成功”,但可以使用以下其他视图之一
备注
- 需要文件存储,不能不使用它
- 支持单个文件上传,尽管附带文件管理器视图
注意:也许将重新排列这些视图以分组它们
视图/文件管理员
- 基本上是一个常规视图,具有类似于原始上传的预定义模板
- 允许删除或下载文件
- 使用与原始上传字段类似的模板
视图/缩略图
- 这是一个简单的视图,将显示缩略图。
- $thumb->setModel($file)->load(10);
- 可以与上传文件一起使用
- 当模型未加载时显示空白图像
视图/缩略图管理员
- 扩展缩略图
- 添加一个十字,具有JS功能以删除图像
控制器/DropZone
- 将此控制器添加到视图中,你将能够在其中拖放图像
- 将自动添加一个隐藏的上传字段或可以使用你指定的字段
- 理想用于与视图/缩略图一起使用。将图像拖放到缩略图中以上传新图像
视图/文件列表
- 类似于缩略图的列表,但显示多个文件
- 不需要加载模型,将迭代它
- 仍然支持拖放区域
- 可以轻松启用排序
- 可以与表单字段链接,该字段将包含模型ID列表
视图/文件列表管理员
- 类似于缩略图管理员,允许删除单个图像
API参考
独立使用
$uploader = $this->add('romaninsh/upload/View_Uploader');
$uploader -> setModel('filestore/File');
此功能无需表单。这里简单地依赖于BlueImp上传器。你可以指定$uploder->options来更改上传的任何内容。你可以使用“uploaded”钩子来对此做一些有用的事情。
测试用例:test/romaninsh/upload/test1
表单使用
$uploader = $form->addField('romaninsh/upload/Upload','file_id');
$uploader -> setModel('filestore/File');
文件上传后,将模型->id放入隐藏的'file_id'字段中。此字段将自动依赖于视图/FileAdmin或视图/ThumbAdmin(取决于你的模型)以显示上传的文件。它还会在成功上传后隐藏上传字段,并在删除文件时再次显示它。
还将触发'upload',以便与以前的上传器实现大致兼容。
如果你启用多文件使用,则它将依赖于列表视图。