外掛說明
Random Post on Refresh 外掛讓使用者在頁面載入時隨機顯示不同文章的內容。
外掛的使用方式非常簡單：
- 安裝外掛。
- 啟用外掛。
- 在頁面或文章要顯示隨機文章內容的地方，插入
[random_post_on_refresh]短代碼，之後載入這個有短代碼的頁面便會顯示隨機文章內容。 - 儲存編輯內容。
外掛特色
- 可用於自訂內容類型。
- 沒有外掛設定頁面，透過外掛提供的短代碼便能在網站上顯示隨機文章內容。
- 乾淨、良好撰寫習慣且不會造成網站遲滯的程式碼。
安裝方式
先決條件
如果網站主機不符合安裝必要條件，強烈建議升級網站的 WordPress 版本，或將網站遷移至支援較新版本 PHP 的主機環境。
- 需要 WordPress 3.2 或更新版本
- 需要 PHP 5 或更新版本 (WordPress 3.2 僅能執行於 PHP 5.2.4 或更新版本)
自動安裝
- 在 WordPress 管理後台中，前往 [外掛] 頁面，然後點擊 [安裝外掛]。
- 在搜尋框中，輸入
Random Post on Refresh並按下 Enter 鍵，這個外掛應該會是第一筆或唯一的搜尋結果。 - 點擊 [安裝]。
- 安裝完畢後，點擊 [啟用]。
手動安裝
- 下載外掛安裝套件的 ZIP 壓縮檔。
- 將解壓縮得到的
random-post-on-refresh資料夾上傳至網站的/wp-content/plugins/目錄。 - 在 [外掛] 頁面中找到這個外掛，然後點擊 [啟用]。
常見問題集
[random_post_on_refresh] 短代碼提供多個屬性，讓使用者能更細部控制隨機文章內容的顯示結果：
-
author：如果只需要顯示一位或少數幾位作者的隨機文章，請使用作者 ID 或以逗號分隔多個作者 ID。範例：
[random_post_on_refresh author="1, 11, 14"] -
ids：如果只需要顯示指定文章為隨機文章，請使用文章 ID 或以逗號分隔多個文章 ID。範例：
[random_post_on_refresh ids="19, 87, 113, 997"] -
image_required：這項屬性僅會在
show屬性包含image時生效。這個屬性的預設值為true，並會讓 WordPress 篩選掉沒有圖片的文章。如果這個屬性設定為false，那無論文章是否有圖片都會加以顯示。範例：[random_post_on_refresh show="title, image" image_required="false"] -
not：如果只需要顯示排除指定文章的隨機文章，請使用文章 ID 或以逗號分隔多個文章 ID。範例：
[random_post_on_refresh not="3, 456, 876"] -
post_type：如果只需要顯示指定內容類型的隨機文章，請使用指定內容類型的代稱。這個屬性的預設值為
post。範例：[random_post_on_refresh post_type="page"] -
search：將指定搜尋關鍵字傳回的文章顯示為隨機文章。範例：
[random_post_on_refresh search="relativity"] -
taxonomy：用於顯示指定分類法的隨機文章，必須搭配
terms屬性使用。範例：[random_post_on_refresh taxonomy="post_tag" terms="2,4"] -
terms：用於顯示指定分類法詞彙的隨機文章，請使用分類法詞彙 ID 或以逗號分隔多個分類法詞彙 ID，且必須搭配
taxonomy屬性。使用範例：[random_post_on_refresh taxonomy="post_tag" terms="2,4"] -
class：將 HTML
div標籤中包含指定的類別名稱的內容顯示為隨機文章。範例：[random_post_on_refresh class="my-custom-class"] -
size：將包含指定註冊尺寸圖片的內容顯示為隨機文章。這是選用屬性，僅適用於包含圖片的內容。範例：
[random_post_on_refresh size="thumbnail"] -
show：僅顯示隨機文章的指定內容元素，請使用逗號或分隔號
|分隔多個內容元素。有效的屬性值為 title、image、excerpt 及 content，預設值為title, image, excerpt。範例：[random_post_on_refresh show="title, image"]
請銘記於心，以上短代碼屬性均可依需求合併使用。範例：[random_post_on_refresh author="19" size="full" not="2310"]。此外，外掛提供的短代碼也可以使用於核心程式內建的 [文字] 小工具。
使用者評論
參與者及開發者
變更記錄
1.2
- Added a shortcode attribute to allow posts without images to be shown when the
showattribute containsimage. - Bug fix for certain strings not being translatable.
1.1.1
- Fixed bug where post excerpts were being generated incorrectly.
1.1
- Ensure code meets coding standards.
- Don’t allow the current post to be selected as the random post.
- Always return the last 100 matching items and select the random post from one of those.
- Tested in WordPress 5.0
1.0
- Tested in WordPress version 4.9.2