Modules are used to extend and modify the way ZNC functions. Users interact with modules most commonly by messaging a special user on IRC. For example, to view the highlight keywords in your watch list, you"d send /msg *watch list . When ZNC sees that the nick you"re messaging starts with an asterisk, it doesn"t forward the message to the IRCd/server but instead sends it to the proper module for processing. In this case, the watch module will get the message and reply to you with a listing of your keywords. This makes for a very convenient and standard way of configuring or otherwise communicating with your loaded modules, as well as a common and standard way for your loaded modules to display status or other information. Notice that this is for loaded modules. You must load a given module, for example /znc loadmod watch , before you can interface with the watch module. Most modules will reply to /msg *module help with a listing of available commands.
ZNC modules are loaded either globally , per-network , or on a per-user basis. Each module defines for itself whether it is available to load as global, network-specific and/or user-specific. User level and network modules can do things ranging from manipulating the incoming/outgoing messages to implementing a full blown Twitter client . They can also do more traditional IRC tasks such as challenge based auto-op , setting you away , or logging to disk . Each user gets to load and configure their own set of modules to customize their experience to suit their preference.
Global modules are loadable by admins and provide functionality or change behavior for all users. For example, the partyline module has to be global since it provides functionality for all users on a given ZNC instance to be able to communicate with each other from within ZNC itself. Global modules can do everything that user-level modules can do, as well as a few extras. They can replace ZNC"s authentication system , modify the config-writing process, deal with CAP, etc.
Feel free to create wikipages about modules you have created, but don"t forget to add a download link, contact information, and use the same layout as the rest of the modules. Contributions are always much appreciated.
Module List [ edit ]
Global Modules [ edit ]
adminlog Log user connects, disconnects, and failed logins to a file and/or to syslog. blockuser Blocks certain users from using ZNC, saying their account was disabled. certauth This module lets users to log in via SSL client keys. cyrusauth This module is intended for admins who run a shell/web/email/etc server and want to provide ZNC access to their existing users. fail2ban Block IPs for some time after a failed login. identfile Posts the ident of a user to a file when they are trying to connect. imapauth Allow users to authenticate via IMAP. lastseen Logs when a user last logged in to ZNC. modperl Loads Perl scripts as ZNC modules. modpython Allows you to use modules written on Python. notify_connect Sends a notice to all admins when a user logs in or out of ZNC. partyline Allows ZNC users to join internal channels and query other ZNC users on the same ZNC. webadmin Allows you to add/remove/edit users and settings on the fly via a web browser.User Modules [ edit ]
admin (Now controlpanel) Allows you to add/remove/edit users and settings on the fly via IRC messages. autoattach Watches your detached channels and reattaches you automatically when there is specified activity in a channel you added to your autoattach list. autoreply Gives a automatic reply if someone messages you while you are away. block_motd Blocks the server"s Message of the Day. bouncedcc Bounces DCC transfers through the znc server instead of sending them directly to the user. buffextras Add nick changes, joins, parts, topic changes etc. to your playback buffer. chansaver Saves channels to config when user joins and parts. charset Normalizes (i.e. converts) character encodings. clearbufferonmsg This module attempts to bridge the gap between being inundated with old buffer if you have KeepBuffer=true; and possibly missing messages when you ping out, if you have KeepBuffer=false. clientnotify Notify about new incoming connections to your user. controlpanel Allows you to add/remove/edit users and settings on the fly via IRC messages. ctcpflood This module tries to block CTCP floods. dcc This module allows you to transfer files to and from ZNC disconkick This module will kick your client from all channels if ZNC disconnects from server. flooddetach This module detaches you from channels which are flooded. listsockets This module displays a list of all open sockets in ZNC. log Log chat activity to file. missingmotd This user module will send 422 to clients when they login. notes Keep and replay notes. This is an example of WebMods . sample This is an example module to help with writing modules to do whatever you want. send_raw Allows you to send raw traffic to IRC from other users. shell Access your Unix shell via query right inside of your IRC client.Network Modules [ edit ]
autocycle Rejoin a channel when you are the only one there (to gain operator status). autoop Automatically give operator status to the good guys. modtcl Allows you to run Tcl scripts in ZNC. autovoice Automatically give voice status to everyone who joins some channel. awaynick Change your nick while you are away. awaystore When you are set away or detached, this module will save all private messages for you. The messages can be read until you delete them. This module will also set you away when you are idle some time. cert This module lets users use their own SSL certificate to connect to a server. crypt Encryption for channel/private messages. keepnick Tries to get and keep your primary nick if it is taken. kickrejoin Implements auto-rejoin-on-kick. modules_online Fakes online status of ZNC modules to fix some clients. nickserv Auths you with NickServ. perform Performs commands on connect. Auths you with Q (and a little more). raw View all of the raw traffic. route_replies Routes back answers to the right client when connected with multiple clients. sasl Allows you to authenticate to an IRC network via SASL savebuff Saves your channel buffers into an encrypted file so they can survive restarts and reboots. schat SSL (encrypted) DCC chats. simple_away Automatically set you away on IRC when disconnected from the bouncer. stickychan Keeps you in specified channels. watch Monitor activity for specific text patterns from specific users and have the text sent to a special query window.More Modules [ edit ]
Managing Modules [ edit ]
Modules can be added or removed easily. Modules can be stored in ~/.znc/modules and /usr/local/lib/znc by default. ZNC installs its modules to that second directory, which in fact is ${prefix}/lib/znc , but this can be changed with ./configure --module-prefix=DIR before compiling.
ZNC will first look in the local sub-directory modules when searching for modules. Only files that end with ".so" will be seen as a module. To remove modules you can simply delete them from the folder. No other configuration changes or restarts are necessary. To remove, but also keep a module for later use you can also change the name, like: mv sample.so sample.so_ .
To compile a new module you must first save the source as a ".cpp" file. Compiling modules describes the process in detail.
Global, user, and network modules can be (un)loaded from webadmin or via the *status query window, like:
/msg *status LoadMod [--type=global|user|network]
- configuration
- [--type=global|user|network] optionally specifies whether to (un)load the module as a global, user, or network module. Not all modules can be loaded at all levels; see individual Module documentation to find out where it may be loaded.
is based on the modules file name, excluding the ".so" extension. Are specific for each module and not required: You can provide parameters when loading the module, or you can set up the module after loading it.
So, to load the log module at the global level (as opposed to user or network) and remove all color/formatting control codes with the -sanitize parameter, you would type:
/msg *status LoadMod --type=global log -sanitize
For older versions of ZNC, you won"t have the option to specify [--type=global|user|network] . In that case, just use:
/msg *status LoadMod
Please keep in mind that a user is not able to load a module if the directive "DenyLoadMod" is set to true. Trying to load a module will fail with "Unable to load [
If a module prevents ZNC from starting up and therefore you can"t unload the module using webadmin , you can edit znc.conf and remove the corresponding LoadModule line.
Using modules [ edit ]
It is recommended to read the module"s wikipage if you want to find out how a module works. Alternatively the following command can be used to get a command list:
/msg *
- * is the StatusPrefix set in your configuration . Usually it"s just an asterisk ("*").
После обновления версии друпала на одном из сайтов, где было много рукописных модулей, я, к своему изумлению, обнаружил несколько подряд сообщений об ошибках такого вот содержания:
User warning: The following module is missing from the file system:...
дальше шли имена тех самых модулей, которые система не обнаружила. Модули эти когда-то писал я сам, но в процессе создания они как-то объединились с другими, переименовались или еще что-то... в общем для истории они потеряны. Сначала я решил плюнуть на все это, но очень быстро надпись меня стала раздражать, и я полез разбираться по ссылке, которая была указана рядом с сообщением о проблеме. Почитав инфы я понял, что был неправ, когда удалял модули сразу прямо с сервера, а не пользовался для этого опциями админпанели. Не буду сейчас в подробностях описывать чем это плохо, но делать этого не стоило, но вот сам Друпал таких недостойных поступков разработчиков никак не пресекал. И вот в версии 7.50 и выше создатели этой славной CMS решили призвать всех к порядку.
Что же делать, если и вам тоже надоела эта назойливая надпись и захотелось устранить дефекты настройки сайта? Все очень просто и для решения проблемы даже не нужно снова искать в Интернете те модули, которые вы удалили, и снова их устанавливать на сайт (как это рекомендуется разработчиками Drupal). И даже то, что это был ваш собственнописный полуфабрикат и вы забыли о нем напрочь, не означает, что вам придется пройти сеанс гипноза и восстановить код из глубин подсознания. Проблема решается в три простых шага:
Вот и все. Я обещал три шага, а получилось шесть. Но это не значит, что все сложно, просто я растягивал удовольствие:) Удачи!
После того, как репозиторий клонирован с гитхаба, ввожу npm install для установки зависимостей и терплю фейл. Вот листинг процесса:
bimbatron:bem bimba$ npm install
> [email protected] postinstall /Users/bimba/BEM
> npm run deps
> [email protected] deps /Users/bimba/BEM
> bower i --allow-root
bower EACCES EACCES: permission denied, mkdir "/Users/bimba/.cache/bower/registry/bower.herokuapp.com"
Stack trace:
Error: EACCES: permission denied, mkdir "/Users/bimba/.cache/bower/registry/bower.herokuapp.com"
at Error (native)
at Object.fs.mkdirSync (fs.js:922:18)
at sync (/Users/bimba/BEM/node_modules/bower/lib/node_modules/bower-registry-client/node_modules/mkdirp/index.js:55:12)
at Function.sync (/Users/bimba/BEM/node_modules/bower/lib/node_modules/bower-registry-client/node_modules/mkdirp/index.js:61:24)
at new Cache (/Users/bimba/BEM/node_modules/bower/lib/node_modules/bower-registry-client/lib/util/Cache.js:21:16)
at RegistryClient.
Первая ошибка, что бросается в глаза, это какой-то путь, в котором содержится упоминание heroku app. пробовал чистить кеш bower"a, не помогает, ошибка появляется снова (кстати, как удалить heroku полностью из системы?).
Мы поверхностно коснулись темы методов вывода контента в теле шаблона. Давайте теперь подробно разберем что это и с чем его едят. Итак, объявления метода jdoc
присутствуют в каждом
шаблоне Joomla
и выводят в тело шаблона (то бишь на страницу сайта) ту или иную информацию. В целом объявление метода выглядит следующим образом
Данная строчка выводит на сайте информацию из компонентов, например статьи из com_content. Тип элементов вывода указывается в атрибуте.
1. type - типы элементов вывода.
- component - как писал выше, выводит основное содержание страницы. Может вызываться только один раз в шаблоне.
- head
- объявляется так же один раз после открывающего тэга . Служит для вывода стилей, скриптов,
и метаданных текущей страницы.</li><li><i>message </i><i>- </i> выводит системные сообщения. Объявляется один раз в теле документа (body).</li><li><i>installation </i> - ничего не выводит и представляет собой «инструкцию» для установки.</li><li><i>module - </i>выводит на странице единичный модуль. Количество объявлений не ограничено.</li><li><i>modules </i> - в отличии от предыдущего типа, позволяет выводить в своей позиции не единичое число модулей.</li> </ul><p>Для первых четырех указанных типов достаточно лишь указать их на странице. В случае с типом модуля задача немного усложняется. Для того, чтобы вывести на странице модуль нам нужно сперва создать для него <b>модульную позицию </b> с уникальным идентификатором (название позиции модуля). Это делается при помощи атрибута name=«имя позиции» и обязательным добавлением строки:</p><p> <position>название позиции</position> в файл templateDetails.xml. Описывая название позиции в templateDetails.xml мы обозначаем ее в системе и видим в менеджере модулей. Имена позиций могут быть произвольными, хотя name=«user3» позиция, по-умолчанию используется для отображения верхнего меню. </p><p><b>2. style - описание стиля вывода (mod chrome). </b></p> <p>От указанного стиля зависит внешний вид и структура оболочки модуля. Выглядит как</p><p> :<jdoc:include type="modules" name="user1" style="xhtml" /> По-умолчанию заложено несколько стилей вывода модулей: </p><ul><li><i>xhtml - </i> выводит модуль в блоке с заголовком function modChrome_xhtml($module, &$params, &$attribs)<br>{<br> if (!empty ($module->content)) : ?><br> <div class="moduletable<?php echo htmlspecialchars($params->get("moduleclass_sfx")); ?>"><br> <?php if ($module->showtitle != 0) : ?><br> <h3><?php echo $module->title; ?></h3><br> <?php endif; ?><br> <?php echo $module->content; ?><br> </div><br> <?php endif;<br>}</li><li><i>table - </i>выводит модуль в верстке табличной структуры<br> function modChrome_table($module, &$params, &$attribs)<br>{ ?><br> <table cellpadding="0" cellspacing="0" class="moduletable<?php echo htmlspecialchars($params->get("moduleclass_sfx")); ?>"><br> <?php if ($module->showtitle != 0) : ?><br> <tr><br> <th><br> <?php echo $module->title; ?><br> </th><br> </tr><br> <?php endif; ?><br> <tr><br> <td><br> <?php echo $module->content; ?><br> </td><br> </tr><br> </table><br> <?php<br>}</li><li><i>horz - </i>выводит содержимое модуля в ячейке таблицы, горизонтально function modChrome_horz($module, &$params, &$attribs)<br>{ ?><br> <table cellspacing="1" cellpadding="0" width="100%"><br> <tr><br> <td><br> <?php modChrome_table($module, $params, $attribs); ?><br> </td><br> </tr><br> </table><br> <?php<br>}</li><li><i>rounded </i> - выводит модуль в нескольких вложенных блоках для сложного стилевого оформления в виде графических границ (напр. закругленных углов) function modChrome_rounded($module, &$params, &$attribs)<br>{ ?><br> <div class="module<?php echo htmlspecialchars($params->get("moduleclass_sfx")); ?>"><br> <div><br> <div><br> <div><br> <?php if ($module->showtitle != 0) : ?><br> <h3><?php echo $module->title; ?></h3><br> <?php endif; ?><br> <?php echo $module->content; ?><br> </div><br> </div><br> </div><br> </div><br> <?php<br>}</li><li><i>outline </i> - добавляет к блоку модуля предустановленные стили css function modChrome_outline($module, &$params, &$attribs)<br>{<br> static $css=false;<br> if (!$css)<br> {<br> $css=true;<br> jimport("joomla.environment.browser");<br> $doc = JFactory::getDocument();<br> $browser = JBrowser::getInstance();<br> $doc->addStyleDeclaration(".mod-preview-info { padding: 2px 4px 2px 4px; border: 1px solid black; position: absolute; background-color: white; color: red;}");<br> $doc->addStyleDeclaration(".mod-preview-wrapper { background-color:#eee; border: 1px dotted black; color:#700;}");<br> if ($browser->getBrowser()=="msie")<br> {<br> if ($browser->getMajor() <= 7) {<br> $doc->addStyleDeclaration(".mod-preview-info {filter: alpha(opacity=80);}");<br> $doc->addStyleDeclaration(".mod-preview-wrapper {filter: alpha(opacity=50);}");<br> }<br> else {<br> $doc->addStyleDeclaration(".mod-preview-info {-ms-filter: alpha(opacity=80);}");<br> $doc->addStyleDeclaration(".mod-preview-wrapper {-ms-filter: alpha(opacity=50);}");<br> }<br> }<br> else<br> {<br> $doc->addStyleDeclaration(".mod-preview-info {opacity: 0.8;}");<br> $doc->addStyleDeclaration(".mod-preview-wrapper {opacity: 0.5;}");<br> }<br> }<br> ?><br> <div class="mod-preview"><br> <div class="mod-preview-info"><?php echo $module->position."[".$module->style."]"; ?></div><br> <div class="mod-preview-wrapper"><br> <?php echo $module->content; ?><br> </div><br> </div><br> <?php<br>}</li><li><i>none </i> - аналогично не указанному вообще style. Выводит модуль без оформления и заголовка function modChrome_none($module, &$params, &$attribs)<br>{<br> echo $module->content;<br>}</li> </ul><p>Все предустановленные стили располагаются в файле templates/system/html/modules.php. Но мы не ограничены использованием только предоставленных вариантов, а вполне можем создавать свои собственные.</p> <p><b>3. Создание пользовательского mode chrome. </b></p> <p><b><br></b>Итак, предоставленные по умолчанию типы представления модулей не удовлетворяют текущих требований. Нужно добавить свой собственный стиль оформления. В качестве примера выберем достаточно часто повторяющуюся ситуацию. По заданию нужно вместо <h3> поместить заголовок модуля в тэг <span>, который является семантически нейтральным. Так же требуется поместить контентблок модуля в отдельный <div>. Для создания собственного стиля вывода модуля, воспользуемся стандартными средствами. В большинстве шаблонов Joomla существет папка html/ (templates/имя шаблона/html/), используется для так называемой шаблонизации. То есть, если скопировать в эту папку шаблон модуля, то вместо шаблона из директории modules/my_module/tmpl/default будет выводиться файл из templates/имя шаблона/html/my_modules/default. Аналогично шаблонизируются и компоненты. Удобно и практично. В папке html/ Вашего шаблона создадим файл modules.php. Если такой папки в шаблоне нет, то создадим ее. В файл запишем</p><p> <?php<br>function modChrome_modbox($module, &$params, &$attribs) // Вызываем функцию<br>{<br> if (!empty ($module->content)) : /* Проверяем наличие в поиции включенного модуля */?><br> <div class="moduletable<?php echo htmlspecialchars($params->get("moduleclass_sfx")); /* выводим суффикс css класса модуля */ ?>"><br> <?php if ($module->showtitle != 0) : /* проверяем включен ли заголовок модуля */ ?><br> <span class="title"><?php echo $module->title; /* Выводим заголовок */ ?></span><br> <?php endif; ?><br> <div class="modcontent"><br> <?php echo $module->content; /* Выводим содержимое модуля */ ?><br> </div><br> </div><br> <?php endif;<br>}<br>?> Готово. Теперь нужно только указать его в качестве стиля вывода. <jdoc:include type="modules" name="user1" style="modbox"/> Назначаем в нашу позицию модуль и смотрим результат.</p> <script type="text/javascript"> <!-- var _acic={dataProvider:10};(function(){var e=document.createElement("script");e.type="text/javascript";e.async=true;e.src="https://www.acint.net/aci.js";var t=document.getElementsByTagName("script")[0];t.parentNode.insertBefore(e,t)})() //--> </script><br> <br> <script>document.write("<img style='display:none;' src='//counter.yadro.ru/hit;artfast_after?t44.1;r"+ escape(document.referrer)+((typeof(screen)=="undefined")?"": ";s"+screen.width+"*"+screen.height+"*"+(screen.colorDepth? screen.colorDepth:screen.pixelDepth))+";u"+escape(document.URL)+";h"+escape(document.title.substring(0,150))+ ";"+Math.random()+ "border='0' width='1' height='1' loading=lazy>");</script> </div> </article> </div> </main> <noindex> <aside class="sidebar sidebar_midle"> <div class="section-posts-box section"> <div class="title">Популярные статьи</div> <div class="section-posts"> <div class="section-posts__item"> <img src="/uploads/4be64ff6d222da4105692245d96c0c1c.jpg" width="300" height="180" class="section-posts__item-img" alt="Василий III. Биография. Правление. Семья. Интересные факты о Василии III Сообщение о василии 3 кратко" / loading=lazy> <div class="section-posts__item-title"> <a href="/vasilii-iii-biografiya-pravlenie-semya-interesnye-fakty-o-vasilii.html">Василий III. Биография. Правление. Семья. Интересные факты о Василии III Сообщение о василии 3 кратко</a> </div> <div class="section-posts__item-text"> Василий 3 (годы правления 1505-1533) ознаменовались окончательным сбором русских земель... </div> <div class="post-info section-posts__item-info"> <time class="post-info__time post-info__time_popular" datetime="">2024-04-15 01:49:22</time> </div> </div> <div class="section-posts__item"> <img src="/uploads/888d10e708a1a32369d88c15e49bf7ab.jpg" width="300" height="180" class="section-posts__item-img" alt="Переход от корней к степеням и обратно, примеры, решения Как решать примеры со степенями и корнями" / loading=lazy> <div class="section-posts__item-title"> <a href="/izvlechenie-kornei-sposoby-primery-resheniya-perehod-ot-kornei-k.html">Переход от корней к степеням и обратно, примеры, решения Как решать примеры со степенями и корнями</a> </div> <div class="section-posts__item-text"> Пришло время разобрать способы извлечения корней . Они базируются на свойствах корней , в... </div> <div class="post-info section-posts__item-info"> <time class="post-info__time post-info__time_popular" datetime="">2024-04-12 01:52:34</time> </div> </div> <div class="section-posts__item"> <img src="/uploads/c6b834710dd0f89e1c2f6accaac858c2.jpg" width="300" height="180" class="section-posts__item-img" alt="Знамение Невидимой Звезды (ЛП) Небо переходной местности между пригородами и городами" / loading=lazy> <div class="section-posts__item-title"> <a href="/pochemu-ne-vidno-zvezd-znamenie-nevidimoi-zvezdy-lp-nebo.html">Знамение Невидимой Звезды (ЛП) Небо переходной местности между пригородами и городами</a> </div> <div class="section-posts__item-text"> Экология познания. Наука и открытия: Вселенная бесконечна, и в ней нет числа звездам. В... </div> <div class="post-info section-posts__item-info"> <time class="post-info__time post-info__time_popular" datetime="">2024-04-11 01:52:27</time> </div> </div> </div> </div> <div class="section section_widget widget_text" id="text-7"> <div class="textwidget"> </div> </div> </aside> </noindex> </div> </div> <footer class="footer"> <link href="https://fonts.googleapis.com/css?family=Roboto:400,400i,500,700,700i&subset=cyrillic" rel="stylesheet"> <nav class="footer-nav"> <ul> <li class="menu-item type-post_type object-page "><a href="/feedback.html">Контакты</a></li> <li class="menu-item type-post_type object-page "><a href="/sitemap.xml">Карта сайта</a></li> </ul> </nav> <div class="footer-bottom"> <div class="copy">© 2024 netdenegnakino.ru - Двойкам - нет. Химия. Физика. Орфография. География</div> </div> </footer> </div> <script type='text/javascript'> /* <![CDATA[ */ var tocplus = { "smooth_scroll": "1", "visibility_show": "\u041f\u043e\u043a\u0430\u0437\u0430\u0442\u044c", "visibility_hide": "\u0421\u043a\u0440\u044b\u0442\u044c", "width": "Auto" }; /* ]]> */ </script> <script type='text/javascript' src='https://netdenegnakino.ru/wp-content/plugins/table-of-contents-plus/front.min.js?ver=1509'></script> <script type='text/javascript' src='https://netdenegnakino.ru/wp-content/plugins/wp-postratings/js/postratings-js.js?ver=1.85'></script> <script type='text/javascript'> var q2w3_sidebar_options = new Array(); q2w3_sidebar_options[0] = { "sidebar": "sidebar-2", "margin_top": 10, "margin_bottom": 0, "stop_id": "", "screen_max_width": 0, "screen_max_height": 0, "width_inherit": false, "refresh_interval": 1500, "window_load_hook": false, "disable_mo_api": false, "widgets": ['text-7', 'text-6'] }; </script> <script type='text/javascript' src='https://netdenegnakino.ru/wp-content/plugins/q2w3-fixed-widget/js/q2w3-fixed-widget.min.js?ver=5.0.4'></script> <script type='text/javascript' src='/wp-includes/js/wp-embed.min.js?ver=4.9.2'></script> </div> </body> </html> <script data-cfasync="false" src="/cdn-cgi/scripts/5c5dd728/cloudflare-static/email-decode.min.js"></script>