MODX по умолчанию предоставляет три типа источников файлов: файловая система, интеграция с Amazon S3 и FTP. Другие источники могут быть созданы путем добавления нового типа источников или путем их загрузки их из Управление пакетами.
Использование источников файлов
В следующих разделах описывается базовое использование источников файлов.
Создание медиа источника
Перейдите в Медиа > Источники файлов. Здесь вы увидите список доступных на данный момент медиа-источников:
Прежде чем мы продолжим, важно отметить разницу между «Медиа источником» и «Типом медиа источника». Тип медиа источника — это классификация источника, такая как тип источник S3 или тип источника Filesystem. Эти типы указывают Источник на различные системы хранения.
А пока, создайте источник мультимедиа, нажав кнопку «Создать» на вкладке «Источник файлов». Должно появиться окно с базовой формой для источника:
Теперь выберите тип источника файловой системы и дайте ему имя.
Этот тип источника мультимедиа позволяет подключаться к корзине Amazon S3.
Доступные свойства
| Имя | Описание |
|---|---|
url |
Обязательное. URL-адрес экземпляра Amazon S3. Часто http://myaccount.s3.amazonaws.com/ или https://s3.amazonaws.com/myaccount/. Если у вас возникают проблемы с просмотром миниатюр, но они работают правильно, убедитесь, что URL заканчивается косой чертой. |
bucket |
Обязательное. Корзина для подключения источника. |
key |
Обязательное. Ключ Amazon используется для аутентификации в корзине. |
secret_key |
Обязательное. Секретный ключ Amazon для аутентификации в корзине. |
imageExtensions |
Список расширений файлов, которые можно превратить в миниатюры. Значение по умолчанию: jpg,jpeg,png,gif |
thumbnailType |
Когда отображается миниатюра, тип изображения будет отображаться как. Значение по умолчанию: png |
thumbnailQuality |
Качество отрисованного превью, по шкале от 0 до 100. Значение по умолчанию: 90 |
skipFiles |
Разделенный запятыми список имен файлов, которые нужно пропустить при просмотре источника. Значение по умолчанию: .svn,.git,notes,nbproject,.idea,.DS_Store |
Как только это будет сделано, вы увидите свой источник мультимедиа в списке. Щелкните по нему правой кнопкой мыши и выберите «Редактировать источник файлов».
Редактирование вашего нового медиа источника
На этом экране будет отображаться основная информация о новом источнике мультимедиа, списком со специфическими для типа свойствами для источника, который вы можете изменить, и вкладка «Права доступа», которая позволит вам ограничить доступ к источнику.
А пока давайте установим свойство basePath и baseUrl на img/ (это путь до папки с изображениями), а затем в свойство imageExtensions допишем значения ,webp,avif (расширяем список поддерживаемых изображений). Сохраните источник.
Использование вашего источника
После того, как вы его создали, вы сможете увидеть источник в раскрывающемся списке в левом дереве на вкладке «Файлы».
Если вы выберете этот источник, теперь вы сможете видеть только содержимое каталога img/ в вашей установке MODX! (Если вы еще не создали каталог img/ в вашей установке, сделайте это сейчас.)
Кроме того, вы можете подключить этот источник к TV типа (параметры ввода): «Изображение» и «Файл» в соответствующей вкладке, при создании или редактировании TV. Это вступит в силу при редактировании TV в ресурсе из этого контекста, а также при отображении этого TV в этом контексте.
Теперь мы, вероятно, захотим рассмотреть возможность ограничения доступа к этому источнику, чтобы наши редакторы контента не могли случайно отредактировать его и испортить. Прочитайте эту статью чтобы узнать, как.
