焦點(diǎn)CMS用戶手冊(cè)

1、焦點(diǎn)CMS 用戶手冊(cè)Version 0.2, 2008-11-18目錄焦點(diǎn)CMS 用戶手冊(cè)1第一章 系統(tǒng)組成1第二章 內(nèi)容管理12.1 我的頻道12.1.1 瀏覽首頁(yè)22.2 頁(yè)面及碎片管理22.2.1 頁(yè)面及碎片組成22.2.2 頁(yè)面管理32.2.3碎片編輯42.3 碎片可視化編輯62.3.1 可視化修改72.3.2 代碼修改102.3.3 修改記錄10第三章 模板管理113.1 元素命名規(guī)范113.2 模板書寫規(guī)范113.3 CSS書寫規(guī)范13第四章 用戶管理134.1 權(quán)限管理13第一章 系統(tǒng)組成焦點(diǎn)CMS主要由三大部分組成：1. 內(nèi)容管理：包括頁(yè)面各站點(diǎn)下頁(yè)面、碎片和專題的管理等；2.

2、 模板管理：頁(yè)面，專題模板等的管理；3. 權(quán)限管理：用戶及其所擁有權(quán)限的管理；第二章 內(nèi)容管理2.1 我的頻道在我的頻道頁(yè)面上列出來(lái)的各個(gè)站點(diǎn)首頁(yè)是當(dāng)前用戶可操作和管理的，是由用戶的權(quán)限來(lái)決定的，點(diǎn)擊任一站點(diǎn)（如成都）可進(jìn)入站點(diǎn)維護(hù)界面。我的頻道顯示結(jié)果如圖所示：2.1.1 瀏覽首頁(yè)瀏覽首頁(yè)的操作如下：1. 用戶登錄passport，焦點(diǎn)CMS沒(méi)有單獨(dú)的二級(jí)域名，而是在各站點(diǎn)下（包括寫字樓office, 別墅villa, 商鋪shop, 博客blog），例如，成都站下的CMS首頁(yè)為：ü2. 點(diǎn)擊頁(yè)面左側(cè)“我的頻道”，顯示我的頻道首頁(yè)。3. 點(diǎn)擊站點(diǎn)名（如成都），進(jìn)入站點(diǎn)管理頁(yè)面。左側(cè)

3、是以樹(shù)狀形式顯示的我當(dāng)前可以編輯的所有頻道，右側(cè)顯示的是我在該頻道下可管理的所有頁(yè)面的列表。2.2 頁(yè)面及碎片管理2.2.1 頁(yè)面及碎片組成模板頁(yè)面主要由碎片組成，碎片有三種類型：1. 靜態(tài)碎片：純HTML代碼，手動(dòng)更新和發(fā)布，可以可視化編輯；2. 定時(shí)更新碎片：動(dòng)態(tài)代碼（可包含其它靜態(tài)碎片），每隔一段時(shí)間執(zhí)行一次，不能可視化編輯，只能在管理界面下編輯。3. 即時(shí)更新碎片：動(dòng)態(tài)或靜態(tài)代碼，手動(dòng)更新和發(fā)布，不能可視化編輯，只能在管理界面下編輯。對(duì)碎片的編輯（修改或發(fā)布），需要一定的權(quán)限，用戶不能直接修改碎片的權(quán)限，需進(jìn)入后臺(tái)管理界面（只有最高權(quán)限的用戶才能進(jìn)入后臺(tái)管理界面）。權(quán)限管理的說(shuō)明見(jiàn)本手

4、冊(cè)的第四章。2.2.2 頁(yè)面管理進(jìn)入某個(gè)頻道，如成都：頁(yè)面右側(cè)以列表形式顯示了當(dāng)前用戶可以修改的頁(yè)面及操作，對(duì)其中的每個(gè)頁(yè)面，各項(xiàng)操作的含義如下所示：n 動(dòng)態(tài)頁(yè)面：由碎片動(dòng)態(tài)生成的最新頁(yè)面，不能可視化編輯（其中碎片的最新內(nèi)容不一定發(fā)布）。將此動(dòng)態(tài)頁(yè)面生成靜態(tài)文件后就是最終用戶看到的頁(yè)面。n 碎片編輯：打開(kāi)碎片可視化編輯頁(yè)面，編輯從這里打開(kāi)頁(yè)面對(duì)頁(yè)面中所有的靜態(tài)碎片進(jìn)行可視化修改和發(fā)布。n 本頁(yè)面碎片：顯示本頁(yè)面所包含的所有碎片及對(duì)碎片的操作，如下圖所示：n 修改：修改本頁(yè)面的一些信息：其中的線上頁(yè)面就是指的動(dòng)態(tài)頁(yè)面的地址，編輯頁(yè)面即可視化編輯的頁(yè)面地址。n 添加新碎片：在本頁(yè)面下添加新碎片：其

