#### 1、公共碎片只能在此`\template\model_style\`目录下面,比如系统自带的公共碎片目录是`\template\model_style\defaul\t`,你自己的专用公共目录可以是`\template\model_style\abcd\`,其中`abcd` 换成你自己的专用标志目录,以后所有你的公共碎片都放在这个目录里边,不要反复更换目录名。 #### 2、公共碎片必须要有同名的配置文件,比如碎片模板是`abc.htm`那么配置文件是`abc.php`,配置文件如下图示列。 [![](https://img.kancloud.cn/17/b3/17b34af6848958905119ae864aac93e0_1362x640.png)](https://img.kancloud.cn/17/b3/17b34af6848958905119ae864aac93e0_1362x640.png) `type1` 如果你的碎片可以同时适应PC与WAP的话,就可以不设置,留空即可,否则就对应的设置为`pc`或`wap`,为的是不要让用户随便乱选择,导致页面变得不协调。 `type2` 如果你的碎片可以同时适应圈子与平台使用的话,就可以不设置。如果只为圈子设计的话,那么就设置参数为`hy`也即黄页的首字母,如果不给圈子使用,而是专给平台使用的话,就设置为`www`,为的是不要给圈子用户随便乱选择。另外特别要注意:如果仅只是站内引用的话,就设置为 `quote` 这样的话,就只能站内引用了,圈子与网站标签设置的时候,不管PC还是WAP都不能调用了。 `'quote'=>true,` 这一项参数设置后就代表可以站内引用。设置为`true`发布信息时允许站内引用使用此风格,不允许使用就删除或设置为`false`,若要指定频道使用的话,就设置频道的目录名,如果即要限频道又要限模型的话,就用类似这样的格式化 `cms|3` 如下图所示。注意:假如`type2` 设置为`quote` 这里也要同时设置`'quote'=>true,` 不能缺少. ![](https://img.kancloud.cn/01/a3/01a3b7b84740583bdc8230b14882c122_1235x154.png) `type3`这一项是专门给PC设置的,因为PC会涉及到窄边的情况,如下图。 `A`与`B`的我们统一定义他为宽边,因为他们的宽度大于500像素。 `C`我们定义他为窄边,因为他的宽度小于500像素。 宽边的元素互相就不会觉得不协调。如果宽边与窄边的元素互换,就会非常不协调。所以我们建议开发者在开发的时候要定义好`type3`这一项参数,以禁止用户胡乱选择,导致不协调的情况发生。 #### 大于500像素的就是宽边`big`,小于500像素的就为窄边`small` [![](https://img.kancloud.cn/64/5d/645d3fea3b579ecf910ceda8e8648838_1563x865.png)](https://img.kancloud.cn/64/5d/645d3fea3b579ecf910ceda8e8648838_1563x865.png) #### 注意事项,如果样式不多的话,就建议写在模板里边,如果样式太多的话,就单独建个.css文件。用到的相关图片与js及样式文件的话,存放目录推荐为 `\public\static\model_style\abcd\` 最后那个即你的专用目录名. #### 碎片如果要给圈子使用的话,不能使用 `qb:tag` 标签,只能使用`qb:hy`标签里边。我们推荐大家全部统一用`qb:hy`标签,用法是一样的。 #### 当前碎片不想给用户重复复制的话,可以给任何一个元素添加一个`taglabel` class类属性即可,也可以单独添加下面的代码 `<div style="display:none;" class="taglabel">目的是不给用户复制当前碎片</div>` #### 碎片可以使用多个标签,也可以使用 `include` 包含其它模板文件,但要注意路径,如下图所示 [![](https://img.kancloud.cn/24/65/2465a63f67afd1d2e79a4372c560e059_1547x665.png)](https://img.kancloud.cn/24/65/2465a63f67afd1d2e79a4372c560e059_1547x665.png) #### 另外,`DIV`等元素命名的 `ID` 及 `class` 名称尽量复杂点,建议以你的专用标志开头做前缀,以避免跟别人的有冲突。当然,最好再加一个系统变量后缀`{:input('tags')}` 比如 ~~~ <div id="abcd_top_{:input('tags')}"></div> ~~~ 系统后缀的目的是方便用户在当前页面复制你的碎片,而不会产生冲突, 不加这个后缀的话,对于幻灯片等涉及到JS特效的,复制多一个碎片出来后,会产生冲突的。 ***** #### 如何上传,先保持网站的原有目录格式打包成zip文件,只能在当前目录打包。不能跑到上级目录打包,并且只能是Zip格式化. [![](https://img.kancloud.cn/54/dc/54dc367b0c8328dd91595dc745029ef2_925x630.png)](https://img.kancloud.cn/54/dc/54dc367b0c8328dd91595dc745029ef2_925x630.png) ***** ***** [![](https://img.kancloud.cn/4f/67/4f6735885e6bd041217be0cee3bc7a93_1491x893.png)](https://img.kancloud.cn/4f/67/4f6735885e6bd041217be0cee3bc7a93_1491x893.png) ***** 注意:上传成功后,需要我们人工审核后,才能在后台应用市场看到的。