Уважаемые Гуру и другие члены форума, хотелось бы понять как пишутся плагины (хаки, продукты). С подробным описанием если не сложно... что, как и почему...
Рассматривал на примере welcome_panel modified by kerk.
Вот что мне удалось сообразить:

<?xml version="1.0" encoding="ISO-8859-1"?>

XML

XML (англ. eXtensible Markup Language — расширяемый язык разметки; произносится [экс-эм-э?л]) — рекомендованный Консорциумом Всемирной паутины язык разметки, фактически представляющий собой свод общих синтаксических правил. XML — текстовый формат, предназначенный для хранения структурированных данных (взамен существующих файлов баз данных), для обмена информацией между программами, а также для создания на его основе более специализированных языков разметки (например, XHTML), иногда называемых словарями. XML является упрощённым подмножеством языка SGML.
Целью создания XML было обеспечение совместимости при передаче структурированных данных между разными системами обработки информации, особенно при передаче таких данных через Интернет. Словари, основанные на XML (например, RDF, RSS, MathML, XHTML, SVG), сами по себе формально описаны, что позволяет программно изменять и проверять документы на основе этих словарей, не зная их семантики, то есть не зная смыслового значения элементов. Важной особенностью XML также является применение так называемых пространств имён (англ. namespace).

encoding

encoding="кодировка"

ISO/IEC 8859-1 (также известная как ISO 8859-1 и Latin-1) — кодовая страница, предназначенная для западноевропейских языков; она базируется на символьном наборе популярных в прошлом терминалов VT220. Кодовые позиции 0—31 (0x0—0x1F) и 127—159 (0x7F—0x9F) не определены. По образцу ISO 8859-1 сделаны все остальные кодировки серии ISO 8859.
ISO-8859-1 — кодировка, зарегистрированная IANA в 1992 г. В отличие от ISO/IEC 8859-1, кодовые позиции 0—31 и 127—159 здесь заполнены управляющими символами (большинство из которых, впрочем, всё равно никто не использует). В HTML ISO-8859-1 является кодировкой по умолчанию (в XHTML, однако, кодировкой по умолчанию является UTF-8).
IANA разрешает использовать следующие варианты названия: ISO_8859-1:1987, ISO_8859-1, ISO-8859-1, iso-ir-100, sISOLatin1, latin1, l1, IBM819, CP819.
В Юникоде первые 256 кодовых позиций совпадают с ISO-8859-1.
В Microsoft Windows для западноевропейских языков используется кодировка Windows?1252, которая отличается от ISO-8859-1 тем, что позиции 128—159 здесь заняты разными полезными типографскими символами. Большинство браузеров не различают ISO-8859-1 и Windows?1252 — фактически и в том, и в другом случае они отображают текст как Windows?1252.
Такая путаница между этими двумя кодировками привела к тому, что многие программы, генерирующие файлы HTML, ошибочно обозначали символы их кодами из Windows?1252 вместо кодов Юникода (исходя из того, что номер символа в ISO-8859-1 равен его номеру в Юникоде): например, тире (—) обозначалось — вместо правильного —, многоточие обозначалось … вместо правильного … и т. д.; из-за распространённости этого явления современные браузеры продолжают показывать, например, — как тире, хотя на самом деле — — это управляющий символ «end of guarded area», применение которого в HTML бессмысленно.
Кодовые таблицы символов в ISO-8859 ISO 8859-1 | ISO 8859-2 | ISO 8859-3 | ISO 8859-4 | ISO 8859-5 | ISO 8859-6 | ISO 8859-7 | ISO 8859-8
ISO 8859-9 | ISO 8859-10 | ISO 8859-11 | ISO 8859-12 | ISO-8859-13 | ISO 8859-14 | ISO 8859-15 | ISO 8859-16

<product productid="welcome_panel" title="Welcome Panel" description="modified by kerk." version="1.0.0" active="1">

product - говорит форуму что данный файл является продуктом
productid="название продуктана буржуйском" - Идентификатор продукта (системная необходимость)
title="название продукта" - в установленных продуктах отображается
/admincp/plugin.php?do=product
description="описание продукта" - в установленных продуктах отображается version="1.0.0" - версия продукта
active="1" - продукт активен (включен)

