Базовая конфигурация

Базовая конфигурация XOOPS

Это руководство охватывает основные параметры конфигурации для правильной работы вашего сайта XOOPS после установки.

Конфигурация mainfile.php

Файл mainfile.php содержит критическую конфигурацию для вашей установки XOOPS. Он создаётся при установке, но вам может потребоваться редактировать его вручную.

Местоположение

/var/www/html/xoops/mainfile.php

Структура файла

<?php
// Конфигурация БД
define('XOOPS_DB_TYPE', 'mysqli');  // Тип БД
define('XOOPS_DB_HOST', 'localhost');  // Хост БД
define('XOOPS_DB_USER', 'xoops_user');  // Пользователь БД
define('XOOPS_DB_PASS', 'password');  // Пароль БД
define('XOOPS_DB_NAME', 'xoops_db');  // Имя БД
define('XOOPS_DB_PREFIX', 'xoops_');  // Префикс таблицы

// Конфигурация сайта
define('XOOPS_ROOT_PATH', '/var/www/html/xoops');  // Путь ФС
define('XOOPS_URL', 'http://your-domain.com/xoops');  // URL веб-сайта
define('XOOPS_TRUST_PATH', '/var/www/html/xoops/var');  // Доверенный путь

// Кодировка символов
define('XOOPS_DB_CHARSET', 'utf8mb4');  // Кодировка БД
define('_CHARSET', 'UTF-8');  // Кодировка страницы

// Режим отладки (установить на 0 в production)
define('XOOPS_DEBUG', 0);  // Установить на 1 для отладки
?>

Объяснение критических параметров

Параметр	Назначение	Пример
XOOPS_DB_TYPE	Система БД	mysqli, mysql, pdo
XOOPS_DB_HOST	Местоположение сервера БД	localhost, 192.168.1.1
XOOPS_DB_USER	Имя пользователя БД	xoops_user
XOOPS_DB_PASS	Пароль БД	[secure_password]
XOOPS_DB_NAME	Имя БД	xoops_db
XOOPS_DB_PREFIX	Префикс имени таблицы	xoops_ (позволяет несколько XOOPS на одной БД)
XOOPS_ROOT_PATH	Путь физической файловой системы	/var/www/html/xoops
XOOPS_URL	Веб-доступный URL	http://your-domain.com
XOOPS_TRUST_PATH	Доверенный путь (вне веб-корня)	/var/www/xoops_var

Редактирование mainfile.php

Откройте mainfile.php в текстовом редакторе:

# Используя nano
nano /var/www/html/xoops/mainfile.php

# Используя vi
vi /var/www/html/xoops/mainfile.php

# Используя sed (найти и заменить)
sed -i "s|define('XOOPS_URL'.*|define('XOOPS_URL', 'http://new-domain.com');|" /var/www/html/xoops/mainfile.php

Общие изменения mainfile.php

Изменить URL сайта:

define('XOOPS_URL', 'https://yourdomain.com');

Включить режим отладки (только разработка):

define('XOOPS_DEBUG', 1);

Изменить префикс таблицы (если необходимо):

define('XOOPS_DB_PREFIX', 'myxoops_');

Переместить доверенный путь вне веб-корня (расширенное):

define('XOOPS_TRUST_PATH', '/var/www/xoops_var');

Конфигурация панели администратора

Настройте основные параметры через панель администратора XOOPS.

Доступ к параметрам системы

1. Войдите в панель администратора: http://your-domain.com/xoops/admin/
2. Перейдите в: Система > Параметры > Общие параметры
3. Измените параметры (см. ниже)
4. Нажмите “Сохранить” в конце

Имя и описание сайта

Настройте, как выглядит ваш сайт:

Имя сайта: Мой сайт XOOPS
Описание сайта: Динамическая система управления содержимым
Девиз сайта: Создано с XOOPS

Контактная информация

Установите контактные данные сайта:

Электронная почта администратора сайта: admin@your-domain.com
Имя администратора сайта: Администратор сайта
Электронная почта формы обратной связи: support@your-domain.com
Адрес электронной почты поддержки: help@your-domain.com

Язык и регион

Установите язык и регион по умолчанию:

Язык по умолчанию: English
Часовой пояс по умолчанию: Europe/Moscow  (или ваш часовой пояс)
Формат даты: %Y-%m-%d
Формат времени: %H:%M:%S

Конфигурация электронной почты

Настройте параметры электронной почты для уведомлений и коммуникаций пользователей.

Место параметров электронной почты

Панель администратора: Система > Параметры > Параметры электронной почты

Конфигурация SMTP

Для надёжной доставки почты используйте SMTP вместо PHP mail():

