焦点CMS用户手册.doc

焦点CMS 用户手册Version 0.2, 2008-11-18目录焦点CMS 用户手册1第一章 系统组成1第二章 内容管理12.1 我的频道12.1.1 浏览首页22.2 页面及碎片管理22.2.1 页面及碎片组成22.2.2 页面管理32.2.3碎片编辑42.3 碎片可视化编辑62.3.1 可视化修改72.3.2 代码修改102.3.3 修改记录10第三章 模板管理113.1 元素命名规范113.2 模板书写规范113.3 CSS书写规范13第四章 用户管理134.1 权限管理13第一章 系统组成焦点CMS主要由三大部分组成：1. 内容管理：包括页面各站点下页面、碎片和专题的管理等；2. 模板管理：页面，专题模板等的管理；3. 权限管理：用户及其所拥有权限的管理；第二章 内容管理2.1 我的频道在我的频道页面上列出来的各个站点首页是当前用户可操作和管理的，是由用户的权限来决定的，点击任一站点（如成都）可进入站点维护界面。我的频道显示结果如图所示：2.1.1 浏览首页浏览首页的操作如下：1. 用户登录passport，焦点CMS没有单独的二级域名，而是在各站点下（包括写字楼office, 别墅villa, 商铺shop, 博客blog），例如，成都站下的CMS首页为： /cms/index.php2. 点击页面左侧“我的频道”，显示我的频道首页。3. 点击站点名（如成都），进入站点管理页面。左侧是以树状形式显示的我当前可以编辑的所有频道，右侧显示的是我在该频道下可管理的所有页面的列表。2.2 页面及碎片管理2.2.1 页面及碎片组成模板页面主要由碎片组成，碎片有三种类型：1. 静态碎片：纯HTML代码，手动更新和发布，可以可视化编辑；2. 定时更新碎片：动态代码（可包含其它静态碎片），每隔一段时间执行一次，不能可视化编辑，只能在管理界面下编辑。3. 即时更新碎片：动态或静态代码，手动更新和发布，不能可视化编辑，只能在管理界面下编辑。对碎片的编辑（修改或发布），需要一定的权限，用户不能直接修改碎片的权限，需进入后台管理界面（只有最高权限的用户才能进入后台管理界面）。权限管理的说明见本手册的第四章。2.2.2 页面管理进入某个频道，如成都：页面右侧以列表形式显示了当前用户可以修改的页面及操作，对其中的每个页面，各项操作的含义如下所示：n 动态页面：由碎片动态生成的最新页面，不能可视化编辑（其中碎片的最新内容不一定发布）。将此动态页面生成静态文件后就是最终用户看到的页面。n 碎片编辑：打开碎片可视化编辑页面，编辑从这里打开页面对页面中所有的静态碎片进行可视化修改和发布。n 本页面碎片：显示本页面所包含的所有碎片及对碎片的操作，如下图所示：n 修改：修改本页面的一些信息：其中的线上页面就是指的动态页面的地址，编辑页面即可视化编辑的页面地址。n 添加新碎片：在本页面下添加新碎片：其中， 碎片类型：为上面讲的三种类型之一。 碎片权限： 设定拥有修改碎片的权限，请小心设置，不提供权限的修改。 页面更新间隔：如果碎片类型为定时执行，必须指定一个时间。 碎片最低字节：此字段0表示不检测碎片大下，如果此字段不为0，在发布时程序会检测实际碎片是否大于设定值，建议合理使用此状态值。 静态碎片行数：主要提供给静态碎片，用于动态计算碎片是否存在，判断动态碎片读取的条数。类似首页的热点新闻头条为2行，当此碎片为空时，下面的动态程序显示条数增加两条。需要注意的是，添加了碎片，此碎片不会出现在动态页面及可视化编辑页面中，需要用户手动添加到这两个页面中。其中：- 动态页面（线上页面）引用的方法为：include($_SERVERDOCUMENT_ROOT . /cmspublish/html/cd/0/14_40.php)- 可视化编辑页面引用的方法为：include($_SERVERDOCUMENT_ROOT . /cms/cmsedit/cd/0/14_40.php)n 添加已有碎片：将其它页面的碎片添加到本页面中。2.2.3碎片编辑 碎片编辑页面在频道页面，点击页面列表中某个页面的“本页面碎片”，在打开的页面中，对某个碎片，点击“选择”，进入碎片编辑页面：其中的大部分项的解释见前面“添加碎片”，其它项的说明如下：n 选择动态模板：提供一些已存在的php程序供选用，注意，这里，碎片不能是静态的。n 管理关联碎片：即添加和修改与此碎片联动的碎片，注意当前碎片为主动方，关联的碎片需要根据此碎片的情况被动刷新。n 碎片的修改分为“新建”和“修改”两项，与旧版的碎片编辑的新建，修改功能一致，即为往日头条提供数据。新建碎片时为往日头条数据库增加一条新的数据，而修改只修改最新一条，不新加。n 碎片的修改日志：可以回溯到某一时间的修改记录。注意php程序的回溯并不完全确保成功，静态碎片请放心使用回溯功能。 碎片内容的编写碎片内容的编写分为以下几种情况：1. php程序，如果引用的内容是common下的公用程序，请在碎片内容里使用 2. 当碎片是受其他程序关联的，请在碎片头部写入如下代码f_url) $xx = $xx - $frag_obj-f_height; ?3. 请确保每个碎片程序都可以独立执行，请在碎片编辑页面中找到编辑页面引用的方法，编辑页面引用的方法： include($_SERVERDOCUMENT_ROOT . /cms/cmsedit/cd/0/14_40.php)即得到如下字符串/cmspublish/php/cd/0/14_40.php，在浏览器地址中输入当前站的url： /cmspublish/php/cd/0/14_40.php进行测试2.3 碎片可视化编辑进入站点管理页面，在要编辑的页面行，点击“碎片编辑”，即进入碎片的可视化编辑环境进行碎片的可视化编辑页面，例如： /cms/editphp/cd_index.php?reloadworkpage=y鼠标移动到碎片处，会出现该碎片的提示信息框，其中，静态碎片的信息信息框是黄色的，定时更新碎片是红色的，即时更新碎片是蓝色的，只有静态碎片可在此页面编辑。其中，信息框中显示的碎片权限表示编辑此碎片所需的权限。点击此信息提示框，打开碎片编辑窗口：此编辑窗口有三个标签，可视化修改，代码修改及修改记录。2.3.1 可视化修改碎片的可视化修改包括行修改和链接交换二部分，打开碎片编辑窗口，默认处于行修改状态。行修改行修改是对页面中的链接进行可视化修改，进入“行修改”状态，单击碎片中的任何一个链接：n 可视化修改：修改标题和链接，会即时并可视化地反应到碎片中n 给标题加红：点击“标题”行右侧的红色小方框n 给标题加粗：点击“标题”行右侧的“B”字n 检查链接：点击“链接”行右侧的符号n 删除链接：点击“链接”行右侧的减号n 在此链接后面新增链接：点击“链接”行右侧的加号，新增链接默认的标题是focus，默认链接是对碎片修改完后，如果直接点按钮“取消”或点击右侧的关闭按钮，碎片会恢复没有修改的样子，所做的修改也不会被保存或发布。如果一个下有多个链接，点击任一链接，会同时编辑包含此链接的下的所有链接：这个例子中的三个链接都包含在一个下，所有，当点击第一个链接时，可同时编辑三个链接，每个链接的“文字”行表示此链接前的文字，它不包含在任何链接中。如果要删除此文字，需要单独点击右侧的减号。修改完碎片，就可点击窗口下端的按钮保存、新建和发布碎片（如果没有权限保存或发布碎片，会给出提示，碎片不会做任何修改，如果用户有权限，操作时却提示没有权限，可能是用户没有登录的原因）。n 保存碎片：将碎片保存到数据库和文件中，但不会发布。n 新建碎片：与保存碎片的区别在，新建碎片时为往日头条数据库增加一条新的数据，而保存碎片只修改最新一条往日头条，不新加。n 发布碎片：请注意，发布碎片前一定要先保存或新建碎片。编辑碎片时，需要注意的是，要删除碎片中的某个，不要在可视化编辑区域中将链接或标题清空，而应该点击可视化编辑窗口的链接行右侧的减号，如下图所示：而要删除前的文字，则同时点击可视化编辑窗口的文字行右侧的减号。链接交换在“可视化修改”标签内，点击右侧的红色按钮“交换状态”：此时，单击要交换的第一个链接，此链接会加上红色的背景：再单击第二个要交换的链接，2个链接就交换了操作结束，同样可点击下面的按钮进行保存、新建或发布碎片。2.3.2 代码修改在碎片编辑窗口，点击“代码修改”标签：编辑框中的内容为碎片的HTML代码，手动修改此代码，点击下面的按钮，就可对碎片进行保存、新建或发布，在保存或新建后，修改后的内容就可反应到碎片中。2.3.3 修改记录在碎片编辑窗口，点击“修改记录”标签（没有保存碎片权限，则不能查看修改记录）：对每次修改记录，可进行回溯。回溯操作会先给出提示，确认后再执行回溯。第三章 模板管理静态页面模板由编辑提供，为了对模板的内容进行标准化，减少不必要的错误，特制定关于模板的规范，包括元素命名规范、HTML书写规范和CSS书写规范。3.1 元素命名规范技术人员定义了以下ID和class，编辑们不可使用：n id或name为cms_template_frag, focus_frag_block；n id（或name，class）以fragEditor或frag_editor或frag-editor开头；n class 为dlg-window, dlg-header, dlg-header-title, dlg-controls, dlg-close, dlg-minimize, dlg-content；n 同时，技术人员定义了以下JavaScript变量，编辑如果用JavaScript，不要使用以下全局变量：n gLogger, gCms, gZIndex, FocusCms3.2 模板书写规范对整个模板文件：n 模板的HTML代码必须符合XHTML规范，验证网址：/常见的要求如：标签闭合，标签小写，元素的ID唯一，另外，尽量使用class，而不是ID，n 模板必须兼容IE6,IE7,FireFox2, FireFox3n 模板文件中只可以包含一个css文件，如规划出公用css文件，请在当前页面的css中引用n 模板文件中不允许包含style等样式标签，必须都写在css中n 模板文件中包含的图片必须是绝对路径，并合理使用背景图，减少不必要的图片n 模板文件中应以div，ul，li布局，不能使用table，tr，td等标签n 模板文件中尽量简洁，减少不必要的嵌套n 不要使用元素，请使用其它方法居中对单个静态碎片：n 碎片所有内容包含在一个顶层的div内（此div可定义样式等）：如碎片内容如果碎片中有浮动元素(假设称为inner div)，而这些浮动元素的父结点(称为outer div)不是浮动元素(non float)，父元素结点将没有高度，有两种解决方案：1. 方法一：在浮动元素后面加上包含样式clear:both的元素，通用的解决方法为：样式.clearfix:after content: .; display:block; height:0px; clear:both; visibility:hidden;.clearfix display:inline-block; /* Hide from IE-Mac */* html .clearfix height:1%; .clearfix display:block; 代码 float层1float层2 2. 方法二：不需要额外加一个DOM结点，而直接在父结点加上样式：.outer-non-float overflow: auto; _overflow: visible; _overflow-x: hidden; _height: 0;即： float层1 float层2 由于方法1使页面中增加很多不必要的DOM元素，所以推荐使用方法2。n 一行最多只出现一个；一行中，如果有多个，则将其写在一个内，且元素的外层或内层不要再嵌套其它元素(如)，一个正确的书写例子如下所示： 专家称北京房价暴利程度非 常高 降价说是忽悠 |广州最高价豪宅6万每平米 专家称不算贵(图) |郑州政府埋单促销售 上海政府购楼方式保住房这样，打开编辑窗口后，单击一行的任何一个链接，都可对本行的所有链接一起编辑n 不要有