[译]:Orchard入门——部件管理
博客分类: 官方教程
返回目录索引
原文链接:Managing Widgets
在Orchard中,部件是可以加入到当前当前主题任何位置或区域(如侧栏sidebar或底部区域footer)的UI块(如:HTML)或代码部分(如:内容部分)。常见部件示例包括:导航菜单navigation menus, 图片库image galleries, 广告ads, 视频videos, 以及标记云图tag clouds
本文介绍部件的基础知识,以及如何管理部件。
层Layers, 区域Zones, 和部件Widgets
在Orchard控制面板中,点击 部件Widgets 菜单进入部件管理界面。Widgets 界面列出了可用的部件列表,以及可以添加部件的层layer和区域zone。
你可以将层 layer 理解为展示一个部件(或一组部件)的一系列规则。例如:一个层可以控制页面上某一部件只对登录用户可见。区域zone控制部件显示在页面的哪一个位置。
下图为部件Widgets 页面:
可用的部件
一旦部件设置可用 (通常是在控制面板-模块-功能下面启用了一个功能后引起), Orchard会自动将部件添加到当前主题区域可用部件列表当中。要查看区域可用部件列表,点击部件界面中区域列表中某一区域后面的添加按钮。
例如:在部件界面中点击 Header 区域后的添加按钮。网站将展示可以添加到区域的可用部件列表。
下面表格描述了Orchard中默认可用的部件:
部件Widget | 描述Description |
---|---|
Blog Archives | 显示指定博客的博文条目列表 |
Container Widget | 显示内容项容器,例如一个列表 |
Html Widget | 显示HTML内容——需要通过部件编辑器添加内容 |
Recent Blog Posts | 显示指定博客的最近更新博文 |
层的列表
Orchard内置提供了一些层。你也可以按照自己的需要定义层,稍后将详述添加层。在部件页面,你可以通过当前层下拉菜单改变当前编辑的层,也可以点击添加一个新层来来添加新层。
下面列表列举了默认层的显示规则,以及层的作用。
层Layer | 规则Rule | 描述Description |
---|---|---|
Default | true | 在所有页面都显示 |
Authenticated | authenticated | 用户已认证——即对登录用户可见 |
Anonymous | not authenticated | 匿名用户可见 |
Disabled | false | 不显示。可用于保存当前不需要显示的部件配置 |
TheHomepage | url("~/") | 首页显示 |
区域列表
Orchard中,网页被分成许多个区域。可用区域被定义在网站主题之中。在部件界面,你可以看到当前选中层所有可用区域的列表。界面上也包含当前选中层的每个区域包含的部件。
关于更多默认主题(TheThemeMachine)的可用区域信息,参见:原文:Customizing the Default Theme。
添加层
点击控制面板-部件-添加一个新层来添加一个层,下图为 Add Layer 界面:
添加新层信息:层名称、描述,以及层规则,完成后点击保存。
层规则的值是一个可以解析为true 或 false的表达式。如果解析为 true, 则部件显示,否则部件不显示。
下表简述了建立层的语法规则:
语法规则Rule Syntax | 描述Description |
---|---|
url("<url path>") | 当当前url地址符合指定的路径,则为true。如果在路径最后加了星号(*),所有此路径下的子链都被认为是true(如:url("~/home*") )。 |
authenticated | 用户已登录则为true。 |
ContentType("<Type>") | 浏览内容类型与特定的类型匹配,则为true。如:内容类型(“Page”) |
not | 逻辑非 |
and | 逻辑与 |
or | 逻辑或 |
表达式可以使用括号。
例如,下面表达式定义的规则表示对于未登录用户可以在About页面查看到部件,登录用户在任何页面都可以看到部件。
(not authenticated and url("~/about")) or authenticated
如 允许多个url值,可以使用如下语法:
url("~/foo") or url("~/bar")
为区域添加部件
点击要添加部件的区域后的添加按钮,然后选择要添加的部件,以此给一个区域添加部件。
例如:点击Header区域后的添加按钮,然后在 Choose A Widget 页面点击 Html Widget。然后网站将展示 Add A Widget 页面
要配置哪些字段取决于你配置的部件类型。所有部件都包含区域Zone, 层Layer, 标题Title, 和 位置Position 字段。位置字段确认区域内部所有部件的相对位置(事实上就是z-order)。需要注意的是区域内的部件可以来自多个层。例如:两个完全不同的层中可能在统一区域都含有部件。
位置字段可以是整数,也可以是由点分隔的整数序列。例如:以下值都是有效的:5, 10.1, 7.5.3.1。位置值小的部件将显示在位置值大的部件之前。
设置完所有字段后,点击保存。
编辑或删除部件
要编辑或删除部件,在部件页面的当前层下拉框中选择部件所在的层。然后在层所含的区域列表中,点击要更改的部件。之后会自动进入编辑部件界面:
编辑你想修改的字段,然后点击保存。要从区域中移除部件,点击后面的移除按钮。
译:奇葩史