Использовать SMTP: Да
Хост SMTP: smtp.gmail.com  (или ваш поставщик SMTP)
Порт SMTP: 587  (TLS) или 465 (SSL)
Имя пользователя SMTP: your-email@gmail.com
Пароль SMTP: [app_password]
Безопасность SMTP: TLS или SSL

Пример конфигурации Gmail

Установите XOOPS для отправки почты через Gmail:

Хост SMTP: smtp.gmail.com
Порт SMTP: 587
Безопасность SMTP: TLS
Имя пользователя SMTP: your-email@gmail.com
Пароль SMTP: [пароль приложения Google - НЕ обычный пароль]
Адрес отправителя: your-email@gmail.com
Имя отправителя: Имя вашего сайта

Примечание: Gmail требует пароля приложения, а не пароля Gmail:

1. Перейти на https://myaccount.google.com/apppasswords
2. Генерировать пароль приложения для “Mail” и “Windows Computer”
3. Использовать сгенерированный пароль в XOOPS

Конфигурация PHP mail() (проще, но менее надёжно)

Если SMTP недоступен, используйте PHP mail():

Использовать SMTP: Нет
Адрес отправителя: noreply@your-domain.com
Имя отправителя: Имя вашего сайта

Убедитесь, что ваш сервер имеет sendmail или postfix:

# Проверьте доступность sendmail
which sendmail

# Или проверьте postfix
systemctl status postfix

Параметры функции электронной почты

Настройте, что вызывает отправку писем:

Отправлять уведомления: Да
Уведомлять администратора при регистрации: Да
Отправлять приветственное письмо новым пользователям: Да
Отправлять ссылку сброса пароля: Да
Включить электронную почту пользователя: Да
Включить приватные сообщения: Да
Уведомлять об административных действиях: Да

Конфигурация часового пояса

Установите правильный часовой пояс для правильных временных меток и планирования.

Установка часового пояса в панели администратора

Путь: Система > Параметры > Общие параметры

Часовой пояс по умолчанию: [Выберите ваш часовой пояс]

Распространённые часовые пояса:

• Europe/Moscow (MSK)
• Europe/London (GMT/BST)
• Europe/Paris (CET/CEST)
• Asia/Tokyo (JST)
• Asia/Shanghai (CST)
• Australia/Sydney (AEDT/AEST)
• America/New_York (EST/EDT)
• America/Los_Angeles (PST/PDT)

Проверка часового пояса

Проверить текущий часовой пояс сервера:

# Показать текущий часовой пояс
timedatectl

# Или проверить дату
date +%Z

# Список доступных часовых поясов
timedatectl list-timezones

Установка часового пояса системы (Linux)

# Установить часовой пояс
timedatectl set-timezone Europe/Moscow

# Или использовать метод symlink
ln -sf /usr/share/zoneinfo/Europe/Moscow /etc/localtime

# Проверка
date

Конфигурация URL

Включить понятные URL (дружественные URL)

Для URL вроде /page/about вместо /index.php?page=about

Требования:

• Apache с mod_rewrite включён
• Файл .htaccess в корне XOOPS

Включить в панели администратора:

1. Перейдите в: Система > Параметры > Параметры URL
2. Отметьте: “Включить дружественные URL”
3. Выберите: “Тип URL” (Path Info или Query)
4. Сохранить

Проверить наличие .htaccess:

cat /var/www/html/xoops/.htaccess

Примерное содержание .htaccess:

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /xoops/
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ index.php?$1 [L,QSA]
</IfModule>

Устранение неполадок понятных URL:

# Проверить mod_rewrite включён
apache2ctl -M | grep rewrite

# Включить при необходимости
a2enmod rewrite

# Перезагрузить Apache
systemctl restart apache2

# Тест правила переписывания
curl -I http://your-domain.com/xoops/index.php

Настроить URL сайта

Панель администратора: Система > Параметры > Общие параметры

Установите правильный URL для вашего домена:

URL сайта: http://your-domain.com/xoops/

Или если XOOPS находится в корне:

URL сайта: http://your-domain.com/

Оптимизация для поисковых систем (SEO)

Настройте параметры SEO для лучшей видимости в поисковых системах.

Мета-теги

Установите глобальные мета-теги:

Панель администратора: Система > Параметры > Параметры SEO

Ключевые слова Meta: xoops, cms, система управления содержимым
Описание Meta: Динамическая система управления содержимым

Они появляются в <head> страницы:

<meta name="keywords" content="xoops, cms, система управления содержимым">
<meta name="description" content="Динамическая система управления содержимым">

Карта сайта

Включите XML карту сайта для поисковых систем:

1. Перейдите в: Система > Модули
2. Найдите модуль “Sitemap”
3. Нажмите для установки и включения
4. Доступ к карте сайта в: /xoops/sitemap.xml

Robots.txt

Управляйте сканированием поисковых систем:

Создайте /var/www/html/xoops/robots.txt:

User-agent: *
Allow: /
Disallow: /admin/
Disallow: /templates_c/
Disallow: /install/
Disallow: /upgrade/

Sitemap: https://your-domain.com/xoops/sitemap.xml

Параметры пользователя

Настройте параметры по умолчанию, связанные с пользователями.

Регистрация пользователя

Панель администратора: Система > Параметры > Параметры пользователя

Разрешить регистрацию пользователя: Да/Нет
Тип регистрации пользователя:
  - Мгновенное (автоматическое одобрение)
  - Требуется одобрение (одобрение администратора)
  - Проверка электронной почты (требуется подтверждение)

Требуется подтверждение по электронной почте: Да/Нет
Метод активации учётной записи: Автоматический/ручной

Профиль пользователя

Включить профили пользователей: Да
Показать аватар пользователя: Да
Максимальный размер аватара: 100KB
Размеры аватара: 100x100 пикселей

Отображение электронной почты пользователя

Показать электронную почту пользователя: Нет (для приватности)
Пользователи могут скрыть электронную почту: Да
Пользователи могут изменить аватар: Да
Пользователи могут загружать файлы: Да

Конфигурация кэша

Улучшите производительность с правильным кэшированием.

Параметры кэша

Панель администратора: Система > Параметры > Параметры кэша

Включить кэширование: Да
Метод кэша: File (или APCu/Memcache если доступно)
Время жизни кэша: 3600 секунд (1 час)

Очистить кэш

Удалить старые файлы кэша:

# Ручная очистка кэша
rm -rf /var/www/html/xoops/cache/*
rm -rf /var/www/html/xoops/templates_c/*

# Из панели администратора:
# Система > Панель управления > Инструменты > Очистить кэш

Контрольный список начальных параметров

После установки настройте:

• Имя и описание сайта установлены правильно
• Электронная почта администратора настроена
• Параметры SMTP электронной почты настроены и протестированы
• Часовой пояс установлен на ваш регион
• URL настроен правильно
• Понятные URL (дружественные URL) включены, если требуется
• Параметры регистрации пользователя настроены
• Мета-теги для SEO настроены
• Язык по умолчанию выбран
• Параметры кэша включены
• Пароль пользователя администратора надёжный (16+ символов)
• Тест регистрации пользователя
• Тест функциональности электронной почты
• Тест загрузки файла
• Посетить главную страницу и проверить внешний вид

Конфигурация тестирования

Тест электронной почты

Отправьте тестовое письмо:

Панель администратора: Система > Тест электронной почты

Или вручную:

/var/www/html/xoops/test-email.php

<?php
require_once __DIR__ . '/mainfile.php';
require_once XOOPS_ROOT_PATH . '/class/mail/phpmailer/class.phpmailer.php';

$mailer = xoops_getMailer();
$mailer->addRecipient('admin@your-domain.com');
$mailer->setSubject('Тест электронной почты XOOPS');
$mailer->setBody('Это тестовое письмо из XOOPS');

if ($mailer->send()) {
    echo "Письмо отправлено успешно!";
} else {
    echo "Ошибка отправки письма: " . $mailer->getError();
}
?>

Тест подключения БД

/var/www/html/xoops/test-db.php

<?php
require_once __DIR__ . '/mainfile.php';

$connection = XoopsDatabaseFactory::getDatabaseConnection();
if ($connection) {
    echo "БД подключена успешно!";
    $result = $connection->query("SELECT COUNT(*) FROM " . $connection->prefix("users"));
    if ($result) {
        echo "Запрос успешен!";
    }
} else {
    echo "Ошибка подключения БД!";
}
?>

Важно: Удалить тестовые файлы после тестирования!

rm /var/www/html/xoops/test-*.php

Сводка файлов конфигурации

Файл	Назначение	Метод редактирования
mainfile.php	Параметры БД и ядра	Текстовый редактор
Панель администратора	Большинство параметров	Веб-интерфейс
.htaccess	Переписывание URL	Текстовый редактор
robots.txt	Сканирование поисковыми системами	Текстовый редактор

Следующие шаги

После базовой конфигурации:

1. Настройте параметры системы в деталях
2. Усилите безопасность
3. Изучите панель администратора
4. Создайте ваше первое содержимое
5. Установите учётные записи пользователей

---

Теги: #configuration #setup #email #timezone #seo

Связанные статьи:

• ../Installation/Installation
• System-Settings
• Security-Configuration
• Performance-Optimization