# dcat-media-selector

**Repository Path**: fitop/dcat-media-selector

## Basic Information

- **Project Name**: dcat-media-selector
- **Description**: 表单媒体选择器，支持中英文拖动
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 7
- **Created**: 2022-01-25
- **Last Updated**: 2022-01-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dcat-admin 表单媒体资源选择器

<p align="center">
    <a href="https://packagist.org/packages/de-memory/dcat-media-selector">
        <img src="https://img.shields.io/packagist/dt/de-memory/dcat-media-selector.svg?color=" />
    </a> 
    <a><img src="https://img.shields.io/badge/php-7.1+-59a9f8.svg?style=flat" /></a> 
    <a><img src="https://img.shields.io/badge/laravel-7.29+-59a9f8.svg?style=flat" ></a>
</p>

![](https://raw.githubusercontent.com/de-memory/dcat-media-selector/master/1.png)
![](https://raw.githubusercontent.com/de-memory/dcat-media-selector/master/2.png)

## 依赖
 
- php  | >= 7.1.0
- dcat/laravel-admin  | >= ~2.0 
- intervention/image  | >= ^2.5

## 安装

### composer 安装

```
composer require de-memory/dcat-media-selector
```

### 后台发布

```
开发工具=》扩展=》de-memory.dcat-media-selector=》启用
```

### 执行该扩展迁移文件

```
php artisan migrate --path=vendor/de-memory/dcat-media-selector/updates
```

### 将根目录下面的文件同步到数据库(可以不执行。如果执行会去掉数据库已有的，根据path字段过滤)

```
php artisan dcat-media-selector:install
```

## 更新

```
composer update

// 强制发布静态资源文件
php artisan vendor:publish --tag=dcat-media-selector-assets --force

// 清理视图缓存
php artisan view:clear
```


## 方法使用

```
$form->mediaSelector('avatar1', '头像2')->required()->rules('required', [
    'required' => '请输上传或选择封面'
])->options([
    'length' => 20,
    'type' => 'blend',
    'sortable' => true,
    'move' => json_encode(['dir' => 'upload_files', 'fileNameIsEncrypt' => true]),
])->help('混合多媒体选择，拖动排序。限制上传或选择20个媒体');
```

## 参数说明

```
/*
|--------------------------------------------------------------------------
| 媒体选择数量。默认1
|--------------------------------------------------------------------------
*/
length(int)

/*
|--------------------------------------------------------------------------
| 媒体上传路径，媒体名称是否加密
|--------------------------------------------------------------------------
| 第一个参数，媒体上传路径。默认upload_files
| 第二个参数，媒体名称是否加密。默认true
|
| 注意：第二个参数如果是false，上传文件时，跟已上传的文件名称相同，会覆盖已上传的文件
| 
*/
move(string, boolean)

/*
|--------------------------------------------------------------------------
| 媒体选择类型。默认blend
|--------------------------------------------------------------------------
| blend            混合选择
| image            图片选择
| video            视频选择
| audio            音频选择
| powerpoint       文稿选择
| code             代码文件选择
| zip              压缩包选择
| text             文本选择
| other            其他选择
*/
type(string)

/*
|--------------------------------------------------------------------------
| 推动排序。默认true
|--------------------------------------------------------------------------
| true             启用排序
| false            禁用排序
*/
sortable(boolean)
```

## 说明

```

在JSON表单可能无法使用。（这个还没有测试）

数据保存处理
1、可以用官网文档中的，模型表单回调
https://learnku.com/docs/dcat-admin/2.x/event/8113

2、可以用laravel模型处理（模型修改器）
https://learnku.com/docs/laravel/7.x/eloquent-mutators/7502#81e641
```

## 回滚该扩展迁移文件。(谨慎操作)

```
php artisan migrate:rollback --path=vendor/de-memory/dcat-media-selector/updates
```