gillesgoetsch/acf-smart-button

一个简单、干净、精简的 ACF 字段，用于内部和外部链接。

维护者

详情

github.com/gillesgoetsch/acf-smart-button

源代码

问题

安装次数: 22,477

依赖项: 0

建议者: 0

安全: 0

星标: 75

关注者: 5

分支: 13

开放问题: 2

类型:wordpress-plugin

1.0.4 2020-07-09 08:50 UTC

Requires

  • php: >=5.3.2

GPLv2.0+ 496b6c77077494c72600a802306d2fccd2c53a18

pluginwordpressbuttonacf

This package is not auto-updated.

Last update: 2024-09-28 19:42:04 UTC

README

一个简单、干净、精简的 ACF 字段，允许用户通过平滑切换选择内部链接作为 post_object 或外部链接作为 url 字段。

它始终将 URL 返回为同一字段，无论它是内部链接还是外部链接。使用 button.target，您可以在模板中添加 target="_blank" 而无需额外的包装。

alt tag

alt tag

示例（twig 风格）

{% if button %}   
  <a href="{{ button.url }}" {{button.target }}>{{ button.text }}</a>   
{% endif %}

这不是很简洁吗 =)?

示例（vanilla PHP）

if ( get_field( 'acf_button_field' ) ) :
  $button = get_field( 'acf_button_field' );
  $button_label = $button['text'];
  $button_url = $button['url'];
  $button_target = $button['target'];
endif;

输出/返回

当为内部链接时

[text] => 我是一个内部按钮
[url] => http://yoursite.dev/selected-page
[target] => ''

当为外部链接时

[text] => 我是一个外部按钮
[url] => http://kollektiv.ag
[target] => 'target="blank"'

注意：在这两种情况下，只有当按钮文本与目标结合设置时，字段数据才会返回。如果任一项缺失，则不会返回数据。

未来计划

  • 选择允许的 post_types 的选项，用于 post_object 选择器 7626ad4
  • 语言支持
  • 验证 URL 字段
  • 清理等。
  • 最终支持 acf4（否？）

兼容性

此插件仅在版本 5 及以上版本中工作。

安装

此插件既可以被视为 WP 插件，也可以被视为主题包含。

作为插件安装

  1. 将 'acf-button' 文件夹复制到您的插件文件夹
  2. 通过插件管理页面激活插件

在主题中包含

  1. 将 'acf-smart-button' 文件夹复制到您的主题文件夹（可以使用子文件夹）。您可以在 'wp-content' 目录中的任何位置放置该文件夹
  2. 编辑您的 functions.php 文件并添加以下代码（确保路径正确以包含 acf-button.php 文件）
include_once('acf-smart-button/acf-smart-button.php');

否则

部分灵感来自 https://github.com/envex/acf-button-field，但缺少 acf5 支持，并没有完全满足我的要求。