README

此插件允许最终用户通过简单的WYSIWYG用户界面创建和编辑静态页面和菜单。

安装

此插件可以通过Composer进行安装。

composer require winter/wn-pages-plugin

管理静态页面

静态页面在静态页面插件的“页面”选项卡中管理。静态页面有三个必填参数 - 标题、URL和布局。当输入标题时，URL会自动生成，但也可以手动更改。URL必须以正斜杠字符开头。布局下拉菜单允许选择用CMS创建的布局。只有包含staticPage组件的布局会显示在下拉菜单中。

页面是分级的。页面层级用于生成新页面URL时，但URL可以手动更改，因此层级实际上不影响路由过程。唯一会影响的地方是生成的菜单。生成的菜单反映了页面层级。您可以通过在页面树中拖动页面来管理页面层级。当鼠标指针移到树中的页面项上时，将出现页面拖动句柄。

静态页面的可选属性是隐藏和隐藏在导航中。隐藏复选框允许从前端隐藏页面。隐藏的页面对于登录到后端的管理员仍然是可见的。隐藏在导航中复选框允许从生成的菜单和面包屑中隐藏页面。

占位符

如果静态布局包含占位符，静态页面编辑器将显示用于编辑占位符内容的选项卡。插件自动检测文本和HTML占位符并为它们显示相应的编辑器 - HTML占位符的WYSIWYG编辑器和文本占位符的文本编辑器。

代码片段

代码片段是可以由静态页面添加到富文本编辑器的元素。它们允许向页面注入复杂（和交互式）区域。有许多可能的应用和示例使用代码片段。

• Google Maps代码片段 - 输出以特定坐标为中心并具有预定义缩放因子的地图。这个代码片段非常适合解释方向的静态页面。
• 通用评论系统 - 允许访客向任何静态页面发表评论。
• 第三方集成 - 例如与Yelp或TripAdvisor集成以在静态页面上显示额外信息。

代码片段在静态页面的侧边栏列表中显示，并且可以通过鼠标点击添加到富编辑器中。代码片段可配置，并且具有用户可以使用检查器管理的属性。

管理菜单

您可以在静态页面插件的“菜单”选项卡中管理菜单。网站可以包含多个菜单，例如主菜单、页脚菜单、侧边栏菜单等。主题开发者可以使用staticMenu组件将菜单包含在页面布局中。

菜单有两个必需的属性 - 菜单的 名称 和菜单的 代码。菜单名称将在后端菜单列表中显示。菜单代码是布局代码中引用菜单所必需的，它是API参数。

{.img-responsive .frame}

菜单可以包含多个 菜单项，菜单项可以嵌套。每个菜单项都有许多属性。存在适用于所有菜单项类型的属性，以及一些依赖于项类型的属性。常见的菜单项属性是 标题 和 类型。标题定义了菜单项文本。类型是一个下拉列表，显示您Winter CMS副本中可用的所有菜单项类型。

{.img-responsive .frame}

标准菜单项类型

可用的菜单项类型取决于已安装的插件，但存在三种基本项类型。

标题 {.subheader}

此类型的项用于显示文本且不链接到任何内容。文本可以用作其他菜单项的类别标题。此类型仅显示标题属性。

URL {.subheader}

此类型的项是链接到特定固定URL。这可能是一个内部页面或外部URL。此类型的项没有其他属性 - 只有点击和URL。

静态页面 {.subheader}

此类型的项引用静态页面。应在下面的 引用 下拉列表中选择静态页面。

所有静态页面 {.subheader}

此类型的项展开以创建到主题中定义的所有静态页面的链接。嵌套页面由嵌套菜单项表示。

自定义菜单项类型

其他插件可以提供新的菜单项类型。例如，博客插件提供了两种更多类型

博客类别 {.subheader}

此类型的项表示到特定博客类别的链接。应在 引用 下拉列表中选择类别。此菜单类型还需要选择一个输出博客类别的 CMS页面。

所有博客类别 {.subheader}

此类型的项展开成多个项，代表所有现有的博客类别。此菜单类型还需要选择一个 CMS页面。

菜单项属性

根据选择的菜单项类型，您可能需要提供菜单项的其他属性。下面描述了可用的属性。

引用 {.subheader}

一个下拉列表，列出菜单项应引用的对象。列表内容取决于菜单项类型。对于 静态页面 项类型，列表显示系统中定义的所有静态页面。对于 博客类别 项类型，列表显示博客类别的列表。

允许嵌套项 {.subheader}

此复选框仅适用于应嵌套对象的菜单项类型。例如，静态页面是分级的，因此此属性适用于 静态页面 项类型。另一方面，博客类别不是分级的，因此复选框被隐藏。

用其生成的子项替换此项 {.subheader}

一个复选框，用于确定是否应将菜单项替换为生成的菜单项。此属性仅适用于需要自动生成项的菜单项类型，例如对于 静态页面 菜单项类型。由于博客分类不能嵌套，且此类型的菜单项始终指向特定的博客分类，因此 博客分类 菜单项类型没有此属性。当您想将生成的菜单项包含到菜单的根目录时，这个属性非常有用。例如，您可以创建 所有博客分类 菜单项并启用替换。结果，您将得到一个在菜单第一级列出所有博客分类的菜单。如果您没有启用替换，则会在根菜单项下列出博客分类。

CMS 页面 {.subheader}

此下拉菜单适用于需要引用特定 CMS 页面的菜单项类型。例如，博客分类 菜单项类型需要托管 blogPosts 组件的 CMS 页面。此项目类型的 CMS 页面下拉菜单将仅显示包含此组件的页面。

代码 {.subheader}

代码字段允许您分配可以在文档中描述的页面的 onInit() 处理器中显式设置活动菜单项的 API 代码。

另请参阅

阅读 October CMS 博客中的 “开始使用静态页面” 教程。

阅读 文档。