ФЭНДОМ


Это расширение подключается по запросу.

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

DPL — мощный инструмент, увеличивающий нагрузку на сервер, что может стать причиной медленной загрузки страниц вашей вики. Поэтому настоятельно рекомендуем ознакомиться с разделом Эффективное использование 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 для вывода статей выбранной категории или пространства имён.
Случайный контент
Создание сложных списков (с пересечением категорий, форматированием и т.д.)
Продвинутое использование
  • Убедитесь что не существует узкоспециализированного расширения прежде чем использовать 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 нужно обновить не только кеш браузера, но и кеш сервера.