Расширение:Дерево категорий

Справка по расширениям MediaWiki

CategoryTree Статус релиза: стабильно
Реализация	Тег , Функция парсера , Служебная страница
Описание	Обеспечивает динамическое представление о структуре категорий вики в виде дерева.
Автор(ы)	Daniel Kinzler (Duesentriebобсуждение)
Последняя версия	continuous updates
Политика совместимости	Снэпшоты выходят вместе с MediaWiki. Мастер не имеет обратной совместимости.
MediaWiki	1.25+
Лицензия	GNU General Public License 2.0 или позднее
Скачать	Скачать расширение Git [?]: скачать текущую версию исхо��ника репозиторий (Phabricator · GitHub) история изменений список разработчиков (GitHub) code review README
Параметры $wgCategoryTreeAllowTag $wgCategoryTreeCategoryPageOptions $wgCategoryTreePageCategoryOptions $wgCategoryTreeMaxDepth $wgCategoryTreeSidebarOptions $wgCategoryTreeDefaultOptions $wgCategoryTreeMaxChildren $wgCategoryTreeSpecialPageOptions $wgCategoryTreeOmitNamespace $wgCategoryTreeSidebarRoot $wgCategoryTreeDisableCache $wgCategoryTreeCategoryPageMode $wgCategoryTreeDefaultMode $wgCategoryTreeUseCategoryTable $wgCategoryTreeHijackPageCategories
Используемые хуки CategoryViewer::doCategoryQuery CategoryViewer::generateLink MediaWikiServices OutputPageRenderCategoryLink ParserFirstCallInit SkinAfterPortlet SkinBuildSidebar SpecialTrackingCategories::generateCatLink SpecialTrackingCategories::preprocess
Ежеквартальные загрузки	298 (Ranked 12th)
Использование общедоступными вики	10,554 (Ranked 11th)
Переведите расширение CategoryTree, если оно доступно на translatewiki.net
Проблемы	Открытые задачи · Сообщить об ошибке

• Скачайте и распакуйте файл(ы) в папку с названием CategoryTree в вашей папке extensions/.
  Вместо этого разработчикам и соавторам кода следует установить расширение из Git, используя:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CategoryTree
• Добавьте следующий код в конце вашего файла LocalSettings.php :

  wfLoadExtension( 'CategoryTree' );
  

•  Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

CategoryTree может быть использован тремя путями:

• непосредственно на страницах категорий,
• как "пользовательский тег" (или "функция парсера") для отображения структуры категории построчно на вики,
• а также на специальной странице.

Расширение CategoryTree добавляет виджет ►, который "разворачивает" подкатегории, перечисленные на страницах категории.

<categorytree mode="pages">Manual</categorytree>

Пользовательский тег называется <categorytree>. Например, если вы поместите <categorytree>Foo</categorytree> на вики-странице, он отобразит содержимое категории Foo как динамическое дерево на странице (см. пример справа). Тег принимает следующие атрибуты, используя HTML-подобный синтаксис:

mode

определяет, какие страницы будут отображены в дереве. Может быть изменено с помощью namespaces. Возможные значения:

categories

показывать только подкатегории (константа 0)

pages

показывать подкатегории и страниц, без изображений (константа 10)

all

показывать все подкатегории, страницы, картинки и т.д. (константа 20)

parents

список корневых категорий, а не подкатегории (константа 100). Это помещает CategoryTree в "инверсивную" операцию (поддерживается начиная с r36892, июль 2008).

depth

определяет, сколько показывать уровней дерева на начальном этапе. По умолчанию 1. 0 означает, только корневой узел. Максимальное значение зависит от указанного режима, и в опции $wgCategoryTreeMaxDepth. (введено между r20410 и r20840, 30 марта 2007; полностью функциональна даже с $wgCategoryTreeDynamicTag начиная с r36864, июль 2008)

onlyroot

"on" показывает только "корневой" узел дерева на начальном этапе. Эквивалент depth="0". (введено в r20385, 13 марта 2007). Запрещено в r36864, июль 2008: заместо него использовать depth="0".

hideroot

"on" спрячет "корневой" узел дерева, т. е. hideroot=on. Например, он не будет отображать название категории Foo

hideprefix

