README

狄俄尼索斯单选字段

此组件是用于 WordPress 的 Olympus Dionysos 字段 的一部分。

composer require getolympus/olympus-dionysos-field-radio

字段初始化

使用以下行在您的 WordPress 管理页面或自定义文章类型元字段中添加 单选字段

return \GetOlympus\Dionysos\Field\Radio::build('my_radio_field_id', [
    'title'       => 'Select a Minion that you may know',
    'default'     => 'kevin',
    'description' => 'A very important question! Pay attention to it ;)',
    'mode'        => 'default',
    'options'     => [
        'kevin' => 'Kevin',
        'mel'   => 'Mel',
        'dave'  => 'Dave',
        'bob'   => 'Bob',
    ],

    /**
     * Texts definition
     * @see the `Texts definition` section below
     */
    't_no_options' => 'The field does no have any options.',
]);

变量定义

显示取决于 模式 值

设置为 default（或 inline），标签选项将在同一行上显示，以 inline-block 显示
设置为 block，标签选项将每行显示一个，以 block 显示
设置为 image，标签选项将以 default 模式显示，带有图像和覆盖文本标签
设置为 image-block，标签选项将以 block 模式显示，带有图像和覆盖文本标签
设置为 group，标签选项将显示为简单但高效的选项组

变量	类型	未设置时的默认值	接受值
`title`	字符串	`'单选按钮'`	empty
`default`	字符串	空字符串	选项键之一
`description`	字符串	empty	empty
`mode`	字符串	`default`	参见变量定义
`options`	数组	empty	包含键/值选项的数组

文本定义

代码	默认值	定义
`t_no_options`	字段没有选项。	在没有设置选项的情况下用作错误

检索数据

使用简单的 get_option('my_radio_field_id', '') 从数据库检索您的值（参见 WordPress 参考）

// Get radio from Database
$radio = get_option('my_radio_field_id', '');

// Display value
echo '<h2><b>'.$radio.'</b>, master of the ceremony</h2>';

图像模式

要显示图片而不是简单的标签，请将 mode 设置为 image，并按照以下方式构建字段的选项

$options = [
    'key-name' => [
        'label' => 'Label item',
        'image' => 'https://label-image-url',
    ],
];

以下是一个完整的示例

return \GetOlympus\Dionysos\Field\Radio::build('my_radio_field_id', [
    'title'       => 'Select a Minion that you may know',
    'default'     => 'dave',
    'description' => 'A very important question! Pay attention to it ;)',
    'mode'        => 'image',
    'options'     => [
        'kevin' => [
            'label' => 'Kevin',
            'image' => 'https://vignette.wikia.nocookie.net/despicableme/images/1/1d/Kevin_minions.png/revision/latest/scale-to-width-down/350?cb=20170703052012',
        ],
        'mel'   => [
            'label' => 'Mel',
            'image' => 'https://vignette.wikia.nocookie.net/despicableme/images/2/2e/Mel_Minion_01.png/revision/latest/scale-to-width-down/350?cb=20160717135212',
        ],
        'dave'  => [
            'label' => 'Dave',
            'image' => 'https://vignette.wikia.nocookie.net/despicableme/images/7/71/Daveholdingcupcake.png/revision/latest/scale-to-width-down/350?cb=20130717145735',
        ],
        'bob'   => [
            'label' => 'Bob',
            'image' => 'https://vignette.wikia.nocookie.net/despicableme/images/c/ca/Bob-from-the-minions-movie.jpg/revision/latest/scale-to-width-down/350?cb=20151224154354',
        ],
    ],

    /**
     * Texts definitions
     * @see the `Texts definitions` section below
     */
    't_no_options' => 'The field does no have any options.',
]);

版本历史

版本	备注
0.0.19	从字段中移除复选框模式
0.0.18	修复小图片的图片标签显示问题
0.0.17	添加具有原生WordPress显示的分组模式

贡献

Fork它 (https://github.com/GetOlympus/olympus-dionysos-field-radio/fork)
创建您的功能分支 (git checkout -b feature/fooBar)
提交您的更改 (git commit -am '添加一些fooBar')
将更改推送到分支 (git push origin feature/fooBar)
创建一个新的拉取请求

由 Achraf Chouk 使用♥构建 ~ (c) 很长时间以来。

getolympus / olympus-radio-field

维护者

详细信息