Wordpress/類別與函式:修訂版本之間的差異

出自福留子孫
跳轉到: 導覽搜尋
函式
第 2 行: 第 2 行:
 
===類別===
 
===類別===
 
===函式===
 
===函式===
 +
常用函式:
 +
*基本條件判斷
 +
*#is_home() : 是否為主頁
 +
*#is_single() : 是否為內容頁(Post)
 +
*#is_page() : 是否為內容頁(Page)
 +
*#is_category() : 是否為Category/Archive頁
 +
*#is_tag() : 是否為Tag存檔頁
 +
*#is_date() : 是否為指定日期存檔頁
 +
*#is_year() : 是否為指定年份存檔頁
 +
*#is_month() : 是否為指定月份存檔頁
 +
*#is_day() : 是否為指定日存檔頁
 +
*#is_time() : 是否為指定時間存檔頁
 +
*#is_archive() : 是否為存檔頁
 +
*#is_search() : 是否為搜索結果頁
 +
*#is_404() : 是否為 「HTTP 404: Not Found」 錯誤頁
 +
*#is_paged() : 主頁/Category/Archive頁是否以多頁顯示
 +
*Header部分常用到的PHP函數
 +
*#博客名稱(Title)
 +
*#CSS文件路徑
 +
*#PingBack Url
 +
*#模板文件路徑
 +
*#WordPress版本
 +
*#Atom Url
 +
*#RSS 2.o Url
 +
*#博客 Url
 +
*#博客網頁Html類型
 +
*#博客網頁編碼
 +
*#博客描述
 +
*#特定內容頁(Post/Page)的標題
 +
*模板常用的PHP函數及命令
 +
*#調用Header模板
 +
*#調用Sidebar模板
 +
*#調用Footer模板
 +
*#顯示內容(Post/Page)
 +
*#檢查是否存在Post/Page
 +
*#如果存在Post/Page則予以顯示
 +
*#While 結束
 +
*#If 結束
 +
*#顯示時間,時間格式由「字符串」參數決定,具體參考PHP手冊
 +
*#正文中的留言鏈接。如果使用 comments_popup_script() ,則留言會在新窗口中打開,反之,則在當前窗口打開
 +
*#內容頁(Post/Page)標題
 +
*#內容頁(Post/Page) Url
 +
*#特定內容頁(Post/Page)所屬Category
 +
*#作者
 +
*#特定內容頁(Post/Page) ID
 +
*#如果用戶已登錄並具有權限,顯示編輯鏈接
 +
*#顯示Blogroll中的鏈接
 +
*#調用留言/回復模板
 +
*#顯示Page列表
 +
*#顯示Categories列表
 +
*#下一篇文章鏈接
 +
*#上一篇文章鏈接
 +
*#日曆
 +
*#顯示內容存檔
 +
*#導航,顯示上一篇/下一篇文章鏈接
 +
*#嵌入其他文件,可為定制的模板或其他類型文件
 +
*與模板相關的其他函數
 +
*#輸出相應信息
 +
*#顯示註冊鏈接
 +
*#顯示登錄/註銷鏈接
 +
*#將當前內容分頁
 +
*#將當前內容截斷,以不在主頁/目錄頁顯示全部內容
 +
*#網頁加載時間(秒)
 +
*#網頁加載查詢量
 
====add_action()====
 
====add_action()====
 
描述:在一個action上掛載(掛鉤機制)一個函數。
 
描述:在一個action上掛載(掛鉤機制)一個函數。

2016年8月18日 (四) 07:16的修訂版本

類別

函式