5、中，ü 碎片類型：為上面講的三種類型之一。ü 碎片權(quán)限： 設(shè)定擁有修改碎片的權(quán)限，請(qǐng)小心設(shè)置，不提供權(quán)限的修改。ü  頁(yè)面更新間隔：如果碎片類型為定時(shí)執(zhí)行，必須指定一個(gè)時(shí)間。ü 碎片最低字節(jié)：此字段0表示不檢測(cè)碎片大下，如果此字段不為0，在發(fā)布時(shí)程序會(huì)檢測(cè)實(shí)際碎片是否大于設(shè)定值，建議合理使用此狀態(tài)值。ü 靜態(tài)碎片行數(shù)：主要提供給靜態(tài)碎片，用于動(dòng)態(tài)計(jì)算碎片是否存在，判斷動(dòng)態(tài)碎片讀取的條數(shù)。類似首頁(yè)的熱點(diǎn)新聞?lì)^條為2行，當(dāng)此碎片為空時(shí)，下面的動(dòng)態(tài)程序顯示條數(shù)增加兩條。需要注意的是，添加了碎片，此碎片不會(huì)出現(xiàn)在動(dòng)態(tài)頁(yè)面及可視化編輯頁(yè)面中，需

6、要用戶手動(dòng)添加到這兩個(gè)頁(yè)面中。其中：- 動(dòng)態(tài)頁(yè)面（線上頁(yè)面）引用的方法為：include($_SERVER"DOCUMENT_ROOT" . "/cmspublish/html/cd/0/14_40.php")- 可視化編輯頁(yè)面引用的方法為：include($_SERVER"DOCUMENT_ROOT" . "/cms/cmsedit/cd/0/14_40.php")n 添加已有碎片：將其它頁(yè)面的碎片添加到本頁(yè)面中。2.2.3碎片編輯2.2.3.1 碎片編輯頁(yè)面在頻道頁(yè)面，點(diǎn)擊頁(yè)面列表中某個(gè)頁(yè)面的“本頁(yè)面碎片”，在

7、打開(kāi)的頁(yè)面中，對(duì)某個(gè)碎片，點(diǎn)擊“選擇”，進(jìn)入碎片編輯頁(yè)面：其中的大部分項(xiàng)的解釋見(jiàn)前面“添加碎片”，其它項(xiàng)的說(shuō)明如下：n 選擇動(dòng)態(tài)模板：提供一些已存在的php程序供選用，注意，這里，碎片不能是靜態(tài)的。n 管理關(guān)聯(lián)碎片：即添加和修改與此碎片聯(lián)動(dòng)的碎片，注意當(dāng)前碎片為主動(dòng)方，關(guān)聯(lián)的碎片需要根據(jù)此碎片的情況被動(dòng)刷新。n 碎片的修改分為“新建”和“修改”兩項(xiàng)，與舊版的碎片編輯的新建，修改功能一致，即為往日頭條提供數(shù)據(jù)。新建碎片時(shí)為往日頭條數(shù)據(jù)庫(kù)增加一條新的數(shù)據(jù)，而修改只修改最新一條，不新加。n 碎片的修改日志：可以回溯到某一時(shí)間的修改記錄。注意php程序的回溯并不完全確保成功，靜態(tài)碎片請(qǐng)放心使用回溯功能

8、。2.2.3.2 碎片內(nèi)容的編寫碎片內(nèi)容的編寫分為以下幾種情況：1. php程序，如果引用的內(nèi)容是common下的公用程序，請(qǐng)?jiān)谒槠瑑?nèi)容里使用<?include_once($_SERVER"DOCUMENT_ROOT"."/common/modules/xxx.php");?> 2. 當(dāng)碎片是受其他程序關(guān)聯(lián)的，請(qǐng)?jiān)谒槠^部寫入如下代碼<?php include_once($_SERVER"DOCUMENT_ROOT"."/include/global.php"); $xx = xx;/當(dāng)前碎片列表

9、數(shù)的變量名及數(shù)量 $matrix_id = xx;/定義當(dāng)前碎片id $frag_sql = "select * from frag_union u ,fragment f where u.f_id_s = $matrix_id and u.f_id_m = f.f_id order by f_id desc" $frag_res = mysql_query_focus( $frag_sql, cmsdb); while($frag_obj = mysql_fetch_object($frag_res) if($DOCUMENT_ROOT.$frag_obj->f_u

10、rl) $xx = $xx - $frag_obj->f_height; ?>3. 請(qǐng)確保每個(gè)碎片程序都可以獨(dú)立執(zhí)行，請(qǐng)?jiān)谒槠庉嬳?yè)面中找到編輯頁(yè)面引用的方法，編輯頁(yè)面引用的方法：ü include($_SERVER"DOCUMENT_ROOT" . "/cms/cmsedit/cd/0/14_40.php")即得到如下字符串/cmspublish/php/cd/0/14_40.php，在瀏覽器地址中輸入當(dāng)前站的url：ü進(jìn)行測(cè)試2.3 碎片可視化編輯進(jìn)入站點(diǎn)管理頁(yè)面，在要編輯的頁(yè)面行，點(diǎn)擊“碎片編輯”，即進(jìn)入碎片的可視化

