README

KickAssets 是 SilverStripe CMS 中“文件与图像”部分（AssetAdmin）的替代品。它增加了拖放上传、鼠标和键盘选择以及各种类似桌面的文件 UI 功能。

看看它。在 49 秒的华丽展示中。

演示

试一试.

(用户: kickassets / 密码: kickassets)

安装

composer require unclecheese/silverstripe-kickassets

依赖项

unclecheese/dropzone

屏幕截图

JavaScript API

一个 API 被暴露在整个 CMS 中，允许您在 KickAssets UI 中提示用户选择文件。以下

$('.select-files').entwine({
	onclick: function(e) {	
		e.preventDefault();
		var $t = this;
		KickAssets.requestFile(function(file) {
			$t.next('ul').append('<li><img src="'+file.iconURL+'"> '+file.filename+'</li>');
		});
	}
});

还有 KickAssets.requestFiles，它返回一个 file 对象数组。

可选地，您可以将权限列表作为 requestFile 或 requestFiles 的第一个参数传递。

$('.select-files').entwine({
	onclick: function(e) {	
		e.preventDefault();
		var $t = this;
		var permissions = {
			folderID: 123, 
			canUpload: false		
		};
		KickAssets.requestFile(permissions, function(file) {
			$t.next('ul').append('<li><img src="'+file.iconURL+'"> '+file.filename+'</li>');
		});
	}
});

权限的完整列表

与 UploadField 和 Dropzone 的使用

默认情况下，unclecheese/silverstripe-dropzone 模块将检测 KickAssets 并在 FileAttachmentField 中使用它来选择现有文件。

要使 UploadField 也具有相同的行为，请确保将 use_on_uploadfield 设置设置为 true。（默认情况下就是这样）。

KickAssets:
  use_on_uploadfield: true

大多数设置，如最大文件数、允许的扩展名和上传文件夹，将转移到 KickAssets 窗口。

与 HTMLEditorField 的使用

除了 CMS 默认配置中的“插入媒体”按钮外，KickAssets 还添加了一个“浏览文件...”按钮，该按钮打开 KickAssets 窗口，允许您上传、移动、编辑和删除文件，并将它们插入到编辑器中的光标位置。

如果您选择了一个或多个图像，它们将以选择的顺序附加到编辑器中。如果您选择了一个文件，它将链接编辑器中选定的任何文本到该文件的 URL。如果没有选择文本并且您选择了一个文件，它将使用文件标题作为可点击文本插入到文件的链接。

浏览器支持

除了 IE9 之外，每个人都可以参加派对。抱歉。

(我并不是真的抱歉。)

贡献

KickAssets 使用 React JS 编写，并需要从 ES6 和 JSX 转译。这使用 Webpack 和 Babel 完成。您需要在您的系统上安装 Webpack。

npm install -g webpack

然后，在您的 kickassets 模块目录中运行 npm install 以安装所有依赖项。

要开始编写代码，运行： webpack --watch

完成后，通过设置环境文件并开启压缩创建生产捆绑包。

PROD=1 webpack -p.

如果您不想全局安装 webpack，这里有一些方便的 npm 脚本

npm run build - 进行一次 webpack 构建
npm run build:watch - 等同于 webpack --watch
npm run build:prod - 等同于 PROD=1 webpack -p

故障排除

在开发环境中，并且当PHP E_NOTICE 启用时，如果您的文件没有同步，KickAssets 将会出错。

幸运的是，SilverStripe 附带了一个可以解决这个问题的新建任务（BuildTask）。前往 dev/tasks 目录并运行 "同步文件与图片资源"。

或者

打电话给Uncle Cheese。

unclecheese / silverstripe-kickassets

维护者

详细信息