README

Dionysos 链接字段

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

composer require getolympus/olympus-dionysos-field-link

字段初始化

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

return \GetOlympus\Dionysos\Field\Link::build('my_link_field_id', [
    'title'       => 'Never gonna give you up!',
    'default'     => [
        [
            'url'    => 'https://www.youtube.com/watch?v=oVTPg9iicy4',
            'label'  => 'Never gonna get you down!',
            'target' => '_blank',
        ],
    ],
    'description' => 'You\'ve been Rick rolled!',
    'multiple'    => false,

    /**
     * Texts definition
     * @see the `Texts definition` section below
     */
    't_addblock_title'        => 'Click on the edit button',
    't_addblock_description'  => 'Click on the "+" button to add your link.',
    't_addblocks_description' => 'Click on the "+" button to add a link item.',
    't_addblock_label'        => 'Add',
    't_editblock_label'       => 'Edit',
    't_removeblock_label'     => 'Remove',
]);

变量定义

变量	类型	未设置时的默认值	接受的值
`title`	字符串	`'超文本链接'`	空
`默认值`	数组	空	空
`description`	字符串	空	空
`多个`	布尔值	`false`	`true` 或 `false`

备注

将 multiple 设置为 true 以启用 "添加链接" 按钮

文本定义

代码	默认值	定义
`t_addblock_title`	点击编辑按钮	无链接的项上显示的消息
`t_addblock_description`	点击 "+" 按钮添加您的链接。	用于添加单个项框的主要助手
`t_addblocks_description`	点击 "+" 按钮添加链接项。	用于添加多个项框的主要助手
`t_addblock_label`	添加	用作添加按钮区域标题
`t_editblock_label`	编辑	用作编辑按钮区域标题
`t_removeblock_label`	移除	用作移除按钮区域标题

检索数据

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

{
  "1": {
    "url": "https://www.google.com",
    "label": "Google.com",
    "target": "_self"
  },
  "2": {
    "url": "https://www.yahoo.com",
    "label": "Yahoo.com",
    "target": "_blank"
  }
}

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

// Get links from Database
$links = get_option('my_link_field_id', []);

// Check if links are empty
if (!empty($links)) {
    // Build HTML list
    echo '<ul>';

    foreach ($links as $link) {
        // Build HTML items
        echo '<li>';
        echo '<a href="'.$link['url'].'" target="'.$link['target'].'" title="'.esc_html($link['label']).'">';
        echo $link['label'];
        echo '</a>';
        echo '</li>';
    }

    echo '</ul>';
}

发布历史

版本	说明
0.0.22	添加编辑器按钮样式表和 wp-util JavaScript 更新 README
0.0.21	JS 兼容性
0.0.20	修复与新移除图标相关的显示问题

贡献

创建分支（https://github.com/GetOlympus/olympus-dionysos-field-link/fork）
创建你的功能分支（git checkout -b feature/fooBar）
提交你的更改（git commit -am 'Add some fooBar'）
将分支推送到远程仓库（git push origin feature/fooBar）
创建新的拉取请求

由Achraf Chouk 用♥构建 ~ （c）很长时间以来。

getolympus / olympus-link-field

维护者

详细信息