dev

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

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

Installation

Configuration

Чтобы добавить содержимое 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 секунд, что составляет одни сутки.

Using configuration options with Fandom Developers Wiki scripts

The instructions on this page describe how to use configuration options with a script. Here on the Fandom Developers Wiki, many scripts provide optional configuration settings as a mean to alter or enhance the default behavior of the script. When installing configuration options in your JavaScript file, please note that they need to go above the import statement in order to work — unless the directions say otherwise. In case MediaWiki:ImportJS is used to load the scripts, it will be executed last.

Configuration options load too late, don't work
// 1. AjaxRC import statement
importArticles({
    type: 'script',
    articles: [
        'u:dev:MediaWiki:AjaxRC.js'
    ]
});

// 2. AjaxRC configuration option
window.ajaxRefresh = 30000;
Proper placement of configuration options
// 1. AjaxRC configuration option
window.ajaxRefresh = 30000;

// 2. AjaxRC import statement
importArticles({
    type: 'script',
    articles: [
        'u:dev:MediaWiki:AjaxRC.js'
    ]
});

Оформление

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

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

Готовые модули

NewPagesModule

После установки скрипта, скопируйте содержимое ниже в Template:NewPagesModule, создав его на своей вики: 

<h2>{{int:newpages}}</h2>
<div class="new-pages-rail-module">
{{Special:NewPages/4}}
<div class="more">'''[[Special:NewPages|{{int:oasis-more}}]]'''</div>
</div>

Также добавьте следующий код для оформления блока:

И укажите свой шаблон в этом параметре (в дополнение к уже подключенным; если таких нет, то только один шаблон): 

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