编辑“CMSware外部投稿”

<span style="border:1px solid #000; float:right; text-align:center; padding:6px;"><strong>导航：</strong>[[CMSware会员系统及外部投稿|返回上一页]]</span>
<div style="clear:both;"></div>
外部投稿功能允许匿名用户通过该接口向[[网站]]允许投稿的栏目投稿。一个栏目是否允许投稿我们已在该栏目的结点设置－稿件工作流套用设定过。设定为投稿即发布时提交以后不会有返回值，即返回为空白页。

'''界面示例：'''
<div>
[[Image:cmsware135.png]]
</div>
'''说明'''

(1)前台接口
<pre>
{PUBLISH_URL}/contribution.php?参数1=X&参数2=Y&参数3=Z
</pre>
可用参数：
#TableID：内容模型ID，用于定位投稿录入界面模版（新闻投稿、软件下载投稿的录入界面都是不同的）
#TargetNodeID：投稿目标结点ID
#Tpl：指定投稿所用的模版名称，模版名称需要以“.html”做后缀。比如现在使用{templates}/plugins/contribution 下的test.html模版，参数就是Tpl=test.html，当然，系统支持参数中省略掉.html类型的模版的后缀名（其它类型的模版文件不可省略），即Tpl=test.html可以这样写：Tpl=test
#o：o=do即提交投稿

'''功能定义'''：

显示投稿界面： 
<pre>
contribution.php?TableID=?
</pre>
提交投稿数据：
GET：
<pre>
contribution.php?o=do&TableID=?&TargetNodeID=?
</pre>
POST：实际投稿数据，表单输入字段名格式为“data_内容模型字段名”，比如“Title”和“Content”字段的表单输入字段名为 “data_Title”、“data_Content”

使用举例：

使用test.html作为新闻模型的投稿录入[[模版]]：
<pre>
contribution.php?TableID=1&Tpl=test.html
</pre>
也可以简写为
<pre>
contribution.php?TableID=1&Tpl=test
</pre>
使用新闻模型的默认自定义模版：contribution.php?TableID=1

(2)模版定义
:*模版目录位于：{templates}/plugins/contribution
:*default.html ：默认模版，当内容模型自定义模版不存在时，使用该模版
:*error.html ：默认投稿成功以后的返回页面，你可以修改这个模版设置自己的返回页面
:*contribution_{TableID}.html ：内容模型默认自定义模版，{TableID}为内容模型TableID

比如我们在{templates}/plugins/contribution下定义一个contribution_1.html，新闻模型投稿默认使用

系统使用模版的优先顺序：自定义模版（Tpl），内容模型自定义模版（contribution_{TableID}.html），默认模版（default.html）

(3)模版制作

简单的讲，我们要把一个做好的[[html]]表单修改成一个投稿模版要做以下几件事情：加form，选结点，改name，添ID，留主体

1.加form即我们先用一个form把要提交的表单用一个form包起来
<pre>
<form name="form1" method="post" action="[$PUBLISH_URL]contribution.php?o=do&TableID=2">
要提交的表单
</form>
</pre>
2.选结点就是要指定投稿到哪个结点。注意：我们必须保证所指定的结点是允许投稿的，

如下是指定投稿到结点ID为12的结点
<pre>
<input type="hidden" name="TargetNodeID" value = "12">
</pre>
如下是显示允许投稿的结点列表供我们选择
<pre>
<select name="TargetNodeID" id = "TargetNodeID">
<loop $NODE_LIST var=var>
<if $var.WorkFlow != 0 && $var.TableID == $TableID >
<option value="[$var.NodeID]">[@str_repeat('&nbsp;&nbsp;&nbsp;&nbsp;', $var.cHeader)] - &nbsp;[$var.Name]</option>
</if>
</loop></select>
</pre>

3.改name

必须把表单中的各类类似
<pre>
<td><input name="areacode"  type="text" size="10">
<input name="phone" type="text" size="20"></td>
</pre>
这里的name部分值前全部加上data_，这是一个强制的系统约定，不可更改。也就是在模版中这部分的代码必须改为
<pre>
<td><input name="data_areacode" type="text" size="10">
<input name="data_phone" type="text" size="20"></td>
</pre>

4.添ID.所有的提交项除了name以外还必须有一个和name一样的ID，这是系统的强制约定。我们上面的这段代码
<pre>
<td><input name="data_areacode"  type="text" size="10">
<input name="data_phone" type="text" size="20"></td>
</pre>
在最终模版中应该是如下这样的：
<pre>
<td><input name="data_areacode" id="data_areacode" type="text" size="10">
<input name="data_phone" id="data_areacode" type="text" size="20"></td>
</pre>

5.留主体。html页面中除了上述部分需要修改以外，其余部分原样保留，不需要变动什么

下面给出一个完整的例子：

