KingCMS文章插件標簽完全解析

KingCMS 通用文章標簽
{king:article} Article 標簽開始 
(HTML)循環輸出部分
{/king} 結束標簽 
循環輸出標簽必須有標簽 開始 如：{king:article} 和 結束 {/king}
需要在模板中循環輸出的的數據，如文章列表必須包含在開始和結束之間，內部循環標簽要由( ) 小括號包圍 


Article標簽參數解析
*type參數如{king:article type="new"} 為調用文章類型，type具有的值 new，related，hot ，commend，list ，sql 
……new ： {king:article type="new"} 最新添加的文章
……related ： {king:article type="related"} 相關文章，與一個頁面具有相同關鍵詞keyword 的文章
……hot： {king:article type="hot"}  熱門，后臺統計點擊量，按點擊量由最高到最低排列
……head ： {king:article type="head"} 頭條文章
……commend： {king:article type="commend"}  推薦文章
……list ： {king:article type="list"} 文章列表(只能在文章列表頁的模板里調用，在其他非文章列表頁如：文章內容頁,但頁面調用無效)
……sql ： {king:article type="sql"} 直接輸入sql調用文章，但必須要和sql屬性配套使用，舉例見下面


type="sql"用法
這個需要你懂得文章插件的數據結構及sql命令才可以正常使用。
{king:article type="sql" sql="where artshow=0 order by artid desc;"}
<a href="(king:path/)">(king:title/)</a>
{/king}
需要注意的是，當type="sql"的時候，必須有sql屬性去設置sql代碼，不然將調用最初加入的文章。
上面的例子中調用的是最新加入的草稿文章


其中頭條，推薦只是文章的一個普通屬性，兩者之間只有名字不一樣，其他屬性值均相同，這兩個屬性是通過后臺添加文章時手動控制


在模板某一模塊想顯示改欄目下的某些特殊文章，那么就想該特殊文章的推薦或者頭條選取，支持同時選擇


*number 循環調用文章的數量，必須為自然數，為0不輸出數據無意義，可以不設置number則默認輸出具有相同type參數的所有文章；


實例：{king:article type="new" number="10"} 說明調用10篇最新文章


*zebra 斑馬線，必須為數字，如zebra="2"，當第2、4、8等整除于zebra參數值的時候，輸出1，其他輸出0


*order 排序，默認值為desc正序，最新添加的文章在最前面，要按id順序輸出，則設置值為asc倒序(跟以前版本正好相反,最早添加的文章在最前面)；限在type="list"的時候有效


*id (欄目id值，在后臺欄目列表可以查看欄目的具體id)指定欄目調用，和3.0版本的union一樣，支持多欄目同時調用，用英文逗號分開，該參數可以不設置則默認輸出所有欄目下具有相同type參數的文章；同時注意5.0文章插件已將union更換為id ，3.0老用戶注意區別


實例：{king:article type="new"  id="1" number="10"} 說明調用1欄目下10篇最新文章


*name 指定欄目名稱調用，多個欄目名稱之間用英文逗號分開，和id參數作用一樣；但是一個標簽中，id或name不能同時存在。 
實例：{king:article type="new"  name="seo" number="10"} 說明調用SEO欄目下10篇最新文章


*keywords 關鍵字參數，調用和keywords參數里指定的關鍵字一致的文章，和type="related"功能類似，但是keywords是用戶手動指定，而type="related"是程序自動尋找


循環體內標簽(HTML)循環輸出部分
(king:artid /) 文章id
(king:listid /) 列表id欄目id
(king:listname /) 列表名稱欄目名稱
(king:listpath /) 列表路徑欄目路徑
(king:path /)文章路徑即一篇文章的地址
(king:title /)文章標題,具有size值，指定輸出多少字節的描述信息，格式(king:title size="64" /)輸出64字符32個漢字的描述信息，一個漢字為兩個字符
(king:from /) 來源
(king:description /) 簡述，具有size值，指定輸出多少字節的描述信息，格式(king:description size="200" /)輸出200字符100個漢字的描述信息，一個漢字為兩個字符
(king:keywords /)關鍵字
(king:author /) 作者
(king:image /) 縮略圖路徑，支持width和height屬性，格式(king:image width="100" height="100" /) 輸出寬高均為100像素的縮略圖，不填寫width和height則輸出原圖片
(king:date /) 文章發布日期，(king:date mode="yy-MM-dd"/) mode屬性指定輸出日期的格式，y年m月d日，之間可以有劃線鏈接或無連接




完整用法舉例：
{king:article type="hot" number="20"}
<a href="(king:path/)">(king:title size="30" /)</a><img src="(king:image width="150" height="100" / ) alt="(king:title /)" />(king:description size="200" /)(king:date mode="yy-MM-dd"/) 
{/king}


內容頁面標簽
{king:artid /} 文章id
{king:listid /} 列表id
{king:title /} 文章標題
{king:content  /}內容
{king:from /} 來源
{king:keywords /} 關鍵字
{king:description /} 簡述
{king:author /} 作者
{king:image /} 縮略圖路徑，支持width和height屬性
{king:path  /}文章路徑
{king:guide /} 導航
{king:pagelist /} 文章分頁
{king:nextpage /} 下一頁
{king:lastpage /} 上一頁
{king:hit /} 點擊次數調用及頁面訪問統計
{king:date /} 日期


以上標簽不在循環體內必須有 { }包圍，注意本身必須有/ 結束
用法舉例：
<h1>{king:title/}</h1>
<img src="{king:image width="200" height="150" /}"/>
 來源：{king:from /}  作者：{king:author /}  日期：{king:date /} 
{king:content  /}
{king:pagelist /} 
下一頁：{king:nextpage /} 上一頁：{king:lastpage /}

什么時候成管理員了？

看來我在官網活動的時間少了

你不覺得這貼得太晚了么~~

很好很不錯，這個好貼啊 對我很實用。

非常不錯，支持一下

學習了