Символическая ссылка

Что такое символическая ссылка?¶

Символическая ссылка переадресует запрос другому ресурсу. URL, по которому пришёл посетитель, сохраняется, а в том же ответе возвращается содержимое цели. Это не HTTP-перенаправление: статус ответа 200, и поисковые системы видят содержимое по обоим URL. В отличие от 301, ссылка не передаёт целевой странице сигналы ранжирования.

Для кода 301 используйте веб-ссылку с кодом ответа 301 или перенаправление на уровне сервера.

Случаи применения¶

Многим сайтам символические ссылки не нужны, но они решают несколько задач:

• Сохранить старый URL после переноса страницы. Если дублирование важно для поиска, добавьте канонический тег.
• Показать одно и то же содержимое в нескольких местах дерева без копирования.
• Дать короткий URL странице, лежащей глубоко в дереве.
• Закрыть варианты написания URL, каждый отдельной символической ссылкой.

Цель¶

Поле content хранит ID целевого ресурса. Тег допускается, если он выводит числовой ID. URL или псевдоним не поддерживается: sendForward() приводит значение к целому числу, поэтому нечисловая цель попадает на страницу ошибки. Для внешних URL используйте веб-ссылку.

Цель должна существовать. При сохранении MODX отклоняет нечисловое значение и несуществующий ресурс. Значение с тегами эту проверку пропускает и разрешается во время запроса.

Процессор обновления также отклоняет ссылку на саму себя. Процессор создания этого не делает, поэтому не вводите ID нового ресурса.

Видимость цели и права¶

Неопубликованная цель не отдаётся анонимным посетителям: MODX считает её отсутствующей и отправляет страницу ошибки 404. Пользователь менеджера с view_unpublished может её открыть.

При переадресации проверяется привилегия view целевого ресурса. Символическая ссылка в другой группе ресурсов не даёт доступа к цели, а добавляет ещё одну проверку. Ссылка может сузить доступ, но не расширить его.

Поля и кеш¶

Непустые поля символической ссылки могут перекрывать поля цели в зависимости от symlink_merge_fields. Поле content всегда остаётся ID цели. Исключения описаны в разделе Использование символических ссылок.

Если цель не появилась после сохранения, очистите кеш сайта и кеш документов.

Смотрите также¶

1. Типы содержимого
2. Именованный якорь
3. Статический ресурс
4. Символическая ссылка
5. Использование символических ссылок
6. Веб-ссылка