WordPress函數

如果你是一名WordPress開發(fā)者，你可能知道WordPress函數 the_content() 可以直接輸出文章內容，而 get_the_content() 則需要在前面添加 echo 才可以輸出文章內容。 <?php the_content(); echo get_the_content(); ?> 這是WordPress內置函數的一個很重要的標志，the_ 開頭的函數直接輸出，…

count_user_posts 是一個用來獲取用戶文章數量的WordPress函數，該函數位于 wp-includes/user.php 文件，具體代碼如下：function count_user_posts( $userid, $post_type = 'post' ) { global $wpdb; $where = get_posts_by_author_sql( $p…

在 WordPress 開發(fā)的過程中，我們需要使用到各種 WordPress 函數，今天介紹一個非常簡單實用的選擇函數 selected() ，它可以簡化我們制作一個多項選擇列表的代碼量。 按照常規(guī)方法，要制作一個下拉選擇列表，我們通常要使用 if() 函數進行判斷：<!-- Testing the values with if() --> <select name="…

描述 add_meta_box() 函數是在 WordPress 2.5 添加的，用來給插件開發(fā)者添加 Meta模塊 到管理界面。 用法 <?php add_meta_box( $id, $title, $callback, $post_type, $context,$priority, $callback_args ); ?> 參數 $id （字符串）（必需）Meta模塊的 HTML…

WordPress附件可以是圖片、視頻、文本文件等類型，但大部分附件函數都是針對圖片的，本文總結了常用的附件函數使用方法。 wp_get_attachment_image_src() <?php wp_get_attachment_image_src( $attachment_id, $size, $icon ); ?> 用于圖片類附件時，根據附件id和指定的尺寸（$size,默認是t…

說明 將已添加的腳本進行本地化（翻譯）。當然也可用來在一個頁面中包含任意的Javascript數據。 用法 <?php wp_localize_script( $handle, $object_name, $l10n ); ?> 參數 $handle （字符串）（必填） 你所要附加數據的處理腳本 默認值：無 $object_name （字符串）（必填） 將包含數據的腳本對象名稱（也就是…

說明 將函數連接到指定action（動作）。 在Plugin API/Action Reference 上查看動作hook列表。wordpress核心調用do_action() 時觸發(fā)動作。 用法 <?php add_action( $tag, $function_to_add, $priority, $accepted_args ); ?> 參數 $tag （字符串）（必填）$fun…

說明 該標簽顯示帶有鏈接的WordPress頁面列表，并且可以選擇將 Home（主頁）自動顯示為列表中的一員。該標簽是自定義側邊欄和標題欄的好幫手，同時還可以用在其它模板中。 用法 <?php wp_page_menu( $args ); ?> 默認用法 <?php $args = array( 'depth' => 0, 'sort_colu…

說明 the_widget() 是一個模板標簽，用來顯示任何一個小工具。它可以在模板的任何地方使用。 用法 <?php the_widget($widget, $instance, $args); ?> 參數 widget （字符串）小工具的 PHP 類名 WP_Widget_Archives —— Archives WP_Widget_Calendar  —— Calend…

說明 is_active_widget() 是一個條件標簽，用來檢查是否小工具已經在前端顯示（已使用）。只有在小工具初始化后，該函數才會生效。 用法 <?php is_active_widget( $callback, $widget_id, $id_base, $skip_inactive ); ?> 參數 $callback （字符串）（可選）小工具回調檢查。 默認值：False …

介紹 用來注銷小工具（通常是用來注銷WordPress內置的小工具） 用法 <?php unregister_widget( $widget_class ) ?> 參數 $widget_class （對象）WP_Widget 擴展的 類名 WP_Widget_Pages = 頁面 WP_Widget_Calendar = 日歷 WP_Widget_Archives = 存檔 WP_Wi…

介紹 注冊一個單獨的側邊欄區(qū)域和返回ID，供 "widgets_init" 鉤子調用。 用法 <?php register_sidebar( $args ); ?> 默認用法 <?php $args = array( 'name' => __( 'Sidebar name', 'theme_text_do…

說明 wp_tag_cloud() 函數的作用是用來標簽云的，可以根據每個標簽所關聯的文章次數來定義字體大小、標簽排序等屬性。從 2.8 版本開始，添加了 分類法（taxonomy）參數，這就意味著，除了 標簽（tags）以外，還可以將 分類（Categories） 或其他 自定義分類法（Custom Taxonomies）作為“云”顯示。 用法 <?php wp_tag_cloud( $a…

描述 將分類以列表的形式顯示為鏈接。點擊分類的鏈接，就可以訪問該分類下的所有文章的存檔頁面。 注意： wp_list_categories() 和 list_cats() 以及 wp_list_cats() 的使用類似，但是后面 2 個已經棄用。 如果你希望不格式化輸出分類，請使用 get_categories() 用法 <?php wp_list_categories( $args ); …

描述 用來顯示網站的作者（用戶）列表，如果用戶發(fā)布有文章，就會將作者名字鏈接到他們的文章。還可以顯示每個作者的文章數和RSS訂閱鏈接。 用法 <?php wp_list_authors( $args ); ?> 默認用法 <?php $args = array( 'orderby' => 'name', 'order…

描述 加載翻譯后的插件字符串。 如果未給出路徑，默認路徑為插件根目錄。.mo文件路徑基于帶有破折號的域名命名，域名后應跟有一個破折號，破折號后為本地語言簡碼。 這里的本地語言簡碼是指你在wp-config.php中填寫的 WPLANG 的值，比如你填寫的是 zh_CN ，那么就該使用 zh_CN，如果你的插件的 text domain 為 “my-plugin”，那么語言包的名字應該為 “my-p…

描述 加載翻譯后的主題字符串。 如果本地主題根目錄下有一個.mo文件，該文件會被包括在$domain的被翻譯字符串中。 .mo文件必須根據本地設置命名。 用法 <?php load_theme_textdomain( $domain, $path ) ?> 參數 $domain（字符串）（必需）用以檢索被翻譯字符串的唯一標識符默認值： None$path（未知）（可選）語言包 .mo …

描述 query_posts() 可以用來控制在循環(huán)（Loop）中顯示哪些文章。它可以替換主查詢，而使用一個新的查詢來獲取文章。要清除 query_posts() 的新查詢，可以使用 wp_reset_query() 來重置查詢。 我們強烈建議您使用 pre_get_posts 來替代 query_posts() ，同時使用 is_main_query 來檢查主查詢。 舉個例子，在首頁（homep…

描述 返回你博客的信息，這些信息可以用在任何地方的 PHP 代碼中。這個函數，和 bloginfo() 一樣，可以用來在模板文件的任何地方顯示你博客的信息。 用法 <?php $bloginfo = get_bloginfo( $show, $filter ); ?> 參數 $show(字符串 string) (可選) 關鍵字命名你想要的信息。默認: name 'name&#…

描述 顯示你博客的相關信息，大部分都是管理后臺生成于“用戶 > 你的個人資料”和“設置 > 常規(guī)”中設置的信息。此功能與 bloginfo() 相同，除非它輸出用于訂閱的RSS標記。 用法 <?php bloginfo_rss('show'); ?> 例子 顯示博客標題和鏈接 顯示帶鏈接和RSS feed標識的博客名稱。 <title><…

描述 顯示你的博客信息，大部分都是顯示WordPress管理界面的 用戶資料 和 常規(guī)設置 中的信息。它可以在模板文件的任何地方使用。一般 bloginfo() 都是用來直接在瀏覽器中輸出內容的。如果你需要在PHP中返回值的話，那么請用 get_bloginfo()。 用法 <?php bloginfo( $show ); ?> 參數 $show (字符串string) (可選)你需要…

描述 加載評論模板。只能用于單篇 文章 或 頁面 來顯示評論，如果不是這些頁面，將沒辦法顯示。 用法 <?php comments_template( $file, $separate_comments ); ?> 參數 $file(字符串string) (可選) 要加載的文件 默認: /comments.php$separate_comments(布爾值boolean) (可選) 是…

描述 引入 searchform.php 文件來顯示搜索表單。 用法 <?php get_search_form( $echo ); ?> 參數 $echo : (布爾值) (可選) 如果是 true 則輸出表單； false 則返回表單的字符串。默認: true 返回值 (字符串string)，如果參數 $echo 設置為 false，就返回表單的HTML代碼。 例子 如果你的主題沒…

描述 引入當前主題的頁腳文件 footer.php，如果使用特定的名字，那么就會調用這個特定名字的頁腳文件 footer-{name}.php 。 如果主題沒有 footer.php 就會引入默認的 wp-includes/theme-compat/footer.php 。 用法 <?php get_footer( $name ); ?> 參數 $name(string) (可選) 調…