Url modx: Использование дружественных URL — Начало работы – Человекопонятные URL в MODX Revolution

MODX — Ресурсы | ИТ Шеф

Статья, в которой рассмотрим понятие и роль такого объекта MODX Revolution как ресурс. Кроме этого познакомимся с тем, как осуществляется работа с ресурсами в MODX, разберём назначение полей ресурса, а также то, как связанный с ресурсом шаблон влияет на его вывод.

Что такое ресурс?

Ресурс — это некоторая сущность, которая представляет страницу в MODX.

Всего в MODX насчитывается 4 различных типа ресурсов: документы (documents), ссылки (weblinks), символические ссылки (symlinks) и статические ресурсы (Static Resources). По умолчанию ресурс имеет тип «Документ».

Ресурс «Документ (document)»

Документ — это тип ресурса MODX, который представляет собой веб-страницу на сайте.

Ресурс «Символическая ссылка (symlink)»

Символическая ссылка в MODX Revolution — это ресурс, с помощью которого можно отобразить контент другого ресурса сайта под определённым URL.

Символическая ссылка не позволяет изменить «привязанный» к ней контент, но зато позволяет настроить иные параметры ресурса, например, такие как шаблон, название и др.

Символическую ссылку обычно используют:

• как вид редиректа 301;
• для того, чтобы избежать дублирования контента. Т.е. ресурс (контент), имеющий тип «Документ», можно создать один раз, а затем при необходимости использовать символическую ссылку на него. Это может применяться, когда необходимо обеспечить чтобы один и тот же контент находился фактически и логически более чем в одном месте на сайте;
• когда необходимо оставить доступ к документу, который был перемещён в структуре сайта, по старой ссылке;
• для обеспечения простого и краткого URL-адреса для документа, который находится глубоко в структуре сайта;
• для того чтобы реализовать обращение к некоторому ресурсу (контенту), используя различные написания. Например: foursquare, 4square, forsquare и т.п. Каждый из этих ресурсов будет представлять собой символическую ссылку, указывающую на один и тот же контент.

Кроме этого, символическим ссылкам, как и другим ресурсам MODX можно настраивать разрешения. Это достигается посредством помещения символических ссылок, в необходимые группы ресурсов.

При работе с символическими ссылками убедитесь в том, что ресурс, с которого она берёт контент, существует и опубликован. Если это не так, то при обращении к ресурсу (символической ссылки) будет создана ошибка.

Ресурс «Ссылка (Weblink)»

Weblink — это ресурс, представляющий собой ссылку. Шаблон для отображения или форматирования этого ресурса (ссылки) обычно не используется. Его применение может быть обусловлено только в том случае, если он будет использоваться как контейнер для переменных шаблона (TV-параметров), которые необходимо добавить к ссылке. Weblink можно использовать на сайте, например, в качестве ссылки, которая должна стать частью сгенерированного меню.

Контент веб-ссылки представляет собой URL-адрес. MODX при открытии такого ресурса просто перенаправляет пользователя на указанный адрес URL. Даже парсер такой тип ресурса не разбирает. Т.е. как только MODX видит, что это «ссылка», он просто использует контент этого ресурса в качестве аргумента метода sendRedirect($url).

В качестве ссылки можно использовать как внешний URL-адрес, так и id существующего ресурса сайта.

Статический ресурс (Static Resource)

Статический ресурс — это абстрактный ресурс, представляющий собой некоторый файл. Он предназначен для виртуального представления некоторого файла веб-сервера. Как и другие MODX ресурсы, эта абстракция может иметь права. Данный тип ресурса, также как и другие, отображается в админке (менеджере) MODX на левой панели в дереве ресурсов. Это позволяет использовать его в динамических меню и результатах поиска.

В поле контента статического ресурса для указания пути к файлу можно использовать теги (параметры системы). Кроме системных тегов в поле контента можно также использовать сниппеты. Это в основном используется только тогда, когда необходимо установить динамический путь к файлу.

Статические ресурсы в MODX Revolution ведут себя подобно документу (стандартному ресурсу). Но для представления файла в статическом ресурсе, ему обязательно необходимо установить соответствующее содержимое (content_type), а также способ того, как браузер должен обработать этот ресурс (content_dispo). Для того чтобы ресурс отображался в браузере, выберите в качестве значения поля «Местонахождение ресурса» вариант «Встроенный». Для того чтобы ресурс стал доступен для скачивания выберите параметр «Прикреплённый».

