證書相關短代碼介紹

證書短代碼僅用於建立證書使用，能依據不同的課程、測驗與學員，動態提取對應的資料。也就是不需要把要顯示在證書上的文字寫上去，而是透過短代碼自動去帶出實際上的資料，例如：人名、課程名稱…等等。

若希望在別的地方(文章、頁面或小工具)顯示類似的資料，請利用其他的短代碼，按此前往觀看。

證書短代碼可以分成以下四種，各自有搭配使用的語法來提取不同的資料。

[usermeta] 可用來顯示與此證書相關的使用者資料。
[courseinfo] 可用來顯示與此證書相關的課程資料。
[quizinfo] 可用來顯示與此證書相關的測驗資料
[groupinfo] 可用來顯示與此證書相關的群組資料

`[usermeta]`

[usermeta] 短代碼可用來顯示與此證書相關的使用者資料，以下是可搭配使用的語法：

[usermeta field="first_name"] – 顯示使用者的名字
[usermeta field="last_name"] – 顯示使用者的姓氏(優易教學網網站包預設停用此欄位)
[usermeta field="display_name"] – 顯示使用者的顯示名稱, 通常是名字與姓氏的排列組合
[usermeta field="user_login"] – 顯示使用者的帳號名稱
[usermeta field="nickname"] – 顯示使用者的暱稱 (需在WordPress後台的個人資料頁面才能設定, 在WooCommerce我的帳號頁面編輯帳號處無法設定)
[usermeta field="user_email"] – 顯示使用者的email
[usermeta field="user_url"] – 顯示使用者的網站網址 (需在WordPress後台的個人資料頁面才能設定, 在WooCommerce我的帳號頁面編輯帳號處無法設定)
[usermeta field="description"] – 顯示使用者的簡介 (需在WordPress後台的個人資料頁面才能設定, 在WooCommerce我的帳號頁面編輯帳號處無法設定)
[usermeta field="id"] – 顯示使用者的帳號ID號碼 (註冊時系統指派的編號，無法更改。)

實際在證書上會顯示的多半只有名字，也就是 [usermeta field="first_name"] ，其他的應該很少會有機會用到。

`[courseinfo]`

[courseinfo] 短代碼可用來顯示與此證書相關的課程資料，其中有兩個用語的定義需要先知道：

aggregate 代表所有此課程中所有測驗的「總和」
cumulative 代表所有此課程中所有測驗的「平均」

以下是可搭配使用的語法：

[courseinfo show="course_title"] – 顯示課程名稱
[courseinfo show="course_price"] – 顯示課程價格 (僅能顯示單次購買的價格)
[courseinfo show="course_price_type"] – 顯示課程存取方式(如：完全開放、免費、內建購買、訂閱制或關閉)
[courseinfo show="course_url"] – 顯示課程網址
[courseinfo show="course_points"] – 顯示完成課程可獲得的點數
[courseinfo show="user_course_points"] – 顯示學員實際獲得的點數
[courseinfo show="enrolled_on"] – 顯示學員註冊日期 (不適用於課程為完全開放的存取方式)
[courseinfo show="completed_on"] – 顯示學員完成課程的日期
[courseinfo show="user_course_time"] – 顯示學員完成課程所花費的時間
[courseinfo show="cumulative_score"] – 顯示在此課程所有測驗的平均得分
[courseinfo show="cumulative_points"] – 顯示在此課程的平均點數
[courseinfo show="cumulative_total_points"] – 顯示在此課程的平均點數(原文中此短代碼的用字與上方相同)
[courseinfo show="cumulative_percentage"] – 顯示在此課程所有測驗的平均百分比
[courseinfo show="cumulative_timespent"] – 顯示在此課程每個部分花費的平均時間
[courseinfo show="aggregate_score"] – 顯示在此課程獲得的總分
[courseinfo show="aggregate_points"] – 顯示在此課程獲得的點數
[courseinfo show="aggregate_total_points"] –顯示在此課程獲得的點數(原文中此短代碼的用字與上方相同)
[courseinfo show="aggregate_percentage"] – 顯示在課程所有測驗總得分的百分比
[courseinfo show="aggregate_timespent"] – 顯示在此課程所有測驗的總花費時間

使用 completed_on 參數時，可自行定義日期格式 (按此觀看WordPress官網說明)，使用方式如下：

