2007年1月23日 星期二

WordPress Plugins 介紹 (1) - WP-PostViews Plus

WP-PostViews Plus 提供查閱 WordPress 文章瀏覽次數的功能,以下節錄內建的 API 說明

函式說明



  • the_views(’Views’, true)
    該篇文章的 瀏覽數
    第一個參數為 加在數字後面的說明文字
    第二個參數為 是否輸出(true為直接印出, false為回傳數值)

  • the_user_views(’Views’, true)
    該篇文章的 使用者 瀏覽數
    第一個參數為 加在數字後面的說明文字
    第二個參數為 是否輸出(true為直接印出, false為回傳數值)

  • the_bot_views(’Views’, true)
    該篇文章的 機器人 瀏覽數
    第一個參數為 加在數字後面的說明文字
    第二個參數為 是否輸出(true為直接印出, false為回傳數值)

  • get_most_viewed('’, 10, 0 , true , true)
    最多閱覽數的文章 輸出回傳的型態為以<li>和</li>包圍的項目清單
    第一個參數為 查詢文章的型態(’post’為文章 ‘page’為網頁 ‘’為兩者都要)
    第二個參數為 輸出回傳的文章數量
    第三個參數為 文章標題的字數(0為不限制)
    第四個參數為 是否輸出(true時直接印出, false時回傳數值)
    第五個參數為 是否包含機器人的閱覽數(true為包含, false為不包含)

  • get_timespan_most_viewed('’, 10, 7, true, true)
    在最近的數天內最多閱覽數的文章 輸出回傳的型態為以<li>和</li>包圍的項目清單
    第一個參數為 查詢文章的型態(’post’為文章 ‘page’為網頁 ‘’為兩者都要)
    第二個參數為 輸出回傳的文章數量
    第三個參數為 查詢的最近天數
    第四個參數為 是否輸出(true時直接印出, false時回傳數值)
    第五個參數為 是否包含機器人的閱覽數(true為包含, false為不包含)



使用者可以自行利用以上函數撰寫程式碼插入 wp-content/theme/{THEME_NAME} 下的 single.php 和 index.php 中,插入的位置在 The Loop 區塊中間。

沒有留言: