返回目录索引
原文链接：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。位置值小的部件将显示在位置值大的部件之前。
设置完所有字段后，点击保存。
编辑或删除部件
要编辑或删除部件，在部件页面的当前层下拉框中选择部件所在的层。然后在层所含的区域列表中，点击要更改的部件。之后会自动进入编辑部件界面：
编辑你想修改的字段，然后点击保存。要从区域中移除部件，点击后面的移除按钮。
译：奇葩史
