Categories

IAB19 — Technology & Computing

Класс Walker для wp_list_categories

Класс Walker для wp_list_categories используется для построения меню, стилизации, добавления своих классов в список категорий. Вставляем данный код в файлик functions.php:

class Subcategory_Walker_Category extends Walker_Category {
  function start_el( &$output, $category, $depth = 0, $args = array(), $id = 0 ) {
    extract($args);
    $cat_name = esc_attr( $category->name );
    $cat_name = apply_filters( 'list_cats', $cat_name, $category );
    $link = '<a  href="' . esc_url( get_term_link($category) ) . '" ';
    if ( $use_desc_for_title == 0 || empty($category->description) )
      $link .= 'title="' . esc_attr( sprintf(__( 'View all posts filed under %s' ), $cat_name) ) . '"';
    else
      $link .= 'title="' . esc_attr( strip_tags( apply_filters( 'category_description', $category->description, $category ) ) ) . '"';
    $link .= '>';
    $link .= $cat_name . '</a>';
    if ( !empty($feed_image) || !empty($feed) ) {
      $link .= ' ';
      if ( empty($feed_image) )
        $link .= '(';
      $link .= '<a href="' . esc_url( get_term_feed_link( $category->term_id, $category->taxonomy, $feed_type ) ) . '"';
      if ( empty($feed) ) {
        $alt = ' alt="' . sprintf(__( 'Feed for all posts filed under %s' ), $cat_name ) . '"';
      } else {
        $title = ' title="' . $feed . '"';
        $alt = ' alt="' . $feed . '"';
        $name = $feed;
        $link .= $title;
      }
      $link .= '>';
      if ( empty($feed_image) )
        $link .= $name;
      else
        $link .= "<img src='$feed_image'$alt$title" . ' />';
      $link .= '</a>';
      if ( empty($feed_image) )
        $link .= ')';
    }
    if ( !empty($show_count) )
      $link .= ' (' . intval($category->count) . ')';
    if ( 'list' == $args ) {
      $output .= "\t<li";
      $class = 'cat-item';
      // Your custom class
      if ($depth)
        $class .= '';
      if ( !empty($current_category) ) {
        $_current_category = get_term( $current_category, $category->taxonomy );
        if ( $category->term_id == $current_category )
          $class .=  ' current-cat';
        elseif ( $category->term_id == $_current_category->parent )
          $class .=  ' current-cat-parent';
      }
      $output .=  ' class="' . $class . '"';
      $output .= ">$link\n";
    } else {
            $output .= "\t$link<br />\n";
    }
  }
}

Вот в принципе и все, теперь перемещение по рубрикам и подрубрикам сайта, осуществляется всего в одно или два щелчка мышкой. При этом у вас всегда есть возможность быстрого перемещения по дочерним категориям находясь в их родительской категории или записях.

Делайте навигацию предельно понятно и удобно для своих посетителей. Даже если реализация довольно сложная и муторная.

Функция wp_list_categories для категории wordpress

По традиции рассматриваю не только вопрос работы с теми или иными элементами системы, но и привожу специальные функции для шаблонов. Точно также как я рассказывал про wordpress страницы. Итак, для вывода списка категорий со ссылками на них используется wp_list_categories. Она имеет целый ряд аргументов:

• show_option_all – отображает ссылка на все категории, если в качестве стиля отображения выбрал список.
• orderby – сортировка для категорий по ID, имени (name), ярлыку (slug), количеству постов (count).
• order – порядок сортировки (ASC – по увеличению, DESC – по уменьшению).
• show_last_updated – показывать дату последнего обновления.
• style – стиль оформления: список (list), разделение через <br> (none).
• show_count – отображать количество постов в категории.
• hide_empty – скрывать пустые рубрики, где нет записей.
• use_desc_for_title – использовать описание для атрибута title в ссылке.
• child_of – вывод только категорий для заданной родительской рубрики.
• feed – отображение ссылку на wordpress rss фид для категорий.
• feed_type – тип фида.
• feed_image – картинка для значка rss.
• exclude – исключение категорий из списка, при этом параметр child_of автоматически отключается.
• exclude_tree – исключения целой ветки рубрик.
• include – обратный параметр, который включает только указанные категории wordpress в список.
• hierarchical – параметр для отображения подкатегорий.
• title_li – заголовок списка рубрик.
• number – количество категорий для отображения (если их слишком много).
• echo – выводит рубрики, по умолчанию равен True.
• depth – указывает количество уровней для подкатегорий для вывода.

