
函式/鉤子名 | 描述 |
---|---|
rest_output_link_header (函式) | rest_output_link_header: 這是一個WordPress的函式,為REST API響應傳送一個連結頭: 該函式接收一個連結陣列併傳送相應的連結頭: 這個函式用於向客戶提供額外的連結 |
rest_is_object (函式) | rest_is_object: 這是一個WordPress的函式,用來檢查一個值是否是一個物件。如果該值是一個物件,該函式返回真,否則返回假: 這個函式是用來驗證和淨化WordPress REST A |
rest_is_ip_address (函式) | rest_is_ip_address: 這是一個WordPress的函式,用來檢查一個值是否是一個有效的IP地址。如果該值是一個有效的IP地址,該函式返回真,否則返回假: 這個函式是用來驗證和淨化Wo |
rest_is_integer (函式) | rest_is_integer: 這是一個WordPress函式,用於檢查一個值是否是整數。如果該值是一個整數,該函式返回真,否則返回假: 這個函式是用來驗證和淨化WordPress REST API |
rest_is_field_included (函式) | rest_is_field_included: 這是一個WordPress的函式,用來檢查一個欄位是否包含在REST API響應的欄位集合中: 該函式接收一個欄位名和一個欄位陣列,如果該欄位被包括,則 |
rest_is_boolean (函式) | rest_is_boolean: 這是一個WordPress的函式,用來檢查一個值是否是布林值。如果該值是布林值,該函式返回真,否則返回假: 這個函式是用來驗證和淨化WordPress REST AP |
rest_is_array (函式) | rest_is_array: 這是一個WordPress的函式,檢查一個值是否是一個陣列。如果該值是一個陣列,該函式返回真,否則返回假: 這個函式是用來驗證和淨化WordPress REST API的 |
rest_handle_options_request (函式) | rest_handle_options_request: 這是一個WordPress的函式,用於處理一個REST API端點的HTTP OPTIONS請求: 該函式在HTTP允許頭中為端點傳送允許的H |
rest_handle_multi_type_schema (函式) | rest_handle_multi_type_schema: 這個函式用來處理一個允許多種型別的模式。它接受兩個引數,第一個是允許多種型別的模式,第二個是代表正在驗證的資料型別的字串。如果根據模式不允 |
rest_handle_doing_it_wrong (函式) | rest_handle_doing_it_wrong: 這個函式用於處理由”做錯了”的開發者產生的錯誤。它接受三個引數,第一個是被錯誤呼叫的函式或方法名稱,第二個是解釋錯誤的訊息,第三個是錯誤用法被棄 |
rest_handle_deprecated_function (函式) | rest_handle_deprecated_function: 這個函式用於處理REST API端點中呼叫的棄用函式。它接受兩個引數,第一個是函式名稱,第二個是該函式被棄用的版本。它產生一個警告資訊 |
rest_handle_deprecated_argument (函式) | rest_handle_deprecated_argument: 該函式用於處理傳遞給REST API端點的過時的引數。它接受兩個引數,第一個是引數名稱,第二個是該引數被棄用的版本。它生成一條警告資訊 |
rest_get_url_prefix (函式) | rest_get_url_prefix: 這個函式用來檢索用於REST API請求的URL字首。它返回一個代表URL字首的字串。 |
rest_get_server (函式) | rest_get_server: 這個函式用於檢索當前的REST伺服器例項。它返回WP_REST_Server的一個例項,它是負責處理REST API請求的類。 |
rest_get_route_for_term (函式) | rest_get_route_for_term: 這個函式用於檢索分類法中某個特定術語的REST API路由。它接受兩個引數,術語ID和分類法名稱,並返回一個代表指定術語的REST API路由的字串。 |
rest_get_route_for_taxonomy_items (函式) | rest_get_route_for_taxonomy_items: 這個函式用於檢索特定分類法的所有術語的REST API路由。它接受一個引數,即分類法名稱,並返回一個字串,代表指定分類法的所有術語 |
rest_get_route_for_post_type_items (函式) | rest_get_route_for_post_type_items: 這個函式用來檢索一個特定文章型別的所有文章的REST API路由。它接受一個引數,即文章型別名稱,並返回一個字串,代表指定文章型 |
rest_get_route_for_post (函式) | rest_get_route_for_post: 這個函式是用來檢索特定文章的REST API路由的。它接受一個引數,即文章的ID,並返回一個代表指定文章的REST API路由的字串。 |
rest_get_queried_resource_route (函式) | rest_get_queried_resource_route: 該函式用於檢索當前被查詢資源的REST API路由。它返回一個字串,代表當前正在查詢的資源的REST API路由。 |
rest_get_endpoint_args_for_schema (函式) | rest_get_endpoint_args_for_schema: 這個函式用於檢索特定模式的端點引數。它接受兩個引數,第一個是需要端點引數的模式,第二個是一個布林值,表示是否在響應中包括模式描述。 |
rest_get_date_with_gmt (函式) | rest_get_date_with_gmt:該函式用於檢索GMT時區的日期字串。它接受一個單一的引數,一個日期字串,並返回在GMT時區的同一日期。它在REST API中用於格式化日期字串。 |
rest_get_combining_operation_error (函式) | rest_get_combining_operation_error: 這個函式用於為使用”allOf”或”anyOf”等組合操作的JSON模式生成一個錯誤響應。它用於確保JSON模式驗證工作正常,並 |
rest_get_best_type_for_value (函式) | rest_get_best_type_for_value: 這個函式用來獲取給定值的最佳資料型別。它接收一個值並返回該值的最佳資料型別。 |
rest_get_avatar_urls (函式) | rest_get_avatar_urls: 這個函式用來獲取一個給定使用者的頭像URLs。它接收一個使用者ID或物件,以及一個頭像尺寸名稱陣列,並返回一個指定尺寸的頭像URL陣列。 |
rest_get_avatar_sizes (函式) | rest_get_avatar_sizes: 這個函式用來獲取在WordPress註冊的頭像尺寸。它返回一個頭像尺寸名稱和它們相應尺寸的陣列。 |
rest_get_authenticated_app_password (函式) | rest_get_authenticated_app_password: 這個函式用來獲取REST API請求的認證應用密碼。它接收當前的請求物件並返回認證的應用程式密碼。 |
rest_get_allowed_schema_keywords (函式) | rest_get_allowed_schema_keywords: 這個函式用來獲取一個模式的允許的關鍵字。它接收一個模式物件並返回一個允許的關鍵字陣列。 |
rest_format_combining_operation_error (函式) | rest_format_combining_operation_error: 這個函式用於格式化包含組合操作(如allOf、anyOf或oneOf)的模式的錯誤資訊,該操作未能驗證。它接收一個錯誤資訊 |
rest_find_one_matching_schema (函式) | rest_find_one_matching_schema: 這個函式用於查詢與給定資料相匹配的模式。它接收一個資料物件和一個模式物件的陣列,並返回與資料相匹配的第一個模式物件。 |
rest_find_matching_pattern_property_schema (函式) | rest_find_matching_pattern_property_schema: 該函式用於查詢與模式屬性相匹配的模式。它接收一個資料物件、屬性名稱和一個模式物件的陣列,並返回與模式屬性相匹配的 |
rest_find_any_matching_schema (函式) | rest_find_any_matching_schema: 這個函式用於查詢與給定資料相匹配的模式。它接收一個資料物件和一個模式物件的陣列,並返回與資料相匹配的第一個模式物件。 |
rest_filter_response_fields (函式) | rest_filter_response_fields: 這個函式用於根據請求的欄位過濾響應資料。它接收一個資料物件、一個要包括的欄位陣列和一個要排除的欄位陣列,並返回過濾後的資料。 |
rest_filter_response_by_context (函式) | rest_filter_response_by_context: 這個函式是用來根據請求的上下文過濾響應資料的。上下文可以是”檢視”、”嵌入”或”編輯”。它接收一個資料物件和當前上下文,並返回過濾後的 |
rest_ensure_response (函式) | rest_ensure_response: 這個函式用來確保REST API返回的資料是正確的格式。它接收一個資料物件,並返回一個包含資料的WP_REST_Response物件,以及相應的頭資訊和狀態 |
rest_ensure_request (函式) | rest_ensure_request: 這個函式確保一個變數是一個WP_REST_Request物件。如果該變數不是WP_REST_Request物件,它將被轉換為WP_REST_Request物件 |
rest_do_request (函式) | rest_do_request: 這個函式使用WP HTTP API執行一個HTTP請求。在REST API中,它被用來向外部API發出請求。 |
rest_default_additional_properties_to_false (函式) | rest_default_additional_properties_to_false:這個過濾器鉤子允許開發者在檢查cookie的有效性時修改返回的狀態。這個過濾鉤子允許開發者在定義JSON模式時設 |
rest_cookie_collect_status (函式) | rest_cookie_collect_status。這個過濾鉤子允許開發者修改在檢查cookie的有效性時返回的狀態。 |
rest_cookie_check_errors (函式) | rest_cookie_check_errors: 這個過濾器鉤子允許開發者修改在檢查cookie的有效性時返回的錯誤。 |
rest_convert_error_to_response (函式) | rest_convert_error_to_response: 這是一個將WP_Error物件轉換為REST API響應的實用函式。它是用來規範REST API中的錯誤響應。 |
要使用` 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;