
函式/鉤子名 | 描述 |
---|---|
retrieve_password (動作鉤子) | retrieve_password: 這個函式通過向使用者的電子郵件地址傳送一封密碼重置郵件來檢索使用者的密碼。密碼重置郵件包含一個連結,使用者可以點選這個連結來重置他們的密碼。 |
registration_errors (過濾鉤子) | registration_errors。這個過濾鉤子用來修改使用者試圖在WordPress網站上註冊時顯示的錯誤資訊。通過使用這個鉤子,你可以新增自定義的錯誤資訊或改變現有錯誤的資訊。 |
register_post (動作鉤子) | register_post: 這個動作鉤子是用來在WordPress中註冊一個文章型別。這個鉤子可以用來新增自定義的文章型別或修改現有文章型別的引數。 |
register_new_user (動作鉤子) | register_new_user: 這個動作鉤子在一個新使用者被註冊後被觸發。這個鉤子可以用來執行額外的動作,例如在新使用者建立後傳送歡迎郵件或更新其他資料。 |
profile_update (動作鉤子) | profile_update – 這是一個WordPress的動作鉤子,當使用者更新他們的個人資料資訊時被觸發。這個鉤子是在使用者的資料資料被儲存到資料庫後觸發的。開發人員可以使用這個鉤子在使用者的資 |
pre_user_url (過濾鉤子) | pre_user_url 是一個過濾鉤子,用於在資料庫中更新使用者的網站URL之前過濾它。這個過濾器可以用來修改使用者的網站URL,或者通過返回一個空字串或一個不同的值來阻止更新。 |
pre_user_nickname (過濾鉤子) | pre_user_nickname是一個過濾器鉤子,用於在資料庫中更新使用者的暱稱之前過濾它。這個過濾器可以用來修改使用者的暱稱,或者通過返回一個空字串或一個不同的值來阻止更新。 |
pre_user_nicename (過濾鉤子) | pre_user_nicename 是一個過濾器鉤子,在使用者nicename的值被更新之前執行。它允許開發人員在儲存到資料庫之前修改該值。使用者nicename的值被作為引數傳給過濾函式,修改後的值 |
pre_user_last_name (過濾鉤子) | pre_user_last_name 是一個過濾器鉤子,在使用者姓氏的值被更新之前執行。它允許開發人員在該值被儲存到資料庫之前修改它。使用者姓氏的值被作為引數傳給過濾器函式,修改後的值應該被返回。 |
pre_user_first_name (過濾鉤子) | pre_user_first_name 是一個過濾器鉤子,在使用者名稱字的值被更新之前執行。它允許開發人員在將值儲存到資料庫之前修改它。使用者名稱字的值被作為引數傳給過濾器函式,修改後的值應該被返回。 |
pre_user_{$field} (過濾鉤子) | pre_user_{$field}是一個通用的過濾器鉤子,在任何使用者欄位的值被更新之前執行。它允許開發者在儲存到資料庫之前修改該值。使用者欄位的值被作為引數傳給過濾器函式,修改後的值應該被返回。 |
pre_user_email (過濾鉤子) | pre_user_email 是一個過濾器鉤子,在使用者電子郵件的值被更新之前執行。它允許開發者在儲存到資料庫之前修改該值。使用者電子郵件的值被作為引數傳遞給過濾器函式,修改後的值應該被返回。 |
pre_user_display_name (過濾鉤子) | pre_user_display_name 是一個過濾器鉤子,在使用者顯示名稱的值被更新之前執行。它允許開發者在數值被儲存到資料庫之前修改它。使用者顯示名稱的值被作為引數傳給過濾器函式,修改後的值應該 |
pre_user_description (過濾鉤子) | pre_user_description 是一個過濾器鉤子,在使用者描述的值被更新之前執行。它允許開發人員在將該值儲存到資料庫之前修改它。使用者描述的值被作為引數傳遞給過濾函式,修改後的值應該被返回。 |
pre_get_blogs_of_user (過濾鉤子) | pre_get_blogs_of_user 是一個過濾鉤子,允許你在WordPress檢索之前修改特定使用者的部落格列表。 |
pre_{$field} (過濾鉤子) | pre_{$field}是一個過濾鉤子,它允許你在WordPress檢索和使用某個特定欄位之前修改其值。鉤子名稱中的$field部分是指你想修改的欄位的名稱。例如,pre_post_title將允許你 |
pre_count_users (過濾鉤子) | pre_count_users: 這是一個過濾鉤子,允許修改傳遞給count_users函式的引數。該鉤子在count_users函式被呼叫之前被觸發,並將引數作為一個引數傳遞。這個鉤子可以用來修改傳 |
password_reset_key_expired (過濾鉤子) | password_reset_key_expired – 這個函式用來檢查密碼重置連結是否已經過期。它接收一個使用者ID和一個密碼重置金鑰,如果連結已經過期,則返回true,如果仍然有效,則返回fal |
password_reset_expiration (過濾鉤子) | password_reset_expiration – 這個函式返回密碼重置連結過期的秒數。預設值是12小時(43,200秒)。 |
password_reset (動作鉤子) | password_reset – 這個函式用於處理WordPress的密碼重置請求。它接收使用者的登入名或電子郵件地址,如果找到一個匹配的使用者,一個密碼重置連結將被髮送到他們的電子郵件地址。 |
password_hint (過濾鉤子) | password_hint – 這個函式返回WordPress中預設的密碼提示資訊。如果使用者忘記了他們的密碼並點選了”丟失密碼?”的連結,密碼提示就會顯示在登入表格上。 |
password_change_email (過濾鉤子) | password_change_email – 這個函式用來在使用者的密碼被改變時向他們傳送一封電子郵件。該郵件包含有關更改的資訊和任何相關的安全措施。 |
new_user_email_content (過濾鉤子) | new_user_email_content。這個過濾鉤子用於修改傳送給新建立使用者的電子郵件的內容。 |
lostpassword_user_data (過濾鉤子) | lostpassword_user_data是一個過濾鉤,允許開發者修改用於重置密碼的使用者資料。這可以用來改變用於啟動密碼重置過程的電子郵件地址、使用者名稱或其他使用者資料。 |
lostpassword_post (動作鉤子) | lostpassword_post是一個動作鉤子,在密碼重置表單提交後,但在重置過程開始前執行。這個鉤子可以用來對提交的表單資料進行自定義驗證,或者在密碼重置過程開始前採取額外的行動。 |
lostpassword_errors (過濾鉤子) | lostpassword_errors是一個動作鉤子,允許開發人員在使用者提交無效資訊時向密碼重置表單新增額外的錯誤資訊。這個鉤子在密碼重置過程中執行,允許在表單中新增自定義驗證。 |
insert_user_meta (過濾鉤子) | insert_user_meta。這個鉤子允許你在WordPress資料庫中插入使用者後設資料。你可以使用這個鉤子來儲存使用者後設資料,如使用者偏好或自定義使用者欄位。 |
insert_custom_user_meta (過濾鉤子) | insert_custom_user_meta。這個鉤子允許你在WordPress資料庫中插入自定義的使用者後設資料。你可以使用這個鉤子來儲存自定義的使用者後設資料,如使用者偏好或自定義使用者欄位。 |
get_user_option_{$option} (過濾鉤子) | get_user_option_{$option}: 該函式為特定使用者檢索指定選項的值。使用者由使用者ID指定,$option引數指定要檢索的選項名稱。 |
get_usernumposts (過濾鉤子) | get_usernumposts: 這個函式檢索一個特定使用者所寫的文章的數量。該使用者是由使用者ID指定的。 |
get_blogs_of_user (過濾鉤子) | get_blogs_of_user: 這個函式檢索多站點設定中的使用者的部落格: 該函式將使用者ID作為引數,並返回該使用者的部落格物件陣列。 |
{$field} (過濾鉤子) | {$field} – 這是一個WordPress資料庫中特定欄位的佔位符。它可以在各種函式和查詢中使用,從資料庫中獲取資料。 |
enable_live_network_counts (過濾鉤子) | enable_live_network_counts – 這是WordPress的一個過濾鉤子,用於啟用或禁用實時網路計數。這指的是實時更新網路站點上的文章和評論計數,由於效能原因,可以禁用它。 |
email_exists (過濾鉤子) | email_exists: 這個函式檢查一個給定的電子郵件地址是否存在於註冊使用者的資料庫中。如果電子郵件存在,該函式返回使用者ID,如果不存在,則返回false。 |
email_change_email (過濾鉤子) | email_change_email: 當使用者在WordPress管理中改變他們的電子郵件地址時,這個動作鉤子被觸發。該鉤子將新的電子郵件地址和使用者ID作為引數,允許你在處理電子郵件變更後執行操作 |
edit_user_{$field} (過濾鉤子) | edit_user_{$field}:這是一組WordPress的過濾鉤子,允許開發者修改特定欄位的使用者資料資料。引數{$field}指的是被編輯的使用者資料欄位的名稱(例如,edit_user_f |
edit_{$field} (過濾鉤子) | edit_{$field}: 這是一個過濾鉤子,允許開發者修改編輯器中某個特定欄位的值。{$field}佔位符會被替換成被編輯的欄位的名稱。 |
determine_current_user (過濾鉤子) | determine_current_user: 這個過濾器是用來確定WordPress中的當前使用者。它通常用於修改使用者資訊或新增自定義使用者角色。 |
clean_user_cache (動作鉤子) | clean_user_cache – 這是WordPress中的一個函式,用於清理特定使用者或所有使用者的快取: 該函式用於確保最新的使用者資料總是可用的。 |
check_is_user_spammed (過濾鉤子) | check_is_user_spammed – 這是WordPress中的一個函式,用於檢查一個使用者是否被標記為垃圾郵件傳送者。如果該使用者被標記為垃圾郵件傳送者,該函式返回真。 |
要使用` 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;