AKCMS動(dòng)態(tài)接口

導(dǎo)航: 返回上一頁(yè)

AKCMS安裝后，默認(rèn)并不生成靜態(tài)頁(yè)，而是提供了幾個(gè)前臺(tái)接口顯示網(wǎng)頁(yè)。

• /akcms_item.php?id=123（顯示ID為123的文章）
• /akcms_category.php?id=1（顯示ID為1的欄目）

接口程序被部署在后臺(tái)文件高一層的目錄中，即：如果管理后臺(tái)的網(wǎng)址是http://www.your.com/akcms/，那文章接口的地址是http://www.your.com/akcms_item.php。

接口的文件名都以akcms_作為前綴前綴，這是為了防止安裝AKCMS覆蓋網(wǎng)站原有的同名文件。

目錄

• 1 akcms_item.php
• 2 akcms_rounter.php
• 3 akcms_category.php
• 4 akcms_section.php
• 5 akcms_comment.php
• 6 akcms_page.php
• 7 akcms_score.php
• 8 akcms_search.php

akcms_item.php

ID參數(shù)的動(dòng)態(tài)頁(yè)面接口

本接口接受的參數(shù)：id，對(duì)應(yīng)頁(yè)面或者文章的ID

舉例：akcms_item.php?id=123

• 特別說(shuō)明

接口雖然支持直接使用，但是通常建議通過(guò)另外一個(gè)php調(diào)用它，以akcms_item.php為例，它支持直接通過(guò) akcms_item.php?id=123的方式調(diào)用，不過(guò)最好新增一個(gè)article.php文件，代碼短只有三行：

<?php
include("akcms_item.php");
?>

從而實(shí)現(xiàn)了通過(guò)article.php?id=123的方式調(diào)用。這樣做的好處是URL可以自行定義，比akcms_item.php這樣的好看；用戶不會(huì)知道使用的CMS是AKCMS，暴露出去的信息越少，系統(tǒng)越安全。

通過(guò)在調(diào)用前設(shè)置變量還可以指定模板：

<?php
//$template = 'test1.htm,test2.htm,test3.htm';
//如果上一句去掉注釋，則動(dòng)態(tài)顯示頁(yè)面，模板在test1.htm、test2.htm,test3.htm中隨機(jī)，隨機(jī)模板可以有效防止內(nèi)容被采集
//$template = 'test1.htm';
//如果上一句去掉注釋，則動(dòng)態(tài)顯示頁(yè)面，模板固定使用test1.htm
//如果以上兩句都注釋掉，也就是說(shuō)不設(shè)置$template變量，則用這篇文章默認(rèn)的模板渲染，取決于這篇文章自身的設(shè)置以及所屬欄目的設(shè)置
include("akcms_item.php");
?>

以下接口也都建議通過(guò)另外一個(gè)php調(diào)用，不再重復(fù)說(shuō)明。

akcms_rounter.php

偽靜態(tài)文件名的動(dòng)態(tài)頁(yè)面接口

本接口接受的參數(shù)：

filename，文件名

舉例：akcms_rounter.php?filename=sports/jordan.htm，這個(gè)接口主要用于配合偽靜態(tài)訪問(wèn)。

Apache的RewriteRule^([a-zA-Z0-9\-_\/]+\.htm)$ akcms_rounter.php?filename=$1 [L]

這樣一來(lái)通過(guò)http://youdomain.com/sports/jordan.htm的訪問(wèn)會(huì)被定向到akcms_rounter.php?filename=sports/jordan.htm，看似是純靜態(tài)，實(shí)際上是動(dòng)態(tài)頁(yè)面。

==='akcms_captcha.php=== 驗(yàn)證碼的圖片接口 本接口接受的參數(shù)：

sid，Session ID，本接口的輸出就是一副普通圖片，<img src="/akcms_captcha.php?sid=12345">就可以顯示一個(gè)驗(yàn)證碼圖片

舉例：

<script>
ran = 'kfld5d';//sid可以通過(guò)JS方式隨機(jī)獲取
document.getElementById("captchaimage").src = "/akcms_captcha.php?sid=" + ran;
</script>

akcms_category.php

欄目頁(yè)面的顯示接口

本接口接受的參數(shù)：

id，欄目的ID

path，欄目的目錄，path=sports/ball/football，則顯示football這個(gè)欄目，前提是football這個(gè)欄目的上級(jí)目錄依次sports和ball，支持無(wú)限

級(jí)欄目

alias，欄目的別名，alias=abc，則顯示別名是abc的欄目，如果有多個(gè)欄目的別名都是abc的話，取ID最小的一個(gè)，因此如果您要使用這個(gè)參數(shù)的話需要自行保證欄目別名的唯一性

category，欄目名稱，category=足球，則顯示足球這個(gè)欄目，與alias參數(shù)一樣，唯一性需自行保證page，頁(yè)碼ID，如果page未指定則顯示欄目

首頁(yè)模板，如果指定則顯示欄目分頁(yè)模板

akcms_section.php

主題頁(yè)面的顯示接口

id，主題的ID

alias，主題的別名，alias=abc，則顯示別名是abc的主題，如果有多個(gè)主題的別名都是abc的話，取ID最小的一個(gè)，因此如果您要使用這個(gè)參數(shù)

的話需要自行保證主題別名的唯一性

section，主題名稱，section=足球，則顯示足球這個(gè)主題，與alias參數(shù)一樣，唯一性需自行保證

akcms_comment.php

接受評(píng)論接口

本接口接受的參數(shù)：（POST方式）

captcha，用戶輸入的驗(yàn)證碼（如果設(shè)置需要驗(yàn)證碼則必提供）

sid，驗(yàn)證碼對(duì)應(yīng)的sid（如果設(shè)置需要驗(yàn)證碼則必提供）

itemid，被評(píng)論文章的ID（必提供）

comment，評(píng)論內(nèi)容（必提供）

username，評(píng)論者姓名

title，評(píng)論題目

本接口不成熟

akcms_page.php

顯示模板接口

本接口接受的參數(shù)：

template，模板（支持多模板隨機(jī)顯示，用,間隔）

本接口用于顯示一個(gè)模板而無(wú)需創(chuàng)建一個(gè)頁(yè)面應(yīng)用這個(gè)模板，從性能上說(shuō)，不用從數(shù)據(jù)庫(kù)獲取頁(yè)面的信息然后再渲染頁(yè)面，減少2次數(shù)據(jù)庫(kù)查詢。

akcms_post.php 投遞內(nèi)容接口 本接口不成熟

akcms_score.php

評(píng)分接口

本接口不成熟

akcms_search.php

搜索接口

keywords，關(guān)鍵詞

category，欄目id

page，頁(yè)面ID