首頁版塊 · 英文版開發文檔

# 首頁版塊表結構 ``` <pre class="calibre14">``` CREATE TABLE `yf_front_forum` ( `forum_id` int(10) NOT NULL AUTO_INCREMENT, `forum_name` varchar(255) NOT NULL COMMENT '板塊名稱', `forum_order` int(10) NOT NULL COMMENT '首頁板塊順序', `forum_state` tinyint(1) NOT NULL DEFAULT 1 COMMENT '狀態1開啟2關閉', `forum_content` varchar(255) NOT NULL COMMENT '板塊內容', `forum_style` int(10) NOT NULL DEFAULT 1 COMMENT '1-長方形 2-正方形', PRIMARY KEY (`forum_id`) ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 ROW_FORMAT=COMPACT COMMENT='首頁板塊設置表'; ``` ``` 1.獲取版塊列表 ``` <pre class="calibre14">``` get:/index.php?crl=Api_Forum&met=front&typ=json <<< success {"cmd_id":-140, "status":200, "msg":"success", "data":{ "page":1, "total":1, "totalsize":"3", "records":"3", "items":[ {"forum_id":"1", //版塊id "forum_name":"店鋪代金券", //版塊名稱 "forum_order":"1", //版塊排序 "forum_state":"1", /版塊狀態 1-開啟 2-關閉 "forum_content":[ {"title":"店鋪代金券", //版塊活動名稱 "type":"voucher", //版塊活動類型 "content":["242","241","240","235"] //版塊活動內容 }], "forum_style":"1", //版塊樣式 1-長方形 2-正方形 "id":"1" }, {"forum_id":"6", "forum_name":"平臺紅包", "forum_order":"2", "forum_state":"2", "forum_content":[ {"title":"平臺紅包", "type":"redpacket", "content":["149","114","30","25"] }], "forum_style":"1", "id":"6"}, {"forum_id":"4", "forum_name":"測試2", "forum_order":"3", "forum_state":"2", "forum_content":[ {"title":"團", "type":"grouptype", "content":["293","228","171","141"] }, {"title":"限時折扣", "type":"discount", "content":["297","298","299"] }], "forum_style":"2", "id":"4" } ] } } <<< error ``` ``` 2.獲取版塊內容 ``` <pre class="calibre14">``` get:/index.php?ctl=Api_Forum&met=getForumContent&typ=json *string:id=默認值#版塊id <<< success {"cmd_id":-140, "status":200, "msg":"success", "data":{ "forum_id":"11", //版塊id "forum_name":"團購", //版塊名稱 "forum_order":"7", //版塊排序 "forum_state":"1", //版塊狀態 1-開啟 2-關閉 "forum_content":[ //版塊內容 {"title":"團購", //版塊活動名稱 "type":"groupbuy", //版塊活動類型 "content":["293","228","171","141","235","304","149"], //版塊活動內容 -- 此處為團購 "content_info":[ //版塊活動內容詳情 -- 此處為團購信息 {"groupbuy_image_rec":"http:\/\/shop.local.yuanfeng021.com\/image.php\/shop\/data\/upload\/media\/d3aabd05be45670d48e2685d1e1f5992\/10104\/51\/image\/20171024\/1508809291346874.jpg!612x318.jpg", //團購圖片 "groupbuy_name":"tz虛擬團", //團購名稱 "groupbuy_endtime":"2018-10-24 10:00:00", //團購結束時間 "groupbuy_starttime":"2017-10-24 10:00:00", //團購開始時間 "groupbuy_buyer_count":"12", //已團人數 "goods_price":"450.00" //團購價 }, {"groupbuy_image_rec":"https:\/\/shop.local.yuanfeng021.com\/image.php\/shop\/data\/upload\/media\/d3aabd05be45670d48e2685d1e1f5992\/10104\/51\/image\/20171208\/1512725526425266.jpg!612x318.jpg", "groupbuy_name":"tttttttt", "groupbuy_endtime":"2018-11-09 23:00:00", "groupbuy_starttime":"2017-12-08 18:00:00", "groupbuy_buyer_count":"4", "goods_price":"50.00"}, {"groupbuy_image_rec":"https:\/\/shop.local.yuanfeng021.com\/image.php\/shop\/data\/upload\/media\/d3aabd05be45670d48e2685d1e1f5992\/10104\/51\/image\/20180329\/1522303533136936.jpg!612x318.jpg", "groupbuy_name":"團購團購", "groupbuy_endtime":"2018-09-15 18:00:00", "groupbuy_starttime":"2018-03-29 15:00:00", "groupbuy_buyer_count":"29", "goods_price":"90.00"}, {"groupbuy_image_rec":"http:\/\/upload.local.yuanfeng021.com\/image.php\/media\/d3aabd05be45670d48e2685d1e1f5992\/10295\/82\/image\/20180823\/1534991492934718.jpg!612x318.jpg", "groupbuy_name":"供應商也可以發團購？", "groupbuy_endtime":"2018-09-19 16:00:00", "groupbuy_starttime":"2018-08-23 11:00:00", "groupbuy_buyer_count":"0", "goods_price":"12.00"} ] }], "forum_style":"1", "id":"11" } } <<< error ``` ``` 3.修改版塊內容 ``` <pre class="calibre14">``` get:/index.php?ctl=Api_Forum&met=editForum&typ=json *string:id#版塊id row:forum_connect#版塊內容 int:edit_content#修改哪塊版塊內容 1-左 2-右 forum_name#版塊名稱 int:forum_state#是否啟用 int:forum_style#版塊樣式 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` ``` <pre class="calibre14">``` 當edit_content = 1 時，edit_econtent需要傳遞鍵值為0的數組 $edit_econtent[0]['title'] = '團購'; $edit_econtent[0]['type'] = 'groupbuy'; $edit_econtent[0]['content'] = array('293','228'); 當edit_content = 2 時，edit_econtent需要傳遞鍵值為1的數組 $edit_econtent[1]['title'] = '團購'; $edit_econtent[1]['type'] = 'groupbuy'; $edit_econtent[1]['content'] = array('293','228'); ``` ``` 4.修改板塊順序 ``` <pre class="calibre14">``` get:/index.php?ctl=Api_Forum&met=setForumOrder&typ=json row:order_forum1#修改的對應板塊 row:order_forum2#修改的對應板塊 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ``` 5.添加版塊內容 ``` <pre class="calibre14">``` get:/index.php?ctl=Api_Forum&met=addFrontForum&typ=json forum_name#版塊名稱 int:forum_order#版塊排序 row:forum_content#版塊內容 int:forum_style=1#版塊樣式 1-長方形 2-正方形 <<< success {"cmd_id":-140,"status":200,"msg":"添加成功","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"最多添加9款商品","data":{}} ``` ``` ``` <pre class="calibre14">``` 版塊內容說明：當forum_style=1時，表明版塊中只有一個活動，forum_content中只有一個活動參數，舉例如下： $updata = array(); $updata[0]['title'] = '團購'; //活動名稱 $updata[0]['type'] = 'grouptype'; //活動類型 $updata[0]['content'] = array('293','228','171','141'); //活動內容 -- 此處為團購商品 forum_content= $updata; 當forum_style=2時，表明版塊中有兩個活動，forum_content中有兩個活動參數，舉例如下： $updata = array(); $updata[0]['title'] = '團購'; //活動名稱 $updata[0]['type'] = 'grouptype'; //活動類型 $updata[0]['content'] = array('293','228','171','141'); //活動內容 -- 此處為團購商品 $updata[1]['title'] = '顯示折扣'; $updata[1]['type'] = 'discount'; $updata[1]['content'] = array('297','298','299'); //活動內容 -- 此處為顯示折扣商品 forum_content= $updata; ``` ``` 6.刪除首頁版塊 ``` <pre class="calibre15">``` get:/index.php?ctl=Api_Forum&met=editForum&typ=json *string:id=默認值#說明文字 name#說明文字 <<< success {"cmd_id":-140,"status":200,"msg":"success","data":{}} <<< error {"cmd_id":-140,"status":250,"msg":"failure","data":{}} ``` ```