README

Link 提供了一个强大的跨内容、外部以及其他各种链接类型的字段类型。

要求

此插件需要 Craft CMS 3.0 或更高版本。

安装

请选择以下方法之一将 Link 添加到您的项目中

1. Composer

   只需从您的项目根目录运行以下命令

   composer require flipboxfactory/craft-link
   

2. Craft CMS 插件商店

   在您的 Craft CMS 项目管理面板中，导航到 '插件商店' 并搜索 'Link'。安装只需点击一下按钮。

一旦插件包含到您的项目中，导航到控制面板，转到设置 → 插件，然后点击 Link 的“安装”按钮。

更多信息（包括价格）可以在 插件商店 中找到。

特性

Link 是 Craft CMS 中最强大和可定制的 '链接' 字段类型。考虑到内容发布者而构建的 Link 具有直观、易于配置的界面，使管理员能够精确构建字段以满足其需求。

以下是一些主要特性

• 可定制的标签
• 字段内可设置多种链接类型
• 可配置的链接类型设置
• 指定元素来源以限制可用的元素
• 在页面上添加并链接到新元素而无需离开页面
• 简单的渲染，并支持覆盖
• 构建自己的自定义链接类型

模板

字段值将是 null 或 链接类型接口 的实例。

渲染预构建的链接

{{ element.fieldHandle.getHtml()|raw }}

使用覆盖渲染预构建的链接

{{ element.fieldHandle.getHtml({
    text: 'Text Override'
})|raw }}

使用额外属性渲染预构建的链接

{{ element.fieldHandle.getHtml({
    class: "bg-blue hover:bg-blue-dark text-white font-bold py-2 px-4 rounded",
    rel: "noopener noreferrer",
    onclick: "return confirm('Are you sure?')"
})|raw }}

构建自己的链接

<a href="{{ element.fieldHandle.url }}">{{ element.fieldHandle.text }}</a>

截图

第一方链接类型

以下第一方链接类型得到支持

• 元素：资产
• 元素：类别
• 元素：条目
• 元素：用户
• HTTP/HTTPS

第三方链接类型

包括自定义链接类型很容易

1. 创建一个新的链接类型类。该类必须实现：flipbox\craft\link\types\TypeInterface（参考：链接类型接口）

   有两个抽象链接类型可以帮助您开始

   • \flipbox\craft\link\types\AbstractType（参考：抽象链接类型）
   • \flipbox\craft\link\types\AbstractElement（参考：抽象元素链接类型）

2. 注册链接类型类。示例

\yii\base\Event::on(
    \flipbox\craft\link\Link::class,
    \flipbox\craft\link\Link::EVENT_REGISTER_TYPES,
    function(RegisterLinkTypes $event) {
        $event->types[] = YourLinkType::class; // Replace this with your link type class
    }
);

致谢

• Flipbox 数字