MLECMS/資源下載模塊相關數(shù)據(jù)調用方法及技巧

軟件下載調用無論是單個數(shù)據(jù)還是多個數(shù)據(jù)列表均使用 {:download::data():} 的方法調用。調用指定ID（一條記錄）時返回一維數(shù)組，其它方法均返回一個二維數(shù)組。

調用方法：

{:download::data():}

相關參數(shù)： 共有 15 個可選參數(shù)，依次為：

1. 排序，對調用的數(shù)據(jù)進行排序：0按自定義字段降序優(yōu)先，其次按發(fā)布日期降序、1發(fā)布日期降序、2發(fā)布日期升序、3資源ID降序、4資源ID升序、5點擊次數(shù)降序、6點擊次數(shù)升序、7評論人數(shù)降序、8評論人數(shù)升序、9下載次數(shù)降序、10下載次數(shù)升序。缺省值為 0
2. 調用記錄數(shù)，分頁時為每頁要顯示的數(shù)量，不分頁時為調用的總記錄數(shù)。缺省值為 10
3. 是否推薦：0調用全部、1只調用推薦、2調用非推薦。缺省值為 0
4. 頻道ID，0為所有頻道下的數(shù)據(jù)。缺省值為 0
5. 欄目ID，含指定ID下的子分類，0為所有欄目下的數(shù)據(jù)。缺省值為 0
6. 調用的資源ID，為0時沒有限制，其它數(shù)字為要調用的ID。調用單個資源時只有標題截?。ǖ?、8個）參數(shù)有效，將忽略其它參數(shù)。指定ID時返回一維數(shù)組。缺省值為 0
7. 對完整標題字段截取長度，0不截取，顯示完整標題。其它數(shù)字為標題截取長度。截取后的標題使用 array['title_format'] 調用，title 始終為未格式化的完整標題。缺省值為 0
8. 當標題被截取時顯示的省略符號。缺省值為 "..."
9. 從第幾條記錄開始調用，分頁時該參數(shù)無效，分頁會根據(jù) $_GET['page'] 來判定起始數(shù)。缺省值為 0
10. 是否分頁，0不分頁，1分頁，缺省值為 0
11. 下載權限：0調用全部、1調用有下載限制的資源、2調用沒有下載限制的資源。缺省值為 0
12. 購買下載：0調用全部、1調用購買下載的資源(需要使用積分或金錢購買后下載的資源)、2調用非出售的資源。缺省值為 0
13. 數(shù)字頁碼范圍，數(shù)碼分頁時當前頁前后顯示多少頁碼。缺省值為 5
14. 是否調用上一篇、下一篇數(shù)據(jù)，0不調用、1調用，為1時將返回一個三個元素的多維數(shù)組：['prev']、['current'] 和 ['next']。對于調用指定ID單條數(shù)據(jù)時有效(即第6個參數(shù)大于0)。缺省值為 0
15. 是否只調用帶有圖片的資源，0調用全部、1只調用含有圖片的資源。缺省值為 0

調用實例：

• 調用ID為 12 的下載資源：

{:$d2 = download::data(0,1,0,0,0,12):}
{:$d2['content']:}

• 調用最新發(fā)布的 5 個下載資源：

{:download::data(1,5):}

• 調用當前頻道下的10個下載資源并循環(huán)：

{:foreach download::data(0,10,0,$mle['channel_id'],0,0,0,0,0,0,0,0,0,0) as $d:}
    <a href="{:$d['URL']:}">{:$d['title']:}</a>

    <!--
    這里還可以使用的其它的變量，如：
    格式化后的下載資源標題(被截取字符、添加字體顏色、字體加粗等屬性)：{:$d['title_format']:}
    轉成數(shù)組后的圖片地址：{:$d['picture'][n]:}
    下載資源發(fā)布日期：{:$d['addtime']:}
    下載資源所屬頻道ID：{:$d['channel_id']:}
    下載資源所屬頻道名稱：{:$d['channel']:}
    下載資源所屬欄目路徑：{:$d['category_id']:}
    下載資源所屬最底層欄目名稱：{:$d['category']:}

    ......

    其它更多參數(shù)見后臺"添加下載資源"中的調用備注。
    -->
{:/foreach:}

列表分頁數(shù)據(jù)調用：

如果使用了分頁(第10個參數(shù)為1時)，將在模板中可以使用以下變量調用分頁數(shù)據(jù)：

1. 數(shù)據(jù)總記錄數(shù)：{:$page_data['total']:}
2. 當前頁碼：{:$page_data['page']:}
3. 每頁要顯示的記錄數(shù)：{:$page_data['limit']:}
4. 總頁數(shù)：{:$page_data['total_page']:}
5. 第一頁鏈接URL：{:$page_data['start_url']:}
6. 上一頁鏈接URL：{:$page_data['first_url']:}
7. 下一頁鏈接URL：{:$page_data['next_url']:}
8. 尾頁鏈接URL：{:$page_data['end_url']:}
9. 已計算好的頁碼數(shù)組(一個以頁碼為鍵名的數(shù)組，值為鏈接URL)：{:$page_data['number']:}

其它相關參數(shù)調用：

1. 當前下載資源所屬頻道ID(頻道首頁、欄目列表頁、下載資源內頁模板中均有效)：{:$mle['channel_id']:}
2. 當前下載資源所屬頻道名稱(頻道首頁、欄目列表頁、下載資源內頁模板中均有效)：{:$mle['channel_title']:}

在下載資源內頁模板中有增加以下變量可以調用：

1. 當前下載資源所屬一級類別ID：{:$d['category_split']['root_id']:}
2. 當前下載資源所屬最低級類別ID：{:$d['category_split']['end_id']:}
3. 當前下載資源所屬最低級類別名稱：{:$d['category_split']['end_name']:}
4. 當前下載資源上一資源數(shù)據(jù)：{:$d['data_prev'][]:}
5. 當前下載資源下一資源數(shù)據(jù)：{:$d['data_next'][]:}

下載內頁(down.tpl)資源下載地址的調用：

{:$d['format_url']:} 被合并本地下載和鏡像下載地址和名稱的一個多維數(shù)組

該數(shù)組中返回當前資源中所有下載地址和名稱，如：

{:$d['format_url'][n][0]:}：下載名稱 (新浪下載)
{:$d['format_url'][n][1]:}：文件URL (http://www.sina.com.cn/aaa.rar)
{:$d['format_url'][n][2]:}：下載鏈接URL (down.php?id=1&do=0)

實例：循環(huán)調用當前資源下載地址：

{:foreach $d['format_url'] as $dd:}
<a href="{:$dd[2]:}" target="_blank">{:$dd[0]:}</a> 
{:/foreach:}

其它：下載資源內頁中的基本字段數(shù)據(jù)調用見后臺"添加下載資源"中的備注。

參考來源

• http://www.mlecms.com/tech/61.html

MLECMS使用手冊導航
MLECMS安裝： 安裝 MLECMS使用： 頻道和導航欄數(shù)據(jù)調用|欄目分類數(shù)據(jù)調用|資源下載模塊數(shù)據(jù)調用|圖片集模塊數(shù)據(jù)調用|商品(產品)模塊數(shù)據(jù)調用|文章內容模塊數(shù)據(jù)調用|廣告模塊數(shù)據(jù)調用