Структура Базы Данных

Четыре таблицы, классы xPDO — в пространстве Gallery3x\Model. Пакет подключается компонентом сам, в своём коде достаточно $modx->getCollection(\Gallery3x\Model\Gallery3xFile::class, [...]).

Таблица	Класс	Что хранит
`gallery3x_files`	`Gallery3xFile`	Изображения
`gallery3x_videos`	`Gallery3xVideo`	Видео
`gallery3x_attachments`	`Gallery3xAttachment`	Файлы-вложения
`gallery3x_embeds`	`Gallery3xEmbed`	Embed (карты, виджеты, iframe)

Во всех таблицах есть id, resource_id (ресурс) и source_id (источник файлов), а также общие поля:

Поле	Тип	Описание
`position`	int	Порядок
`group`	varchar	Группы через `\|\|`
`extra_text, extra_text2`	varchar	Дополнительные текстовые поля
`extra_num`	int	Дополнительное число
`extra_date`	datetime	Дополнительная дата
`active`	tinyint	1 — показывается, 0 — выключено
`createdon, updatedon`	datetime	Даты создания и изменения
`createdby, updatedby`	int	ID пользователей

gallery3x_files

Поле	Тип	Описание
`name`	varchar	Название
`alt`	text	Альтернативный текст
`description`	text	Описание (HTML)
`path`	varchar	Папка внутри источника, например `15/`
`file`	varchar	Имя файла оригинала
`type, size`	varchar, int	MIME-тип и размер в байтах
`hash`	varchar	MD5 файла
`properties`	text (JSON)	Данные превью: `thumbnails.<размер>.path` и т.д.
`special`	tinyint	«Особенное»
`parent_id`	int	Зарезервировано

gallery3x_videos

Поле	Тип	Описание
`url`	text	Ссылка на видео
`service, video_id`	varchar	Сервис (`youtube`, `rutube`, `vk`, `kinescope` …) и ID видео на нём
`title, description`	varchar, text	Название и описание
`thumbnail`	varchar	Обложка (путь в источнике)
`special`	tinyint	«Особенное»

gallery3x_attachments

Поле	Тип	Описание
`name, description`	varchar, text	Заголовок и описание
`path, file`	varchar	Папка и имя файла
`type, size`	varchar, int	MIME-тип и размер
`hash`	varchar	MD5 файла

gallery3x_embeds

Поле	Тип	Описание
`title, description`	varchar, text	Заголовок и описание
`mode`	varchar	`url` — по ссылке, `code` — готовый код
`url, code`	text, mediumtext	Исходная ссылка или код вставки
`provider, embed_id`	varchar	Распознанный сервис (`yandex_map`, `google_map`) и итоговый адрес iframe
`height`	int	Высота, px (пусто — 400)
`thumbnail`	varchar	Превью
`special`	tinyint	«Особенное»

Пример

$files = $modx->getCollection(\Gallery3x\Model\Gallery3xFile::class, [
    'resource_id' => 12,
    'active' => 1,
]);
foreach ($files as $file) {
    $thumbs = $file->get('properties')['thumbnails'] ?? [];
    echo $file->get('name'), ': ', $thumbs['small']['path'] ?? '', "\n";
}

Адреса строите через источник файлов ($source->getBaseUrl() . path) или берите готовые из сниппетов — пути в базе относительные.