wpscholar/wp-transient-admin-notices

在页面重定向或重新加载后,在 WordPress 中显示管理通知。

1.0 2017-11-02 17:47 UTC

This package is auto-updated.

Last update: 2024-08-28 23:40:25 UTC


README

处理页面重定向或重新加载后在 WordPress 中显示的管理通知。

详细信息

在创建新的 TransientAdminNotices 实例时,您需要提供瞬态名称。这用作缓存启用时的缓存键,或者在不使用缓存选项时的数据库选项名称。如果您通知是针对特定用户的,请确保将瞬态名称限定在用户范围内。

请确保在 admin_init 钩子上实例化类。这确保类可以自动设置钩子以在 admin_notices 钩子中渲染通知,并且仅在 WordPress 管理中运行。请注意,即使您没有添加新通知,也必须创建一个实例,以便显示前一次页面加载的通知。

添加到您的实例的所有通知都需要一个键、您想要显示的消息以及通知类型。键可以是您想要的任何字符串,并且可以用来稍后从队列中获取或删除该特定通知。

通知类型

这些通知类型是 WordPress 提供的类型,但可以通过 add() 方法传递以自定义通知的显示方式。

  • success - 使用绿色栏显示
  • info - 使用蓝色栏显示(默认值)
  • warning - 使用橙色栏显示
  • error - 使用红色栏显示

示例用法

<?php 

use wpscholar\WordPress\TransientAdminNotices;

add_action( 'admin_init', function() {
	
    $transient_name = md5( 'my_plugin' . get_current_user_id() );
    $notices = new TransientAdminNotices( $transient_name );
    
    if( ! $user_has_account ) {
        $notices->add( 'msg1', 'Looks like you have not created an account yet!', 'warning' );
    }
    
} );