Лео добавил 05.07.2008 в 06:18

<url />
    <versioncheckurl />
    <dependencies>
    </dependencies>
    <codes>
    </codes>

Ничего не знаю... прошу разжевать.. я поправлю пост....

<templates>
        <template name="forumhome_welcomepanel" templatetype="template" date="1127431399" username="kerk" version="3.5.0 Gold"><![CDATA[<if condition="$bbuserinfo[userid]">      
   КОД ШАБЛОНА      
   </if>]]></template>
</templates>

<templates>смотрите ниже пример шаблона</templates> - "тег" отделяющий шаблоны от плагинов (об этом ниже) Изменяет шаблоны форума при импорте продукта.
<template>Код внутри шаблона</template> - тег шаблона
Применяются следующие параметры для тега <template>:
name="forumhome_welcomepanel" - имя шаблона
templatetype="template" - тип шаблона насколько я понял (хотелось бы уточнить на какие виды они делятся)
date="1127431399" - дата создания/редактирования шаблона (не понимаю, если не сложно расшифруйте как переводить в нормальный формат)
username="kerk" - Имя юзверя создавшего шаблон (при изменении редактируемого шаблона меняется на это *поседний раз редактировалось*)
version="3.5.0 Gold" - версия форума для которой написан шаблон (при импорте есть галочка *игнорировать версию форума*)
![CDATA - сокращение от character data что в переводе с английского обозначает «символьные данные.» Используется для разных, но связных между собой целей в языках разметки SGML и XML. CDATA показывает, что определённая часть документа представляет собой символьные данные, в отличие от несимвольных или символьных, но особым образом структурированных данных. подробнее...
<if condition="$bbuserinfo[userid]"></if> - if (если) condition (условие) $bbuserinfo[userid] (загадка для меня) - тег выполняющий условие
пример "if else"

<if condition="$show['guest']">
показывать это для гостей
<else />
показывать всем, кроме гостей
</if>

пример шаблона

<template name="forumhome_welcomepanel" templatetype="template" date="1127431399" username="kerk" version="3.5.0 Gold"><![CDATA[<if condition="$bbuserinfo[userid]">

<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
<tr>
<td class="tcat" colspan="3" align="center">
код какой хотите видеть в шаблоне
</td>
</tr>
</tbody>
</table>

</if>]]></template>

по поводу ниже приведенного тоже ничего сказать не могу
<plugins>
</plugins>
<phrases>
</phrases>
<options>
</options>
<helptopics>
</helptopics>
<cronentries>
</cronentries>
<faqentries>
</faqentries>

Пример шаблона zCarot]

<?xml version="1.0" encoding="ISO-8859-1"?>

<product productid="zshowban" active="1">
<title>zShowBan</title>
<description>Отображение причины блокировки под статусом пользователя</description>
<version>0.1</version>
<url />
<versioncheckurl />
<dependencies>
</dependencies>
<codes>
</codes>
<templates>
</templates>
<plugins>
<plugin active="1" executionorder="5">
<title>Название шаблона латиницей</title>
<hookname>postbit_display_complete</hookname>
<phpcode><![CDATA[if <if condition="$bbuserinfo[userid]">
{
if (!($zshowban[$post['userid']]))
{
$ztmp = $vbulletin->db->query_first("SELECT `reason` FROM " . TABLE_PREFIX . "userban WHERE userid=".$post['userid']);
if ($ztmp['reason'])
{
$zshowban[$post['userid']] = $ztmp['reason'];
}
}
$post[usertitle] .= '<br /><i>'.$zshowban[$post['userid']].'</i>';
}]]></phpcode>
</plugin>
</plugins>
<phrases>
</phrases>
<options>
</options>
<helptopics>
</helptopics>
<cronentries>
</cronentries>
<faqentries>
</faqentries>
</product>

не по порядку, а по мере составления ответа на вопрос:
вопрос:

Originally Posted by Лео

как пишутся плагины (хаки, продукты)

