Sape в Mediawiki

Я давно хотел обновить тему для сайта на движке MediWiki. Мне нравится тема Vector, но как добавить туда рекламный код не понимал. Поиске в интернете с периодичностью пару в пару месяцев не давал результатов.

Так что я решил потратить время и разобраться с этим вопросом. Но перво-наперво я скачал новый скин из движка. Пришлось обновить движок до последней версии. Выяснилось, что теперь нужно обновить PHP. Ладно это не сложно, благо, что подобное делается в несколько кликов (сайт крутиться на хостинге от Reg.ru, но это также легко сделать в любой панели ISPManagaer). В любом случае, проверяйте версии, которые требуется для установки или обновления сайта. Меня оправдывает, что есть свежий BackUp, а посещаемость сайта около 10 человек в день. Это тестовый сайт. На нем протестирую и буду обновлять второй, где посещаемость гораздо выше.

Итак, приступаем. Устанавливать я буду рекламный блок от Sape. Но от других бирж не сильно отличается установка.

Первым делом прописываем инициализацию кода Sape, для это нужно в файл настроек LocalSettings.php, в конец файла дописать код с сайта (не забудьте исправить пользователя Sape на свой):

# SAPE
global $sape;
if (!defined('_SAPE_USER')){
    define('_SAPE_USER', 'КОД ПОЛЬЗОВАТЕЛЯ SAPE');
}
$o[ 'force_show_code' ] = true;
require_once ("$IP".'/'._SAPE_USER.'/sape.php');
$o['charset'] = 'UTF-8';
$sape = new SAPE_client($o);
unset($o);

В корень сайта закидываем папку от SAPE (папка имеет кучу случайных символов), в ней два файла sape.php и .htaccess

А теперь самое сложно. Заходим в папку mediawiki\skins\Vector\includes\VectorTemplate.php

private function buildSidebar() : array {
// находим данную функцию

// и перед циклом надо добавить свой код
foreach ( $portals as $name => $content ) {

То есть должно получиться что-то подобное

private function buildSidebar() : array {
    $skin = $this->getSkin();
    $portals = $skin->buildSidebar();
    $props = [];
    $languages = null;
    // Render portals

    // ДОБАВЛЯЕМ СЮДА
    global $sape;
    $portals['SAPE'] = [
        $sape->return_block_links()
        ];
    foreach ( $portals as $name => $content ) {

Чуть ниже находим swith, в который добавляем прямо перед case 'SEARCH':

case 'SAPE':
$html = $content[0];
$content = [];
wfDeprecated(
    "`content` field in portal $name must be array."
    . "Previously it could be a string but this is no longer supported.",
    '1.35.0'
);
$portal = $this->getMenuData(
    $name, $content, self::MENU_TYPE_PORTAL
);

if ( $html ) {
    $portal['class'] = 'vector-menu vector-menu-portal portal';
    $portal['html-items'] .= $html;
}
$props[] = $portal;
break;

Вот и всё. Код должен выводиться.

В принципе тут можно любой html код выводить, нужно просто добавить перед циклом foreach $portals['индификатор'] = HTML_CODE и в SWITH нужно добавить его обработку (просто скопировать CASE 'SAPE', где просто меняем SAPE на наш идентификатор).