<span class="pun"><span class="pun">[</span></span><span class="pln"><span class="pln">courseinfo show</span></span><span class="pun"><span class="pun">=</span></span><span class="str"><span class="str">"completed_on"</span></span><span class="pln"><span class="pln"> format</span></span><span class="pun"><span class="pun">=</span></span><span class="str"><span class="str">"F j, Y"</span></span><span class="pun"><span class="pun">]</span></span>

`[quizinfo]`

[quizinfo] 短代碼僅能用於完成測驗後所獲得的證書，若用於完成課程後所獲得的證書，將 無法正常顯示資料。

這裡有兩個用語 score (得分) 與 points (點數) 的定義區別說明如下：
score(得分) 是完成測驗後，答題正確的百分比。一個測驗的預設通過得分為80%，要答題正確超過80%才能通過測驗。(獲得證書的得分可以另外設定)
points (點數) 是

以下是可搭配使用的語法：

[quizinfo show="score"] – 顯示在此測驗的得分
[quizinfo show="count"] – 顯示此測驗中題目數量
[quizinfo show="pass"] – 顯示通過此測驗所需的得分
[quizinfo show="timestamp"] – 顯示完成此測驗的日期/時間
[quizinfo show="points"] – 顯示學員在此測驗獲得的點數
[quizinfo show="total_points"] – 顯示此測驗可能獲得的總點數
[quizinfo show="percentage"] – 顯示學員在此測驗獲得的分數百分比
[quizinfo show="quiz_title"] – 顯示測驗名稱
[quizinfo show="course_title"] – 顯示與此測驗關聯的課程名稱
[quizinfo show="timespent"] – 顯示完成此測驗所花費的時間

跟上面提過的一樣，日期格式可以自行定義：

<span class="pun"><span class="pun">[</span></span><span class="pln"><span class="pln">quizinfo show</span></span><span class="pun"><span class="pun">=</span></span><span class="str"><span class="str">"timestamp"</span></span><span class="pln"><span class="pln"> format</span></span><span class="pun"><span class="pun">=</span></span><span class="str"><span class="str">"F j, Y"</span></span><span class="pun"><span class="pun">]</span></span>

`[groupinfo]`

[groupinfo] 短代碼僅能用於完成群組所有課程後所獲得的證書，若用於完成單一課程或測驗後所獲得的證書，將 無法正常顯示資料。

Here’s a list of all available options to output quiz information on a group certificate:

[groupinfo show="group_title"] – 顯示群組名稱
[groupinfo show="group_url"] – 顯示群組網址
[groupinfo show="group_price_type"] – 顯示群組存取方式(如：完全開放、免費、內建購買、訂閱制或關閉)
[groupinfo show="group_price"] – 顯示群組價格
[groupinfo show="group_users_count"] – 顯示註冊此群組的學員人數
[groupinfo show="group_courses_count"] – 顯示此群組包含的課程數量
[groupinfo show="user_group_status"] – 顯示該學員在此群組的進度狀態
[groupinfo show="enrolled_on"] – 顯示學員註冊日期
[groupinfo show="completed_on"] – 顯示學員完成所有課程的日期
[groupinfo show="percent_completed"] – 顯示在此群組的得分

跟上面提過的一樣，日期格式可以自行定義：

<span class="pun"><span class="pun">[</span></span><span class="pln"><span class="pln">groupinfo show</span></span><span class="pun"><span class="pun">=</span></span><span class="str"><span class="str">"timestamp"</span></span><span class="pln"><span class="pln"> format</span></span><span class="pun"><span class="pun">=</span></span><span class="str"><span class="str">"F j, Y"</span></span><span class="pun"><span class="pun">]</span></span>

上一章節

返回課程

下一章節

證書相關短代碼介紹

`[<span>usermeta</span>]`

`[<span>courseinfo</span>]`

`[<span>quizinfo</span>]`

`[<span>groupinfo</span>]`

[<span>usermeta</span>]

[<span>courseinfo</span>]

[<span>quizinfo</span>]

[<span>groupinfo</span>]

輸入完按下enter開始搜尋

`[<span>usermeta</span>]`

`[<span>courseinfo</span>]`

`[<span>quizinfo</span>]`

`[<span>groupinfo</span>]`