определяет, когда префикс пространства имён должны быть скрыт от записи в дереве (начиная с r36864, июль 2008). Возможные значения:

always

всегда скрывать префикс. Следует использовать только тогда, когда все страницы имеют одно и то же пространство имён (константа 10).

never

никогда не скрывать префикс (константа 0).

auto

скрывать пространство имён категорий, если категории показаны через mode="categories" (константа 30); Это эквивалентно старому поведению по умолчанию (до июня 2008).

categories

всегда скрывать пространство имен категорий, но показать все другие префиксы (константа 20). Это новое поведение по умолчанию (начиная с r36864, июль 2008).

showcount

"on", чтобы показать число записей в подкатегории, т. е. showcount="on" (начиная с r36864, июль 2008). По-умолчанию отключено для дерева категории встроенного в страницы, но по-умолчанию включено в списках категорий на страница Служебная:CategoryTree. This is disabled per default for category trees inlined on pages, but enabled per default in category listings and on Special:CategoryTree.

notranslations

set this to "on" to hide all translations pages corresponding to the pages pertaining to the category, i.e. notranslations="on" (since Gerrit change 526234, November 2019). This is disabled by default. If this option is set to "on", instead of the different translations (e.g. Page, Page/en, Page/fr, Page/de) only the standard translation "Page" is displayed and all translations are suppressed.

This doesn't affect "showcount", so still a bug.

namespaces

список пространств имён страниц, которые должно быть показано в дереве (начиная с r36864, июль 2008). Записи в списке должны быть разделены пробелами. Основное пространство имён может быть представлено как "-" или "0".

<categorytree mode="pages" namespaces="Main">Manual</categorytree>

<categorytree mode="pages" namespaces="Main Category">Manual</categorytree>

<categorytree mode="categories">Manual</categorytree>
<categorytree namespaces="Category">Manual</categorytree>
<categorytree>Manual</categorytree>