11、編輯環(huán)境進(jìn)行碎片的可視化編輯頁(yè)面，例如：ü鼠標(biāo)移動(dòng)到碎片處，會(huì)出現(xiàn)該碎片的提示信息框，其中，靜態(tài)碎片的信息信息框是黃色的，定時(shí)更新碎片是紅色的，即時(shí)更新碎片是藍(lán)色的，只有靜態(tài)碎片可在此頁(yè)面編輯。其中，信息框中顯示的碎片權(quán)限表示編輯此碎片所需的權(quán)限。點(diǎn)擊此信息提示框，打開(kāi)碎片編輯窗口：此編輯窗口有三個(gè)標(biāo)簽，可視化修改，代碼修改及修改記錄。2.3.1 可視化修改碎片的可視化修改包括行修改和鏈接交換二部分，打開(kāi)碎片編輯窗口，默認(rèn)處于行修改狀態(tài)。2.3.1.1行修改行修改是對(duì)頁(yè)面中的鏈接進(jìn)行可視化修改，進(jìn)入“行修改”狀態(tài)，單擊碎片中的任何一個(gè)鏈接：n 可視化修改：修改標(biāo)題和鏈接，會(huì)即時(shí)并可視

12、化地反應(yīng)到碎片中n 給標(biāo)題加紅：點(diǎn)擊“標(biāo)題”行右側(cè)的紅色小方框n 給標(biāo)題加粗：點(diǎn)擊“標(biāo)題”行右側(cè)的“B”字n 檢查鏈接：點(diǎn)擊“鏈接”行右側(cè)的符號(hào)n 刪除鏈接：點(diǎn)擊“鏈接”行右側(cè)的減號(hào)n 在此鏈接后面新增鏈接：點(diǎn)擊“鏈接”行右側(cè)的加號(hào)，新增鏈接默認(rèn)的標(biāo)題是focus，默認(rèn)鏈接是對(duì)碎片修改完后，如果直接點(diǎn)按鈕“取消”或點(diǎn)擊右側(cè)的關(guān)閉按鈕，碎片會(huì)恢復(fù)沒(méi)有修改的樣子，所做的修改也不會(huì)被保存或發(fā)布。如果一個(gè)<li>下有多個(gè)鏈接，點(diǎn)擊任一鏈接，會(huì)同時(shí)編輯包含此鏈接的<li>下的所有鏈接：這個(gè)例子中的三個(gè)鏈接都包含在一個(gè)<li>下，所有，當(dāng)點(diǎn)擊第一個(gè)鏈接時(shí)，可同時(shí)編輯三個(gè)

13、鏈接，每個(gè)鏈接的“文字”行表示此鏈接前的文字，它不包含在任何鏈接中。如果要?jiǎng)h除此文字，需要單獨(dú)點(diǎn)擊右側(cè)的減號(hào)。修改完碎片，就可點(diǎn)擊窗口下端的按鈕保存、新建和發(fā)布碎片（如果沒(méi)有權(quán)限保存或發(fā)布碎片，會(huì)給出提示，碎片不會(huì)做任何修改，如果用戶有權(quán)限，操作時(shí)卻提示沒(méi)有權(quán)限，可能是用戶沒(méi)有登錄的原因）。n 保存碎片：將碎片保存到數(shù)據(jù)庫(kù)和文件中，但不會(huì)發(fā)布。n 新建碎片：與保存碎片的區(qū)別在，新建碎片時(shí)為往日頭條數(shù)據(jù)庫(kù)增加一條新的數(shù)據(jù)，而保存碎片只修改最新一條往日頭條，不新加。n 發(fā)布碎片：請(qǐng)注意，發(fā)布碎片前一定要先保存或新建碎片。編輯碎片時(shí)，需要注意的是，要?jiǎng)h除碎片中的某個(gè)<a>，不要在可視化編

