【phpcms-v9】前台content模块中pc标签的调用说明

痛定思痛。 2022-06-06 05:10 169阅读 0赞

http://blog.csdn.net/yanhui\_wei/article/details/7927387

\[html\]  [view plain][]  [copy][view plain]

1.  内容模块PC标签调用说明  
2.    
3.  模块名：content  
4.    
5.  模块提供的可用操作  
6.    
7.      操作名         说明  
8.        
9.      lists           内容数据列表   
10.     relation        内容相关文章   
11.     hits            内容数据点击排行榜   
12.     category        内容栏目列表   
13.     position        内容推荐位列表   
14.   
15.   
16. \--------------------------------------------------------------------------------  
17.   
18. 内容推荐位列表（position）：  
19.   
20. 可用参数：  
21.   
22.     参数名     是否必须        默认值     说明  
23.       
24.     posid       是       null        推荐位ID   
25.     catid       否       null        调用栏目ID   
26.     thumb       否       0           是否仅必须缩略图   
27.     order       否       null        排序类型   
28.     num         是       null        数据调用数量   
29.   
30.   
31. 代码例子：  
32.   
33.     \{pc:content  action="position" posid="2" order="listorder DESC" num="4"\}  
34.   
35.     **<****ul****>**  
36.   
37.         \{loop $data $key $val\}  
38.   
39.         **<****li****>** **<****a** href="\{$val\['url'\]\}"**>**\{$val\['title'\]\}**</****a****>****</****li****>**  
40.   
41.         \{/loop\}  
42.   
43.     **</****ul****>**  
44.   
45.     \{/pc\}  
46.   
47. 返回参数如下表：  
48.   
49.     字段      类型      空   默认      注释   
50.     title       char(80)    否   NULL        推荐位标题   
51.     url         char        否   NULL        推荐位链接地址   
52.     inputtime   int(10)     否   NULL        推荐位发布时间   
53.     thumb       char        是   NULL        推荐位缩略图   
54.     其他          不定      是   根据模型所设置的加入到推荐位中字段名称   
55.   
56.    
57.   
58.   
59. \--------------------------------------------------------------------------------  
60.   
61. 内容列表（lists）：  
62.   
63. 可用参数：  
64.   
65.     参数名     是否必须            默认值     说明  
66.       
67.     catid       否           null        调用栏目ID ,此参数必不可少，因为要根据此函数的值来设置模型、选择模型数据表  
68.     where       否           null        sql语句的where部分   
69.     thumb       否           0       是否仅必须缩略图   
70.     order       否           null        排序类型   
71.     num         是           null        数据调用数量   
72.     moreinfo    否           0       是否调用副表数据   
73.   
74. 也可以自定义多个参数名，如：aa、bb、cc，这些参数的值都可以再lists方法中通过$data\['aa'\]、$data\['bb'\]、$data\['cc'\]来获取到参数的值，这样的话我们就可以根据  
75. 业务的需要，给pc标签添加任意多个参数作为条件用于lists方法中的流程控制，这一点个人感觉phpcms-v9做的比较灵活，非常便于二次开发  
76. 如：\{pc:content  action="lists" catid="2" aa='aa' bb='bb' c='cc' order="id DESC" num="4"\}\{/pc\}  
77.   
78.   
79. 提醒：从PHPCMS V9 Beta 20101105版本开始支持moreinfo参数属性，本参数表示在返回数据的时候，会把副表中的数据也一起返回。  
80. 一个内容模型分为2个表，一个主表一个副表，主表中一般是保存了标题、所属栏目等等短小的数据（方便用于索引），而副表则保存  
81. 了大字段的数据，如内容等数据。在模型管理中新建字段的时候，是允许你选择存入到主表还是副表的（我们推荐的是，把不重要的  
82. 信息放到副表中）。想要在列表中调取副表的数据就需要在PC标签中使用moreinfo这个属性。  
83.   
84. 代码例子：  
85.   
86.     \{pc:content  action="lists" catid="2" order="id DESC" num="4"\}  
87.   
88.     **<****ul****>**  
89.   
90.         \{loop $data $key $val\}  
91.   
92.         **<****li****>** **<****a** href="\{$val\['url'\]\}"**>**\{$val\['title'\]\}**</****a****>****</****li****>**  
93.   
94.         \{/loop\}  
95.   
96.     **</****ul****>**  
97.   
98.     \{/pc\}  
99.   
100.   
101. where用法：  
102.   
103.   
104.     \{pc:content  action="lists" catid="2" where="\`thumb\`!='' AND \`status\`=99" order="id DESC" num="4"\}  
105.   
106.     **<****ul****>**  
107.   
108.         \{loop $data $key $val\}  
109.   
110.         **<****li****>** **<****a** href="\{$val\['url'\]\}"**>**\{$val\['title'\]\}**</****a****>****</****li****>**  
111.   
112.         \{/loop\}  
113.   
114.     **</****ul****>**  
115.   
116.     \{/pc\}  
117.   
118. 返回参数如下表：  
119.   
120.     字段      类型      空       默认      注释  
121.       
122.     title       char(80)    否       NULL        推荐位标题   
123.     url         char        否       NULL        推荐位链接地址   
124.     inputtime   int(10)     否       NULL        推荐位发布时间   
125.     thumb       char        是       NULL        推荐位缩略图   
126.     其他          不定      是       其他模型字段   
127.   
128. \--------------------------------------------------------------------------------  
129.   
130. 点击排行榜（hits）：  
131.   
132. 可用参数：  
133.   
134.     参数名     是否必须            默认值     说明   
135.   
136.     catid       否           null        调用栏目ID   
137.     day         否           0       调用多少天内的排行   
138.     order       否           null        排序类型（本月排行- monthviews DESC 、本周排行 - weekviews DESC、今日排行 - dayviews DESC）   
139.     num         是           null        数据调用数量   
140.   
141. 代码例子：  
142.   
143.     \{pc:content  action="hits" catid="2" order="weekviews DESC" num="10"\}  
144.   
145.     **<****ul****>**  
146.   
147.         \{loop $data $key $val\}  
148.   
149.         **<****li****>** **<****a** href="\{$val\['url'\]\}"**>**\{$val\['title'\]\}**</****a****>****</****li****>**  
150.   
151.         \{/loop\}  
152.   
153.     **</****ul****>**  
154.   
155.     \{/pc\}  
156.   
157. 返回参数如下表：  
158.   
159.     字段      类型          空       默认      注释  
160.       
161.     title       char(80)    否       NULL        推荐位标题   
162.     url         char        否       NULL        推荐位链接地址   
163.     inputtime   int(10)     否       NULL        推荐位发布时间   
164.     thumb       char        是       NULL        推荐位缩略图   
165.     其他          不定      是       其他模型字段   
166.   
167. \--------------------------------------------------------------------------------  
168.   
169. 相关文章（relation）：  
170.   
171. 可用参数：   
172.   
173.     参数名     是否必须            默认值     说明   
174.     catid       否           null        调用栏目ID   
175.     relation    否           $relation   关联文章id   
176.     keywords    否           null        热词搜索   
177.     num         是           null        数据调用数量   
178.   
179.    
180.   
181.    
182.   
183. 代码例子：  
184.   
185.     \{pc:content action="relation" relation="$relation" catid="$catid" num="5" keywords="$rs\[keywords\]"\}  
186.       
187.          \{loop $data $r\}   
188.   
189.           **<****li****>****<****a** href="\{$r\[url\]\}" target="\_blank"**>**\{$r\[title\]\}**</****a****>****<****span****>**(\{date('Y-m-d',$r\[inputtime\])\})**</****span****>****</****li****>**   
190.            
191.          \{/loop\}   
192.     \{/pc\}  
193.   
194. 返回参数如下表：  
195.   
196.     字段          类型      空       默认      注释  
197.       
198.     title       char(80)    否       NULL        推荐位标题   
199.     url         char        否       NULL        推荐位链接地址   
200.     inputtime   int(10)     否       NULL        推荐位发布时间   
201.     thumb       char        是       NULL        推荐位缩略图   
202.     其他          不定      是       其他模型字段   
203.   
204. \--------------------------------------------------------------------------------  
205.   
206. 栏目列表（category）：  
207.   
208. 可用参数：  
209.   
210.     参数名     是否必须            默认值     说明   
211.     catid       否               0       调用该栏目下的所有栏目 ，默认0，调用一级栏目   
212.     $siteid     否               1       默认调用系统站点   
213.     order       否           null        排序方式、一般按照listorder ASC排序，即栏目的添加顺序   
214.   
215.    
216.   
217. 代码例子：  
218.   
219.     \{pc:content action="category" catid="0" num="25" siteid="$siteid" order="listorder ASC"\}  
220.   
221.         \{loop $data $r\}   
222.           
223.         **<****li****>****<****a** href="\{$r\[url\]\}"**>****<****span****>**\{$r\[catname\]\}**</****span****>****</****a****>****</****li****>**       
224.           
225.         \{/loop\}  
226.   
227.     \{/pc\}  
228.   
229. 返回参数如下表：  
230.   
231.     字段          类型          默认值     说明    
232.   
233.     catid       smallint        无       栏目ID   
234.     siteid      tinyint(3)      0       站点ID   
235.     module      varchar(15)     无       模块ID   
236.     type        tinyint(1)      1       栏目类型ID   
237.     modelid     tinyint(5)      5       模型ID   
238.     parentid    smallint(5)     5       上级父栏目   
239.     arrparentid varchar(255)    无       所有父栏目   
240.     child       tinyint(1)      0       子栏目   
241.     arrchildid  mediumtext      无       所有子栏目   
242.     catname     varchar(30)     无       栏目名称   
243.     image       varchar(100)    无       栏目图片   
244.     description mediumtext      无       栏目描述   
245.     parentdir   varchar(100)    无       父栏目目录   
246.     catdir      varchar(30)     无       栏目目录   
247.     url         varchar(100)    无       栏目链接   
248.     items       mediumint(8)    0       栏目内容数   
249.     hits        int(10)         0       点击数   
250.     setting     mediumtext      无       栏目设置   
251.     listorder   smallint(5)     0       排序   
252.     ismenu      tinyint(1)      0       是否显示   
253.     sethtml     tinyint(1)      0       是否生成到根目录   
254.     letter      varchar(30)     无       栏目拼音

[view plain]: http://blog.csdn.net/yanhui_wei/article/details/7927387#