Плагин Data Tables 1.4.6

Data Tables позволяет администраторам создавать автономные, полностью настраиваемые таблицы данных в XenForo — без необходимости написания кода. Определяйте собственные столбцы, настраивайте выпадающие списки, связывайте записи между таблицами и управляйте структурированными данными прямо из панели администратора, получая при этом чистые общедоступные страницы, оформленные в стиле вашего форума.

Идеально подходит для каталогов товаров, баз данных игр, списков команд, таблиц цен, списков товаров или любых структурированных данных, которые не помещаются в темы форума.

Основные функции

• Динамические определения таблиц — Создавайте неограниченное количество таблиц, каждая со своим заголовком, URL-адресом, описанием и порядком отображения. Переключайте таблицы в активное/неактивное состояние без удаления данных.
• Списочные/несписочные таблицы — Скрывайте определения из общедоступного индекса таблиц, сохраняя при этом доступ к ним по прямому URL-адресу. Значок «Несписочные» в панели администратора.
• 8 типов полей — Создавайте столбцы, используя: текст, число, URL, дата, поиск (выпадающий список), поиск по таблице (межтабличная ссылка), текстовое поле и Да/Нет (логическое значение). Каждое поле поддерживает флаги сортировки и фильтрации.
• Видимость полей — Переключатель «Показывать в таблице» для каждого поля позволяет скрывать столбцы из табличного представления, сохраняя при этом их отображение на страницах с подробными сведениями о записи.
• Столбцы поиска (реляционные выпадающие списки) — Определяйте параметры выпадающего списка для любого поля. Параметры хранятся в реляционном виде (а не в виде плоских строк), что обеспечивает удобный ввод данных и согласованное отображение.
• Связи между таблицами — связывание записей между таблицами с помощью поля типа «Поиск в таблице». Выберите связанную таблицу и поле отображения, и пользователи будут выбирать записи из этой таблицы через выпадающий список. Значения отображаются в виде кликабельных ссылок на соответствующую запись.
• Встроенная кнопка «Создать новую» — кнопка «+» рядом с каждым выпадающим списком «Поиск в таблице» открывает модальное окно для создания новой записи в связанной таблице. Сохранение происходит через AJAX, и значение автоматически выбирается в родительском выпадающем списке — без перезагрузки страницы и перехода на другую страницу. Работает как в панели администратора, так и на общедоступных страницах.
• Удобные URL-адреса — записи доступны по адресу /data-tables/record/{table-slug}/{record-slug}/ с автоматически генерируемыми уникальными URL-адресами. Устаревшие URL-адреса перенаправляются на новый формат с помощью 301-перенаправления.
• Хлебные крошки — полная навигационная цепочка на всех общедоступных страницах: Главная > Таблицы данных > Имя таблицы > Заголовок записи.
• Интерактивные строки таблицы — Щелкните в любом месте строки таблицы, чтобы перейти на страницу с подробными сведениями о записи. Ctrl/Cmd+click открывает новую вкладку.
• Страницы с подробными сведениями о записи — Каждая запись имеет свою собственную страницу с подробными сведениями, отображающую все поля и раздел «Ссылки на другие таблицы», в котором перечислены записи из других таблиц, ссылающихся на нее.
• Импорт CSV — Загрузка CSV-файлов со страницы списка записей в панели администратора. Поддерживаются разделители: запятая, табуляция, точка с запятой и вертикальная черта. Автоматическое сопоставление столбцов по имени заголовка, предварительный просмотр 5 строк, разрешение поиска с возможностью автоматического создания отсутствующих параметров.
• Экспорт CSV — Загрузка данных таблицы в формате CSV с отформатированными значениями ячеек (метки поиска, логические значения «Да/Нет», метки отображения поиска в таблице).
• Редактирование порядка отображения непосредственно на странице списка полей — Редактируйте значения порядка отображения полей непосредственно на странице списка полей, не открывая каждое поле по отдельности.
• Выбор иконок FontAwesome — выберите пользовательскую иконку для каждого определения таблицы из более чем 1500 иконок FontAwesome (например, fa-car, fa-wrench, fa-database). Иконки отображаются в списке таблиц, заголовке представления таблицы и заголовке сведений о записи.
• Расширенный список таблиц — общедоступный каталог таблиц использует расширенные строки карточек с иконкой определения, описанием, количеством полей и значком количества записей с плавными переходами при наведении курсора.
• Единые заголовки страниц — страницы представления таблицы и сведения о записи используют единый шаблон заголовка с иконкой и блоком заголовка для визуальной согласованности на всех страницах.
• Групповой выбор и удаление — список записей администратора имеет флажок «Выбрать все» и кнопку пакетного удаления с динамическим отображением количества.
• Управление записями администратора — полный CRUD для записей в панели администратора. Динамические формы автоматически адаптируются к вашим определениям полей — текстовые поля становятся текстовыми полями ввода, поля поиска — выпадающими списками, числа — счетчиками, логические значения — флажками.
• Отображение публичных таблиц — Чистые, адаптивные публичные страницы по адресу /data-tables/, отображающие все перечисленные таблицы, с возможностью просмотра отдельных таблиц по адресу /data-tables/{slug}/. Полная интеграция с темой.
• Сортировка столбцов — Отметьте поля как «сортируемые» в админке, и пользователи смогут щелкать заголовки столбцов в публичном представлении таблицы для сортировки по возрастанию/убыванию.
• Публичная отправка записей — При желании разрешите участникам отправлять новые записи с публичной стороны (контролируется правами доступа).
• Многовыборочный поиск в таблице — Поля поиска в таблице могут быть помечены как многовыборочные для связей «многие ко многим». Отображаются как выпадающий список с множественным выбором (или теги автозаполнения для больших списков). Отображение ячеек показывает разделенные запятыми ссылки на элементы, по которым можно перейти.
• Публичное редактирование/удаление — Владельцы записей могут редактировать и удалять записи с публичных страниц. Контролируется специальными правами доступа с разумными значениями по умолчанию (редактирование: Разрешить, удаление: Запретить).
• Проверка обязательных полей — Отметьте поля как обязательные. Применяется ко всем действиям сохранения (административное и публичное) с четкими сообщениями об ошибках.
• Автозаполнение поиска — поля поиска в таблице с более чем 50 вариантами автоматически переключаются с выпадающего списка на автозаполнение AJAX с замедленным поиском и удаляемыми тегами для множественного выбора.
• Встроенное редактирование связанной записи — значок карандаша рядом с полями поиска в таблице с одним выбором открывает всплывающее окно для редактирования связанной записи. Метка варианта обновляется при сохранении без перезагрузки страницы.
• Доступ с контролем разрешений — четыре разрешения по умолчанию:
• Просмотр таблиц данных (по умолчанию: Разрешить для всех)
• Добавление записей (по умолчанию: Запретить)
• Редактирование записей (по умолчанию: Разрешить)
• Удаление записей (по умолчанию: Запретить)
• Пагинация — как в административном, так и в публичном режимах постраничная навигация с 50 записями на странице.
• Конфигурация поля AJAX — при редактировании
• При выборе поля "Поиск в таблице" динамически отображаются связанные таблицы и выпадающие списки полей с помощью AJAX — перезагрузка страницы не требуется.
• Кликабельные поля URL — значения полей типа URL отображаются как кликабельные ссылки как в административной панели, так и в публичных представлениях таблиц.
• Чистая деинсталляция — все 5 таблиц базы данных удаляются при деинсталляции. Остаток данных отсутствует.