常用函式:

  • 基本條件判斷
    1. is_home() : 是否為主頁
    2. is_single() : 是否為內容頁(Post)
    3. is_page() : 是否為內容頁(Page)
    4. is_category() : 是否為Category/Archive頁
    5. is_tag() : 是否為Tag存檔頁
    6. is_date() : 是否為指定日期存檔頁
    7. is_year() : 是否為指定年份存檔頁
    8. is_month() : 是否為指定月份存檔頁
    9. is_day() : 是否為指定日存檔頁
    10. is_time() : 是否為指定時間存檔頁
    11. is_archive() : 是否為存檔頁
    12. is_search() : 是否為搜索結果頁
    13. is_404() : 是否為 「HTTP 404: Not Found」 錯誤頁
    14. is_paged() : 主頁/Category/Archive頁是否以多頁顯示
  • Header部分常用到的PHP函數
    1. 博客名稱(Title)
    2. CSS文件路徑
    3. PingBack Url
    4. 模板文件路徑
    5. WordPress版本
    6. Atom Url
    7. RSS 2.o Url
    8. 博客 Url
    9. 博客網頁Html類型
    10. 博客網頁編碼
    11. 博客描述
    12. 特定內容頁(Post/Page)的標題
  • 模板常用的PHP函數及命令
    1. 調用Header模板
    2. 調用Sidebar模板
    3. 調用Footer模板
    4. 顯示內容(Post/Page)
    5. 檢查是否存在Post/Page
    6. 如果存在Post/Page則予以顯示
    7. While 結束
    8. If 結束
    9. 顯示時間,時間格式由「字符串」參數決定,具體參考PHP手冊
    10. 正文中的留言鏈接。如果使用 comments_popup_script() ,則留言會在新窗口中打開,反之,則在當前窗口打開
    11. 內容頁(Post/Page)標題
    12. 內容頁(Post/Page) Url
    13. 特定內容頁(Post/Page)所屬Category
    14. 作者
    15. 特定內容頁(Post/Page) ID
    16. 如果用戶已登錄並具有權限,顯示編輯鏈接
    17. 顯示Blogroll中的鏈接
    18. 調用留言/回復模板
    19. 顯示Page列表
    20. 顯示Categories列表
    21. 下一篇文章鏈接
    22. 上一篇文章鏈接
    23. 日曆
    24. 顯示內容存檔
    25. 導航,顯示上一篇/下一篇文章鏈接
    26. 嵌入其他文件,可為定制的模板或其他類型文件
  • 與模板相關的其他函數
    1. 輸出相應信息
    2. 顯示註冊鏈接
    3. 顯示登錄/註銷鏈接
    4. 將當前內容分頁
    5. 將當前內容截斷,以不在主頁/目錄頁顯示全部內容
    6. 網頁加載時間(秒)
    7. 網頁加載查詢量

add_action()

描述:在一個action上掛載(掛鉤機制)一個函數。

函數原型:add_action ( '動作名', '響應函數名', [優先級], [參數數目] );

參數說明:

(一)動作名: WordPress所提供的動作名,用於標識在哪個動作發生時,執行響應函數。相應函數名:當動作 hook_name 發生時需要執行的響應函數的名字。可以是 PHP 標準的函數,或者是 WordPress 內的函數,或者是插件內自定義的函數。

動作 (Actions) 是由 WordPress 內部的某些事件所觸發的,比如說發表一篇文章、更換主題或者訪問後台的某個管理界面,這些都是一件事件的例子。而插件則可以指定某些 PHP 函數來響應這些事件所觸發的動作。例如:

  1. 修改數據庫數據
  2. 發送電子郵件
  3. 修改即將顯示出來的內容
  4. 使用動作來掛載插件的基本步驟如下:
  5. 在插件代碼中定義當某個事件發生時,需要執行的 PHP 函數

用add_action() 把這個函數註冊到動作執行掛勾上,把插件源碼放到 WordPress 指定的地方,然後啟用它

(二)定義動作響應函數:要在插件中執行動作,就要先在插件文件(必須放到wp-content/plugins下)中定義一個響應動作的 PHP 函數。比如下面的例子,實現的功能是在新文章發佈時,通過電子郵件通知好友。

$friends = 'bob@example.org,susie@example.org';  
    mail($friends, "sally's blog updated",   
      'I just put something on my blog: http://blog.example.com');  
    return $post_ID;

可以把函數掛載到系統中:add_action ( 'publish_post', 'email_friends' );

(三)優先級:這是一個可選的參數,預設值為10。由於可以把多個函數註冊到同一個動作,所以這個參於是用於指定註冊到這個動作中的這個函數執行的優先級,數字越小優先 級越高,執行得也越早,反之亦然。如果若干個函數以相同的優先級註冊到同一個動作,那麼執行順序則是由它們註冊的先後順序所決定。

(四)參數數目:這是一個可選的參數,預設值是1。由於某些動作可能會把多個參數傳給響應函數,所以這個有時候需要指定響應函數能接受多少個參數。這個參數是在 1.5.1 版加進去的。這個函數類似於Qt中的信號槽機制。