Справка:DynamicPageList

Это расширение отключено по умолчанию, но его можно подключить, оставив запрос в поддержке.

DPL (Динамический список страниц) — расширение MediaWiki, которое позволяет создавать списки страниц, используя различные критерии, например, принадлежность статьи к категории или упоминание в ней определённого инфобокса.

DPL — мощный инструмент, увеличивающий нагрузку на сервер, что может стать причиной медленной загрузки страниц вашей вики. Поэтому настоятельно рекомендуем ознакомиться с разделом Эффективное использование DPL этой статьи.

Возможности DPL[]

DPL полезен тем, что малым объёмом кода можно создать большой и детальный список, составление которого вручную займёт много времени.

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

Как разместить DPL на странице[]

DPL запрос должен быть заключен в тэги <dpl></dpl>. Между ними вы можете перечислить широкий набор параметров для настройки внешнего вида результатов.

Другой способ — использовать код {{#dpl: .... }}.

Пример DPL запроса, который выведет список статей из категории «Персонажи»:

<DPL>
category=Персонажи
</DPL>

В дальнейшем его можно настроить так, чтобы он выводил все страницы из пространства имён «Персонажи», содержащиеся в категории «Персонажи», но не попавшие в категорию «Персонажи первого сезона», в виде нумерованного списка:

<DPL>
category=Персонажи
notcategory=Персонажи первого сезона
namespace=Персонаж
mode=ordered
</DPL>

Полный список параметров доступен по ссылке.

Эффективное использование DPL[]

Во-первых, перед тем как запрашивать DPL, убедитесь, что он вам действительно нужен. Замедление работы вики может сказаться на встроенных RSS и видео.

Во-вторых, если вы решили, что DPL — лучший вариант для вашей задачи, дайте DPL закэшировать результаты! Просто добавьте в DPL запрос строку:

allowcachedresults=true

Инструменты, заменяющие DPL[]

Создание простых списков категорий

Может быть сделано с помощью <categorytree> тэгов (документация). Пример кода для получения списка страниц в категории «Сообщество»:

<categorytree mode="pages" hideroot=on>Сообщество</categorytree>

Создания списков страниц

Используйте NewPages для вывода статей выбранной категории или пространства имён.

Случайный контент

Используйте расширение RandomSelection.

Создание сложных списков (с пересечением категорий, форматированием и т. д.)

Решается ботами. Вы можете узнать больше о создании ботов из Википедии.

Продвинутое использование

Убедитесь что не существует узкоспециализированного расширения прежде чем использовать DPL. Например, вместо того чтобы создавать календарь на DPL, предлагаем изучить это. Если вы не уверены или не нашли нужное расширение, свяжитесь с нами, и мы будем рады вам помочь.

Чего следует избегать[]

Не используйте DPL для:

функций, использующих «randomcount», — они не могут быть закэшированы;
больших запросов — не выводите на экран 500 строк, если достаточно 20;
случаев, где требуется более двух запросов в статье;
шаблонов, которые используют site-wide, — создаются скрытые DPL-вызовы по всей вики.

Обновление кеша[]

Если вы видите странный результат работы DPL, попробуйте добавить ?action=purge (или &action=purge, в случае когда ? уже использован) в конец вашего URL и перезагрузите URL.
- Это может исправить проблему, когда внутренний код DPL был изменён, но кэш сервера ещё не обновился.

Примеры использования DPL[]

Галереи[]

DPL можно использовать для формирования галерей:

<DPL>
    namespace          = File
    category           = CategoryNameHere
    format             = <gallery widths="150" spacing="small">,%PAGE%\n,,</gallery>
    allowcachedresults = true
</DPL>

Списки[]

Можно составить список страниц, которые необходимо отредактировать:

<DPL>
    category           = Stubs
    format             = ,#%PAGE%\n,,
    allowcachedresults = true
</DPL>

Можно составить список изображений, которые необходимо категоризовать:

<DPL>
    namespace = File
    notcategory = Season 1
    notcategory = Season 2
    notcategory = Season 3
    notcategory = Season 4
    format = <gallery widths="150" spacing="small">,%PAGE%\n,,</gallery>
    allowcachedresults = true
</DPL>

Примечания[]

Фэндом не поддерживает функции DPL, основанные на количестве просмотров страниц.
Для обновления DPL нужно обновить не только кеш браузера, но и кеш сервера.

См. также[]

Начало работы с DynamicPageLists

Вики Сообщества