焦点CMS 用户手册.doc

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