Що таке ресурс?
Ресурс - це деяка сутність, яка представляє сторінку в MODX.
Всього в MODX налічується 4 різних типи ресурсів: документи (documents), посилання (weblinks), символічні посилання (symlinks) і статичні ресурси (Static Resources). За замовчуванням ресурс має тип "Документ".
Ресурс "Документ (document)"
Документ - це тип ресурсу MODX, який представляє собою веб-сторінку на сайті.
Символічне посилання зазвичай використовують:
Weblink - це ресурс, який представляє собою посилання. Шаблон для відображення або форматування цього ресурсу (посилання) зазвичай не використовується. Його застосування може бути обумовлено тільки в тому випадку, якщо він буде використовуватися як контейнер для змінних шаблону (TV-параметрів), які необхідно додати до заслання. Weblink можна використовувати на сайті, наприклад, в якості посилання, яка повинна стати частиною згенерованого меню.
Статичний ресурс (Static Resource)
Статичний ресурс - це абстрактний ресурс, який представляє собою деякий файл. Він призначений для віртуального уявлення деякого файлу веб-сервера. Як і інші MODX ресурси, ця абстракція може мати права. Даний тип ресурсу, також як і інші, відображається в адмінки (менеджері) MODX на лівій панелі в дереві ресурсів. Це дозволяє використовувати його в динамічних меню і результати пошуку.
В поле контенту статичного ресурсу для вказівки шляху до файлу можна використовувати теги (параметри системи). Крім системних тегів в поле контенту можна також використовувати сніппети. Це в основному використовується тільки тоді, коли необхідно встановити динамічний шлях до файлу.
Статичні ресурси в MODX Revolution поводяться подібно документу (стандартному ресурсу). Але для подання файла в статичному ресурсі, йому обов'язково необхідно встановити відповідний вміст (content_type), а також спосіб того, як браузер повинен обробити цей ресурс (content_dispo). Для того щоб ресурс відображався в браузері, виберіть в якості значення поля "Місцезнаходження ресурсу" варіант "Вбудований". Для того щоб ресурс став доступний для скачування виберіть параметр "прикріплений".
Зверніть увагу на те, що при створенні статичного ресурсу, псевдонім alias не повинен містити розширення файлу. Розширення файлу визначається типом контенту ресурсу.
Для того щоб файл передавався правильно через статичний ресурс, йому необхідно як шаблон вказувати порожній шаблон. Якщо до статичного ресурсу необхідно додати деяку додаткову інформацію через змінні шаблону (TV-параметри). То в цьому випадку необхідно створити новий "порожній" шаблон і встановити в якості його змісту наступне:
ідентифікатор ресурсу
Кожен ресурс в MODX має унікальний ідентифікатор (id). Він дозволяє системі MODX визначити, який ресурс необхідно вибрати, коли користувач завантажує в браузері ту чи іншу веб-сторінку. Його також бажано використовувати, коли необхідно організувати зв'язок між ресурсами. В цьому випадку MODX буде генерувати посилання автоматично, і її не доведеться редагувати при зміні псевдоніма (alias), типу контенту або якого-небудь іншого поля ресурсу.
Розглянемо невеликий приклад, а саме те, як MODX визначає який ресурс необхідно віддати користувачеві при відкритті їм деякої сторінки на сайті (www.mysite.ru).
Якщо на сайті не використовуються дружні URL, то ресурс, який необхідно відобразити користувачеві вказується за допомогою ідентифікатора в get параметрі id сторінки "index.php".
Наприклад, відобразити в браузері сторінку (ресурс) сайту, який має ідентифікатор 16:
Якщо ж на сайті включені і налаштовані дружні URL, то звернення до ресурсу вже буде здійснюватися з використанням псевдоніма. Наприклад, відобразити ресурс з ідентифікатором 16, що має псевдонім some-page і тип вмісту "html" (суфікс, дорівнює .html):
Тут some-page - це alias ресурсу, а .html - це тип вмісту (контенту) даного ресурсу.
Робота з ресурсами в MODX
Ресурси в адмінки (менеджері) MODX відображаються в лівій панелі на вкладці "Ресурси". Представляються вони користувачу у вигляді дерева.
створення ресурсу
Створення ресурсу в MODX здійснюється за допомогою кнопок розташованих на відповідній панелі в лівій частині адмінки.
Після цього на екрані з'явиться сторінка ресурсу, що складається з вкладок і панелі "Вміст ресурсу". Всі ці елементи містять поля ресурсу.
Після заповнення необхідних полів і натискання на кнопку "Зберегти", вони заносяться в базу даних, а ресурсу присвоюється певний ідентифікатор (порядковий номер ресурсу).
редагування ресурсу
Відредагувати ресурс в адмінці MODX можна декількома способами:
- за допомогою натискання лівою кнопкою миші на необхідний ресурс в дереві;
- за допомогою піднесення курсора до певного ресурсу і вибором з контекстного меню пункту "Редагувати". Викликається контекстне меню за допомогою правої кнопки миші.
Після редагування ресурсу, його необхідно зберегти. Для цього необхідно натиснути на кнопку, розташовану у верхній частині екрану і має відповідну назву.
видалення ресурсу
Для видалення ресурсу в MODX Revolution до нього необхідно піднести курсор і в контекстному меню вибрати пункт "Видалити". Крім цього видалити ресурс можна також в режимі редагування за допомогою кнопки "Видалити". Після видалення, ресурс насправді не видаляється. Йому просто встановлюється включеним стан параметра deleted. тобто ресурс як би позначається на видалення. Для того щоб остаточно стерти ресурс або ресурси, помічені на видалення, необхідно на вкладці "Ресурси" натиснути на значок сміттєвого відра.
поля ресурсу
Всі ресурси мають такі зумовлені поля:
1. Базові поля ресурсу MODX.