這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

ACF Tooltip

外掛說明

If an ACF field requires a longer instruction text, the layout of the edit screen is messy and a lot of space is wasted.

The ACF Tooltip plugin hides the field instructions, adds a help symbol to the field labels and generates a tooltip based on the instruction text.

New in Version 1.2.0

The tooltip will not hide if moused over, allowing create a tooltip with a link inside without hiding the tooltip.

Custom settings

There are 7 filters that allow adjusting the design and the behavior of the tooltips.

This plugin works only with the ACF PRO (version 5.5.0 or higher).

Localizations

  • English
  • Deutsch

Custom settings with filter hooks

There are 7 filters that allow adjusting the design and the behavior of the tooltips can be adjusted.

Set the design of the tooltips

<?php
function acf_tooltip_style() {
    $style = 'qtip-acf';

    return $style;
}
add_filter('acf/tooltip/style', 'acf_tooltip_style');
?>

The available styles can be found on the qTip options page and are shown on the qTip demo site.

You can mix the styles; e.g. “qtip-acf qtip-rounded qtip-shadow”

If you like, you can define your own style, with the class name of your style from your own CSS file (see next filter).

The qtip-acf style is the standard style, which is set without a filter.

Define your own CSS file

<?php
function acf_tooltip_css() {
    $css_file = get_bloginfo('template_url') . '/qtip-own.css'; // if the file is saved in your themes folder

    return $css_file;
}
add_filter('acf/tooltip/css', 'acf_tooltip_css');
?>

You will find a ‘qtip-example-style.css’ in the ‘/assets/css’ folder.

Positioning the corner of the tooltip

<?php
function acf_tooltip_position_my() {
    $position_my = 'center left';

    return $position_my;
}
add_filter('acf/tooltip/position/my', 'acf_tooltip_position_my');
?>

Position in relation to the tooltip icon

<?php
function acf_tooltip_position_at() {
    $position_at = 'center right';

    return $position_at;
}
add_filter('acf/tooltip/position/at', 'acf_tooltip_position_at');
?>

Check out the qTip demo site to find your perfect positioning.

Apply tooltips only to fields with specific class

<?php
function acf_tooltip_class() {
    $class = 'with__tooltip'; // edit this to your prefered class name

    return $class;
}
add_filter('acf/tooltip/class/only', 'acf_tooltip_class');
?>

Add the class to the fields where you want to show tooltips.

Exclude tooltips on fields with specific class

<?php
function acf_tooltip_class_exclude() {
    $class = 'no__tooltip'; // edit this to your prefered class name

    return $class;
}
add_filter('acf/tooltip/class/exclude', 'acf_tooltip_class_exclude');
?>

Add the class to the fields where you don’t want to show tooltips.

Add tooltips to the Field Editor

With this filter, you can specify whether the instructions in the Field Editor are displayed as tooltips as well. By default, the instructions are displayed.

<?php
add_filter('acf/tooltip/fieldeditor', '__return_true');
?>

螢幕擷圖

  • ACF Tooltip in standard mode

安裝方式

  1. Upload the acf-tooltip folder to your /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Done!

使用者評論

2019 年 2 月 7 日
Great plugin! Does the job well. However, a bit heavy; for large use cases where you have many ACF fields, I have seen a significant performance drop in the WP dashboard and increased load times.
2018 年 12 月 16 日
Thanks for keeping it maintained, too.
2018 年 11 月 16 日
For those who like verbose instructions, this plugin is a lifesaver. Works exactly as expected. Thank you so much!
閱讀全部 6 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈ACF Tooltip〉的開發相關工作。

參與者

ACF Tooltip 外掛目前已有 4 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈ACF Tooltip〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

v1.2.2

  • Fixed compatibilty error of 1.2.1 update if ACF is < 5.7.0

v1.2.1

v1.2.0

  • Tooltip is no longer hidden on hover

v1.1.0

  • Changed class name to prevent future conflicts with ACF

v1.0.0

  • Initial release of this plugin, tested and stable.