佈景主題常用的函數小抄

通堂我們在修改現有的主題外觀或是排版時會常看到一些不知是顯示什麼訊息的 php 程式碼或是不知道什麼頁面的程式碼是落在哪個檔案裡,所以就列出常在佈景主題檔案裡看到的程式碼的相關說明以及說明佈景主題的檔案結構。

Theme Structure(佈景主題結構)
如果您要從無到有創造一個WordPress用佈景主題,那麼以下的檔案都是必須的,因為那是一個標準的主題都會包含的檔案,所以至少要有以下這些檔案來建構出主題。

  • header.php – 頁首
  • index.php – 首頁
  • sidebar.php – 側邊欄頁面
  • footer.php – 頁底
  • single.php – 單篇文章頁面
  • page.php – 分頁頁面
  • comments.php – 迴響頁面(從迴響清單 ~ 發表迴響表單)
  • search.php – 搜尋頁面
  • searchform.php – 搜尋框
  • archive.php – 彙整頁面
  • functions.php – 存放主題自製函數的檔案
  • 404.php – 錯誤 / 找不到網頁訊息頁面

Template Include Tags(呼叫頁面用標籤)
因為一個網頁是由數個檔案所組成,所以要在index、single等這些主頁之中插入程式碼來呼叫頁首底或是迴響頁面才能顯示成一個完整的頁面。

 - 呼叫頁首檔案:header.php
 - 呼叫側邊欄頁面檔案:sidebar.php
 - 呼叫頁底檔案:footer.php
 - 呼叫迴響頁面檔案:comments.php

 

Template Bloginfo Tags(顯示網站資訊用標籤)
以下的標籤是用來顯示您的部落格名稱、描述及連結等資訊。

 - 顯示網誌標題
 - 顯示網誌描述
 - 顯示網誌安裝網址
 - 顯示網誌網址
 - 顯示系統管理員電子郵件(指第一位系統管理員)
 - 顯示部落格網頁編碼
 - 顯示網誌 RSS 文章摘要網址
 - 顯示網誌 RSS 迴響摘要網址
 - 顯示網誌目前使用的佈景主題目錄網址
 - 顯示網誌 pingback 網址
 - 顯示網誌目前使用的佈景主題 CSS 檔案網址

 

WordPress Conditional Tags(條件判斷用標籤)
我們可以用WordPress內建的一些判斷函數來很快速的做出僅限首頁顯示某某資訊、某篇文章或是在單篇文章才顯示資訊等效果。
這邊會在下一篇文章更詳細說明如何運用這些判斷標籤,在這只是大約提起一下。

  • is_admin() – 僅有管理員才看得到
  • is_home() – 僅在首頁顯示
  • is_front_page() – 當每次連到網誌時顯示(第一個看到的網誌頁面)
  • is_single – 僅在單篇文章頁面顯示
  • is_sticky() – 僅在置頂文章頁面顯示
  • is_page() – 僅在分頁顯示
  • is_category() – 僅在分類頁面顯示

Common WordPress Tags(通用標籤)
這邊列出的是顯示常見的文章資訊,例如作者、發表日期時間及文章連結還有內容等等,像是上下篇文章連結也有標籤可以運用。
註:the_xxx()系列都是用在迴圈裡的,這點別忘了。

 - 顯示文章發表時間
 - 顯示文章發表日期
 - 顯示文章標題
 - 顯示文章內容
 - 顯示文章摘要
 - 顯示文章連結網址
 - 顯示文章所屬的分類
 - 顯示文章的發表作者
 - 顯示文章的編號
 - 顯示分頁
 - 顯示標籤雲
 - 顯示分類
 - 顯示行事曆
 - 顯示加上某些條件後彙整的文章(比如某年某月發表的文章清單等)
 - 顯示上下篇文章連結
 - 顯示下一篇文章連結
 - 顯示上一篇文章連結

以上列的就是目前比較常在佈景主題中看到的函數代表意義,下一篇將說明各個函數的運用及範例。

本文資料來源:http://www.graphicrating.com/2009/01/18/my-wordpress-cheat-sheet/

關於 Mr. 夫

唯有力量才能制衡一切,沒有力量什麼都保護不了,就連自身也難保...