比如我们做好了如下的一个静态页面提交表单， 要将其改为投稿模版，其代码为
<pre>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr>
<td align="center"><table width="520" border="0" cellpadding="1" cellspacing="1">
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18"> 　姓名：</td>
<td><input name="name" size="30"></td>
</tr>
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18">　性别：</td>
<td><select name="sex">
<option value="先生" selected>先生</option>
<option value="女士">女士</option>
</select></td>
</tr>
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18">　电话：</td>
<td><input name="areacode" type="text" size="10">
-
<input name="phone" type="text" size="20"></td>
</tr>
<tr>
<td align="right"></td>
<td bgcolor="#C6EFCF" class="l18">　手机：</td>
<td><input name="mobile" type="text" size="30"></td>
</tr>
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18"><span class="e18">　Email</span>：</td>
<td><input name="email" type="text" size="30"></td>
</tr>
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18">　所在地区：</td>
<td>
<select name="area">
<option value="北京" selected>北京</option>
<option value="上海">上海 </option>
<option value="天津">天津 </option>
<option value="重庆">重庆 </option>
<option value="黑龙江">黑龙江 </option>
<option value="吉林">吉林 </option>
<option value="辽宁">辽宁 </option>
<option value="河北">河北 </option>
<option value="山东">山东 </option>
<option value="山西">山西 </option>
<option value="河南">河南 </option>
<option value="陕西">陕西 </option>
<option value="青海">青海 </option>
<option value="宁夏">宁夏 </option>
<option value="西藏">西藏 </option>
<option value="新疆">新疆 </option>
<option value="内蒙古">内蒙古 </option>
<option value="四川">四川 </option>
<option value="云南">云南 </option>
<option value="广东">广东 </option>
<option value="广西">广西 </option>
<option value="海南">海南 </option>
<option value="湖南">湖南 </option>
<option value="湖北">湖北 </option>
<option value="江西">江西 </option>
<option value="安徽">安徽 </option>
<option value="江苏">江苏 </option>
<option value="浙江">浙江 </option>
<option value="福建">福建 </option>
<option value="甘肃">甘肃 </option>
<option value="贵州">贵州</option>
<option value="海外地区">海外地区</option>
</select>
<input name="region" type="text" size="15">
市/区</td>
</tr>

<tr>
<td align="right">&nbsp;</td>
<td bgcolor="#C6EFCF" class="l18">　通讯地址：</td>
<td><input name="address" type="text" size="30"></td>
</tr>
<tr>
<td align="right">&nbsp;</td>
<td bgcolor="#C6EFCF" class="l18">　邮政编码：</td>
<td><input name="postcode" type="text" size="30"></td>
</tr>
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18">　留言类型：</td>
<td>
<select name="type">
<option value="咨询" selected>咨询</option>
<option value="投诉">投诉</option>
<option value="意见或建议">意见或建议</option>
<option value="其它">其它</option>
</select>
</td>
</tr>
<tr>
<td align="right" valign="top"><font color="#f74d00">*</font></td>
<td valign="top" bgcolor="#C6EFCF" class="l18">　留言内容：</td>
<td><textarea name="content" cols="40" rows="5"></textarea></td>
</tr>
</table>
<table width="520" border="0" cellspacing="1" cellpadding="1">
<tr>
<td class="l18"><font color="#f84c02">您是否需要获得公司的新品信息或市场营销活动信息？</font></td>
</tr>
<tr>
<td>&nbsp;</td>
<td class="l18"><input type="radio" name="sendmail" value="y" checked>
请通过电子邮件发送给我新品信息或市场营销活动信息</td>
</tr>
<tr>
<td>&nbsp;</td>
<td class="l18"><input type="radio" name="sendmail" value="n">
请不要使用该资料向我发送新品信息或市场营销活动信息</td>
</tr>
</table>
<br>
<table width="100%" border="0" align="center" cellpadding="0" cellspacing="0">
<tr>
<td width="201" bgcolor="#e5e5e5">&nbsp;</td>
<td width="89">
<input name="submit" type="submit" value="提交" width="89" height="28" border="0" onclick="return checkform();"></td>
<td width="95">
<input name="clean" width="95" height="28" border="0" type="reset" value="重填" onclick="document.form1.reset();return false;"></td>
<td bgcolor="#e5e5e5">&nbsp;</td>
</tr>
</table></td>
<td width="1" bgcolor="#B5B5B5"><img src="0.gif" width="1" height="1"></td>
</tr>
</table>
</pre>
我们将其修改为如下的投稿模版：
<pre>
<form name="form1" method="post" action="[$PUBLISH_URL]contribution.php?o=do&TableID=2">
<input type="hidden" name="TargetNodeID" value = "12"> 
</pre>
<pre>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr>
<td align="center"><table width="520" border="0" cellpadding="1" cellspacing="1">
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18"> 　姓名：</td>
<td><input name="data_name" id="data_name" size="30"></td>
</tr>
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18">　性别：</td>
<td><select name="data_sex" id="data_sex">
<option value="先生" selected>先生</option>
<option value="女士">女士</option>
</select></td>
</tr>
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18">　电话：</td>
<td><input name="data_areacode" id="data_areacode" type="text" size="10">
-
<input name="data_phone" id="data_areacode" type="text" size="20"></td>
</tr>
<tr>
<td align="right"></td>
<td bgcolor="#C6EFCF" class="l18">　手机：</td>
<td><input name="data_mobile" id="data_areacode" type="text" size="30"></td>
</tr>
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18"><span class="e18">　Email</span>：</td>
<td><input name="data_email" id="data_areacode" type="text" size="30"></td>
</tr>
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18">　所在地区：</td>
<td>
<select name="data_area" id="data_areacode">
<option value="北京" selected>北京</option>
<option value="上海">上海 </option>
<option value="天津">天津 </option>
<option value="重庆">重庆 </option>
<option value="黑龙江">黑龙江 </option>
<option value="吉林">吉林 </option>
<option value="辽宁">辽宁 </option>
<option value="河北">河北 </option>
<option value="山东">山东 </option>
<option value="山西">山西 </option>
<option value="河南">河南 </option>
<option value="陕西">陕西 </option>
<option value="青海">青海 </option>
<option value="宁夏">宁夏 </option>
<option value="西藏">西藏 </option>
<option value="新疆">新疆 </option>
<option value="内蒙古">内蒙古 </option>
<option value="四川">四川 </option>
<option value="云南">云南 </option>
<option value="广东">广东 </option>
<option value="广西">广西 </option>
<option value="海南">海南 </option>
<option value="湖南">湖南 </option>
<option value="湖北">湖北 </option>
<option value="江西">江西 </option>
<option value="安徽">安徽 </option>
<option value="江苏">江苏 </option>
<option value="浙江">浙江 </option>
<option value="福建">福建 </option>
<option value="甘肃">甘肃 </option>
<option value="贵州">贵州</option>
<option value="海外地区">海外地区</option>
</select>
<input name="data_region" id="data_areacode" type="text" size="15">
市/区</td>
</tr>