14、輯區(qū)域中將鏈接或標(biāo)題清空，而應(yīng)該點(diǎn)擊可視化編輯窗口的鏈接行右側(cè)的減號(hào)，如下圖所示：而要?jiǎng)h除<a>前的文字，則同時(shí)點(diǎn)擊可視化編輯窗口的文字行右側(cè)的減號(hào)。2.3.1.2鏈接交換在“可視化修改”標(biāo)簽內(nèi)，點(diǎn)擊右側(cè)的紅色按鈕“交換狀態(tài)”：此時(shí)，單擊要交換的第一個(gè)鏈接，此鏈接會(huì)加上紅色的背景：再單擊第二個(gè)要交換的鏈接，2個(gè)鏈接就交換了操作結(jié)束，同樣可點(diǎn)擊下面的按鈕進(jìn)行保存、新建或發(fā)布碎片。2.3.2 代碼修改在碎片編輯窗口，點(diǎn)擊“代碼修改”標(biāo)簽：編輯框中的內(nèi)容為碎片的HTML代碼，手動(dòng)修改此代碼，點(diǎn)擊下面的按鈕，就可對(duì)碎片進(jìn)行保存、新建或發(fā)布，在保存或新建后，修改后的內(nèi)容就可反應(yīng)到碎片中。2.

15、3.3 修改記錄在碎片編輯窗口，點(diǎn)擊“修改記錄”標(biāo)簽（沒(méi)有保存碎片權(quán)限，則不能查看修改記錄）：對(duì)每次修改記錄，可進(jìn)行回溯?；厮莶僮鲿?huì)先給出提示，確認(rèn)后再執(zhí)行回溯。第三章 模板管理靜態(tài)頁(yè)面模板由編輯提供，為了對(duì)模板的內(nèi)容進(jìn)行標(biāo)準(zhǔn)化，減少不必要的錯(cuò)誤，特制定關(guān)于模板的規(guī)范，包括元素命名規(guī)范、HTML書寫規(guī)范和CSS書寫規(guī)范。3.1 元素命名規(guī)范技術(shù)人員定義了以下ID和class，編輯們不可使用：n id或name為cms_template_frag, focus_frag_block；n id（或name，class）以fragEditor或frag_editor或frag-editor開(kāi)頭；n

16、class 為dlg-window, dlg-header, dlg-header-title, dlg-controls, dlg-close, dlg-minimize, dlg-content；n 同時(shí)，技術(shù)人員定義了以下JavaScript變量，編輯如果用JavaScript，不要使用以下全局變量：n gLogger, gCms, gZIndex, FocusCms3.2 模板書寫規(guī)范對(duì)整個(gè)模板文件：n 模板的HTML代碼必須符合XHTML規(guī)范，驗(yàn)證網(wǎng)址：常見(jiàn)的要求如：標(biāo)簽閉合，標(biāo)簽小寫，元素的ID唯一，另外，盡量使用class，而不是ID，n 模板必須兼容IE6,IE7,FireFo

17、x2, FireFox3n 模板文件中只可以包含一個(gè)css文件，如規(guī)劃出公用css文件，請(qǐng)?jiān)诋?dāng)前頁(yè)面的css中引用n 模板文件中不允許包含style等樣式標(biāo)簽，必須都寫在css中n 模板文件中包含的圖片必須是絕對(duì)路徑，并合理使用背景圖，減少不必要的圖片n 模板文件中應(yīng)以div，ul，li布局，不能使用table，tr，td等標(biāo)簽n 模板文件中盡量簡(jiǎn)潔，減少不必要的嵌套n 不要使用<center>元素，請(qǐng)使用其它方法居中對(duì)單個(gè)靜態(tài)碎片：n 碎片所有內(nèi)容包含在一個(gè)頂層的div內(nèi)（此div可定義樣式等）：如<div>碎片內(nèi)容</div>如果碎片中有浮動(dòng)元素(假設(shè)稱

18、為inner div)，而這些浮動(dòng)元素的父結(jié)點(diǎn)(稱為outer div)不是浮動(dòng)元素(non float)，父元素結(jié)點(diǎn)將沒(méi)有高度，有兩種解決方案：1. 方法一：在浮動(dòng)元素后面加上包含樣式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%; .cle

19、arfix display:block; 代碼<div> <div id="outer"><div id="inner" class="float">float層1</div><div id="inner" class="float">float層2</div><div class="clearfix" /> </div></div>2. 方法二：不需要額外加一個(gè)DOM

20、結(jié)點(diǎn)，而直接在父結(jié)點(diǎn)加上樣式：.outer-non-float overflow: auto; _overflow: visible; _overflow-x: hidden; _height: 0;即：<div> <div id="outer" class="outer-non-float"><div id="inner" class="float">float層1</div> <div id="inner" class="float">float層2</div> </div></div>由于方法1使頁(yè)面中增加很多不必要的DOM元素，所以推薦使用方法2。n 一行最多只出現(xiàn)一個(gè)<li>；一行中，如果有多個(gè)<a>，則將其寫在一個(gè)<li>內(nèi)，且<a>元素的外層或內(nèi)層不要再嵌套其它元素(如<span>)，一個(gè)正確的書寫例子如下所示：<li>    ·<a target="_bla