Обзор дополнительных полей в коде

Обзор дополнительных полей в коде
Дополнительные поля в Cotonti - это пользовательские поля, которые расширяют структуру данных по умолчанию для таких объектов, как страницы или категории. Они позволяют администраторам определять дополнительные атрибуты (например, настраиваемые текстовые поля, выпадающие списки или флажки) для страниц, которые хранятся в базе данных и могут использоваться в шаблонах или логике. Код включает в себя несколько функций, которые управляют дополнительными полями для страниц (таблица страниц) и категориями страниц (таблица структуры).

Ключевые функции и обработка дополнительных полей
Вот как дополнительные поля интегрируются в предоставленный код, с акцентом на их роль и потенциальную экстраполяцию.:

Регистрация дополнительных полей:

cot_extrafields_register_table('page');

Это регистрирует таблицу страниц для дополнительных полей, позволяя определять пользовательские поля в панели администратора CMS.
Аналогично, дополнительные поля могут быть зарегистрированы для таблицы структуры (используемой для категорий страниц).
Экстраполяция: Вы можете распространить это на другие таблицы в Cotonti (например, пользователи, комментарии), вызвав cot_extrafields_register_table() для этих таблиц, включив настраиваемые поля в разных модулях.

Генерация тегов страниц с дополнительными полями (cot_generate_pagetags):

if (!empty(Cot::$extrafields[Cot::$db->pages])) {
    foreach (Cot::$extrafields[Cot::$db->pages] as $exfld) {
        $tag = mb_strtoupper($exfld['field_name']);
        $exfld_title = cot_extrafield_title($exfld, 'page_');
        $temp_array[$tag . '_TITLE'] = $exfld_title;
        $temp_value = isset($page_data['page_'.$exfld['field_name']]) ? $page_data['page_'.$exfld['field_name']] : null;
        $temp_array[$tag] = cot_build_extrafields_data('page', $exfld, $temp_value, $page_data['page_parser']);
        $temp_array[$tag . '_VALUE'] = $temp_value;
    }
}

Этот код генерирует теги шаблона для каждого дополнительного поля, связанного с таблицей pages. Например, если определено дополнительное поле с именем color, создаются такие теги, как PAGE_ROW_COLOR, PAGE_ROW_COLOR_TITLE и PAGE_ROW_COLOR_VALUE.
Функция cot_build_extrafields_data форматирует значение дополнительного поля на основе его типа (например, text, select, checkbox) и синтаксического анализа страницы (например, HTML, BBCode).

Экстраполя:
Вы можете добавить новые типы дополнительных полей (например, выбор даты, загрузка файла), расширив cot_build_extrafields_data для обработки пользовательского форматирования или проверки.
Вы можете изменить соглашение об именовании тегов (например, использовать строчные или пользовательские префиксы), изменив переменную $tag.
Вы можете создать условную логику для отображения дополнительных полей только для определенных категорий страниц или ролей пользователей, добавив проверки в цикле.
Дополнительные поля для категорий (структурная таблица):

if (isset(Cot::$extrafields[Cot::$db->structure])) {
    foreach (Cot::$extrafields[Cot::$db->structure] as $exfld) {
        $tag = mb_strtoupper($exfld['field_name']);
        $exfld_title = cot_extrafield_title($exfld, 'structure_');
        $temp_array['CAT_' . $tag . '_TITLE'] = $exfld_title;
        $temp_value = isset(Cot::$structure['page'][$page_data['page_cat']][$exfld['field_name']]) ? Cot::$structure['page'][$page_data['page_cat']][$exfld['field_name']] : null;
        $temp_array['CAT_' . $tag] = cot_build_extrafields_data('structure', $exfld, $temp_value);
        $temp_array['CAT_' . $tag.'_VALUE'] = $temp_value;
    }
}

Аналогично дополнительным полям страницы, это создает теги для дополнительных полей, относящихся к определенной категории (например, CAT_CUSTOMFIELD, CAT_CUSTOMFIELD_TITLE).

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

Сортировка по дополнительным полям (cot_page_config_order):

foreach($cot_extrafields[$db_pages] as $exfld) {
    $options_sort[$exfld['field_name']] = isset($L['page_'.$exfld['field_name'].'_title']) ? $L['page_'.$exfld['field_name'].'_title'] : $exfld['field_description'];
}

Эта функция позволяет сортировать страницы по значениям дополнительных полей в панели администратора или на лицевой стороне и в списках.
Экстраполяция:
Вы можете добавить пользовательскую логику сортировки для определенных типов дополнительных полей (например, числовые поля сортируются как числа, поля данных анализируются как временные метки).
Вы могли бы реализовать многополевую сортировку (например, сортировать по exfld_priority, а затем по page_data), изменив $sql_order в cost_page_enum.

Импорт дополнительных данных поля (cot_page_import):

if (!empty(Cot::$extrafields[Cot::$db->pages])) {
    foreach (Cot::$extrafields[Cot::$db->pages] as $exfld) {
        $value = isset($rpage['page_' . $exfld['field_name']]) ? $rpage['page_' . $exfld['field_name']] : null ;
        $rpage['page_' . $exfld['field_name']] = cot_import_extrafields('rpage' . $exfld['field_name'], $exfld, $source, $value, 'page_');
    }
}