Напоследок приведу ряд примеров использования wp_list_categories. Во-первых, вариант из шапки этого блога.

<?php wp_list_categories('hide_empty=1&exclude=1&title_li=&orderby=count&order=desc&use_desc_for_title=0'); ?>

Здесь задано отображение скрытых категорий, исключение из списка рубрики с, пустая строка для заголовка блока, сортировка по количеству статей и по уменьшению (то есть больше всего статей у меня в разделе функции wordpress). Последний аргумент не подставляет описание категории в title для ссылки.

Ну и еще парочку простых ситуаций. Использование исключений и включений категорий.

<ul><?php wp_list_categories('orderby=name&include=3,5,9,16'); ?></ul>
<ul><?php wp_list_categories('orderby=name&show_count=1&exclude=10'); ?></ul>

Отображения только подрубрик выбранной категории

<ul> 
<?php wp_list_categories('orderby=id&show_count=1&use_desc_for_title=0&child_of=8'); ?>
</ul>

Показ категорий с RSS ссылками

<ul>
<?php wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?>
</ul>

Можно использовать картинку для фидов rss

<ul>
<?php wp_list_categories('orderby=name&show_count=1&feed_image=/images/rss.gif'); ?>
</ul>

How to categorize: guidance by topic

For some categories, there is special guidance on how best to sort content within that category. This guidance can be found in a category scheme or a commons project for your topic. There is also some categorizing information in this section and sometimes there is guidance at the top of the category’s page, in the Category namespace. So, for instance, some guidance on categorizing content depicting people is at the top of Category:People, and some is in the section below.

People

Content depicting people should be put in categories which describe them, such as Category:Economists from the United States. Start exploring at Category:People.

Please see Commons:Category scheme People for details on how to name and organize these categories.

Landscapes, outdoor views

Content depicting a given subject from a common vantage point are grouped in Views of Subject from Viewpoint categories such as Views of Cathedral of Seville from the Giralda. Such categories should be subcategories of both the subject’s category (Cathedral of Seville in this example) and the viewpoint’s category (Giralda in this example).

In this example, the Views of Cathedral of Seville from the Giralda category is not placed directly in the subject and viewpoint categories, but in Views of the Cathedral of Seville and Views from Giralda. Such intermediate categories are often necessary to create structure and avoid , particularly for views of a city from a vantage point located within the city. For example, Views of Rome from the Pincio needs the intermediate category Views of Rome to avoid placing it directly in Rome, which would constitute over-categorization.

Texts

Texts, such as scans of books, should normally have a category for each version of the scan and each edition of the text. Thus a book published in three separate editions would have a parent category for the book, three subcategories for each text, and further subcategories for the text as a jpeg, a DjVu, etc., assuming each version had actually been uploaded. (Categories would not be created for editions not held on Commons.) This is particularly important for files in formats other than DjVu and PDF, where the category is the only practical means of keeping the scans together; see eg. Category:The Chronicles of England, Scotland and Ireland, Holinshed, 1587 which contains 2857 jpeg images of page scans.

GLAMs

For categorization issues related to mass content donations from GLAMs (Galleries, Libraries, Archives & Museums), please see .

Adding a page to a category[edit | edit source]

To add a page or uploaded file to a category, simply edit the page and add the following text (where Name is the name of the category you want to add it to).

[[Category:Name]]

