README

这是一个适用于TYPO3的易于使用的“固定侧边栏菜单”。如果您需要为移动版创建菜单，此扩展正好提供了您所需的一切。版本3仅支持支持fetch的浏览器。

与版本2的区别

mdy/fixedsidemenu的版本2可以在没有JavaScript的情况下以及在任何当前使用的设备或浏览器上工作。此版本会将整个菜单打印到每个传递的页面上。版本2的支持仍然可用。但此版本将不会接收任何新功能。

用例和示例

在生产环境中使用的扩展 mdy/fixedsidemenu

您可以在这里看到此扩展的实际应用。只需调整浏览器窗口大小至小于640px或切换到移动视图。菜单打开器将出现在右上角。

在您的环境中测试扩展 mdy/fixedsidemenu

只需按照这里的说明安装扩展。在您包含它之后，菜单将默认自动工作并显示。您可以选择通过媒体查询显示或按您的需求显示。

您可以使用常量编辑器来更改其行为、颜色或菜单内应显示的页面。默认情况下，它将从根页面开始显示整个页面树。您可以通过网站地图元素、csv或全部定义页面。

安装

此扩展仅适用于TYPO3。选择以下方法之一将此扩展安装到您的TYPO3页面。

通过composer安装

composer require mdy/fixedsidemenu

通过TYPO3扩展管理器安装

您可以通过扩展管理器在您的TYPO3安装中安装mdy/fixedsidemenu。只需单击扩展进入扩展管理器。然后选择获取扩展并搜索fixedsidemenu。

单击导入和安装按钮。

通过发行版下载安装

转到https://extensions.typo3.org/extension/fixedsidemenu/#version-history并选择一个可用的发布版本。下载它并将其通过FTP、SSH或任何其他方式上传到您的TYPO3。

包含扩展

通过管理界面包含扩展

转到您的其中一个根页面，并通过模板 > 编辑整个模板记录 > 包含包含所需的TypoScript文件。选择fixedsidemenu基本设置（fixedsidemenu）以及其中一个可用布局，如fixedsidemenu：简单左右边栏菜单（fixedsidemenu）。

通过TypoScript包含扩展

包含TypoScript常量

@import 'EXT:fixedsidemenu/Configuration/TypoScript/constants.typoscript'

包含TypoScript设置

@import 'EXT:fixedsidemenu/Configuration/TypoScript/setup.typoscript'

开发和测试扩展

ddev是必需的！您可以使用本地机器上的ddev轻松地开发和测试扩展。克隆扩展并运行以下命令

ddev create

这将创建一个带有安装了mdy/fixedsidemenu的全新TYPO3 11安装，并准备好测试。脚本完成后，请将您的浏览器指向http://fixedsidemenu.ddev.site。在此处登录到后端http://fixedsidemenu.ddev.site/typo3，用户名为admin，密码为adminadmin。

资产构建系统

您可以使用以下命令构建开发环境中的所有资产

ddev assets

发布前构建

如果您即将将分支推送到仓库，请按以下方式构建生产环境中的资产

ddev build

验收测试

您可以使用以下命令在本地机器上运行测试

ddev tests

本地代码检查

您可以通过运行以下命令对ddev环境中所有文件进行代码检查

ddev lint