я уже где то описывал очень подробно, но нужно поискать, давно было...
ответ:
1. в менеджере продуктов добавить новый продукт
2. там в полях прописать переменную (идентификатор продукта), описание, ссылку на тему продукта (если есть) и т.д.... добавить...
3. создаешь новую группу настроек в основных настройках (если в хаке используются свои настройки), произвольная переменная, но лучше делать, что бы было все на своих местах, открой любой один из недавних моих продуктов (не переделку), там везде стоит префикс - "kr_" + "product_id" + "free_var"
4. когда добавляешь новую настройку к хаку, то указываешь идентификатор продукта (хак)
5. когда добавляешь новый шаблон (если в хаке используются шаблоны), то указываешь идентификатор продукта (хак)
6. когда добавляешь новый плагин (если в хаке используются плагины), то указываешь идентификатор продукта (хак), указываешь хук (hook), которым этот плагин будешь цеплять, активен/нет, добавить....
вопрос:

Originally Posted by Лео

date="1127431399" - дата создания/редактирования шаблона

ответ:
UNIX Timestamp - юникс время от 01.01.1970 г

PHP Code:

// запрос в БД в табл. table_name
$result = $vbulletin->db->query_read("
                                  SELECT table_name.*,
                                  FROM " . TABLE_PREFIX . "table_name AS table_name
                            WHERE table_name.userid = " . intval($vbulletin->userinfo['userid']) . "
                            ORDER BY table_name.date ASC
                      ");
$var = $vbulletin->db->fetch_array($result); // массив данных из табл table_name, где date == 1127431399

$var['date'] = vbdate("H:i d.m.Y", $var['date'], false);

print $var['date']; // результат: 00:23 23.09.2005
print $var['userid']; // результат: 1 (к примеру)
print $var['username']; // результат: kerk (к примеру) 


вопрос:

Originally Posted by Лео

<plugins>
</plugins>
<phrases>
</phrases>
<options>
</options>
<helptopics>
</helptopics>
<cronentries>
</cronentries>
<faqentries>
</faqentries>

ответ:
плагины,
фразы,
настройки,
помощь, если есть (не обязательно),
выполнение кода по расписанию, если есть в хаке (не обязательно),
текст FAQ если есть (не обязательно)

так же в продукте может быть код установки/удаления, может быть разным, например создание/удаление своих таблиц в БД и/или добавление/удаление новых полей в уже существующие таблицы

когда продукт готов - экспорт продукта из менеджера
===
вот собсно как то так, если коротко, а если все подробно, то это не одна страница текста будет и не один день работы

Originally Posted by kerk

3. создаешь новую группу настроек в основных настройках (если в хаке используются свои настройки), произвольная переменная, но лучше делать, что бы было все на своих местах, открой любой один из недавних моих продуктов (не переделку), там везде стоит префикс - "kr_" + "product_id" + "free_var"

не совсем понятно...как добавлять новую группу настроек? Продукт создал... а где остальное заполнять? и что за "kr_" + "product_id" + "free_var"?

при нажатии Добавить новый модуль 2 строку Местоположение модуля существует возможность выбора только от хака БЛАГОДАРНОСТИ ЗА СООБЩЕНИЕ

Что касается времени, нашел удобную вещ по твоей ссылке Unix time конвертор

Как дописывать код в шаблоны при помощи хака?
Например в шаблон headinclud мне нужно добавить JS

Originally Posted by Лео

Например в шаблон headinclud мне нужно добавить JS

можно добавить прямо в шаблон, если это ссылка на файл скрипта, либо подключить код скрипта как шаблон плагином, например:
1 вариант - у тебя уже есть шаблон с именем tamplate_name, нужно в шаблоне воблы найти код, который от версии к версии не меняется, например в версии 3.7.2 в шаблоне headinclude есть такая строка <!-- / CSS Stylesheet -->, мы можем использовать ее для нужных нам целей, без правки шаблона вручную, добавляем плагин с кодом:

PHP Code:

$search = '<!-- / CSS Stylesheet -->';
$vbulletin->templatecache['headinclude'] = str_replace($search, $search.fetch_template('tamplate_name'), $vbulletin->templatecache['headinclude']); 


и подключаем этот плагин хуком global_start
сам код нашего шаблона может выглядеть так:

<script type="text/javascript" src="clientscript/your_js.js"></script>

или если это не ссылка на файл, а сам код яваскрипта, то и в шаблоне соотв. код JS

Originally Posted by Лео

"kr_" + "product_id" + "free_var"?

как пример, хак vBGarage:
<product productid="kr_vbgarage" active="1">
где kr_ - префикс и vbgarage - идентификатор продукта, по этому префиксу я быстро нахожу свои продукты/плагины/шаблоны
и далее на примере шаблона:
<template name="vbgarage_addgarage" templatetype="template" date="1211514258" username="kerk" version="3.8.1">
где vbgarage - идентификатор продукта и addgarage - что бы самому понятней было, за что отвечает шаблон, в данном случае, это добавление авто в гараж

Originally Posted by Лео

не совсем понятно...как добавлять новую группу настроек?

это можно сделать только в отладочном режиме (debug mode)

kerk, а как можно добавить группу настроек в форму создания/редактирования разделов?

это можно сделать только редактированием файла forum.php в админке
смотри структуру файла

1. Возможна ли вставка ссылок в RSS ленту без правки файлов?
2. Как расписать правильно условия для следующего меню в коде модуля?

<select name=\"setting[$setting[varname]]\" tabindex=\"1\" class=\"bginput\">
<option value=\"0\" " . iif($setting['value']=='0','selected="selected"') . ">cp1251</option>
<option value=\"1\" " . iif($setting['value']=='1','selected="selected"') . ">utf8</option>
</select>

код взят как пример из хака "кто скачивал"

3. Где лучше прописывать "ВЫКЛЮЧЕНИЕ" в шаблонах или модулях?

<if condition="$vboptions[xxx]==1">
бла бла бла
</if>

Originally Posted by Лео

. Где лучше прописывать "ВЫКЛЮЧЕНИЕ" в шаблонах или модулях?

если хах без плагинов - в шаблонах
если хак с плагинами - в плагинах

Originally Posted by Лео

Как расписать правильно условия для следующего меню в коде модуля? Код: cp1251 utf8

В вобле 3.7 и выше, сделали, чтобы не прописывать эти селекты вот такого рода код:

select:piped
0|no
1|yes
2|yes_but_disable_moderators

появляется вот такой выбор

они пишутся так:

select:piped
значение|фраза, или обычный текст

Originally Posted by GiveMeABreak

В вобле 3.7 и выше, сделали, чтобы не прописывать эти селекты вот такого рода код:

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

Лео добавил 28.07.2009 в 06:03
Где можно в админке добавить данные для этой строки?
<phrasetype name="Название группы фраз" fieldname="Префикс фразы">

Очередное "КАК?"))
Задача:

