Magnolia技术人员使用手册.doc

Magnolia技术人员使用手册一、 登陆首先下载到magnolia的安装包：ITServicepersonalhanhongguangmagnoliamagnolia-enterprise-bundle-4.4-tomcat-bundle.zip(直接解压缩便可使用)登陆：1. 首先，在浏览器上输入http:/localhost:8090/2. 其次，选择Author instance登陆，如下图选择Author instance登陆图1-1 最后，输入用户名/密码，（这里可以使用superuser/superuser）进行登陆。图1-2二、 页面管理图2-11. 语言设置Mognlia支持多国语言，首先我们先来将转变为中文点击此处图2-2 点击User：superuser处，修改语言类型。如下图在下拉框里选择Chines（China）图2-32. 创建模板 模板配置1. 打开Configuration 工作区域，然后代开module文件夹2. 在templatingtemplates下创建子文件夹wxxr图2-43. 在wxxr文件夹下创建MyTamplate的内容节点。4. 在MyTamplate内容节点下创建以下七个数据节点：description，i18nBasename，name，mytemplatePath，title，type，visible。5. 在wxxr下另外创建一个新的内容节点，名字叫subTemplates。6. 在subtemplates下在创建一个名叫print的内容节点。7. 在printer内容节点下再创建三个数据节点：extention、templatesPath、type。8. 照着下面的截图配置所有的数据节点的值。图2-5 接着开始编写我们的模板wxxr.jsp1. 在magnoliaAuthortemplates下创建自己的项目，如wxxr，然后在该项目下创建templates。magnoliaAuthortemplateswxxrtemplates2. 现在我们可以开始创建我们第一个模板了，wxxr.jsp；代码如下 $content.title $content.title Hello Wxxr ! 在magnoliaAuthortemplates下创建文件夹wxxr（名字可改）以及它的子文件夹templates图2-6 接着把模板wxxr.jsp放到wxxrtemplates下图2-73. 使用模板创建完模板后，我们就可以使用自己的模板了 首先打开WebSite，在新建一个名叫wxxr-demo的页面，然后选择我们的模板New Templates选择我们的模板New Temple右键点击增加一个新页面wxxr-demo图2-8 创建完毕后，双击wxxr-demo这个新建页面，我们就会看到图2-94. 添加mainbar这个时候我们需要添加和编辑页面内容.以下三个是添加和编辑页面内容的要领。1. 需要一个工具栏按钮来打开一个编辑Dialogs。2. Dialogs允许我们进行添加和编辑内容。3. Paragraph依赖于Dialogs。4. Mainbar包含一个preview、 AdmanCentral。PageProperty按钮和语言选择框，它允许我们对添加toolbar对页面进行编辑。 现在我们开始将mainbar放入我们的模板wxxr.jsp当中 $content.title 加入Mainbar $content.title Hello Wxxr ! 然后我们在双击击wxxr-demo这个页面，就会看到下图Mainbar图2-105. 定义页面配置dialogs接下来，我们定义一个my-page-properties-dialog指向我们的脚本，并让我们的模板使用它。1. 首先，我们要下载到magnolia-module-samples-4.1.jar这个jar包。并将jar包放到magnolia-enterprise-bundle-4.4-tomcat-bundlemagnolia-enterprise-4.4apache-tomcat-6.0.29webappsmagnoliaAuthorWEB-INFlib下（magnolia的安装包解压后的路径）Jar包的放置路径图2-112. 然后，在我们的Configuration工作空间，展开/modules/samples/dialogs文件夹。3. 复制mainProperties这个内容节点4. 粘贴到/samples/dialogs下（即当前路径），并重命名为my-page-properties-dialog图2-12在Website工作空间，双击我们新建的wxxr-demo的页面，点击Page Properties这个按钮，我们就会看到图2-136. 创建一个Paragraph接下来我们将要往我们的模板中加入newbar标签，newbar包含在CMS Tag library中。这个newbar中包含着新的按钮，这个新的按钮允许我们编辑者往页面中插入新的paragraphs。Paragraphs它使得我们在一个模板中，可以引入更多的模板，现在开始建立一个新Paragraphs。 首先，先要建立一个dialogs。打开Configuration工作空间1. 在 Configuration 空间下, 展开 /modules/templating 文件夹2. 在 dialogs 内容创建子内容节点,命名为 wxxr3. 往内容节点 wxxr 添加一个名为height的数据节点4. 在wxxr内容节点下创建一个名为tabTextBlock 的子内容节点5. 在 tabTextBlock内容节点下添加两个数据节点，命名为 controlType 和 label6. 在tabTextBlock 内容节点下创建一个新的子内容节点，命名为textBlock7. 在textBlock内容节点下添加6个数据节点，分别命名为controlType, description, height, label, name and type.8. 按照下图的详细内容配置所有的数据节点String图2-14 接着再创建paragraphs的定义1. 在Configuration workspace，展开/modules/templating 文件夹.2. 在templating/paragraphs下，创建一个名为wxxr子文件夹.3. 在wxxr文件夹下，创建一个新的内容节点，命名为myTextBlock.4. 在myTextBlock内容节点下加入六个数据节点，分别命名为description, dialog, name, templatePath, title and type.5. 按照下图设置所有的数据节点的值图2-15 创建paragraph脚本1. 在magnoliaAuthor /templates/myProject创建名为paragraphs的文件夹.图2-162. 创建 myTextBlock.jsp文件，脚本内容如下：图2-17源码如下： .myTextBlock font-style: normal; font-size: 10pt; text-decoration: none; font-family: Verdana, Helvetica, Arial, sans-serif; $content.textBlock 接着我们将这个paragraph添加到newBar 标签中；这样我们通过newbar可以动态的取到我们的paragraph插入的页面。例如wxxr.jsp在newBar中加入我们的paragraph”myTextBlock”图2-18在Website工作空间，双击我们新建的wxxr-demo的页面，这是我们新加入的newbar图2-19双击“newbar”这个按钮图2-20选择其中的一项，例如选择My Text为例，选中“My Text”后，点击“OK”图2-217. EditBar首先创建editBar中要使用的Dialog1. 在 Configuration 空间下, 展开 /modules/templating/dialogs2. 在dialogs下新建一个内容节点，名字叫myDialog3. 在myDialog下创建三个数据节点，分别命名为height, label and width.4. 在myDialog内容节点下创建一个子内容节点，命名为tabText5. 在tabText下再创建两个内容节点，分别命名为textTitle and textBlock.6. 在textTitle下创建四个数据节点，分别命名为controlType, label, name and type.7. 在textBlock内容节点下创建6个数据节点，分别命名为controlType, description, height, label, name and type.8. 按下面的截图配置所有数据节点的详细信息。图2-22在上面的配置都完成后，我们将editbar写入到我们的模板中，还是以wxxr.jsp(位置在magnoliaAuthortemplateswxxrtemplates)为例editBar代码块对应之前配置好的”myDIalog”图2-23注：代码块中的“myContent2”是允许我们自己自定义名称的，但它在和中必须一致，即contantNodeName的值必须一致。最后在页面上AdminCentral下就能看到第二步 弹出对话框编辑页面第一步双击Edit Text按钮图2-24关于tag标签可以查看官网的：CMS Tag library三、 数据管理（工具工作区间）在我们编辑完网站页面的时侯，我们常常会疑惑编辑的数据存储在什么地方呢？是否管理到它呢？答案是肯定的。我们可以管理到这些数据。页面数据管理：当我们在website（网站）工作空间上，编辑页面信息的时候，如新建一个demo页面图3-1对helloworld页面进行内容编辑第二步选择一个新添的paragraphs模板第一步点击“新建”图3-2在对话框内加入“helloworld”，日期选择当天时间图3-3点击“保存后”这是咱们编辑的内容图3-4Helloworld页面当新加编辑完页面后，在Tools（工具）JCR Brower(WebSite)中，我们能相应地找到页面信息这是我们添加的内容信息图3-5四、 模板的导入导出1. 模板导出当我们写好模板配置后，我们可以对其进行导入和导出，这样使可以便捷的迁移到其他magnolia系统上。在Configuration（配置空间中），我们的模板配置，如modulestemplatingtemplates关于wxxr的模板配置，我们可以右键，选择“Export tree to xml”右键，选择“Export tree to xml”图4-1这时会弹出对话框提示，问你是否想导出你所选择的模板配置，点击“确定”图4-2点击“保存”图4-3选择要保存路径，点击“保存”即可图4-4最后我们会得到一个XML的描述文件图4-52. 模板配置的导入假如我们在新的magnolia平台上想使用我们之前的模板时，我们就需要用到模板配置的导入。 首先，我们把之前编写好的模板，放到相应的路径。 接着，我们就要把相应的模板配置导入进去 modulestemplatingtemplates下点击右键，“Import from XML”将模板配置导入进来选着你想放的路径，右键点“Import from XML”击图4-6 将你要导的模板配置导入后，你就会看到你导入的模板配置导入的模板配置图4-7五、 权限配置权限是网站管理必不可少的模块，现在让我们对它进行一个入门式介绍Magnolia权限设置主要由roles（角色），group（组），users（用户），System users和public users组成。1. Roles（角色）角色：是magnolia权限的最基本元素之一，它能具体地控制到具体模块，页面的操作。 首先，SecurityRoles 下新建一个新的角色，如“products-Editor”产品编辑角色（可以右键建立角色，也可以右下角建立）第二步建“products-Editor”角色角色第一步，点击“创建角色”图5-1 接着双击新建的角色products-Editor”，编辑它的权限，在“可操作列表”选项卡中，给角色分配权限。1. 选择“网站”第一步第三步，添加规则第二步，选择模块图5-22. 接着在上图第二步的地方，选择Expressions，如下图的配置图5-33. 再相同的地方再选择URL，如下图的设置图5-44. 再相同的地方再选择“配置”，如下图设置图5-55. 再相同的地方再选择“配置”，如下图设置图5-6 在“设置”选项卡中，填写描述说明，也可以不填图5-7这样角色“products-Editor”就建好了。2. Group(组)组：是mag