Any number of Category tags may be added to the page and the page will be listed in all of them. Category tags, along with interwiki language links which appear below the Tools section on the sidebar, are usually added at the very bottom of the page for the convenience of other editors.

On a categorized page, categories are displayed in the Categories: box strictly in the order they appear in the wikitext.

If $wgUseCategoryBrowser is set to true, under the first list each category is listed again, breadcrumb-style, with all its parent categories, sorted alphabetically. (At least in MediaWiki 1.18.2) if a category is a subcategory of more than one parent, both hierarchies will be listed, but the tagged category will be stripped off all but one of these. This creates the potential for what appear to be duplicate entries if a category with multiple parents and more than one of its parents are tagged on a page. For example suppose Maryanne is a subcategory of both Mary and Anne. If a page tags categories Maryanne and Anne then the Category breadcrumbs will show

Anne 
Anne
Mary -> Maryanne

«Anne» appears to be duplicated, but what is meant is

Anne 
Anne -> Maryanne
Mary -> Maryanne

This is probably a bug, and has been reported in Bug 33614.

Sort keyedit | edit source

By default, a page is sorted within a category under the first letter of its name — without the namespace. Also, MediaWiki groups accented characters separately from their unaccented version, so pages starting by À, Á, Ä, will be listed under separate headings, instead of under heading A (and not following A, but following Z). MediaWiki is Anglo-centric by default, so for languages with a lot of diacritics (accented characters), a lot of additional work is required to sort entries correctly.

A sort key specifies under which letter heading, and where in the category list, the page will appear. You can add a sort key by placing it inside the tag after a pipe character. For example, the tag below will add the page under heading «S».

[[Category:Name|Sort]]

Sort keys are case-sensitive, and spaces and other characters are also valid. The order of the sections within a category follows the Unicode sort order. The sort key does not change the page title displayed in the category. In particular, a leading space in the sort key will cause that page to file at the beginning of the list of pages in the category.

See Sorting for further information on category sorting.

DEFAULTSORT magic wordedit | edit source

Pages can also be assigned a sort order based on the magic word . For example, German has some established non-accented versions of their accented characters, like ue for ü and ss for ß. For the page or category «Bücher» to be properly sorted, the following code could be added at the bottom of the wikitext:

Hidden categories[edit | edit source]

The categories that a page is in are normally listed at the bottom of the page. In Mediawiki 1.13+, a category can be hidden from this list by adding the magic word «» to the category page. Hidden categories are not hidden from category pages.

Users can choose to see hidden categories in a separate «Hidden categories» list, by checking «Show hidden categories» in the «Appearance» section of Special:Preferences.

Hidden categories are automatically added to Category:Hidden categories. This category is specified in the system message MediaWiki:Hidden-category-category.

This designation can be useful for administrative tracking of pages. For example, all pages with videos, or all pages which share some other characteristic which may otherwise be difficult to find by searching.

wp_list_categories

Данная функция выводит html на экран или возвращает его в переменную. Давайте сразу посмотрим пример.

<?php
$args = [
	'echo' => true,
	'style'=>'list',
	'show_count' => false, // что-бы не показывало количество записей в категории
];
?>
<ul>
	<?php wp_list_categories( $args ); ?>
</ul>
// Получим что-то типа этого 
<ul>
	<li><a href="http://exmpl.ru/cat-1">Название категории 1</a></li>
	<li><a href="http://exmpl.ru/cat-2">Название категории 2</a></li>
</ul>

Таким образом мы получили ненумерованный список. Можно получить ссылки.

<?php
$args = [
	'echo' => true,
	'style'=>'none',
	'show_count' => false, // что-бы не показывало количество записей в категории
];
?>
<?php wp_list_categories( $args ); ?>
// Получим что-то типа этого 
<a href="http://exmpl.ru/cat-1">Название категории 1</a>, <br>
<a href="http://exmpl.ru/cat-2">Название категории 2</a>, <br>

