Modx 中的 Wayfinder IncludeDocs 参数破坏了代码段

Question

我被一个意想不到的问题困住了。我正在尝试使用 Wayfinder 为项目生成站点地图。导航项的输出符合预期，但除了主要导航元素之外，我还需要包含一些文档。

为此，我使用了 includeDocs 参数。

[[Wayfinder? &startId=`0` &includeDocs=`17,18,19,20`]]

当我这样做时，我根本没有得到任何输出。删除 includeDocs，我得到标准导航（预期）。使用参数，输出完全为空。

不知道我做错了什么或者必须定义什么（如果有的话）其他设置才能使其正常工作。

Answer 1

includeDocs 参数非常具有误导性。它应该被命名为“onlyIncudeDocs”或“restrictTo”，因为它就是这样做的。它还要求您包含的文档可以从您的 startId 直接访问，或者将整个路径“包含”。

我建议您直接在您的 startId 下创建网络链接资源，并将它们链接到您想要包含的资源。默认情况下，寻路器会拾取它们。 （请注意，您可能需要在 rowTpl 中为 wayfinder 处理此问题，因为网络链接将实际链接存储在其内容字段中）

如果您还想包含您指定的 id 的子代，最好稍微修改一下资源结构。