
函式/鉤子名 | 描述 |
---|---|
get_theme_starter_content (函式) | get_theme_starter_content: 這個函式返回一個主題的啟動內容的陣列。這個啟動內容可以用來為一個新的網站填充樣本內容。 |
get_theme_roots (函式) | get_theme_roots: 這個函式返回一個已安裝的主題目錄陣列。這在處理子主題時很有用,因為它允許你確定父主題目錄。 |
get_theme_root_uri (函式) | get_theme_root_uri:該函式返回包含所有已安裝主題的目錄的URI。這個URI用於載入主題檔案,如style.css和JavaScript檔案。 |
get_theme_root (函式) | get_theme_root:該函式返回包含所有已安裝主題的目錄的伺服器檔案路徑。 |
get_theme_mods (函式) | get_theme_mods: 這個函式用來檢索一個所有主題修改設定的陣列。它返回一個修改設定陣列,其中鍵是修改設定名稱,值是修改設定值。 |
get_theme_mod (函式) | get_theme_mod: 這個函式用來檢索一個主題修改設定值。它接受兩個引數:修改設定的名稱和一個預設值(如果修改設定不存在)。 |
get_template_directory_uri (函式) | get_template_directory_uri: 這個函式檢索到當前主題目錄的URL。它不接受任何引數,以字串形式返回主題目錄的URL。 |
get_template_directory (函式) | get_template_directory: 這個函式檢索到當前主題目錄的路徑。它不接受任何引數,以字串形式返回主題目錄的路徑。 |
get_template (函式) | get_template: 這個函式檢索頁面的主要模板檔案的路徑。它不接受任何引數,以字串形式返回模板檔案的路徑。 |
get_stylesheet_uri (函式) | get_stylesheet_uri: 這個函式可以檢索到當前主題的樣式表檔案的URL。它不接受任何引數,並以字串的形式返回URL。 |
get_stylesheet_directory_uri (函式) | get_stylesheet_directory_uri: 這個函式可以檢索到當前主題的樣式表目錄的URL。它不接受任何引數,並以字串的形式返回URL。 |
get_stylesheet_directory (函式) | get_stylesheet_directory: 這個函式檢索到當前主題的樣式表目錄的路徑。它不接受任何引數,並以字串的形式返回路徑。 |
get_stylesheet (函式) | get_stylesheet: 這個函式檢索網站當前使用的樣式表的名稱。它不需要任何引數,並以字串的形式返回樣式表的名稱。 |
get_registered_theme_features (函式) | get_registered_theme_features函式是一個WordPress函式,用於檢索已註冊的主題特徵陣列: 這個函式返回一個主題特徵的陣列,鍵為特徵名稱,值為特徵資訊的陣列。 |
get_registered_theme_feature (函式) | get_registered_theme_feature函式是一個WordPress函式,用於檢索一個特定的註冊主題功能: 這個函式以特徵名稱為引數,並返回一個特徵資訊的陣列。 |
get_raw_theme_root (函式) | get_raw_theme_root函式是WordPress的一個函式,用於檢索原始主題根目錄的路徑: 這個函式需要一個可選的引數,即主題的樣式表或模板,它返回到原始主題根目錄的路徑,但沒有尾部斜線。 |
get_random_header_image (函式) | get_random_header_image函式是一個WordPress函式,它為一個特定的頭像主題檢索一個隨機的頭像: 這個函式接收一個頭像主題的可選引數,並返回一個隨機頭像。 |
get_locale_stylesheet_uri (函式) | get_locale_stylesheet_uri函式用來檢索與當前locale對應的樣式表的URL: 這個函式可以用來根據網站的語言和格式設定來載入不同的樣式表。 |
get_header_video_url (函式) | get_header_video_url: 這個函式用來檢索當前WordPress網站的標題視訊的URL。這個URL可以指向網站上或外部平臺上託管的視訊檔案。 |
get_header_video_settings (函式) | get_header_video_settings: 這個函式用來檢索當前WordPress網站的標題視訊的視訊設定。這可以包括關於視訊格式、尺寸和播放控制的資訊。 |
get_header_textcolor (函式) | get_header_textcolor: 這個函式用來檢索當前WordPress網站的頭像的文字顏色。這可以用來確保文字在標題影象的背景下是可讀的。 |
get_header_image_tag (函式) | get_header_image_tag: 這個函式用來檢索當前WordPress網站的頭像的HTML標籤。這個標籤可以被定製,以包括任何需要的額外屬性或樣式。 |
get_header_image (函式) | get_header_image: 這個函式用來檢索當前WordPress網站的頭像URL。頭部影象通常顯示在網站的主頁上。 |
get_editor_stylesheets (函式) | get_editor_stylesheets: 這個函式用來檢索當前WordPress安裝的編輯器樣式表的列表。編輯器樣式表是用來定義WordPress編輯器中內容的外觀的。 |
get_custom_header_markup (函式) | get_custom_header_markup: 這個函式返回當前主題的自定義頁首的HTML標記。它可以用來在網站的前端顯示頁首。 |
get_custom_header (函式) | get_custom_header: 這個函式返回一個陣列,包含關於當前主題的自定義頭的資訊。這可以包括頭像的URL、高度和寬度等屬性。 |
get_background_image (函式) | get_background_image: 這個函式返回主題的背景圖片,如主題的自定義設定中所定義。它不接受任何引數。 |
get_background_color (函式) | get_background_color: 這個函式返回主題的背景顏色,在主題的自定義設定中定義。它不接受任何引數。 |
display_header_text (函式) | display_header_text: 這個函式用於在網頁的頁首部分顯示網站的標題和描述。 |
current_theme_supports (函式) | current_theme_supports: 這個函式檢查當前主題是否支援一個給定的功能,如文章縮圖或自定義背景。它可以在外掛和主題開發中使用,以確保在嘗試使用某項功能之前是可用的。 |
create_initial_theme_features (函式) | WordPress中的create_initial_theme_features函式是用來註冊WordPress中的初始主題功能。它在安裝過程中被呼叫,也可以手動呼叫以確保初始主題功能的存在。 |
check_theme_switched (函式) | check_theme_switched: 這個函式檢查當前主題是否被切換,如果被切換,它將執行任何必要的操作。它用於檢測使用者何時切換到一個新的主題。 |
background_image (函式) | background_image: 這個函式用來檢索WordPress網站的背景影象。它不接受任何引數,並返回背景圖片的URL。 |
background_color (函式) | background_color: 這個函式用來檢索WordPress網站的背景顏色。它不接受任何引數,並返回一個代表十六進位制顏色值的字串。 |
add_theme_support (函式) | add_theme_support – 註冊對一個特定主題功能的支援: 這個函式允許開發者向他們的主題新增將被WordPress識別的功能,例如自定義標題或文章格式。 |
add_editor_style (函式) | add_editor_style: 這個函式用來給WordPress的視覺化編輯器新增自定義樣式: 該函式需要一個引數:樣式表的URL。 |
_wp_keep_alive_customize_changeset_dependent_auto_drafts (函式) | _wp_keep_alive_customize_changeset_dependent_auto_drafts: 呼叫此函式是為了在自定義器更改期間保持依賴變化集的自動草稿的活力。 |
_wp_customize_publish_changeset (函式) | _wp_customize_publish_changeset: 這個函式在WordPress定製器中釋出變化集時被呼叫。它允許你在更改集釋出後執行操作。 |
_wp_customize_loader_settings (函式) | _wp_customize_loader_settings: 這個函式是用來設定WordPress定製器的初始設定的。它允許你修改自定義器的預設設定。 |
_wp_customize_include (函式) | _wp_customize_include: 這個函式包括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;