Обратите внимание на то, что при создании статического ресурса, псевдоним alias не должен содержать расширение файла. Расширение файла определяется типом контента ресурса.

Для того чтобы файл передавался правильно через статический ресурс, ему необходимо в качестве шаблона указывать пустой шаблон. Если к статическому ресурсу необходимо добавить некоторую дополнительную информацию через переменные шаблона (TV-параметры). То в этом случае необходимо создать новый «пустой» шаблон и установить в качестве его содержания следующее:

[[*content]]

Идентификатор ресурса

Каждый ресурс в MODX имеет уникальный идентификатор (id). Он позволяет системе MODX определить, какой ресурс необходимо выбрать, когда пользователь загружает в браузере ту или иную веб-страницу. Его также желательно использовать, когда необходимо организовать связь между ресурсами. В этом случае MODX будет генерировать ссылку автоматически, и её не придётся редактировать при изменении псевдонима (alias), типа контента или какого-нибудь другого поля ресурса.

Рассмотрим небольшой пример, а именно то, как MODX определяет какой ресурс необходимо отдать пользователю при открытии им некоторой страницы на сайте (www.mysite.ru).

Если на сайте не используются дружественные URL, то ресурс, который необходимо отобразить пользователю указывается посредством идентификатора в get параметре id страницы «index.php».

Например, отобразить в браузере страницу (ресурс) сайта, имеющий идентификатор 16:

http://www.mysite.ru/index.php?id=16  

Если же на сайте включены и настроены дружественные URL, то обращение к ресурсу уже будет осуществляться с использованием псевдонима. Например, отобразить ресурс с идентификатором 16, имеющий псевдоним some-page и тип содержимого «html» (суффикс, равен .html):

http://www.mysite.ru/some-page.html

Здесь some-page — это alias ресурса, а .html — это тип содержимого (контента) данного ресурса.

Кроме этого, MODX разрешает использовать вложенные URL. Например, ресурс с псевдонимом «child», который расположен внутри ресурса-контейнера с псевдонимом «parent», будет иметь адрес:

http://www.mysite.ru/parent/child.html

Работа с ресурсами в MODX

Ресурсы в админке (менеджере) MODX отображаются в левой панели на вкладке «Ресурсы». Представляются они пользователю в виде дерева.

Создание ресурса

Создание ресурса в MODX осуществляется с помощью кнопок расположенных на соответствующей панели в левой части админки.

После этого на экране появится страница ресурса, состоящая из вкладок и панели «Содержимое ресурса». Все эти элементы содержат поля ресурса.

После заполнения необходимых полей и нажатия на кнопку «Сохранить», они заносятся в базу данных, а ресурсу присваивается некоторый идентификатор (порядковый номер ресурса).

Редактирование ресурса

Отредактировать ресурс в админке MODX можно несколькими способами:

• с помощью нажатия левой кнопкой мыши на необходимый ресурс в дереве;
• посредством поднесения курсора к определённому ресурсу и выбором из контекстного меню пункта «Редактировать». Вызывается контекстное меню с помощью правой кнопки мыши.

После редактирования ресурса, его необходимо сохранить. Для этого необходимо нажать на кнопку, расположенную вверху экрана и имеющее соответствующее название.

Удаление ресурса

Для удаления ресурса в MODX Revolution к нему необходимо поднести курсор и в контекстном меню выбрать пункт «Удалить». Кроме этого удалить ресурс можно также в режиме редактирования с помощью кнопки «Удалить». После удаления, ресурс на самом деле не удаляется. Ему просто устанавливается включенным состояние параметра deleted, т.е. ресурс как бы помечается на удаление. Для того чтобы окончательно стереть ресурс или ресурсы, помеченные на удаление, необходимо на вкладке «Ресурсы» нажать на значок мусорного ведра.

Поля ресурса

Все ресурсы имеют следующие предопределенные поля:

1. Базовые поля ресурса MODX.

2. Поля, осуществляющие настройку ресурса.

Где хранятся ресурсы

Ресурсы, как и другие объекты MODX хранятся в базе данных.

1. Обзор таблицы (site_content), содержащей ресурсы, в phpmyadmin.

2. Структура таблицы (site_content), содержащей ресурсы.

Ресурс и связанный с ним шаблон

