sebkln / content-slug
为 TYPO3 内容元素添加一个便于阅读的锚点字段(例如 "domain.com/page/#my-section"),默认情况下,该锚点以标题的 id 属性形式呈现。
4.0.0
2024-07-07 09:33 UTC
Requires
- typo3/cms-core: >=12.4.0 <13.4.99
README
可说话的 URL 片段(TYPO3 扩展程序)
完整文档
您可以在 docs.typo3.org(HTML)和 Documentation/
文件夹(ReST)中找到更详细的文档,包括多个截图和教程。
简介
"可说话的 URL" 是网页必备的功能。TYPO3 v9 及更高版本提供了路由功能来实现这一点。旧版本的 TYPO3 需要第三方扩展 RealURL 或 CoolUri。
TYPO3 还提供了导航内容元素 "章节索引" 和 "从选定页面生成子页面章节索引",这些元素将构建页面及其包含的内容元素列表。
这些内容元素将通过其唯一的 ID 进行链接,例如。
https://www.example.org/a-sub-page/#c123
它工作得很好,但不是人类可读的。
此扩展程序做了什么?
首先,此扩展程序为 TYPO3 内容元素提供了 人类可读的 URL 片段。
https://www.example.org/a-sub-page/#section-of-interest
此外,扩展程序允许在标题旁边设置 锚点链接。编辑器可以通过复选框为单个内容元素激活这些链接。
功能
- 编辑器可以为每个内容元素设置单独的人类可读片段标识符。
- 编辑器可以使用按钮自动从当前标题生成片段。
- 编辑器可以激活内容元素的标题锚点链接。
- 范围:人类可读的片段用于 章节索引 菜单,以及用于 RTE 或 TCA 字段中的
inputLink
渲染类型链接。 - 回退:如果没有提供自定义片段或标题被隐藏,则在渲染的链接中使用默认片段。
- 评估 #1:仅存储受支持的字符。特殊字符将被替换。
- 评估 #2:同一页面上的所有内容元素都将获得唯一的片段标识符。
- 错误预防:默认情况下,片段将使用内容元素的 uid 进行前缀。
- 当然,您可以自定义 Fluid 模板以满足您的需求。
兼容性
TYPO3 12.4.0 - 13.4.99
安装
此扩展程序需要像其他 TYPO3 CMS 扩展程序一样安装。
执行以下步骤
- 加载并安装扩展程序。
- 将静态模板 "Speaking URL fragments (anchors) (content_slug)" 包含到您的 TypoScript 模板中。
- 为您的编辑器添加新
tt_content
字段tx_content_slug_fragment
和tx_content_slug_link
的权限。 - 使用 TypoScript 配置片段,并根据需要自定义 Fluid 模板。