В шаблоне postbit_legacy сделать из

        <!-- message -->
        <div id="post_message_$post[postid]">
            $ad_location[ad_showthread_firstpost_start]
            $post[message]
        </div>
        <!-- / message -->

Следующее:

        <!-- message -->
        <div id="post_message_$post[postid]">
            $ad_location[ad_showthread_firstpost_start]
<sape_index>
            $post[message]
</sape_index>
        </div>
        <!-- / message -->

и в любое место в шаблон postbit_legacy вставить $show[sape_context]

Велосипед

Учитывая знания которыми в этой теме поделился kerk, за что очередное спасибо и не последнее)) Я замутил следующий велосипед:
Создать шаблоны ld_monetisation_addlinks_cont_1

<sape_index>

ld_monetisation_addlinks_cont_2

</sape_index>

и плагин "Автозаполнение postbit_legacy" в postbit_legacy_start

PHP Code:

$search = '<!-- message -->
         <div id="post_message_$post[postid]">
             $ad_location[ad_showthread_firstpost_start]';

$vbulletin->templatecache['postbit_legacy'] = str_replace($search, $search.fetch_template('ld_monetisation_addlinks_cont_1'), $vbulletin->templatecache['postbit_legacy']);

$search = '$post[message]';

$vbulletin->templatecache['postbit_legacy'] = str_replace($search, $search.fetch_template('ld_monetisation_addlinks_cont_2'), $vbulletin->templatecache['postbit_legacy']);

output .= $show['sape_context']; // и конечно же переменная, кстати так и не пойму зачем перед равно точка 


Прошу помощи в более компактной и правильной реализации