函数/钩子名 | 描述 |
---|---|
uninstall_{$file} (动作钩子) | “uninstall_{$file}”是 WordPress 中的一个过滤器钩子,它允许您在卸载插件时运行自定义代码。 “$file”的值是插件的主文件,例如“my-plugin/my-plugin. |
pre_uninstall_plugin (动作钩子) | pre_uninstall_plugin: 这个动作在卸载一个插件之前被触发。它允许在卸载插件之前采取一些行动,例如清理插件的特定数据。 |
plugin_files_exclusions (过滤钩子) | plugin_files_exclusions 是一个过滤器钩子,它允许开发者从插件更新过程中排除特定的文件。这个钩子可以用来排除不应该被更新的文件,如自定义或修改的文件。 |
delete_plugin (动作钩子) | delete_plugin: 这个函数用于从WordPress网站上删除一个插件。它通常用于删除一个不再需要或在网站上造成问题的插件。 |
deleted_plugin (动作钩子) | deleted_plugin: 当一个插件从WordPress网站上被删除时,这个动作会被触发: 当一个插件被删除时,它通常被用来执行额外的操作。 |
deactivate_{$plugin} (动作钩子) | deactivate_{$plugin}: 当一个特定的插件被停用时,这个动作钩子被触发。$plugin变量是被停用的插件的基本名称。它允许开发者在该插件被停用时执行特定的动作。 |
deactivate_plugin (动作钩子) | deactivate_plugin: 当一个插件被停用时,这个动作钩被触发。它允许开发者在插件停用时进行操作,如清理数据或禁用功能。 |
deactivated_plugin (动作钩子) | deactivated_plugin: 当一个插件被停用时,这个动作钩子会被触发。它允许开发者在一个插件停用时执行动作,如清理数据或禁用功能。 |
activate_{$plugin} (动作钩子) | activate_{$plugin}是一个动作钩子,当一个特定的插件被激活时被触发。{$plugin}的占位符会被替换成插件的名称,例如,如果插件被命名为”example-plugin”,那么这个钩子 |
activate_plugin (动作钩子) | activate_plugin 是一个动作钩子,当一个插件被激活时被触发。这个钩子可以被插件用来在激活后执行任何必要的动作,如创建数据库表或初始化设置。 |
activated_plugin (动作钩子) | activated_plugin是一个动作钩子,当一个插件从WordPress的插件管理界面被激活时被触发。 |
wp_get_plugin_error (函数) | wp_get_plugin_error: 这个函数返回一个加载失败的插件的错误信息。它接受一个插件文件名作为参数。 |
wp_clean_plugins_cache (函数) | wp_clean_plugins_cache: 这是一个清除已安装插件的缓存的函数。它可以用来确保对插件所做的任何改动都能立即反映在网站上。 |
wp_add_privacy_policy_content (函数) | wp_add_privacy_policy_content: 这个函数用于在WordPress网站上添加隐私政策内容: 该函数需要一个参数:$content。$content是应该被添加到隐私政策页面 |
validate_plugin_requirements (函数) | validate_plugin_requirements。这个WordPress函数用于在安装一个插件之前验证它的要求。它检查该插件的最小WordPress版本、PHP版本和其他要求是否满足,如果发现 |
validate_plugin (函数) | validate_plugin。这个WordPress函数用于在安装一个插件之前对其进行验证。它检查插件文件是否存在,是否可读,是否包含有效的插件头,如果发现任何错误,则返回一个错误信息。 |
validate_active_plugins (函数) | validate_active_plugins: 这个WordPress函数是用来验证一组给定的插件是否是活动的。它返回一个活跃的插件文件名的数组,可以用来确保所需的插件在继续使用前已经安装并活跃。 |
user_can_access_admin_page (函数) | user_can_access_admin_page: 这个钩子用来检查一个用户是否可以访问WordPress的管理页面。 |
uninstall_plugin (函数) | uninstall_plugin: 当一个插件被卸载时,这个动作被触发。它可以用来执行任何清理任务或删除任何额外的数据库表或与该插件相关的选项。 |
settings_fields (函数) | settings_fields: 这是一个WordPress的函数,显示一个给定的设置页面的设置字段。它通常用于输出设置字段的HTML,如文本输入字段或复选框: 这个函数需要一个参数,就是设置页面的名 |
resume_plugin (函数) | resume_plugin: 这是一个WordPress动作,当一个插件被停用后恢复时被触发: 当一个插件被停用时,它的功能不会被执行: 当该插件被重新激活时,resume_plugin被调用,允许该 |
remove_submenu_page (函数) | remove_submenu_page: 这个函数用于从WordPress管理菜单中删除一个子菜单页面。子菜单页是用来向WordPress管理菜单添加额外的页面: 这个函数需要两个参数,第一个是父菜单 |
remove_menu_page (函数) | remove_menu_page: 这个函数用来从WordPress管理菜单中删除一个菜单页: 这个函数有一个参数,就是要删除的菜单页的标题。 |
remove_allowed_options (函数) | remove_allowed_options: 这个函数用于从允许的选项列表中删除一个或多个选项。这个列表是用来确定哪些选项可以使用update_option函数来更新。 |
plugin_sandbox_scrape (函数) | plugin_sandbox_scrape: 该函数用于对插件沙盒的HTML内容进行净化和验证。它需要一个参数:$content,这是需要净化和验证的HTML内容: 该函数返回经过净化和验证的内容。 |
paused_plugins_notice (函数) | paused_plugins_notice: 这个函数生成一个通知,告知用户一些插件已经暂停。它不需要任何参数。 |
option_update_filter (函数) | option_update_filter: 当WordPress数据库中的一个选项被更新时,这个过滤器钩被触发。它允许开发者在保存选项数据之前对其进行修改或验证。 |
menu_page_url (函数) | menu_page_url – 这个WordPress函数被用来获取一个特定的管理菜单页面的URL。它对创建链接或重定向到WordPress管理界面中的特定页面很有用。 |
is_uninstallable_plugin (函数) | is_uninstallable_plugin是一个WordPress函数,用于检查给定的插件是否可以卸载。它接受一个参数,即主插件文件的路径,如果该插件是可卸载的,则返回一个布尔值true,否则返回 |
is_plugin_paused (函数) | is_plugin_paused: 这个函数检查一个特定的插件是否被暂停。它把插件的名称作为参数,如果该插件被暂停,则返回真,如果不是,则返回假。 |
is_plugin_inactive (函数) | is_plugin_ctive: 这个函数检查一个特定的插件是否是不活动的。它以插件名称为参数,如果该插件是不活动的,则返回真,如果是活动的则返回假。 |
is_plugin_active_for_network (函数) | is_plugin_active_for_network: 这个函数检查一个特定的插件是否在整个WordPress多站点网络中处于活动状态。它把插件的名字作为一个参数,如果该插件是活动的,则返回tru |
is_plugin_active (函数) | is_plugin_active: 这个函数检查一个特定的插件是否处于活动状态。它将插件名称作为参数,如果该插件处于活动状态,则返回 true,如果不是则返回 false。 |
is_network_only_plugin (函数) | is_network_only_plugin: 这个函数检查一个插件是否只在网络上活动,而不是在WordPress多站点网络中的单个站点上。 |
get_plugins (函数) | get_plugins函数用于检索所有已安装插件的数组。它返回一个数组,其中包含每个插件的信息,例如插件名称、版本号和插件文件路径。 |
get_plugin_page_hookname (函数) | get_plugin_page_hookname函数用于检索插件管理页面的挂钩名称。它需要三个参数,第一个是插件文件,第二个是页面标识符,第三个是访问页面所需的功能。 |
get_plugin_page_hook (函数) | get_plugin_page_hook函数用于检索插件管理页面的挂钩名称。它有两个参数,第一个是插件文件,第二个是页面标识符。页面标识符是表示页面的唯一标识符的字符串。 |
get_plugin_files (函数) | get_plugin_files函数用于检索给定目录中的插件文件数组。它接受一个参数,即要在其中搜索的目录,并返回一个插件文件数组。 |
get_plugin_data (函数) | get_plugin_data函数是一个WordPress函数,用于检索一个插件的元数据: 这个函数接受一个参数,即你想检索元数据的插件文件的路径: 该函数返回一个指定插件的元数据数组,包括名称、版本 |
get_mu_plugins (函数) | get_mu_plugins函数用于检索WordPress安装中的活动必须使用(mu)插件数组: 此函数可用于检索有关当前正在使用的MU插件的信息。 |
要使用` get_users
`函数获取所有用户列表,可以按照以下步骤进行:
1. 使用` get_users
`函数调用获取用户列表:
$users = get_users();
2. 您可以按需使用参数来过滤结果。例如,您可以通过角色、用户ID、用户登录名等过滤用户列表。以下是一个根据用户角色为过滤条件的示例:
$users = get_users( array( 'role' => 'subscriber' // 将角色名称替换为您要过滤的角色 ) );
在上述示例中,将` role
`参数设置为所需的角色名称来过滤用户列表。
3. 您可以使用循环遍历获取的用户列表,并访问每个用户的属性。例如,以下示例将显示每个用户的用户名和电子邮件地址:
foreach( $users as $user ) { echo '用户名:' . $user->user_login . ', 电子邮件:' . $user->user_email . ; }
在上述示例中,通过` $user->user_login
`和` $user->user_email
`访问每个用户的用户名和电子邮件地址。
请注意,` get_users
`函数默认返回所有用户,并可以根据需要使用更多参数进行过滤。您可以参阅WordPress官方文档中的` get_users
`函数文档,了解更多可用参数和用法示例。
总结起来,使用` get_users
`函数获取所有用户列表的步骤是:
get_users
`函数获取用户列表。在WordPress中,可以使用WP_PLUGIN_DIR和WP_PLUGIN_URL常量来定义插件的目录路径和URL。
1. `WP_PLUGIN_DIR`:这是一个常量,用于定义插件的目录路径(文件系统路径)。您可以使用以下代码在插件文件中访问该常量:
$plugin_dir = WP_PLUGIN_DIR . '/your-plugin-folder/';
在上述代码中,将"your-plugin-folder"替换为您插件的实际文件夹名称。使用该常量,您可以获取插件文件的完整路径。
2. `WP_PLUGIN_URL`:这是一个常量,用于定义插件的URL(用于在网页上访问插件文件)。以下是一个使用该常量的示例:
$plugin_url = WP_PLUGIN_URL . '/your-plugin-folder/';
同样,请将"your-plugin-folder"替换为您插件的实际文件夹名称。使用该常量,您可以获取插件在网页上的完整URL。
请注意,`WP_PLUGIN_DIR`和`WP_PLUGIN_URL`常量在WordPress版本2.6之后引入。从WordPress 5.5版本开始,这两个常量被标记为过时(deprecated),因为WordPress更倾向于使用新的插件文件结构。如果您正在开发新插件,建议使用新的插件文件结构和相关函数。
在新的插件文件结构中,可以使用以下函数来获取插件的目录路径和URL:
- `plugin_dir_path()`:获取插件目录路径。
- `plugin_dir_url()`:获取插件URL。
这些函数会自动将插件的版本、多站点和SSL等考虑因素纳入计算。
总结起来,使用`WP_PLUGIN_DIR`和`WP_PLUGIN_URL`常量定义插件的目录和URL的方法是:
$plugin_dir = WP_PLUGIN_DIR . '/your-plugin-folder/'; $plugin_url = WP_PLUGIN_URL . '/your-plugin-folder/';
但请注意,这两个常量已被标记为过时,建议使用新的插件文件结构和相关函数来获取插件的路径和URL。
使用PHP在WordPress中添加自定义功能可以通过以下方式实现:
下面是一个实操示例。
要在WordPress中添加自定义功能,可以按照以下步骤使用PHP编写并添加自定义功能:
// 添加自定义功能示例 // 1. 创建自定义短代码 function custom_shortcode() { return '这是我的自定义短代码内容'; } add_shortcode('custom', 'custom_shortcode'); // 2. 自定义小工具 function custom_widget() { echo '这是我的自定义小工具内容'; } register_widget('custom_widget'); // 3. 自定义菜单 function custom_menu() { register_nav_menu('custom-menu', '自定义菜单'); } add_action('after_setup_theme', 'custom_menu'); // 4. 自定义页面模板 function custom_page_template() { /* Template Name: 自定义模板 */ // 自定义模板的内容和样式 }
请注意,修改主题文件可以在主题更新时丢失,因此建议在进行任何更改之前备份functions.php文件。此外,为避免不必要的错误和冲突,建议在添加自定义功能前先了解WordPress开发文档和最佳实践,以确保正确、安全地实现所需的自定义功能。
使用 do_action
函数可以触发一个钩子函数。do_action
函数的参数与要触发的钩子函数的参数相同。
例如,触发save_post钩子函数的代码如下:
do_action( 'save_post', $post_ID, $post );
这里,$post_ID
和 $post
是传递给钩子函数的参数。
使用 wp_get_current_user
获取当前登录用户的信息:
$current_user = wp_get_current_user(); // 获取当前用户的ID $user_id = $current_user->ID; // 获取当前用户的用户名 $user_login = $current_user->user_login; // 获取当前用户的邮箱 $user_email = $current_user->user_email; // 获取当前用户的显示名称 $display_name = $current_user->display_name;