shel / neosbase
Neos CMS 基础助手包
README
⚠️ 注意
由于大多数功能已在过去几年中被 Neos 核心功能所替代,因此此包不再进一步开发。您仍然可以复制所需的部分,但不再建议安装。
描述
此包可作为 Neos CMS 项目的起点。它提供了许多项目中需要的良好默认设置,可以与其他包结合使用,以快速设置新的网站。
功能
节点类型
MetaMenuMixin
Shel.NeosBase:MetaMenuMixin
可作为 Neos.Neos:Document
的超类型添加,以标记显示 Shel.NeosBase:MetaMenu
ts 对象的页面。例如在网站页脚中。
RootPage
Shel.NeosBase:RootPage
是一个良好的网站起点,可以为整个网站添加额外的属性。更改根节点的类型以使用它。
您应该在文档类型中添加以下约束,以仅允许 RootPage
作为网站根并对其进行修改以适应您的节点名称
"My.Package:MyDocumentType": constraints: nodeTypes: "Shel.NeosBase:RootPage": false
表单元素
Shel.NeosBase:Honeypot
是一个隐藏的表单元素,可以捕获垃圾邮件机器人。
视图助手
EmbedViewHelper
允许通过 fluid 嵌入文件内容,例如 svg 文件。FlattenViewHelper
将二维数组渲染为简单的字符串,以便通过邮件发送表单数据。TagViewHelper
渲染具有定义属性的标签。您现在可以像这样在节点模板中编写而不是像这样编写<div{attributes ->f:format.raw()}>
,现在您可以编写<snb:tag attributes="{attributes}" tag="div">
要使用它们,请将以下内容添加到您的 fluid 模板中
{namespace snb=Shel\NeosBase\ViewHelpers}
或者,当您想要自动完成时,请将以下内容添加到模板开头
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xmlns:snb="https://xsd.helzle.it/ns/Shel/NeosBase/ViewHelpers">
之后,在 schema url 上 alt 点击,并告诉 PhpStorm 从外部资源获取 schema。
Fluid 视图助手模式
对于自动完成,您可以向 PhpStorm 添加视图助手模式。模式在包文件夹中的 Documentation/Schema.xsd
。
要为此包重建 Fluid 视图助手模式,请运行此命令
./flow documentation:generatexsd --phpNamespace "Shel\NeosBase\ViewHelpers" --targetFile Packages/Plugins/Shel.NeosBase/Documentation/Schema.xsd --xsdNamespace "https://helzle.it/ns/Shel/NeosBase/ViewHelpers"
验证器
IsEmptyValidator
- 用于包含 HoneyPot 表单元素。
增强的 TypoScript 用于页面渲染
页面渲染
本包使用了Neos文档中描述的替代页面渲染方法(见Neos文档)。可扩展的基本原型为Shel.NeosBase:DefaultPage
。请阅读Neos文档了解如何添加您自己的页面布局。
额外的HTML头部部分
在页面头部添加额外的可配置元标签(例如css、作者、ie兼容性、viewport、favicon等)。请参阅原型Shel.NeosBase:DefaultPage
获取详细信息。
额外的HTML身体部分
还包括一个可配置的实时重新加载脚本,当您开发样式表时使用。请参阅Settings.yaml
进行配置。
要轻松包含您的javascript包,请查看ts路径body.javascripts.bundle
。
TypoScript对象
Shel.NeosBase:Navigation
是一个用于主站导航的菜单。Shel.NeosBase:MetaMenu
是一个菜单,它会渲染所有标记有显示在元菜单
属性的所有文档,由Shel.NeosBase:MetaMenuMixin
提供。Shel.NeosBase:SiteLogo
是一个可配置的助手,用于渲染网站标志,包括指向主页的链接。Shel.NeosBase:LinkTag
、Shel.NeosBase:ScriptTag
、Shel.NeosBase:MetaTag
、Shel.NeosBase:StyleSheetTag
使向文档添加自定义标签变得更加容易。Shel.NeosBase:Debug
是一个融合助手,用于将融合值输出到浏览器控制台。