У этой функции есть еще множество параметров, которые помогут вам структурировать список, их вы можете узнать в официальной документации или на wp-kama. Однако всё будет крутиться вокруг списков или ссылок и простого способа обернуть категорию, например, в <div> нет. Так что давайте рассмотрим второй способ.

Плагины для задания категорий и тегов страницам

Начнем с модулей, наиболее простого варианта

Важно понимать, что все эти решения просто активируют возможность присвоения всем публикациям определенных меток и разделов, они не выводят никакую информацию на самом сайте. Вам нужно будет дополнительно править шаблон и добавлять функции как и при оформлении записей в WordPress:

Разделы: <?php the_category(', '); ?>.
Теги: <?php the_tags('', ', ', '.'); ?>

В большинстве случаев код вставляется в page.php (или другой подходящий файл).

Post Tags and Categories for Pages

С этим модулем я знаком уже давно. Он обновлялся 10 месяцев назад и пропустил несколько последних знаковых релизов, тем не менее, при тестировании все было отлично. Не удивительно, что Post Tags and Categories for Pages имеет более 30тысяч скачиваний и почти максимальную оценку.

Процесс установки прост — находите плагин по названию среди других и активируете, настроек никаких нет. Сразу после этого в меню админки для раздела страниц появится 2 новых дополнительных пункта. Работать с ними можно точно также, как с записями.

На скриншоте видите, что расширение совместимо и с некоторыми другими, например, с Simple Tags. Также я успешно тестировал вывод тегов страниц в WordPress через the_tags в шаблоне и аналогичную фишку для категорий — the_category.

Единственный возможный минус — в своих «личных записях» нашел пометку о том, что данное решение глючит с исключениями (не могу вспомнить, что это значит): то ли речь идет о параметре exclude в WP функциях, то ли о плагинах похожих постов и Exclude categories … Как выход из ситуации, предлагается добавить метки, а после отключить модуль. Вдруг, информация кому-то пригодится.

Tag Pages

В отличии от предыдущего решения это позволяет работать исключительно с WordPress тегами. Если вам нужна только такая фишка, то есть смысл ставить плагин без поддержки категорий. Из плюсов: однозначно актуальность (обновка около месяца назад) + 20тысяч загрузок и хорошая оценка.

По функциям:

• появление специального блока ввода меток в WP при редактировании;
• с помощью фильтра pre_get_posts все ваши публикации будут корректно выводиться в архивах, RSS фидах;
• совместим с мультисайтовой установкой;
• не делает никакие правки в БД, только использует хуки.

Add Category to Pages

У модуля меньше всего загрузок — 10тысяч, но при этом максимальная оценка. Не смотря на название, он позволяет работать не только с категориями страниц WordPress но и тегами. Вы сможете просматривать архивы со списками публикаций по определенной теме. Единственное, что смущает — последний апдейт был 3 года назад. Хотя, по сути, применяемые здесь WP функции, за это время не изменились.

Описание параметров

Creating a category page[edit | edit source]

Categories exist even if their page has not been created, but these categories are isolated from others and serve little purpose for organization or navigation.

A category is created by creating a page in the Category: namespace. A category page can be created the same way as other wiki pages (see Starting a new page); just add «» before the page title.

To avoid extra work, try searching within your wiki before creating a new category. The list of all categories can be found in «Special pages» in the «tools» box of the .

Unlike other wiki pages, it is not possible to rename (move) a category. It is necessary to create a new category and change the Category tag on every page. The new category will not have the older category’s page history, which is undesirable if there are many revisions.

Tools

• Gadgets enabled through the
  • Cat-a-lot: A tool that helps with moving multiple files between categories or adding categories to search results. [documentation / talk] 
  • HotCat: d Easily add / remove / change a category on a page, with name suggestions. [documentation / example / talk] 
  • Gallery Details: Adds a link in the toolbox to display galleries and categories (and Newimages and Search result pages) with extensive details from file description pages and links to easily mark an image without source, etc. If Pretty log is activated, it also works on Log pages. [documentation / talk] 
  • Place categories above content, but below image on file description pages.  Modifies the placement of categories on the user interface.
  • Add a link to category pages to search for the category name with the option «-incategory». This excludes files already in the category (doesn’t work if the category was added by a template).  
