自定义插件的 Woocommerce 管理工具提示

Question

我构建了我的 Woocommerce 插件，我需要使用工具提示在我的输入旁边放置一些内容。 我从Woocommerce Docs中找到了这个函数： wc_help_tip()但我不明白，也不起作用。

这是我的代码：

<?php 
    $tip = "test";
    echo wc_help_tip($tip, false);
?>

当我用 F12 调试时，我看到了一个 span 内容：

<span class="woocommerce-help-tip" data-tip="test"></span> 

但是前端什么都没有出现。

对此有什么想法吗？ 或者其他的东西来放置 WordPress 的原生工具提示？

编辑：我需要在自定义管理后端页面挂钩中使用它，而不是在前端也不是 woocommerce 管理后端页面

Answer 1

您应该将您的屏幕 ID 添加到 woocommerce。 使用 woocommerce_screen_ids 过滤器

例子：

add_filter('woocommerce_screen_ids', [ $this, 'set_wc_screen_ids' ] );

public function set_wc_screen_ids( $screen ){
      $screen[] = 'your_screen_id';
      return $screen;
}

Answer 2

确保您已为此排队 TipTip JS，这是可能对您有所帮助的代码，复制下面的代码并粘贴所有 javascript 文件排队的位置

<?php
wp_register_script( 'woocommerce_admin', WC()->plugin_url() . '/assets/js/admin/woocommerce_admin.js', array( 'jquery', 'jquery-blockui', 'jquery-ui-sortable', 'jquery-ui-widget', 'jquery-ui-core', 'jquery-tiptip' ), WC_VERSION );
$locale = localeconv();
$decimal = isset( $locale['decimal_point'] ) ? $locale['decimal_point'] : '.';

$params = array(
/* translators: %s: decimal */
'i18n_decimal_error' => sprintf( __( 'Please enter in decimal (%s) format without thousand separators.', 'woocommerce' ), $decimal ),
/* translators: %s: price decimal separator */
'i18n_mon_decimal_error' => sprintf( __( 'Please enter in monetary decimal (%s) format without thousand separators and currency symbols.', 'woocommerce' ), wc_get_price_decimal_separator() ),
'i18n_country_iso_error' => __( 'Please enter in country code with two capital letters.', 'woocommerce' ),
'i18_sale_less_than_regular_error' => __( 'Please enter in a value less than the regular price.', 'woocommerce' ),
'decimal_point' => $decimal,
'mon_decimal_point' => wc_get_price_decimal_separator(),
'strings' => array(
'import_products' => __( 'Import', 'woocommerce' ),
'export_products' => __( 'Export', 'woocommerce' ),
),
'urls' => array(
'import_products' => esc_url_raw( admin_url( 'edit.php?post_type=product&page=product_importer' ) ),
'export_products' => esc_url_raw( admin_url( 'edit.php?post_type=product&page=product_exporter' ) ),
),
);

wp_localize_script( 'woocommerce_admin', 'woocommerce_admin', $params );
wp_enqueue_script( 'woocommerce_admin' );

Answer 3

您无需为此加载整个 WooCommerce 管理脚本。 事实上，这是 WooCommerce 使用的 jQuery 插件的一部分，而不是 WooCommerce 代码本身的一部分。

因此，首先，您需要确保jquery-tiptip已加载到您的页面上：

wp_enqueue_script( 'jquery-tiptip' );

然后，使用 JS 在woocommerce-help-tip元素上初始化tipTip()函数：

jQuery( function( $ ) {
    $('.woocommerce-help-tip').tipTip({
        'attribute': 'data-tip',
        'fadeIn':    50,
        'fadeOut':   50,
        'delay':     200
    });
});

确保在加载此脚本时，将jquery-tiptip作为依赖项包含（ wp_enqueue_script()的第三个参数）

wp_enqueue_script(
    'your-script',
    plugin_dir_url( __FILE__ ) . '/js/example.js',
    array( 'jquery', 'jquery-tiptip' ),
    '1.0.0'
);

Answer 4

此功能是为后端...

下面有一个示例，它将在订单编辑页面中输出工具提示：

// Displayed in Order edit pages below order details on top first column
add_action( 'woocommerce_admin_order_data_after_order_details', 'displaying_tooltip_in_order_edit_pages', 10, 1 );
function displaying_tooltip_in_order_edit_pages( $order ){
    ?>
        <p class="form-field form-field-wide wc-customer-custom">Some text with a tooltip <?php echo wc_help_tip("hello world"); ?></p>
    <?php
}

代码位于活动子主题（或活动主题）的 function.php 文件中。

测试和工作。

因此，如果您添加一些代码以通过钩子在 woocommerce 管理页面中显示一些自定义字段或内容，您可以使用wc_help_tip()函数添加这些工具提示