plato-creative / silverstripe-menu
通过yml定义并使用CMS管理多个菜单。
2.0.1
2023-04-04 22:33 UTC
Requires
README
通过yml定义并使用CMS管理多个菜单。
安装
Composer是推荐安装SilverStripe模块的方式。
composer require plato-creative/silverstripe-menu
需求
- silverstripe/framework ^4.0
- symbiote/silverstripe-gridfieldextensions ^3.1
- gorriecoe/silverstripe link ^1.1
维护者
创建自定义菜单
由于在模板中通常通过slug引用MenuSets,您可以在/dev/build任务期间自动创建集合。这些集合无法通过CMS删除。
gorriecoe\Menu\Models\MenuSet:
sets:
main: Main menu
secondary: Another menu
嵌套和平铺菜单
默认情况下,菜单将是平铺的,这意味着链接不能关联子链接。如果您需要嵌套菜单结构,可以通过在yml文件中添加allow_children: true
来实现,如下所示。
gorriecoe\Menu\Models\MenuSet:
sets:
footer:
title: Footer menu
allow_children: true
向菜单添加链接
创建菜单后,您可以在管理区域添加链接。字段继承自silverstripe link。
从sitetree自动添加链接到特定菜单
如果您需要在创建页面后自动将链接添加到菜单,可以通过添加以下扩展到页面并定义owns_menu
来实现。
Page:
extensions:
- gorriecoe\Menu\Extensions\SiteTreeAutoCreateExtension
owns_menu:
- main
- footer
在模板中的使用
<ul>
<% loop MenuSet('footer') %>
<li>
{$Me}
</li>
<% end_loop %>
</ul>
有关更多模板选项,请参阅silverstripe link。