======Inserticon для «ДокуВики»======
{{:wiki:plugin:dwplugin.png?70 |}} Добавляет маленькие иконки (16 пикселей) на любую страницу

Этот плагин был разработан Ди Терлицци.
  * **Релиз:** 2008-05-05. 
  * **Правка:** 2025-01-05. 
  * **Репозиторий:**https://www.dokuwiki.org/plugin:inserticon
  * **Совместимость с «Докувики»:** 04.04.2023 "Джек Джекрам" 

=====Совместимость=====
  * 2024-02-06 "Kaos" да
  * 2023-04-04 "Jack Jackrum" да
  * 2022-07-31 "Igor" да
  * 2020-07-29 "Hogfather" да
:!: **Внимание:** Данный плаген разработан Adolfo González Blázquez в 2008 году и не поддерживается автором проекта и не работает с Dokuwiki старше 2020 года. Внесенные [[wiki:plugin:inserticon#Редактирование|небольшие правки]]  в код автора (без его разрешения), следуя  рекомендациям кода авторов Dokuwiki и этот замечательный плагин вновь функционирует в 2025 году.
=====Монтаж=====
Используйте менеджер плагинов для установки или…

  - скачать zip-файл
  - распаковать его в <dokuwiki>/lib/plugins/
  - войдите как администратор и измените плагин в менеджере конфигурации

:!: **Внимание:** Данный плаген разработан Adolfo González Blázquez в 2008 году и не поддерживается автором проекта и не устанавливается в Dokuwiki старше 2020 года. Внесенные [[wiki:plugin:inserticon#Редактирование|небольшие правки]]  в код автора (без его разрешения), следуя  рекомендациям кода авторов Dokuwiki и этот замечательный плагин вновь функционирует в 2025 году.

=====Примеры/Использование=====
{{:wiki:plugin:plugen_inserticon_edit_0.png?|}}
  

===== Синтаксис =====
  * ''%%{foldericon}%%'' will add {{https://trello.com/1/cards/5d57fbdccb946375612151da/attachments/5d57ff1534741a193d378a4b/download/folder.png?recache|{foldericon} }}
  * ''%%{imageicon}%%'' will add {{https://trello.com/1/cards/5d57fbdccb946375612151da/attachments/5d57ff165fec2d60895b3f3d/download/image.png?recache|{imagericon} }}
  * ''%%{peopleicon}%%'' will add {{https://trello.com/1/cards/5d57fbdccb946375612151da/attachments/5d57ff1718c4be8eec477f86/download/people.png?recache|{peopleicon} }}
  * ''%%{soundicon}%%'' will add {{https://trello.com/1/cards/5d57fbdccb946375612151da/attachments/5d57ff18253b3708867059a9/download/sound.png?recache|{soundicon} }}
  * ''%%{videoicon}%%'' will add {{https://trello.com/1/cards/5d57fbdccb946375612151da/attachments/5d57ff19e397c24fbc6c005b/download/video.png?recache|{videoicon} }}
  * ''%%{zipicon}%%'' will add {{https://trello.com/1/cards/5d57fbdccb946375612151da/attachments/5d57ff1af0ab5517dbe9a9aa/download/zip.png?recache|{zipicon} }}

=====Редактирование=====
Плагин совсем небольшой и состоит из исполняющего код файла syntax.php, файла лицензии и папки images с иконками
{{:wiki:plugin:plugen_inserticon_edit_1.png?|}}

Редактируем файл syntax.php (стр. 46 и 50)
{{:wiki:plugin:plugen_inserticon_edit_2.png?|}}
<code php index.php>
    function handle($match, $state, $pos, &$handler) {  
    	return array($match, $state, $pos);
    }
    
    function render($mode, &$renderer, $data) {
</code>
заменим на 
<code php index.php>
    function handle($match, $state, $pos, Doku_Handler $handler) {  
    	return array($match, $state, $pos);
    }
    
    function render($mode, Doku_Renderer $renderer, $data) {
</code>
{{:wiki:plugin:plugen_inserticon_edit_3.png?|}}
Да, всего лишь ''&'' меняем на ''Doku_Renderer'' и сохраняем файл.\\   
упаковываем в архив ''zip'' и устанавливаем через менеджер плагинов в Dokuwiki 2024-02-06 «Kaos»
{{:wiki:plugin:plugen_inserticon_edit_4.png?|}}
Мы видем подсказку об успешной установке плагина
{{:wiki:plugin:plugen_inserticon_edit_5.png?|}}
Используем [[wiki:plugin:inserticon#Редактирование|синтаксис]] плагина в редакторе страниц для вставки иконки согласно документации автора
{{:wiki:plugin:plugen_inserticon_edit_6.png?|}}
И добавленные иконки при предварительном просмотре страницы.\\  
На этом редактирование закончено и плагин можно использовать в Dokuwiki 2024-02-06 «Kaos»
=====Обновление=====
Для обновления удалите исходную папку lib/plugins/icons и установите новую версию, как указано выше.
=====Добавление плагина в меню=====
Создадим в папке плагина ''inserticon'' путь: ''dokuwiki/lib/plugins/inserticon'' файл скрипта 
**''script.js''** и запишем в него код для наших кнопок

{{:wiki:plugin:plugen_inserticon_edit_10.png?|}}

<code js script.js>
/* JavaScript function to create color toolbar in Dokuwiki */
/* see http://www.dokuwiki.org/plugin:color for more info */

icon_icobase = "../../plugins/inserticon/images/";

if(window.toolbar != undefined) {
    toolbar[toolbar.length] = {
    "type":"picker",
    "title":"Insert icon",
    "icon":icon_icobase+"toolbar_icon.png",
    "list":[
{"type":"format", "title":"foldericon", "icon":icon_icobase+"folder.png", "open":"{", "close":"}" },
{"type":"format", "title":"imageicon", "icon":icon_icobase+"image.png", "open":"{", "close":"}" },
{"type":"format", "title":"soundicon", "icon":icon_icobase+"sound.png", "open":"{", "close":"}" },
{"type":"format", "title":"videoicon", "icon":icon_icobase+"video.png", "open":"{", "close":"}" },
{"type":"format", "title":"peopleicon", "icon":icon_icobase+"people.png", "open":"{", "close":"}" },
{"type":"format", "title":"zipicon", "icon":icon_icobase+"zip.png", "open":"{", "close":"}" }
	]
  };
}
</code>
Сохраним и очистим кэш local.php

{{:wiki:plugin:plugen_inserticon_edit_11.png?|}}

Открываем панель редактирования страницы и раскрываем наше новое меню с иконками и вставляем на страницу
{{:wiki:plugin:plugen_inserticon_edit_12.png?|}}
Результат работы плагина с кнопкой в меню редактора
{{:wiki:plugin:plugen_inserticon_edit_13.png?|}}
=====Дополнения и Файлы=====
Icons are from the [[http://tango.freedesktop.org/Tango_Desktop_Project|Tango Project]], licensed under the [[https://creativecommons.org/licenses/by-sa/2.5/|Creative Commons Attribution Share-Alike]] license, and from the [[https://www.gnome.org/|GNOME]] project, licensed under the [[https://www.gnu.org/licenses/old-licenses/gpl-2.0.html|GPL-2]].
Далее приведена ссылка загрузки на оригинальный плагин (для ознакомления с кодом - не совместим с Dokuwiki в 2025году):
  * {{ :wiki:plugin:inserticon_1_.tar.gz |Оригинал плагина автора}}
Ссылка загрузки рабочей в 2025 году версии плагина. После загрузки  
  * {{ :wiki:plugin:inserticon.zip |inserticon.zip edit for «Kaos»}}
Ссылка загрузки рабочей в 2025 году версии плагина со скриптом для меню
  * {{ :wiki:plugin:inserticonnavkaos.zip |inserticon_nav_kaos.zip с меню}}
:!: **Примечание:** После загрузки любого из архивов, его перед установкой необходимо переименовать в 
inserticon_1_.tar.gz --> inserticon.tar.gz \\  
inserticonnavkaos.zip --> inserticon.zip


=====Лицензия=====
  * **Author:** [[code@infinicode.org|Adolfo González Blázquez]]
  * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]]