GpowerCMS林大模板制作手册.doc

Gpower CMS Dreamweaver插件使用手册GpowerCMS林大模板制作手册Ver 1.0作者：龙泉 版权所有(c) 信息中心 网站的表现形式为html页面，包括栏目的页面、栏目下文章的页面。这些页面的来源是企业的新闻、活动、产品、宣传的资料等，即内容。如何将企业的内容转化为丰富多彩的html页面，这就是由模板实现的。模板是包含有Gpower CMS置标的HTML文件（或其它类似的文件）。Gpower CMS 的模板负责发布后的页面显示部分，具有十分重要的作用。为了增强模板管理的方便性和提高模板的使用效率，系统支持模板嵌套，一个模板可以包含另外一个模板；但是嵌套的模板必须符合相应的标准。模板一共分为三类：1、 索引模板索引模板即为每个栏目首页的模板，它会控制栏目首页的显示风格。2、 文章模板文章模板即为栏目下文章的模板，它会控制栏目下文章页面的显示风格。3、 包含模板包含模板为被索引、文章模板所引用的模板。如网站的上边、左边、下边等通用的，每个栏目基本一样，就可拆分为包含模板，如下图所示。通过包含模板，可最大利用模板的可重用性，也使得网站改版非常方便。1.如何取一个网站文章页的静态页面。= 实例演示： （北林保卫处网站）首先打开一个文章。将其另存为 网页，全部(*.htm;*.html) 保存完后网页会以你自定义的命名方式保存HTML网页与HTML要用到的图存到相同的文件名加_files的文件夹里。如果你有这个站的静态页面，则你可以跳过以上步骤。新建一个文件夹 images ，将 欢迎来到北京林业大学保卫处网站_files 里的所有文件复制到images文件夹，再新建一个 text.htm 文件。(这样做是为了去除文件关联)再用记事本打开 欢迎来到北京林业大学保卫处网站.htm用文本替换功能将 欢迎来到北京林业大学保卫处网站_files 替换为 images去掉网页注解头：这是保存网页时留下的信息再将修改好的内容复制到 text.htm 并保存。经过如上操作，一个基本的网站文章静态样式就出来了。接下来就是制作CMS系统的模板了。2.如何将静态页面转为模板= 系统提供模板所见即所得的编辑功能(不推荐)。为了方便安全的模板的制作，特提供了Dreamweaver插件，模板支持导入导出功能。可以支持html、htm、vm、jsp、asp、zip格式的文件。双击安装插件首先我们看一下Dreamweaver的使用界面，经常使用Dreamweaver工具的人就会很清楚的看到Gpower CMS置标的位置：Gpower CMS置标向导从左到右依次为文章列表、自频道列表、路径、当前文章属性、相关新闻、相关附件、包含静态模板、包含动态模板、分页九种置标。我们用DW打开text.htm 将文章的标题改为CSM变理：再依次修改和添加：作者：$!curArticle.author 时间：$cms.format($curArticle.publishDate) 浏览次数：有显示浏览次数当然就要有一个记录次数的脚本：(写入日志)这里添加时得注意保持网页原来的字体风格。一般是将光标移至文字的中间再进行变量添加。添加变量时最好在可设计模式里，否则在再一些特殊内容如链接这些在代码模式下有可能添加不成功的。再删除原来的文章内容，改为变量$curArticle.content这样，一个文章的模板完成了3. GpowerCMS常用变量整理= 作者：龙泉 北京林业大学信息中心#foreach($article in $cms.getContents(栏目名称,10)#foreach($article in $cms.getPageContents($curChannel,$curPage)$cms.format($article.publishDate)$ 或 $curA$cms.getUrl($article)#summary($ 20)#end$cms.getUrl(栏目名称)#foreach($tmpChannel in $cms.getPathChannels($curChannel.parent)$tmpChannel.title»#end $curChannel.title$curChannel.title#foreach($tmpChannel in $cms.getPathChannels($curChannel)$tmpChannel.title»#end $curA$!curArticle.source$!curArticle.author$cms.format($curArticle.publishDate) $curArticle.content4. GpowerCMS 系统北林问题解答集= 作者：龙泉 北京林业大学信息中心Q.为什么无法显示图片水印,站点水印设置无法设置图片水印，试了GIF、JPG和PNG都不行。Q.能不能实现彩色文章列表A.这种是根据什么规则列出来的呢,有规则，CMS能实现.Q.删除一个用户后不能添加 如：admin 删除用户 feikeq 2007-09-28 09:36:51.0 成功 再点 新建 用户后系统报HTTP Status 500 -错误 再点用户组显示 出错信息提示A.原因是CMS把一些信息都load到内存中了，你在数据库里删除了，然后就不能匹配了。 须重启CMS系统的TOMCAT服务，这是一个BUG.等近期通元公司会修改.Q.如何实现栏目文章列表分页#page()？A.共$totalRows条新闻，分$totalPage页，当前第$curPage页 最前页 上一页 下一页 最后页 选中显示分页后还不显示文章列表的。 这须在CMS后台设置栏目列表- 修改栏目 -分页条数:25 即可Q.如何调用搜索A./cms/search/Q.如何获得最近更新的文章列表？而不是指定某栏目下的文章。A. #foreach($article in $cmsService.getPageDatas(from Content where siteID=$site.ID and pubFlag=1 and status=3 order by publishDate desc,1,10) #summary($ 12) #endQ.如何显示当前站点所有栏目里级别5的文章A. #foreach($article in $cmsService.getPageDatas(from Content where siteID=$site.ID and pubFlag=1 and status=3 and grade=5 order by viewcount desc,1,5) #summary($ 17) #endQ.如何在网页中调用文章或栏目标题而不须要加空格?A.文章标题：$curA 栏目名称：$curChannel.titleQ.发现文章排序有问题。A.默认按照时间排序,在栏目里面有个排序方式,需要改成sortID desc 就是按照编号排序才可以调序,栏目管理基本设置最下面有个排序方式Q.如何在引用的JS文件中调用CMS系统变量？A.最好是把JS文件转为HTML定到一个页面。Q.CMS系统后台的内容列表显示文章数目过少(10条)如何添加显示条数？A.在系统设置中设置文章列表分页条数:30。Q.另外那个文章阅读次数 可不可以自定义显示方式?例：浏览次数：0 ，而不是 阅读次数：0次A.须手工修改改一下/cms/web/count.jsp就可以 正确的调用方法 须添加日志才能记录，上面是显示代码. 栏目访问日志： 文章访问日志：Q.如何获得文章列表时该文章的浏览点击次数？ Q.如何统计网站的总访问量？和一些相关统计A.在站点管理-栏目管理里找到首页的编号，如信息中心的首面编号为17 总访问量：0 今日访问量：0 在首页中加上访问日志记录 文章数量:#set($count=$cmsService.getCount(select count(* ) from Article) $count 图片数量:#set($count1=$cmsService.getCount(select count(* ) from Attachment where type=1) $count1Q.投票列表 - 修改投票 时原来的投票选项不能显示出来。A.修改投票时，只能新增投票选项，不能对以前的做修改。这是为了确保投票的性能，做了一些处理Q.如何调用投票？A.在站点管理的投票管理里新建投票 位置:里填首页或其它你自定义的内容，调用方法 #showPlacePoll(首页)Q.如何获得AAA主栏目下BBB、CCC和DDD子栏目的文章列表显示在首页AAA那一栏里？A.将BBB、CCC和DDD子栏目设定自动分发到AAA主栏目即可。Q.如何显示一个栏目列表中文章是最近三天内的文章加一个标记？例如new图标A.使用#showNew($content) 如果是新的新闻，显示最新图标!可以自定义宏文件global.vmQ.2.如何添加热门文章列表：(列网站下点击次数超过20次的文章) 例：显示各栏目下最新的点击次数超过20次的文章5篇A. #foreach($article in $cmsService.getPageDatas(from Content where siteID=$site.ID and pubFlag=1 and status=3 order by viewCount desc,1,8) #if ($article.viewCount20) #summary($ 31) $cms.format($article.publishDate,MM/dd) #end #end Q.如何设置网站内容自动更新至FTPA.进入站点管理 自动FTP: 将此选上将自动更新至FTP FTP服务器: 直接填FTP地址无须加FTP协议 FTP端口: 21 (远程FTP的端口号) 服务器类型: Unix平台 Windows平台 服务器路径: /Q.为什么我设置好FTP，网站无法更新同步FTP？ (例：我FTP里都被我手工清掉了文件，可它就再也不同步了)A.首先清空Web服务器上该网站的所有文件。如果还是无法同步 进入CMS目录，cmsconfigure中自动生成ftp的标志文件(CMS里所有站点都在这个目录里) 标志了哪些文件被同步 哪些没有同步 你需要把site*.status是删除再完全发布(这里的*对应的是网站ID，在后台的工作台站点列表可以看到.) (这里注意千万别把其它网站的site*.status删除了，否的被删的网站无法同步),它才能再进行ftp同步 X:能不能在后台做个功能,我的意思做一个强行同步的功能 Y:那个不能删除啊 要不然以后你怎么比较哪些文章有变化了呢 你想每次都把传过去的文件删掉 然后重新ftp吗Q.删除了site*.status还是不能同步A.是因为网络十年网站在/u02/www/nic/n10而信息中心网站在/u02/www/nic里面包含了n10的目录所以在同步n10网站的FTP里没问题，当同步NIC网站的FTP时因为里面有N10的文件夹，CMS会创一个n10的文件，但由于WEB服务器上有n10这个文件夹所以创建失败，导至整理同步过程中止。(可以发现Web服务器上有些目录还没来得级创建完就中止了)另外还发现同步FTP时不能有中文名！Q.为什么文章中有summary()函数不成功的A.因为CMS系统包含一个模板宏定义 global.vm 文件 新建 包含 名称为：宏定义模板 文件名为：global.vm (包含不须要文件头) 然后重启一下服务.Q.系统管理-用户管理-角色 角色名不能为中文，否则报500错误A.去数据库中删除吧,然后正式使用时 我们把提示加上.如何定义一个角色，让他能管理当前网站的所有功能，除网站设置外(也是就是他没有站点设置权限，对这个站的其他权限都有)查看日志：/cms/logs/cms4.logQ.FTP因某个文件导致无法同步： 2008-05-23 17:26:11,722 ERROR com.gpower.util.ftp.FileSync - .ftp.FTPException: /document/20080523145119249598.chm: No such file or directory. at .ftp.FTPControlSocket.validateReply(FTPControlSocket.java:902) at .ftp.FTPClient.delete(FTPClient.java:2478) at A.原来是服务器上没有20080523145119249598.chm 这个文件，所以删除命令就失败了，新建了一个文件20080523145119249598.chm然后同步可能是文件上传了，他修改了以后，系统把旧的文件删除了，所以相应的WEB服务器上也要删除这个文件，但找不到这个文件因为要执行在WEB服务器删除那个文件的操作，结果不能执行delete操作就报错了！5. Dreamweaver插件使用手册=目录1.Dreamweaver插件的安装42.模板导入63.Dreamweaver插件的使用93.1.文章列表93.1.1.栏目103.1.2.分页显示113.1.3.输入栏目113.1.4.文章条数113.1.5.标题样式123.1.6.显示风格123.1.7.标题截取123.1.8.显示为新123.1.9.显示是否有图片123.1.10.显示是否有附件133.1.11.显示文章级别133.1.12.显示宏定义133.1.13.是否包含更多133.2.子频道列表133.2.1.栏目143.2.2.输入栏目143.2.3.是否分页143.2.4.显示风格153.2.5.是否宏定义153.3.路径置标153.3.1.路径类型163.3.2.宏定义163.4.当前文章属性163.4.1.文章属性163.4.2.扩展属性173.4.3.阅读次数183.4.4.文章打分183.4.5.发表评论183.5.相关新闻183.5.1.相关新闻标记193.5.2.是否宏定义193.6.相关附件193.6.1.相关附件标记193.6.2.是否宏定义203.7.包含静态模板203.8.包含动态模板203.9.访问日志213.10.投票223.11.分页231. Dreamweaver插件的安装通元软件为了方便广大Gpower CMS用户尽快掌握模板的制作技巧，特提供了Dreamweaver插件，为广大Dreamweaver使用者提供了条件，在使用Dreamweaver来制作模板之前，首先运行通元软件提供的GPowerCMS.mxp文件。安装Gpower CMS Extension之后，我们启动Dreamweaver，看一下Gpower CMS 置标是如何在html页面上运用自如的。2. 模板导入模板制作的过程，就是将已经存在的html静态页面，在本地用dreamweaver制作，添加上模板置标，然后导入到cms中形成模板。模板制作时，html要保证是html、images文件夹和css文件夹在同一目录，以便模板导入时图片和样式表的路径自动替换，如下图：导入过程是初次导入时，为了把样式表和图片自动上传到服务器上，需要将html、images文件夹和css文件夹一起打包成zip文件，如下图：初次导入模板时，要将css和images文件夹连同html一起打包成zip文件导入到模板管理中。这样图片和样式表会自动根据站点的本地存放路径，上传到相应目录中。添加成zip格式模板导入选择本地文件初次导入模板需要修改内容类型，以后导入无需修改这样模板就会自动上传到cms的模板管理中，以后如果图片和样式表不需要替换则无需继续导入，只导入html文件即可。转载请保留版权,更多请访问 / 北京林业大学信息中心3. Dreamweaver插件的使用首先我们看一下Dreamweaver的使用界面，经常使用Dreamweaver工具的人就会很清楚的看到Gpower CMS置标的位置：Gpower CMS置标向导从左到右依次为文章列表、自频道列表、路径、当前文章属性、相关新闻、相关附件、包含静态模板、包含动态模板、分页九种置标。3.1. 文章列表文章列表是html页面中最常见的表现形式。如图：将html页面用dreamweaver打开：在高级编辑器里，光标放在需要拆分的文章列表附近文章列表首页调用文章列表时，栏目都需手工填写生成的置标源码用户需要把生成的代码按照原html的格式替换进去。替换后的置标源码，#foreach 和 #end 在之外，调用出的文章列表就会一行一行显示。3.1.1. 栏目栏目主要分当前栏目、父栏目和手写栏目三种。l 当前栏目：是指调用此模板的栏目，为未指定栏目，即哪个栏目选用此模板即调用哪个栏目。一般用于通用模板中。而且只有选择当前栏目，栏目才可以选择分页，其他两种类型的栏目则无法选择分页。当前栏目名称的置标为$curChannel.title。l 父栏目：是指栏目的父栏目，即所在栏目树的上级栏目。父栏目名称的置标为$curChannel.parent.titlel 手写栏目：是指选择手写栏目后，用户可以在输入栏目的输入框内填入所要调用的栏目名称。3.1.2. 分页显示分页显示是指栏目的文章列表可以分上一页、下一页的显示，用户可以根据点击上一页和下一页来浏览本栏目的所有文章内容。而且文章列表中，必须指定栏目为当前栏目才可以进行分页。3.1.3. 输入栏目当栏目类型为手写栏目时，用户可以在输入框内输入所要调用的名称。3.1.4. 文章条数是指文章列表规定此栏目在页面上显示的文章的条数。系统默认为5条，根据用户需要可以进行相应修改。3.1.5. 标题样式标题演示共有三种，新闻标题时间、新闻标题和图片新闻标题的，用户可以根据自己的需要选择标题样式。3.1.6. 显示风格显示风格也分三种，是控制文章列表的显示方式，有表格样式、列表形式和换行形式三种。3.1.7. 标题截取标题截取是指用户的文章列表，有的标题过长的显示在页面上，影响了页面的风格，选用标题截取，我们可以直接在输入框内输入要截取多少个字，0为不截取，在发布出来的html页面上就会控制文章列表的显示风格，直接显示你输入的标题字数，其余的用省略号显示。3.1.8. 显示为新这里调用宏定义置标，是在模板中global.vm里面包含已定义的显示为新置标，只须选择是否调用显示为新，如果调用，就会把最新录入的文章显示标志new（图片或者文字用户可以自定义），模板中文章列表会存在相应的置标#showNew($article)3.1.9. 显示是否有图片判断文章内容中是否包含图片，如果包含，在页面显示有图标志，模板中文章列表会存在相应的置标#hasPicture($article)3.1.10. 显示是否有附件判断文章内容是否带附件，如果包含，在页面显示有附件标志，模板中文章列表会存在相应置标#attachments($article)3.1.11. 显示文章级别在内容管理中，如果文章定义级别，在页面上会显示级别标志，模板中文章列表会存在相应置标#showGrade($article)3.1.12. 显示宏定义是指整个文章列表，在宏定义里面已经定义好了，直接调用这个宏定义，即把宏定义置标显示在模板的相应位置。3.1.13. 是否包含更多是否包含更多，如果选择是，用户可以直接点击更多进入相应栏目的首页，即可以访问更多的文章的列表。3.2. 子频道列表子频道列表是指栏目的子栏目的列表，如图：新闻中心下的子栏目将html用dreamweaver打开：在高级编辑器里，光标放在需要拆分的子栏目列表附近子频道列表高级编辑器显示置标生成的置标源码用户需要把生成的代码按照原html的格式替换进去。替换后的置标源码，#foreach 和 #end 在之外，调用出的子栏目列表就会一行一行显示。3.2.1. 栏目栏目主要分当前栏目、父栏目和手写栏目三种。l 当前栏目：是指调用此模板的栏目，为未指定栏目，即哪个栏目选用此模板即调用哪个栏目。当前栏目的置标为$curChannel.title。l 父栏目：是指栏目的父栏目，即所在栏目树的上级栏目。父栏目的置标为$curChannel.parent.titlel 手写栏目：是指选择手写栏目后，用户可以在输入栏目的输入框内填入所要调用的栏目名称。3.2.2. 输入栏目当栏目类型为手写栏目时，用户可以在输入框内输入所要调用的名称。3.2.3. 是否分页如果选择分页是指栏目的子栏目列表可以分上一页、下一页的显示，用户可以根据点击上一页和下一页来浏览本栏目的所有子栏目列表。而且子频道列表中，必须指定栏目为当前栏目才可以进行分页。3.2.4. 显示风格显示风格也分三种，是控制文章列表的显示方式，有表格样式、列表形式和换行形式三种。3.2.5. 是否宏定义是指整个子频道列表，在宏定义里面已经定义好了，直接调用这个宏定义，即把宏定义置标显示在模板的相应位置。3.3. 路径置标路径置标是显示栏目或者文章所在的位置，一般为“您当前的位置：首页*”，分栏目路径和文章路径两种。路径置标3.3.1. 路径类型路径类型分栏目路径和文章路径两种，栏目路径是指栏目所在的位置，文章路径是指文章所在的位置。3.3.2. 宏定义是指栏目路径，在宏定义里面已经定义好了，直接调用这个宏定义，即把宏定义置标显示在模板的相应位置。栏目路径为#channelNav()，文章路径为#articleNav()。3.4. 当前文章属性用在文章页，显示文章基本属性的信息，如文章标题、内容、作者、来源、发布日期等，如图：相关附件文章内容作者、来源和发布日期文章标题当前文章属性3.4.1. 文章属性当前文章属性是指文章模板中调用的文章的相关属性，包括：l 文章标题（$curA）l 内容（$curArticle.content）l 摘要（$curArticle.summary）l 关键字（$curArticle.keyword）l 来源（$curArticle.source）l 作者（$curArticle.author）l 级别（$curArticle.grade）l 发布日期（年-月-日 时：分：秒$cms.format($curArticle.publishDate,yyyy-MM-dd hh:mm:ss) 年-月-日$cms.format($article.publishDate)月-日$cms.format($article.publishDate,”MM-dd”)时：分：秒$cms.format($curArticle.publishDate,hh:mm:ss)）l 价格（$curArticle.price）l 副标题（$curArticle.viceTitle）3.4.2. 扩展属性当文章属性选择扩展属性，属性名称中可以填写在Gpower CMS中自定义的内容类型列表中扩展属性中的字段名。置标写法如下：$curArticle.getProperty(time1) ，这是用于文章模板里，如果索引模板也要调用这个扩展属性，则在#foreach与#end循环之间写$article.getProperty(“time1”)即可。*注：其中time1为自己定义的字段名。3.4.3. 阅读次数应用于文章模板里，可以实时显示出文章被阅读的次数，统计出文章的受欢迎度。置标为：*注：统计文章阅读次数时必须在模板中加入文章访问日志（见3