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' ); } } );