Начиная с r25825 (2007-9-13), вы можете также использовать синтаксис синтаксического анализатора чтобы поместить дерево категорий на странице. Работает подобно тегу <categorytree>, используя другой синтаксис, например, {{#categorytree:Foo}}; опции могут быть определены с использованием синтаксиса именованных параметров шаблона, например, {{#categorytree:Foo|hideroot|mode=pages}}.

Использование синтаксиса синтаксического анализатора имеет преимущество, позволяющее использовать волшебные слова, шаблоны и параметры шаблонов при определении категории для отображения. Вот некоторые примеры:

• Использование волшебной переменной для отображения этих страниц дерева категорий (могут быть полезны на страницах описания категории): {{#categorytree:{{PAGENAME}}}}.
• Использование шаблонов для указания категории: {{#categorytree:{{root category}}}} - имя корневой категории будут определены по содержанию Template:Root_category.
• Использование шаблонов для указания категории, при использовании CategoryTree внутри шаблона: {{#categorytree:{{{1}}}}} в Template:Baz может вызываться при помощи {{Baz|Foo}}

Существуют некоторые опции, который вы можете указать в своем файле LocalSettings.php :

$wgCategoryTreeMaxChildren

максимальное количество дочерних категорий в дереве. По умолчанию 200.

$wgCategoryTreeAllowTag

включить тег <categorytree>. По умолчанию true.

$wgCategoryTreeDynamicTag

загрузка первого уровня в дерево <categorytree> динамически. Таким образом, кэширование не должно быть отключено. По умолчанию false.

$wgCategoryTreeDisableCache

отключить кэширование для страниц с тегом <categorytree>. По умолчанию 21600, что составляет 6 часов.

$wgCategoryTreeUseCache

enable HTTP cache for anon users. Default is false.

$wgCategoryTreeOmitNamespace

do not show the namespace name for pages and categories. Default is false, namespaces are shown unless showing categories only. Deprecated as of r36864, July 2008: use $wgCategoryTreeDefaultOptions['hideprefix'] instead.

$wgCategoryTreeMaxDepth

an array defining the maximum depth for each mode, to which the tree may be expanded initially using the depth parameter in a <category> tag. By default, this is set to 2 for the "categories" mode, and 1 for other modes. To set it to 3 for categories and 2 for other modes, for example, you can use $wgCategoryTreeMaxDepth = [10 => 2, 20 => 2, 0 => 3, 100 => 2];.

$wgCategoryTreeDefaultMode

the default mode to use when no mode attribute is specified in a <categorytree> tag. May be 0 (the default - categories), 10 (pages), or 20 (all).

$wgCategoryTreeCategoryPageMode

the mode to use when rendering trees on category pages. Deprecated as of r36864, July 2008: use $wgCategoryTreeCategoryPageOptions['mode'] instead.

$wgCategoryTreeSidebarRoot

root category to use for integrating the category tree in the sidebar (since r36920, July 2008). If not set, no tree is integrated (this is the default). Integrating a CategoryTree into the sidebar only works with skins based upon SkinTemplate, that is, Modern, Monobook, Chick, Simple, and MySkin, but not Standard, Nostalgia or CologneBlue. This is currently broken for MediaWiki 1.35.1 and the vector skin, see phab:278306.

$wgCategoryTreeDefaultOptions

default options to apply, as an array (since r36864, July 2008). The available options are described above. Example: $wgCategoryTreeDefaultOptions['mode'] = 'pages';.

$wgCategoryTreeCategoryPageOptions

options to use on category pages, as an array (since r36864, July 2008).

$wgCategoryTreeSpecialPageOptions

options to use on Special:CategoryTree, as an array (since r36864, July 2008).

$wgCategoryTreeSidebarOptions

options to use when showing the tree in the sidebar, as an array (since r36920, July 2008)

{{#ifeq:$1|0||$1 categories}}

({{#ifeq:$4|0|empty|{{#ifeq:$1|0||$1 C{{#ifeq:{{#expr:$3+$2}}|0||,}}}} {{#ifeq:$2|0||$2 P{{#ifeq:$3|0||,}}}} {{#ifeq:$3|0||$3 F}}}})

({{#ifeq:$4|0|empty|{{#ifeq:$1|0||$1 categories{{#ifeq:{{#expr:$3+$2}}|0||,}}}} {{#ifeq:$2|0||$2 pages{{#ifeq:$3|0||,}}}} {{#ifeq:$3|0||$3 files}}}})

• Включите error reporting
• Убедитесь, что установлены все необходимые файлы
• Убедитесь, что все файлы расширения имеют правильно настроенные права доступа mode 644, и права на папку CategoryTree - 755.

• Убедитесь, что вы указываете параметры после подключения расширения.

function efCategoryTreeParserOutput( &$outputPage, &$parserOutput )  {
    CategoryTree::setHeaders( $outputPage );
    return true;
}

function AppendCategoryTreeToSidebar() {
    try {
        var node = document.getElementById( "p-tb" )
                           .getElementsByTagName('div')[0]
                           .getElementsByTagName('ul')[0];
 
        var aNode = document.createElement( 'a' );
        var liNode = document.createElement( 'li' );
 
        aNode.appendChild( document.createTextNode( 'CategoryTree' ) );
        aNode.setAttribute( 'href' , '[[w:Special:CategoryTree]]' );
        liNode.appendChild( aNode );
        liNode.className = 'plainlinks';
        node.appendChild( liNode );
    } catch(e) {
        // lets just ignore what's happened
        return;
    }
}
 
addOnloadHook( AppendCategoryTreeToSidebar );

$wgCategoryTreeSidebarRoot = 'Category:article_name';

• Extension:SubpageNavigation

Это расширение используется в одном или нескольких проектах Викимедиа. Вероятно, это означает, что расширение стабильно и работает достаточно хорошо, чтобы использоваться такими сайтами с высоким трафиком. Найдите название этого расширения в файлах конфигурации Викимедиа CommonSettings.php и InitialiseSettings.php, чтобы узнать, где оно установлено. Полный список расширений, установленных на конкретной вики, можно увидеть на странице Special:Version wiki.

Это расширение включено в следующие вики-фермы/хостинги и/или пакеты: BlueSpice Canasta Debian Фэндом (Fandom) Miraheze MyWikis ProWiki semantic::core ShoutWiki Telepedia wiki.gg WikiForge Это не исчерпывающий список. Некоторые вики-фермы/хостинги и/или пакеты могут содержать это расширение, даже если они не перечислены здесь. Всегда сверяйтесь со своими вики-фермами/хостингами или комплектами/бандлами для подтверждения.