FANDOM


AddRailModule добавляет пользовательский модуль с рельс (правую колонку) вашей вики. По умолчанию контент страницы Template:RailModule вниз рельса, прямо над блоком популярных страниц. Используя конфигурацию, можно добавить сразу несколько модулей, а два из них могут быть помещены на верх рельса, под блок с рекламой. Каждый такой модуль обернут в селектор section.railModule.rail-module.

Существует лимит на количество и высоту разрешенных блоков в рельсе. Общая высота пользовательских модулей не должна превышать высоту стандартных модулей. Также только один модуль может быть размещен над модулем Недавней вики-деятельности.

Установка

Настройка

Чтобы добавить содержимое Template:RailModule в начало рельса, напишите:

window.AddRailModule = [{ prepend: true }];

Несколько модулей с контентом страниц Template:Foo, Template:Bar и Template:Baz в низ рельса, воспользуйтесь кодом:

window.AddRailModule = ['Template:Foo', 'Template:Bar', 'Template:Baz'];

Чтобы добавить несколько модулей и в верх, и в низ рельса, напишите:

window.AddRailModule = [
    { page: 'Template:Foo', prepend: true },
    'Template:Bar',
    'Template:Baz',
];

Если для добавления на верх будет назначено больше двух блоков, будут учитываться только первые два:

window.AddRailModule = [
    { page: 'Template:Foo', prepend: true },  // пойдет
    { page: 'Template:Bar', prepend: true },  // пойдет
    { page: 'Template:Baz', prepend: true }   // не пойдет; будет добавлен в низ
];

Контент каждого модуля может быть сохранен в кеше на maxAge секунд. По умолчанию это значение установлено на 300 секунд (пять минут). Если ваш блок должен обновляться часто (например, он содержит опрос) или если он зависит от переменных страницы типа {{PAGENAME}}, тогда нужно смело ставить maxAge на ноль секунд. А вот если модуль может находиться в одном состоянии долго, хорошим значением для maxAge станет 86400 секунд, что составляет одни сутки.

window.AddRailModule = [
    { page: 'Template:RandomGreeting', prepend: true, maxAge: 0 },
    { page: 'Template:FAQs', maxAge: 86400 }
];

Использование настроек для скриптов из Fandom Developers Wiki

Инструкции на этой странице описывают, как использовать настройки для скриптов. Здесь, на вики Fandom Developers Wiki, у многих скриптов есть необязательные параметры, применяемые как средство изменения или улучшения поведения скриптов по умолчанию. При настройке параметров в JS обратите внимание на то, что они должны находиться выше импорта для работы, если в описании скрипта не указано иное. Если для загрузки скриптов используется страница MediaWiki:ImportJS, то она будет загружена последней.

Настройки загружаются поздно, не работают
// 1. опция импорта AjaxRC
importScriptPage('AjaxRC/code.js','dev');
 
// 2. опция с настройками AjaxRC
var ajaxRefresh = 30000;
Правильное размещение настроек
// 1. опция с настройками AjaxRC
var ajaxRefresh = 30000;
 
// 2. опция импорта AjaxRC
importScriptPage('AjaxRC/code.js','dev');

Оформление

Чтобы выделить все пользовательские модули, используйте селектор .railModule.

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

Расширенное использование

Если ваш модуль использует такие теги, как <gallery/> или <twitter/>, может выясниться, что они не загружаются нормально. В таком случае загляните в статью "Rewire", раздел "Support", и если они указаны в этом списке, импортируйте скрипт dev:Rewire.js с помощью MediaWiki:ImportJS.

Community content is available under CC-BY-SA unless otherwise noted.

Fandom may earn an affiliate commission on sales made from links on this page.

Stream the best stories.

Fandom may earn an affiliate commission on sales made from links on this page.

Get Disney+