Title: ACF Tooltip
Author: dreihochzwo
Published: <strong>2017 年 3 月 21 日</strong>
Last modified: 2024 年 12 月 22 日

---

搜索插件

![](https://ps.w.org/acf-tooltip/assets/banner-772x250.png?rev=1620887)

**该插件尚未通过WordPress的最新3个主要版本进行测试**。 当与较新版本的WordPress一起
使用时，可能不再受到维护或支持，并且可能会存在兼容性问题。

![](https://ps.w.org/acf-tooltip/assets/icon-256x256.png?rev=1620887)

# ACF Tooltip

 作者：[dreihochzwo](https://profiles.wordpress.org/tmconnect/)

[下载](https://downloads.wordpress.org/plugin/acf-tooltip.1.2.5.zip)

 * [详情](https://cn.wordpress.org/plugins/acf-tooltip/#description)
 * [评价](https://cn.wordpress.org/plugins/acf-tooltip/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/acf-tooltip/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/acf-tooltip/#developers)

 [支持](https://wordpress.org/support/plugin/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](https://www.advancedcustomfields.com/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](http://qtip2.com/options#style)
and are shown on the [qTip demo site](http://qtip2.com/demos/).

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](http://qtip2.com/demos/) 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⌉⌊ACF Tooltip in standard mode⌉[

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!

## 评价

![](https://secure.gravatar.com/avatar/7c04aec7f8289d1c303076cda1c97a59ab17839df986f491cb33b2e7015bbb23?
s=60&d=retro&r=g)

### 󠀁[Works like charme](https://wordpress.org/support/topic/works-like-charme-2/)󠁿

 [indysigner](https://profiles.wordpress.org/indysigner/) 2021 年 9 月 21 日

Installed it, activated it, and guess what? It just works! Great job, Thomas!

![](https://secure.gravatar.com/avatar/74653e09d86eca41f64dc2c33de34f923ade472a5bd1d6ed89ab55389e1f4174?
s=60&d=retro&r=g)

### 󠀁[Very useful plugin.](https://wordpress.org/support/topic/very-useful-plugin-959/)󠁿

 [dionysios](https://profiles.wordpress.org/dionysios/) 2020 年 5 月 15 日

Very useful plugin. Please keep it alive and updated! Thank you!

![](https://secure.gravatar.com/avatar/4d014efa87ba16a435aec963da1d15ad17246bf7a0d53e23e801e652a26648c6?
s=60&d=retro&r=g)

### 󠀁[Excellent!](https://wordpress.org/support/topic/excellent-7319/)󠁿

 [palmerijosh](https://profiles.wordpress.org/palmerijosh/) 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.

![](https://secure.gravatar.com/avatar/d17ff61b1a90175bd9c750ce3a0aa795d30bc8539cf0c7c9b67882d2b75fe06d?
s=60&d=retro&r=g)

### 󠀁[Very useful](https://wordpress.org/support/topic/very-useful-1776/)󠁿

 [edmin](https://profiles.wordpress.org/edmin/) 2018 年 12 月 16 日

Thanks for keeping it maintained, too.

![](https://secure.gravatar.com/avatar/0c7a2d9183c117bb04031d4d3cfe6cc84b39a0ba9eaf15506ba2b51a64307907?
s=60&d=retro&r=g)

### 󠀁[Saves so much space!](https://wordpress.org/support/topic/saves-so-much-space/)󠁿

 [FriendlyWP](https://profiles.wordpress.org/mmcginnis/) 2018 年 11 月 16 日

For those who like verbose instructions, this plugin is a lifesaver. Works exactly
as expected. Thank you so much!

 [ 阅读所有6条评价 ](https://wordpress.org/support/plugin/acf-tooltip/reviews/)

## 贡献者及开发者

「ACF Tooltip」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ dreihochzwo ](https://profiles.wordpress.org/tmconnect/)

「ACF Tooltip」插件已被翻译至 4 种本地化语言。 感谢[所有译者](https://translate.wordpress.org/projects/wp-plugins/acf-tooltip/contributors)
为本插件所做的贡献。

[帮助将「ACF Tooltip」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/acf-tooltip)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/acf-tooltip/)，查看[SVN仓库](https://plugins.svn.wordpress.org/acf-tooltip/)，
或通过[RSS](https://plugins.trac.wordpress.org/log/acf-tooltip/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/acf-tooltip/)。

## 更新日志

#### v1.2.5

 * Fixed PHP8 compatibilty

#### v1.2.2

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

#### v1.2.1

 * Fixed [White-space bug](https://wordpress.org/support/topic/white-space-where-instructions-would-be-2)

#### 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.

## 额外信息

 *  版本 **1.2.5**
 *  最后更新：**1 年前**
 *  活跃安装数量 **2,000+**
 *  WordPress 版本 ** 4.7 或更高版本 **
 *  已测试的最高版本为 **6.7.5**
 *  语言
 * [English (US)](https://wordpress.org/plugins/acf-tooltip/) 、 [French (France)](https://fr.wordpress.org/plugins/acf-tooltip/)、
   [German](https://de.wordpress.org/plugins/acf-tooltip/) 、 [Japanese](https://ja.wordpress.org/plugins/acf-tooltip/)
   和 [Swedish](https://sv.wordpress.org/plugins/acf-tooltip/).
 *  [翻译成简体中文](https://translate.wordpress.org/projects/wp-plugins/acf-tooltip)
 * 标签
 * [acf](https://cn.wordpress.org/plugins/tags/acf/)[acfpro](https://cn.wordpress.org/plugins/tags/acfpro/)
   [advanced custom fields](https://cn.wordpress.org/plugins/tags/advanced-custom-fields/)
   [instructions](https://cn.wordpress.org/plugins/tags/instructions/)[tooltip](https://cn.wordpress.org/plugins/tags/tooltip/)
 *  [高级视图](https://cn.wordpress.org/plugins/acf-tooltip/advanced/)

## 评级

 5 星（最高 5 星）。

 *  [  5 条 5 星评价     ](https://wordpress.org/support/plugin/acf-tooltip/reviews/?filter=5)
 *  [  0 条 4 星评价     ](https://wordpress.org/support/plugin/acf-tooltip/reviews/?filter=4)
 *  [  0 条 3 星评价     ](https://wordpress.org/support/plugin/acf-tooltip/reviews/?filter=3)
 *  [  0 条 2 星评价     ](https://wordpress.org/support/plugin/acf-tooltip/reviews/?filter=2)
 *  [  0 条 1 星评价     ](https://wordpress.org/support/plugin/acf-tooltip/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/acf-tooltip/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/acf-tooltip/reviews/)

## 贡献者

 *   [ dreihochzwo ](https://profiles.wordpress.org/tmconnect/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/acf-tooltip/)

## 捐助

您愿意支持这个插件的发展吗?

 [ 捐助此插件 ](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=XMLKD8H84HXB4&lc=US&item_name=Donation%20for%20WordPress%20Plugins&no_note=0&cn=Add%20a%20message%3a&no_shipping=1&currency_code=EUR)