TYPO3 12：文件夹内页面链接无法生成问题求助

问题原因 #

TYPO3 默认将文件夹（Folder类型页面）下的子页面标记为「非站点核心页面」，不会自动纳入站点的URL生成规则，同时默认配置会限制对这类页面的链接生成。而Home页面作为站点根页面，属于默认允许的站点页面范围，因此可以正常生成链接。

具体解决步骤 #

1. 调整站点配置（关键）

进入 TYPO3 后台的「站点管理」，编辑当前站点：

• 在「页面树」设置中，将 Meta Navigation 文件夹纳入站点的页面范围，确保其下的 Search、Login 页面被识别为当前站点的一部分。

2. 添加必要的 TypoScript 配置

在你的站点全局 TypoScript 配置中添加以下内容，允许链接到文件夹内的页面：

# 允许链接到受访问限制或隐藏的页面（如果文件夹内页面有相关设置）
config {
  linkAccessRestrictedPages = 1
  showHiddenPages = 1
}

# 配置元导航的菜单获取规则（如果用 TypoScript 生成导航）
lib.metaNavigation = HMENU
lib.metaNavigation {
  special = directory
  special.value = [你的 Meta Navigation 文件夹 UID]
  includeNotInMenu = 1 # 如果页面没勾选「在菜单中显示」
  1 = TMENU
  1 {
    wrap = <ul class="meta-nav">|</ul>
    NO = 1
    NO {
      wrapItemAndSub = <li>|</li>
      stdWrap.cObject = TEXT
      stdWrap.cObject {
        field = title
        typolink.parameter.field = uid
      }
    }
  }
}

3. Fluid 模板优化

如果坚持用 Fluid 的 <f:link.page> 标签，需要确保页面UID对应的页面已被站点识别，同时可以强制生成链接：

<f:link.page pageUid="{item.data.uid}" forceAbsoluteUrl="false">{item.data.title}</f:link.page>

如果仍不生效，检查 item.data.uid 是否正确获取到了文件夹内页面的真实UID（可通过 <f:debug>{item.data}</f:debug> 验证）。

额外注意事项 #

• 确保文件夹内的页面没有设置「隐藏」「禁用」或「访问限制」，如果有，必须配合 TypoScript 中的 linkAccessRestrictedPages 和 showHiddenPages 参数。
• 部分 TYPO3 版本中，文件夹页面的子页面需要手动设置「站点根」属性（在页面属性的「站点」标签中选择当前站点）。

内容的提问来源于stack exchange，提问作者Paradonix