Параметр Wayfinder IncludeDocs в Modx ломает фрагмент

Question

Я застрял на неожиданной проблеме. Я пытаюсь использовать Wayfinder для создания карты сайта для проекта. Вывод элементов навигации является ожидаемым, но мне нужно включить ряд документов в дополнение к основным элементам навигации.

Для этого я использовал параметр includeDocs.

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

Когда я делаю это, я вообще ничего не получаю. Удалите includeDocs, и я получу стандартную навигацию (ожидается). Используйте параметр и вывод будет полностью пустым.

Понятия не имею, что я делаю неправильно или какие (если таковые имеются) другие настройки должны быть определены, чтобы сделать эту работу.

Answer 1

Параметр includeDocs вводит в заблуждение. Его лучше назвать "onlyIncudeDocs" или "restrictTo", так как это то, что он делает. Это также требует, чтобы документы, которые вы включаете, были напрямую доступны из вашего startId, или же весь путь "включался".

Я бы посоветовал вам создавать ресурсы веб-ссылок прямо под вашим startId и связывать их с ресурсами, которые вы хотите включить. Таким образом, wayfinder подберет их по умолчанию. (Обратите внимание, что вам может потребоваться обработать это в вашем rowTpl для wayfinder, поскольку веб-ссылка хранит фактическую ссылку в своем поле содержимого)

Если вы также хотите включить дочерние элементы указанных вами идентификаторов, вам, вероятно, будет лучше немного изменить структуру ресурсов.