Настройка MediaWiki при помощи файла LocalSettings.php

Linux, VPS | Amber | Комментировать запись

MediaWiki – это приложение для создания вики-сайтов и управления ними. Изначально разрабатывалось компанией WikiMedia Foundation для обслуживания проекта Wikipedia. На сегодняшний день данное приложение доступно и для поддержки менее объёмных проектов.

Примечание: Для выполнения данного руководства нужно предварительно установить MediaWiki на виртуальный выделенный сервер. Все необходимые инструкции можно найти в этом руководстве.

В данном руководстве речь пойдёт о базовой настройке MediaWiki, которую можно выполнить при помощи файла LocalSettings.php.

Можно ли изменить настройки через веб-интерфейс?

В целом, большинство настроек и задач по управлению доступно в обычнчом веб-интерфейсе вики, однако существует некоторые настройки, которые требуют редактирования текстовых файлов сервера.

Файл LocalSettings.php не доступен из веб-интерфейса из соображений безопасности. Чтобы отредактировать файл вручную, нужно подключиться к серверу по SSH.

Где хранятся стандартные настройки MediaWiki?

Настройки по умолчанию хранятся в файле под названием DefaultSettings.php.

Файл DefaultSettings.php ни в коем случае нельзя редактировать, но иногда в нём можно найти необходимые значения. Откройте файл для просмотра:

less /etc/mediawiki/includes/DefaultSettings.php

Чтобы изменить, какое-либо значение, запишите его, а затем внесите изменения в файл LocalSettings.php.

Как изменять параметры MediaWiki?

Все пользовательские настройки следует вносить в файл LocalSettings.php. Он очень похож на DefaultSettings.php, но он немного короче. Введите следующую команду, чтобы открыть файл для редактирования:

sudo nano /etc/mediawiki/LocalSettings.php

Этот файл написан на PHP, но синтаксис его достаточно прост и понятен. В большинстве своём он имеет такой вид:

$VariableName      = "VariableValue";

Этот файл содержит большое количество настроек, но в нём определены далеко не все доступные настройки. Как правило, в нём находятся настройки, значение которых противоречат стандартным настройкам файла DefaultSettings.php.

Чтобы изменить настройки DefaultSettings.php, нужно найти соответствующий параметр в LocalSettings.php и изменить его. Если такого параметра нет, нужно просто добавить его в конец файла.

Общие параметры настроек

Перед изменением любых настроек рекомендуется создать резервную копию конфигурационных файлов (на случай если что-то не сработает):

sudo cp /etc/mediawiki/LocalSettings.php /etc/mediawiki/LocalSettings.php.bak

Откройте файл LocalSettings.php для редактирования:

sudo nano /etc/mediawiki/LocalSettings.php

Изменение названия сайта

Название сайта указывается во время начальной настройки mediawiki. Чтобы изменить название сайта, отредактируйте переменные wgSitename и wgMetaNamespace.

$wgSitename         = "New Site Name";
$wgMetaNamespace    = "New_Site_Name";

Вторая переменная устанавливает пространство имен для страниц, которые относятся к вики. Обратите внимание: она не позволяет использовать пробелы.

Изменение языка сайта

Чтобы изменить языковую кодировку сайта, измените значение переменной wgLanguageCode:

$wgLanguageCode = "language_code";

Фраза language_code в этом примере заменяет любое значение, содержащееся в файле:

less /etc/mediawiki/languages/Names.php

Изменив язык, запустите скрипт, который активирует изменения:

cd /etc/mediawiki/maintenance
sudo php rebuildmessages.php --rebuild

Как разрешить загрузку изображений

Прежде, чем позволить загрузку изображений на вики, нужно установить некоторые дополнительные программы для обработки изображений из набора imagemagick:

sudo apt-get install imagemagick

Снова откройте файл LocalSettings.php:

sudo nano /etc/mediawiki/LocalSettings.php

Чтобы пользователи вики могли подгружать изображения, измените значение переменной wgEnableUploads на true:

$wgEnableUploads = true;

Раскомментируйте следующие две переменные, чтобы программа MediaWiki нала использовать imagemagick для  преобразования, управления и изменения размеров изображений.

$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";

Эти настройки позволяют использовать свёрнутые изображения.

По умолчанию поддерживаются форматы png, gif и jpeg/jpg. Чтобы настроить поддержку других форматов, добавьте переменную wgFileExtensions:

$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'pdf', 'additional_format', '...')

Примечание: Любой веб-сайт, который принимает контент от пользователей, подвергается определенному уровню риска! Позволяя пользователям загружать изображения, осознавайте последствия такой активности и примите соответствующие меры безопасности.

Разрешение изображений WikiCommons

Следующая важная переменная зовётся wgUseInstantCommons. Она позволяет вики-сайту автоматически настраивать доступ к контенту Wikimedia Commons. Его можно встроить в страницы сайта.

$wgUseInstantCommons = true;

Чтобы использовать изображения Wikimedia Commons, найдите здесь нужное изображение:

http://commons.wikimedia.org/

Скопируйте его URL, а затем откройте или отредактируйте страницу и просто вставьте скопированную только что ссылку в двойных скобках:

[[File:Parson_Russell_Terrier_Puppy_3_Months_Old.jpg]]

После этого изображение будет доступно на странице вашего сайта.

Чтобы вместо этого использовать миниатюру изображения, добавьте после имени файла прямой слэш (символ |) и thumb:

[[File:Parson_Russell_Terrier_Puppy_3_Months_Old.jpg|thumb]]

Изменение логотипа

У вики-страниц есть стандартный логотип. Пользователи сети Интернет часто интересуются, как изменить этот логотип в левом верхнем углу страницы, чтобы он имел отношение к сайту.

Для начала нужно скопируйте файл логотипа в соответствующий каталог на виртуальном сервере:

scp /path/to/local/image.png username@server_ip:/etc/mediawiki/skins/common/images/

Затем измените путь в wgLogo, указав путь к файлу логотипа:

$wgLogo         = "$wgStylePath/common/images/image_name.png

Стандартный логотип будет изменён только что подгруженным изображением.

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

Для получения сообщений электронной почты, в том числе отчетов об ошибках, укажите свою электронную почту в переменной wgEmergencyContact.

$wgEmergencyContact = "your_email@address.com"

Также нужно настроить wgPasswordSender, указав действующий адрес электронной почты, чтобы пользователи могли сообщать о возникновении неполадок или проблем.

$wgPasswordSender = "password_email@address.com"

Заключение

Теперь вы знаете основы использования файла LocalSettings.php.

На самом деле, в MediaWiki существует огромное количество настроек, не включённых в LocalSettings.php по умолчанию. Не забывайте обращаться к /etc/mediawiki/includes/DefaultSettings.php.

Подробную информацию о конкретных переменных можно найти здесь.