README

此组件是用于WordPress的Olympus Dionysos字段的一部分。
它使用默认的wpMedia WordPress JavaScript包来管理字段。

composer require getolympus/olympus-dionysos-field-upload

字段初始化

使用以下代码行在您的WordPress管理页面或自定义文章类型元字段中添加一个上传字段。

return \GetOlympus\Dionysos\Field\Upload::build('my_upload_field_id', [
    'title'       => 'What\'s your flavor?',
    'can_upload'  => false,
    'default'     => [],
    'description' => 'Tell me what\'s your flavour!',
    'multiple'    => false,
    'type'        => 'image',
    'size'        => 'thumbnail',

    /**
     * Texts definition
     * @see the `Texts definition` section below
     */
    't_addblock_description'  => 'Click on the "+" button to add a media.',
    't_addblocks_description' => 'Click on the "+" button to add medias.',
    't_cannot_upload'         => 'It seems you are not able to upload files.',
    't_name_label'            => 'Edit the legend',
    't_addblock_label'        => 'Add',
    't_editblock_label'       => 'Edit',
    't_removeblock_label'     => 'Remove',
]);

变量定义

变量	类型	未设置时的默认值	接受的值
`title`	字符串	`'Upload'`	empty
`can_upload`	布尔型	`false`	`true`或`false`
`default`	数组	empty	empty
`description`	字符串	empty	empty
`multiple`	布尔型	`false`	`true`或`false`
`类型`	字符串	`'image'`	默认文件MIME类型
`size`	字符串	`'thumbnail'`	来自`add_image_size()`的图像大小 WordPress函数

注意

can_upload值由current_user_can('upload_files')定义（见WordPress参考）
将multiple设置为true以启用“添加媒体”按钮

文本定义

代码	默认值	定义
`t_addblock_description`	点击"+"按钮添加媒体。	用于添加单个项目框的主要辅助程序
`t_addblocks_description`	点击"+"按钮添加媒体。	用于添加多个项目框的主要辅助程序
`t_cannot_upload`	看起来您无法上传文件。	如果用户无法上传文件则显示错误
`t_name_label`	编辑说明	名称项的占位符
`t_addblock_label`	添加	用作添加按钮区域标题
`t_editblock_label`	编辑	用作编辑按钮区域标题
`t_removeblock_label`	删除	用作删除按钮区域标题

检索数据

使用简单的get_option('my_upload_field_id', [])从数据库检索您的值（见WordPress参考）。以下是一个json_encode()示例，说明数据如何存储在数据库中。

{
  "mediaId": {
    "name": "mediaName.mediaExt",
    "id": "mediaId",
    "height": "mediaHeight",
    "url": "mediaUrl",
    "width": "mediaWidth"
  }
}

以下是一个简单的示例，说明如何在PHP中迭代数据数组。

// Get upload from Database
$upload = get_option('my_upload_field_id', []);

if (!empty($upload)) {
    foreach ($upload as $img) {
        echo '<figure id="'.$img['id'].'">';
        echo '<img src="'.$img['url'].'" width="'.$img['width'].'" height="'.$img['height'].'" alt="'.esc_html($img['name']).'" />';
        echo '<figcaption>'.$img['name'].'</figcaption>';
        echo '</figure>';
    }
}

发布历史

0.0.16

移除无用的管理脚本

0.0.15

现在与新的Zeus-Core版本兼容

0.0.14

新的Olympus组件兼容性
将存储库改为成为Dionysos字段的一部分

贡献

进行分支 (https://github.com/GetOlympus/olympus-dionysos-field-upload/fork)
创建您的功能分支 (git checkout -b feature/fooBar)
提交您的更改 (git commit -am '添加一些fooBar')
推送到分支 (git push origin feature/fooBar)
创建一个新的Pull Request

由Achraf Chouk构建于 GitHub (https://github.com/crewstyle) ~ (c) 已有很长时间。

getolympus / olympus-upload-field

维护者

详细信息