zoukankan      html  css  js  c++  java
  • [译]: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 界面:

    添加新层信息:层名称、描述,以及层规则,完成后点击保存

    层规则的值是一个可以解析为truefalse的表达式。如果解析为 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。位置值小的部件将显示在位置值大的部件之前。

    设置完所有字段后,点击保存

    编辑或删除部件

    要编辑或删除部件,在部件页面的当前层下拉框中选择部件所在的层。然后在层所含的区域列表中,点击要更改的部件。之后会自动进入编辑部件界面:

    编辑你想修改的字段,然后点击保存。要从区域中移除部件,点击后面的移除按钮。


    译:奇葩史

  • 相关阅读:
    MySQL 5.7.18 zip 文件安装过程
    Mysql 自定义随机字符串
    JAVA基本类型和引用类型
    初识JSP
    Java导出错误数据
    时序图的使用习惯
    Redis踩坑
    ES踩坑
    代码规范
    Git在公司的使用流程
  • 原文地址:https://www.cnblogs.com/huaxia283611/p/Managing-widgets.html
Copyright © 2011-2022 走看看