Инструменты

Меню "Инструменты" включает в себя пункты для импорта страниц на сайт MODX и для работы с соответствующими наборами свойств.

Импорт ресурсов

Возможна ситуация, когда у вас есть ряд файлов, которые нужно импортировать на сайт MODX как статические ресурсы или как документы. Когда их у вас не очень много, вы можете легко перенести их содержимое на сайт MODX. Однако, если их много, возможно вы захотите импортировать их, используя этот инструмент (или "Импорт HTML", описанный ниже).

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

В поле пути укажите полный путь (не URL). Не забудьте указать конечный слеш в конце пути.

 Для импорта статических ресурсов в поле modResource введите modStaticResourse.  MODX создаст статические ресурсы для каждого файла, имеющего указанный в соответствующем поле путь. Имя файла (без расширения) будет помещено в поля pagetitle и alias.

Для импорта файлов на сайт MODX в качестве документов, укажите modDocument  в поле modResource. MODX создаст для каждого файла новый документ и поместит содержимое файла в поле ресурса content.  Для файлов (X)HTML будет импортирована только часть, заключенная в теги <body>. Имя файла (без расширения) будет помещено в поля pagetitle и alias.

Для ограничения импорта файлами с определенными расширениями укажите список расширений, разделенный запятыми (без точек) в поле для ввода расширений (например, htm, html).

В поле корневого HTML-элемента вы можете указать ту часть файла, которую нужно импортировать. Для (X)HTML файлов вы вероятно укажете раздел <body>, но также возможно указать и <head> или <html>.  Если у вас имеется текстовый файл, из которого вы хотели бы импортировать часть контента, просто отредактируйте файл в текстовом редакторе и заключите часть, которая вам нужна в теги <body></body>.

Для импорта ресурсов кликните на кнопке "Импорт ресурсов" в правом верхнем углу. Если вы обновите дерево ресурсов, то вы увидите ваши импортированные ресурсы.

Импорт HTML

Если у вас есть несколько файлов с одним и тем же расширением в отдельной директории и вам нужно импортировать только некоторые из них, панель управления обеспечивает легкий способ как это сделать. Просто скопируйте файлы в каталог core/import (вначале убедитесь, что этот каталог пуст).  Затем установите поля корневого HTML-элемента и родительский элемент, как это указано в предыдущем разделе и кликните кнопку "Импорт HTML" справа вверху. Файлы будут импортированы как документы также, как и в предыдущем разделе, но будут импортированы только файлы из каталога core/import.

 Наборы параметров

 Более подробно, что такое параметры и наборы параметров и как они используются, мы рассмотрим в отдельном разделе далее. Наборы параметров, прикрепляемые к сниппетам, работают по аналогии с параметрами, передаваемыми в теге сниппета (хотя любые параметры, передаваемые в теге сниппета, переопределяют любые прикрепленные параметры).

Для сниппетов вы можете создавать и редактировать наборы параметров на вкладке "Параметры" при редактировании сниппета. MODX Revolution, тем не менее, также позволяет вам создавать наборы параметров, которые могут быть прикреплены к чанкам и другим элементам.

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

Сниппеты имеют параметры по умолчанию, которые на постоянной основе прикреплены к отдельному сниппету и сохраняются с кодом сниппета. Эти параметры не могут редактироваться в данном пункте меню.

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

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

Если вы перешли по вкладке "Параметры" и далее по кнопке "Новый набор параметров", появится диалоговое окно , в котором вы можете указать имя, категорию и описание набора параметров. Для того, чтобы сохранить эти данные, кликните на кнопке "Сохранить" в выпадающем окне.

Для работы с данным набором параметров вы можете или кликнуть в дереве или использовать диалоговое окно "Создать параметр".

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

Для того, чтобы элемент использовал набор параметров, вы должны сделать две вещи. Во-первых, вам нужно прикрепить набор параметров к элементу. Выполняйте это путем клика правой кнопкой мыши на имени набора параметров в дереве и выбора пункта "Связать с элементом". Выберите тип элемента и имя элемента в выпадающих списках и нажмите кнопку "Сохранить". Во-вторых, вам нужно указать MODX какой набор параметров использовать с элементом путем указания названия набора параметров в теге элемента со знаком @. Для чанка это будет выглядеть следующим образом :

Не оставляйте пробелов между именем элемента, знаком @ и именем набора параметров.

 

 

 

Назад Вперёд