Различия

Показаны различия между двумя версиями страницы.

--- wiki:plugin:pagelist [2023/08/30 11:04] – внешнее изменение 127.0.0.1
+++ wiki:plugin:pagelist [Дата неизвестна] (текущий) – внешнее изменение (Дата неизвестна) 127.0.0.1
@@ Строка 9: / Строка 9: @@
 Сообщайте об ошибках или просьбах о новых функциях в [[https://github.com/dokufreaks/plugin-pagelist/issues|системе отслеживания ошибок]]
+**Примечание по обновлению** : в августе 2023 года стиль CSS немного изменился. Конкретные стили для каждой ячейки заменяются более общими стилями. Также все стили, кроме **simplelist**, получили дополнительный класс **plgn__pglist**, позволяющий лучше настроить этот плагин с помощью вашего собственного стиля.
 =====Монтаж=====
@@ Строка 71: / Строка 73: @@
 Плагин можно настроить с помощью менеджера конфигурации DokuWiki, доступного в меню администратора. Эти настройки также применяются к плагинам, которые используют вспомогательный компонент плагина списка страниц, например, архивный компонент плагина блога .
-|style|	Стиль списка (по умолчанию, таблица, таблица/список, простой список)|
+|style|Стиль списка (по умолчанию, таблица, таблица/список, простой список)|
-|showheader|	Показать заголовок таблицы|
+|showheader|Показать заголовок таблицы|
-|showdate|	Показывает/скрывает столбец даты (скрыть, дата создания, дата изменения)|
+|showdate|Показывает/скрывает столбец даты (скрыть, дата создания, дата изменения)|
-|showuser|	Показывает/скрывает столбец пользователя (скрыть, создатель, участники)|
+|showuser|Показывает/скрывает столбец пользователя (скрыть, создатель, участники)|
-|showdesc|	Показывает/скрывает краткое описание, взятое из первого абзаца страницы (скрыть, максимум 160 символов, максимум 500 символов)|
+|showdesc|Показывает/скрывает краткое описание, взятое из первого абзаца страницы (скрыть, максимум 160 символов, максимум 500 символов)|
-|showcomments|	Показывает/скрывает комментарии страницы (требуется плагин https://www.dokuwiki.org/plugin:discussion обсуждения )|
+|showcomments|Показывает/скрывает комментарии страницы (требуется плагин  [[https://www.dokuwiki.org/plugin:discussion|обсуждения]] )|
-|showlinkbacks|	Показывает/скрывает обратные ссылки на странице (требуется плагин обратных ссылок )|
+|showlinkbacks|Показывает/скрывает обратные ссылки на странице (требуется плагин обратных ссылок )|
-|showtags|	Показывает/скрывает теги страницы (требуется плагин тегов )|
+|showtags|Показывает/скрывает теги страницы (требуется плагин тегов )|
-|sort|	Сортирует страницы в алфавитном порядке по имени страницы.|
+|sort|Сортирует страницы в алфавитном порядке по имени страницы.|
-|showdiff|	Отображает столбец различий со значком различий, ссылающимся на соответствующую страницу различий для каждой строки.|
+|showdiff|Отображает столбец различий со значком различий, ссылающимся на соответствующую страницу различий для каждой строки.|
-|showimage|	Показывает/скрывает столбец изображения (требуется плагин https://www.dokuwiki.org/plugin:pageimage Pageimage ).|
+|showimage|Показывает/скрывает столбец изображения (требуется плагин [[https://www.dokuwiki.org/plugin:pageimage|Pageimage]] ).|
+=====Вспомогательный плагин=====
+Вы можете легко использовать функциональность плагина Pagelist в своих собственных плагинах. Вот базовый фрагмент кода:
+<code php>
+$pages = [
+    ['id' => 'wiki:dokuwiki'],
+    ['id' => 'wiki:syntax'],
+];
+$pagelist = $this->loadHelper('pagelist');
+if (!$pagelist) return false; // failed to load plugin
+$pagelist->startList();
+foreach ($pages as $page){
+    $pagelist->addPage($page);
+}
+$renderer->doc .= $pagelist->finishList();
+</code>
+С момента выпуска 2017-08-24 функция startList() имеет дополнительный параметр для указания класса CSS для добавления его в класс элемента таблицы:
+<code php>
+$pagelist->startList('myclass');
+</code>
+Подробнее см. в разделе [[wiki:plugin:pagelist_development|«Как использовать Pagelist в вашем плагине»]] .
 =====Обновление=====
 Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.
 =====Файл для загрузки=====
-{{ :wiki:plugin:htmlmetatags-master.zip |}}
+{{ :wiki:plugin:plugin-pagelist-master.zip |}}
 =====Лицензия=====
-  * **Author:** [[info@soft2c.de|Soft2C.de]]
+  * **Author:** [[freaks@dokuwiki.org|Dokufreaks (previous authors: Matthias Schulte, Michael Hamann, Esther Brunner, Gina Häußge, Michael Klier)]]
   * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]]
-Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на [[https://www.dokuwiki.org/plugin:htmlmetatags#htmlmetatags_plugin|эту страницу]] с вашего сайта, если вам нравится этот продукт.
+Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на [[https://www.dokuwiki.org/plugin:pagelist#pagelist_plugin|эту страницу]] с вашего сайта, если вам нравится этот продукт.