Каждому ресурсу в MODX Revolution должен быть обязательно назначен имеющийся или пустой шаблон. Определиться, нужен ли ресурсу шаблон или нет можно следующим образом. Шаблон имеет смысл создавать, если его необходимо связать с несколькими ресурсами или использовать TV-переменные. В этом случае страница будет выводиться, используя связанный с ней шаблон. Контент ресурса в этом шаблоне будет представляться с помощью тега MODX [[*content]].

Если страница не имеет связанного с ней шаблона (выбран пустой шаблон), то она будет отображаться на основании поля «Содержимое ресурса».

Не работают дружественные URL MODX Revo 2.3.1-pl

Не работают дружественные URL.
1. Все работало долгое время, проблема началась после переноса на новый хостинг, настройки все те-же.
2. При включении дружественных URL все ссылки ведут на главную страницу, при выключении все работает но ссылки вида /index.php?id=2

.htaccess

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# MODX supports Friendly URLs via this .htaccess file. You must serve web
# pages via Apache with mod_rewrite to use this functionality, and you must
# change the file name from ht.access to .htaccess.
#
# Make sure RewriteBase points to the directory where you installed MODX.
# E.g., "/modx" if your installation is in a "modx" subdirectory.
#
# You may choose to make your URLs non-case-sensitive by adding a NC directive
# to your rule: RewriteRule ^(.*)$ index.php?q=$1 [L,QSA,NC]

RewriteEngine On
RewriteBase /



# Rewrite www.domain.com -> domain.com -- used with SEO Strict URLs plugin
#RewriteCond %{HTTP_HOST} .
#RewriteCond %{HTTP_HOST} !^example-domain-please-change\.com [NC]
#RewriteRule (.*) http://example-domain-please-change.com/$1 [R=301,L]
#
# or for the opposite domain.com -> www.domain.com use the following
# DO NOT USE BOTH
#
#RewriteCond %{HTTP_HOST} .
#RewriteCond %{HTTP_HOST} !^www\.example-domain-please-change\.com [NC]
#RewriteRule (.*) http://www.example-domain-please-change.com/$1 [R=301,L]




# The Friendly URLs part
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?q=$1 [L,QSA]



# Make sure .htc files are served with the proper MIME type, which is critical
# for XP SP2. Un-comment if your host allows htaccess MIME type overrides.

#AddType text/x-component .htc



# If your server is not already configured as such, the following directive
# should be uncommented in order to set PHP's register_globals option to OFF.
# This closes a major security hole that is abused by most XSS (cross-site
# scripting) attacks. For more information: http://php.net/register_globals
#
# To verify that this option has been set to OFF, open the Manager and choose
# Reports -> System Info and then click the phpinfo() link. Do a Find on Page
# for "register_globals". The Local Value should be OFF. If the Master Value
# is OFF then you do not need this directive here.
#
# IF REGISTER_GLOBALS DIRECTIVE CAUSES 500 INTERNAL SERVER ERRORS :
#
# Your server does not allow PHP directives to be set via .htaccess. In that
# case you must make this change in your php.ini file instead. If you are
# using a commercial web host, contact the administrators for assistance in
# doing this. Not all servers allow local php.ini files, and they should
# include all PHP configurations (not just this one), or you will effectively
# reset everything to PHP defaults. Consult www.php.net for more detailed
# information about setting PHP directives.

#php_flag register_globals Off



# For servers that support output compression, you should pick up a bit of
# speed by un-commenting the following lines.

#php_flag zlib.output_compression On
#php_value zlib.output_compression_level 5



# The following directives stop screen flicker in IE on CSS rollovers. If
# needed, un-comment the following rules. When they're in place, you may have
# to do a force-refresh in order to see changes in your designs.

#ExpiresActive On
#ExpiresByType image/gif A2592000
#ExpiresByType image/jpeg A2592000
#ExpiresByType image/png A2592000
#BrowserMatch "MSIE" brokenvary=1
#BrowserMatch "Mozilla/4.[0-9]{2}" brokenvary=1
#BrowserMatch "Opera" !brokenvary
#SetEnvIf brokenvary 1 force-no-vary

Дружественные URL, псевдонимы — Создание сайта на MODX Revolution

Дружественные URL обычно сокращаются в MODX как FURL.

