Основное назначение файла и его место в системе Cotonti
Файл page.setup.php является конфигурационным файлом модуля "Pages" (Страницы) в системе управления контентом Cotonti CMF. Он находится в директории /modules/page/, что указывает на его принадлежность к модулю, обрабатывающему страницы и их категории.
Его основная цель — определить метаданные модуля и параметры конфигурации, которые регулируют работу модуля "Pages". Этот файл не содержит логики выполнения PHP-кода в привычном виде, а представляет собой структуру с описанием настроек, которые используются движком для автоматического подключения модуля, его настройки и управления через административную панель.
Структура и содержимое файла
-
Блок [BEGIN_COT_EXT] / [END_COT_EXT]
Этот блок описывает основные метаданные модуля:
- Название модуля (Pages) и его описание (Pages and Categories) определяют, как модуль будет отображаться в административной панели.
- Версия, дата релиза, авторство и информация о лицензии (BSD License) нужны для контроля версий и соблюдения авторских прав.
- Параметры Auth_guests, Lock_guests, Auth_members, Lock_members регулируют уровни доступа для гостей и зарегистрированных пользователей (например, только чтение для гостей и расширенные права для участников).
- Параметр Admin_icon (не задан в данном файле) позволяет назначить иконку для модуля в панели администратора.
-
Блок [BEGIN_COT_EXT_CONFIG] / [END_COT_EXT_CONFIG]
Этот блок описывает настройки, которые могут быть изменены администратором сайта в панели управления:
- markup — включает или отключает использование разметки текста.
- parser — задает парсер для обработки контента, вызывая функцию
cot_get_parsers().
- count_admin — учитывает ли статистика действия администратора.
- autovalidate — автоматическая проверка страниц перед публикацией.
- maxlistsperpage — максимальное количество элементов (страниц), отображаемых на одной странице списка.
- title_page — шаблон для формирования заголовка страницы.
-
Блок [BEGIN_COT_EXT_CONFIG_STRUCTURE] / [END_COT_EXT_CONFIG_STRUCTURE]
Этот блок отвечает за настройки структуры категорий страниц:
- order — задает порядок сортировки страниц (например, по названию), вызывая функцию
cot_page_config_order().
- way — направление сортировки (по возрастанию или убыванию).
- maxrowsperpage — максимальное количество строк на одной странице списка.
- truncatetext — обрезка текста для предпросмотра.
- allowemptytext — разрешение на создание страниц с пустым текстом.
- keywords, metatitle, metadesc — SEO-настройки для страниц (ключевые слова, мета-заголовки и мета-описания).
Взаимодействие с другими частями сайта
Файл page.setup.php не выполняется напрямую при обработке запросов на сайте. Вместо этого он загружается и интерпретируется системой Cotonti в момент инициализации модуля "Pages":
- Административная панель использует данные из этого файла для формирования настроек модуля, которые видны и доступны для изменения администраторам.
- Другие модули и плагины могут ссылаться на параметры из
page.setup.php для настройки взаимодействия с модулем "Pages".
- Система прав доступа Cotonti использует настройки
Auth_guests и Auth_members для управления доступом к функциональности модуля.
Заключение
Файл page.setup.php — это конфигурационный элемент модуля "Pages", определяющий его свойства, настройки и параметры доступа. Он не выполняет функции обработки данных, но является критически важным для правильной работы модуля, взаимодействуя с ядром Cotonti, административной панелью и другими модулями системы.
<?php
/* ====================
[BEGIN_COT_EXT] // Начало блока описания расширения Cotonti.
Name=Pages // Название модуля — "Pages" (Страницы).
Description=Pages and Categories // Описание модуля — "Страницы и категории".
Version=1.0.14 // Версия модуля — 1.0.14.
Date=2024-11-21 // Дата последнего обновления модуля — 21 ноября 2024 года.
Author=Neocrome & Cotonti Team // Авторы модуля — Neocrome и команда Cotonti.
Copyright=(c) Cotonti Team 2008-2024 // Авторские права принадлежат команде Cotonti за период с 2008 по 2024 годы.
Notes=BSD License // Лицензия на использование — BSD License.
Auth_guests=R // Права доступа для гостей: R (только чтение).
Lock_guests=A // Ограничение для гостей: A (администрирование недоступно).
Auth_members=RW1 // Права доступа для зарегистрированных пользователей: R (чтение), W (запись), 1 (дополнительные привилегии).
Lock_members= // Ограничений для зарегистрированных пользователей нет.
Admin_icon= // Иконка для панели администратора не указана.
[END_COT_EXT] // Завершение блока описания расширения.
[BEGIN_COT_EXT_CONFIG] // Начало блока конфигурации настроек модуля.
markup=01:radio::1: // Опция "markup" (разметка), тип — переключатель (radio), значение по умолчанию — 1 (включено).
parser=02:callback:cot_get_parsers():none: // Опция "parser" (парсер), тип — callback, вызывается функция cot_get_parsers(), значение по умолчанию — none.
count_admin=03:radio::0: // Опция "count_admin" (учёт для администраторов), тип — переключатель, значение по умолчанию — 0 (выключено).
autovalidate=04:radio::1: // Опция "autovalidate" (автоматическая проверка), тип — переключатель, значение по умолчанию — 1 (включено).
maxlistsperpage=06:select:5,10,15,20,25,30,40,50,60,70,100,200,500:30: // Опция "maxlistsperpage" (максимум элементов на странице), тип — выбор из списка, возможные значения: 5–500, значение по умолчанию — 30.
title_page=07:string::{TITLE} - {CATEGORY}: // Опция "title_page" (шаблон заголовка страницы), тип — строка, значение по умолчанию — "{TITLE} - {CATEGORY}".
[END_COT_EXT_CONFIG] // Завершение блока конфигурации настроек модуля.
[BEGIN_COT_EXT_CONFIG_STRUCTURE] // Начало блока конфигурации структуры категорий.
order=01:callback:cot_page_config_order():title: // Опция "order" (порядок сортировки), тип — callback, вызывается функция cot_page_config_order(), значение по умолчанию — сортировка по заголовку (title).
way=02:select:asc,desc:asc: // Опция "way" (направление сортировки), тип — выбор из списка (asc — по возрастанию, desc — по убыванию), значение по умолчанию — asc.
maxrowsperpage=03:string::30: // Опция "maxrowsperpage" (максимум строк на странице), тип — строка, значение по умолчанию — 30.
truncatetext=04:string::0: // Опция "truncatetext" (обрезка текста), тип — строка, значение по умолчанию — 0 (обрезка отключена).
allowemptytext=05:radio::0: // Опция "allowemptytext" (разрешить пустой текст), тип — переключатель, значение по умолчанию — 0 (не разрешено).
keywords=06:string::: // Опция "keywords" (ключевые слова для SEO), тип — строка, значение по умолчанию — пусто.
metatitle=07:string::: // Опция "metatitle" (мета-заголовок для SEO), тип — строка, значение по умолчанию — пусто.
metadesc=08:string::: // Опция "metadesc" (мета-описание для SEO), тип — строка, значение по умолчанию — пусто.
[END_COT_EXT_CONFIG_STRUCTURE] // Завершение блока конфигурации структуры категорий.
==================== */