Как это работает

1. Создание определения — перейдите в AdminCP > Инструменты > Таблицы данных > Добавить определение. Присвойте ему заголовок (например, «Каталог продукции») и URL-адрес (например, «товары»).
2. Добавление полей — нажмите «Поля», чтобы определить столбцы. Например:
   • Название (Текст, Обязательно, Сортируемое)
   • Категория (Поиск — с вариантами, такими как «Электроника», «Одежда», «Дом»)
   • Цена (Число, Сортируемая)
   • В наличии (Да/Нет)
   • Веб-сайт (URL)
   • Производитель (Поиск по таблице — связан с таблицей «Производители», отображающей поле «Название»)
3. Добавление записей — нажмите «Записи», чтобы начать ввод данных. Форма автоматически генерирует правильный тип ввода для каждого поля. Нужна новая связанная запись? Нажмите «+» рядом с любым раскрывающимся списком «Поиск по таблице» и создайте ее непосредственно в тексте.
4. Импорт данных — У вас уже есть данные? Нажмите «Импорт CSV» на странице списка записей, загрузите файл, сопоставьте столбцы, просмотрите результат и импортируйте.
5. Просмотр публично — Перейдите по адресу /data-tables/products/, чтобы увидеть свою таблицу с сортируемыми столбцами, разрешенными значениями поиска, кликабельными перекрестными ссылками и аккуратным форматированием. Щелкните любую строку, чтобы просмотреть страницу с подробной информацией по удобному URL-адресу.

Пример межтабличных связей
Допустим, у вас есть две таблицы: «Производители» и «Продукты». Добавьте в таблицу «Продукты» поле поиска по таблице, указывающее на таблицу «Производители». Теперь при добавлении продукта пользователи будут выбирать из существующих производителей с помощью выпадающего списка. В таблице «Продукты» названия производителей отображаются в виде кликабельных ссылок на страницу с подробной информацией о производителе. На странице с подробной информацией о производителе в разделе «Используется» перечислены все продукты, которые ссылаются на него.

Технические характеристики

• Архитектура: Гибридный JSON + нормализованные запросы к 5 таблицам базы данных
  • xf_qubn_dt_definition - определения таблиц (title, slug, status, is_listed)
  • xf_qubn_dt_field - определения столбцов для каждой таблицы (type, options, is_show_in_table)
  • xf_qubn_dt_lookup_option - выпадающие списки для полей поиска
  • xf_qubn_dt_record - строки данных (JSON-объект для каждой записи, slug для удобных URL-адресов)
  • xf_qubn_dt_record_ref - денормализованное отслеживание межтабличных ссылок
• Производительность: Значения поиска разрешаются за один пакетный запрос. Межтабличные ссылки отслеживаются с помощью денормализованной таблицы для быстрого обратного поиска. Составные индексы по часто запрашиваемым столбцам. Пагинация до 50 записей на страницу.
• Совместимость: XenForo 2.3.x. Отсутствие расширений классов — полностью автономный код без конфликтов.
• Качество кода: Чистый код уровня 3 по PHPStan. 122 автоматизированных теста в браузере. Фильтрация всего пользовательского ввода. Защита от CSRF на всех формах.
• Обновление: Беспроблемное обновление с любой предыдущей версии (от v1.0.0 до v1.2.1) с автоматическими шагами миграции.