Индексный файл index.php в MODX фактически является модулем-диспетчером. Все запросы браузера относительно тех или иных веб страниц проходят через index.php. При выключенных FURL (это имеет место после первой установки MODX) MODX обращается к документам по их номерам идентификатора ресурса. Поэтому, если браузер запрашивает страницу с ID 11, URL будет выглядеть примерно вот так :

http://yoursite.com/index.php?id=11

Если же вы включите FURL и ресурс 11 будет иметь псевдоним «support», URL будет выглядеть следующим образом :

 http://yoursite.com/support.html

Почему желательно использовать FURL и дружеские псевдонимы

Поисковые машины, подобные Google, при индексации сайтов ищут ключевые слова. Они ищут их в заголовках страницы, в заголовке сайта, содержимом страницы, а также в URL страницы. Без использования FURL поисковые машины будут игнорировать ID в URL. Они будут видеть ключевые слова в имени домена, но не увидят их в названии каждой страницы. Таким образом, использование дружественных URL и псевдонимов страниц делает сайт более дружественным для поисковиков.

Системные настройки для FURL

Для включения FUR нужно, во-первых, соответственно установить системные настройки и отредактировать располагающийся в корне сайта файл .htaccess. Вначале рассмотрим системные настройки, а затем файл .htaccess. Для того, чтобы увидеть системные настройки для FURL перейдите к разделу Система -> Настройки системы. Можно в поле «поиск по ключу»  набрать friendly и нажать «Enter», но лучше использовать фильтр по разделу и выбрать «Дружеские URL».

Вы можете кликнуть на значке «+» слева от названия любой установки, чтобы больше о ней узнать. Если вы дважды кликните на поле значения, вы сможете изменить его значение в большинстве браузеров. Если это не работает, кликните на установке правой кнопкой и выберите «Редактировать».

Настройка «использовать дружественные URL»

Эта настройка позволяет включить и выключить дружественные URL. Помните, что включение дружественных URL не обеспечит вам их автоматическое использование до тех пор, пока вы не настроите файл .htaccess.

Настройка «использовать вложенные URL»

Эта настройка определяет будет ли с помощью дружественных URL показан весь путь до страницы или нет. То, как вы устанавливаете настройку «использовать вложенные URL» по большому счету зависит от ваших личных предпочтений. Включение этой настройки дает больше ключевых слов поисковым машинам, однако, с другой стороны, это может приводить к созданию длинных (иногда очень длинных) URL, которые неудобно будет набирать пользователям.

Конфигурирование файла .htaccess

Сервер анализирует файл .htacess, который устанавливает множество настроек, управляющих работой сервера. Вы можете иметь файл .htaccess в любой директории, но сейчас мы рассматриваем файл, который находится в корневом каталоге.

Если вы разместили ваш сайт в директории public_html (или некоторой другой) на удаленном хостинге, первым делом нужно проверить не разместил ли хостинг-провайдер уже  этот файл в этой директории. Чаще всего этого не случается, но если это так, то разместите код MODX FURL в существующем файле. Важно : если файл .htacess существует, сделайтеего копию перед внесение каких-либо изменений.

Во время установки MODX помещает файл ht.access в корневую директорию. Это не файл .htaccess. Файл h.taccess не выполняет никаких функций, но содержит код, необходимый для работы MODX FURL. Если нет существующего файла, скопируйте ваш файл ht.access в ht.access.bac, чтобы у вас была резервная копия. Затем создайте файл .htacess, переименовав ht.acces в .htacess.

После того, как вы создали ваш файл .htacess, убедитесь, что ввлючена настройка «Использовать дружественные URL» в настройках системы и очистите кэш MODX (Сайт -> Обновить сайт)

Как убрать .html в конце URL в MODX Revolution

Сегодня разберем, как можно убрать окончание .html в адресах страниц сайта.

Итак, вполне вероятно, что, раз Вы читаете эту статью, то URL страниц Вашего сайта выглядят примерно так:

На самом деле, это нормально для MODX. Если Вы настраивали ЧПУ по моей статье, то, скорее всего, тоже получили такой результат.

Для того, чтобы убрать это окончание, идем в меню Содержимое → Типы содержимого.

На открывшейся странице найдите тип содержимого HTML, щелкните двойным нажатием мышки по полю в колонке Расширение файла и сотрите его.

Было:

Стало:

После этого нужно открыть меню Управление, очистить кэш сайта и перегенерировать URL страниц.

Процесс генерации новых URL будет отображаться в консоли.

После этого адреса страниц примут вид как на скриншоте ниже.