• Toollabs / toolserver tools
  • – this new version has other features
  • – plots categories trees. For example https://tools.wmflabs.org/vcat/render?wiki=commonswiki&category=Water%20wells generates graph for parent categories of Category:Water wells
• Database reports and special pages
  • Categories that are their own parent categories
  • Alphabetic lists of categories with files or other pages in them – including nonexistent categories
  • Category tree
  • Unused categories – including categories redirected with `Category redirect`
  • Uncategorized categories
• Bookmarklets
  • Category redirect bookmarklets
• Scripts, software, etc.
  • AutoWikiBrowser (for access: checkpage)
  • pywikipediabot category.py (for access: request page)
  • Degrandparent – a tool to remove files from a category if they are also in one or more of its subcategories.
• Bots
  • SieBot – renames or adds categories. See – requests.
  • EuseBot – adds additional parent categories to categories (and galleries) depending on which category an article in English Wikipedia is in. For requests.
  • RussBot – clears Non-empty category redirects
  • CategorizationBot – adds uncategorized images into Media needing categories – notifies uploaders, and attempts to categorize images (Media needing category review)
  • Requests for work to be done

Navigation menu

In Wikipedia

• Alemannisch
• العربية
• مصرى
• অসমীয়া
• Azərbaycanca
• تۆرکجه
• Беларуская
• Беларуская (тарашкевіца)‎
• Български
• भोजपुरी
• বাংলা
• Bosanski
• Català
• Cebuano
• Čeština
• Dansk
• Deutsch
• Ελληνικά
• English
• Español
• Eesti
• فارسی
• Suomi
• Français
• Galego
• ગુજરાતી
• Gaelg
• עברית
• हिन्दी
• Hrvatski
• Magyar
• Հայերեն
• Interlingua
• Bahasa Indonesia
• Italiano
• 日本語
• ქართული
• 한국어
• Kurdî
• Kernowek
• Latina
• Lietuvių
• Македонски
• മലയാളം
• मराठी
• Bahasa Melayu
• မြန်မာဘာသာ
• Plattdüütsch
• नेपाली
• Nederlands
• Polski
• Português
• Romani čhib
• Română
• Русский
• Sicilianu
• Scots
• سنڌي
• Davvisámegiella
• Srpskohrvatski / српскохрватски
• සිංහල
• Simple English
• Slovenčina
• Slovenščina
• Shqip
• Српски / srpski
• Sunda
• Svenska
• தமிழ்
• తెలుగు
• Тоҷикӣ
• ไทย
• Türkçe
• Татарча/tatarça
• Українська
• اردو
• Oʻzbekcha/ўзбекча
• Tiếng Việt
• 吴语
• ייִדיש
• 中文
• 粵語

Categorization workflow

Currently, a bot checks if newly uploaded files are categorized in topical categories and attempts to categorize files that are not. Before 17 June 2015, CategorizationBot was responsible for this job. As of June 2019, SteinsplitterBot occasionally checks for uncategorized files.
The workflow is the following:

1. User uploads a new file and adds categories (or not).
2. A bot checks if the file is categorized.
   • File is already categorized => ok
   • File is not categorized => the bot tags the file for Category:Media needing categories. Today’s files are in Category:Media needing categories as of 11 December 2020
3. Users categorize files further (e.g. category diffusion below)

See also: , categorization statistics

Other, if manual, categorization workflows are possible :

• Category filling: Use appropriate keywords in the search engine to find the files that should be in a given category, and put them there.
• Category diffusing: Go to Category:Categories requiring diffusion, select a crowded category, create appropriate subcategories if needed, and move the files to the subcategories. Gadgets like Cat-a-lot and Hotcats can help.

Properties of objects and morphisms[edit]

Isomorphismsedit