<tr>
<td align="right">&nbsp;</td>
<td bgcolor="#C6EFCF" class="l18">　通讯地址：</td>
<td><input name="data_address" id="data_address" type="text" size="30"></td>
</tr>
<tr>
<td align="right">&nbsp;</td>
<td bgcolor="#C6EFCF" class="l18">　邮政编码：</td>
<td><input name="data_postcode" id="data_postcode" type="text" size="30"></td>
</tr>
<tr>
<td align="right"><font color="#f74d00">*</font></td>
<td bgcolor="#C6EFCF" class="l18">　留言类型：</td>
<td>
<select name="data_type" id="data_type">
<option value="咨询" selected>咨询</option>
<option value="投诉">投诉</option>
<option value="意见或建议">意见或建议</option>
<option value="其它">其它</option>
</select>
</td>
</tr>
<tr>
<td align="right" valign="top"><font color="#f74d00">*</font></td>
<td valign="top" bgcolor="#C6EFCF" class="l18">　留言内容：</td>
<td><textarea name="data_content" id="data_content" cols="40" rows="5"></textarea></td>
</tr>
</table>
<table width="520" border="0" cellspacing="1" cellpadding="1">
<tr>
<td class="l18"><font color="#f84c02">您是否需要获得公司的新品信息或市场营销活动信息？</font></td>
</tr>
<tr>
<td>&nbsp;</td>
<td class="l18"><input type="radio" name="data_sendmail" id="data_sendmail" value="y" checked>
请通过电子邮件发送给我新品信息或市场营销活动信息</td>
</tr>
<tr>
<td>&nbsp;</td>
<td class="l18"><input type="radio" name="data_sendmail" id="data_sendmail" value="n">
请不要使用该资料向我发送新品信息或市场营销活动信息</td>
</tr>
</table>
<br>
<table width="100%" border="0" align="center" cellpadding="0" cellspacing="0">
<tr>
<td width="201" bgcolor="#e5e5e5">&nbsp;</td>
<td width="89">
<input name="data_submit" id="data_submit" type="submit" value="提交" width="89" height="28" border="0" onclick="return checkform();"></td>
<td width="95">
<input name="data_clean" id="data_clean" width="95" height="28" border="0" type="reset" value="重填" onclick="document.form1.reset();return 
false;"></td>
<td bgcolor="#e5e5e5">&nbsp;</td>
</tr>
</table></td>
<td width="1" bgcolor="#B5B5B5"><img src="0.gif" width="1" height="1"></td>
</tr>
</table>
</pre>
<pre>
</form>
</pre>
表单效果示例： 
<div>
[[Image:cmsware136.jpg]]
</div>



==参考来源==
*[http://www.lonmo.com/cmsware/manual/ 参考来源]


[[category:CMSware]]