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',
]);

变量定义

备注

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

文本定义

检索数据

使用简单的 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 'Add some fooBar'）
将分支推送到远程（git push origin feature/fooBar）
创建一个新的Pull Request

getolympus / olympus-dionysos-field-upload

维护者

详细信息