A morphism fA→B{\displaystyle f:A\to B} in a category is said to be an isomorphism if there is a morphism gB→A{\displaystyle g:B\to A} in the category with gf=1A{\displaystyle gf=1_{A}}, fg=1B{\displaystyle fg=1_{B}}. It is easy to prove that g{\displaystyle g} is then uniquely determined by f{\displaystyle f}. The morphism g{\displaystyle g} is called the inverse of f, written g=f−1{\displaystyle g=f^{-1}}. It follows that f=g−1{\displaystyle f=g^{-1}}. If there is an isomorphism from A{\displaystyle A} to B{\displaystyle B}, we say A{\displaystyle A} is isomorphic to B{\displaystyle B}, and it is easy to prove that «isomorphism» is an equivalence relation on the objects of the category.

Examplesedit

• A function from A{\displaystyle A} to B{\displaystyle B} in the category of sets is an isomorphism if and only if it is bijective.
• A homomorphism of groups is an isomorphism if and only if it is bijective.
• The isomorphisms of the category of topological spaces and continuous maps are the homeomorphisms. In contrast to the preceding example, a bijective continuous map from one topological space to another need not be a homeomorphism because its inverse (as a set function) may not be continuous. An example is the identity map on the set of real numbers, with the domain having the discrete topology and the codomain having the usual topology.

Monomorphisms and Epimorphismsedit

A morphism f{\displaystyle f} in a category C{\displaystyle {\mathcal {C}}} is a monomorphism if, for any morphisms g{\displaystyle g} and h{\displaystyle h}, if fg{\displaystyle fg} and fh{\displaystyle fh} are defined and fg=fh{\displaystyle fg=fh} then g=h{\displaystyle g=h}.

A morphism f{\displaystyle f} in a category C{\displaystyle {\mathcal {C}}} is an epimorphism if, for any morphisms g{\displaystyle g} and h{\displaystyle h}, if gf{\displaystyle gf} and hf{\displaystyle hf} are defined and gf=hf{\displaystyle gf=hf} then g=h{\displaystyle g=h}.

T{\displaystyle T} is said to be a terminal (or final) object when X→T{\displaystyle X\to T} is a unique morphism for any X{\displaystyle X} in C{\displaystyle {\mathcal {C}}}. The law of composition ensures that if T{\displaystyle T} and T′{\displaystyle T’} are terminal objects in C{\displaystyle {\mathcal {C}}}, they are isomorphic, i.e., T(′){\displaystyle T(‘)} is unique up to isomorphism. In the categories of sets, groups, and topological spaces, the terminal objects are singletons, trivial groups, and one-point spaces, respectively. «b» is the terminal object in 2 as depicted above.

Общие параметры функции

Итак, для того чтобы просто вывести перечень всех категорий достаточно вставить в виджет «PHP-код» вот такой код:

<?php wp_list_categories('arguments');?>

При использовании данной функции, по умолчанию в блоке категорий выводится стандартный заголовок.

Оформление данного заголовка редко вписывается в дизайн сайтов, поэтому его зачастую либо просто удаляют, либо изменяют.

Для этого в нашу функцию через символ & добавляется параметр title_li= . С помощью кода, приведенного ниже, заголовок просто удаляется:

<?php wp_list_categories('arguments&title_li=');?>

Для того, чтобы все-таки добавить заголовок в блок категорий, вы можете задать стандартным способом название самому виджету в который мы вставляем код или оформить его обычным HTML:

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

(adsbygoogle = window.adsbygoogle || []).push({});

<?php wp_list_categories('title_li=Мои рубрики');?>

Блок категорий при использовании этого кода не будет отличаться от первоначального, только с другим текстом в первой строке.

Кстати, название блока категорий (в моем примере это фраза «Мои рубрики») также можно заключать в теги. Например, можно воспользоваться тегами выделения шрифта жирным или как заголовок, например:

<?php wp_list_categories('title_li=<h3>Мои рубрики</h3>');?>

Это позволит вам в некоторых случаях более удачно оформить свой блок категорий.