Это позволяет импортировать значения дополнительных полей из параметров запроса (например, при отправке формы) и проверять их на основе их типа.
Экстраполя:
Вы можете добавить пользовательские правила проверки для определенных дополнительных полей (например, регулярное выражение для поля номера телефона), расширив cot_import_extrafields.
Вы могли бы реализовать условные поля (например, показывать дополнительное поле только в том случае, если другое поле имеет определенное значение), добавив логику в процесс импорта.
Добавление и обновление страниц с дополнительными полями (cot_page_add, cot_page_update):
Обе функции вызывают функцию cot_extrafield_movefiles() для обработки загрузки файлов с дополнительными полями типа file.
Экстраполяция:
Вы можете расширить обработку файлов, чтобы поддерживать загрузку нескольких файлов или определенных типов файлов (например, только изображений), изменив конфигурацию extrafield и cot_extrafield_movefiles.
Вы можете добавить перехватчики для обработки данных с дополнительными полями до или после сохранения (например, изменения размера изображений, создания миниатюр).

Идеи для экстраполяции
На основе кода ниже приведены способы расширения или экстраполяции функциональности с дополнительными полями:

Новые типы дополнительных полей:
Добавьте поддержку сложных типов, таких как JSON, геолокация или поля с множественным выбором, обновив cot_build_extrafields_data и схему базы данных.
Пример: Дополнительное поле геолокации может хранить широту/долготу и генерировать теги карты для шаблонов.
Условное отображение:
Измените cot_generate_pagetags, чтобы включить дополнительные поля только для определенных категорий страниц или ролей пользователей.:

if ($page_data['page_cat'] === 'special_category') {
    $temp_array['CUSTOM_FIELD'] = $page_data['page_custom_field'];
}

Динамические шаблоны:
Позволяют использовать дополнительные поля для определения пользовательских фрагментов шаблона. Например, дополнительное поле может указывать пользовательскую структуру HTML для отображения:

$temp_array[$tag . '_CUSTOM'] = cot_parse($exfld['field_template'], $page_data['page_' . $exfld['field_name']]);

Интеграция с API:
Предоставьте доступ к дополнительным полям через xa API (https://x.ai/api), сериализовав их в теги cot_generate_page для вывода в формате JSON.
Пример:

$temp_array['API_EXTRAFIELDS'] = json_encode(array_filter($temp_array, fn($key) => str_starts_with($key, 'EXTRA_'), ARRAY_FILTER_USE_KEY));

Расширенная проверка:
Добавьте пользовательские правила проверки в cost_page_validate для определенных дополнительных полей:

if ($exfld['field_name'] === 'phone_number') {
    cot_check(!preg_match('/^\+?\d{10,12}$/', $rpage['page_phone_number']), 'Invalid phone number', 'rpagephone_number');
}

Аналитика и отчетность:
Используйте дополнительные поля для аналитики, например, для отслеживания приоритетов страницы или пользовательских показателей. Создавайте диаграммы (например, с помощью Chart.js) для визуализации распределения данных по дополнительным полям.

Практический пример
Предположим, вы хотите добавить дополнительное поле "приоритет" к страницам, чтобы управлять порядком их отображения в cot_page_enum. Ты можешь:

Задайте дополнительное поле в панели администратора (тип: целое число, имя: приоритет).
Измените cot_page_enum для сортировки по этому полю:

$order = 'page_priority DESC, page_date DESC';

Сгенерировать тег шаблона для приоритета:

$temp_array['PRIORITY'] = $page_data['page_priority'];

В шаблоне tpl страницы с высоким приоритетом отображаются по-разному

<!-- IF {PAGE_ROW_PRIORITY} > 5 -->
    <div class="high-priority">{PAGE_ROW_TITLE}</div>
<!-- ELSE -->
    <div>{PAGE_ROW_TITLE}</div>
<!-- ENDIF -->

Ограничения и рекомендации
Производительность базы данных: Добавление большого количества дополнительных полей может увеличить размер базы данных и сложность запросов. Используйте индексацию для часто запрашиваемых полей.
Накладные расходы на шаблон: создание большого количества тегов с дополнительными полями может замедлить вывод шаблона. Рассмотрите возможность отложенной загрузки несущественных полей.
Безопасность: Проверьте и обработайте ввод дополнительных полей в cot_page_import, чтобы предотвратить внедрение SQL или XSS-атаки.
Вывод
Система дополнительных полей в этом коде отличается высокой гибкостью, позволяя легко интегрировать пользовательские данные на страницы и в категории. Расширяя существующие функции, вы можете добавлять новые типы полей, улучшать проверку, интегрировать с API или оптимизировать производительность. Если у вас есть конкретный вариант использования дополнительных полей (например, новый тип поля или логика отображения), дайте мне знать, и я смогу предоставить более целенаправленную экстраполяцию!