Настройки поиска

* * * Структура хука * * *

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

Хуки находятся в разделе:

<hooks>
</hooks>

файла manifest.xml.

Сам хук объявляется следующим образом:

<hook id="ЗДЕСЬ ПРОПИСЫВАЕТСЯ ИДЕНТИФИКАТОР ХУКА">

и закрывается тегом:

</hook>

______________________________

Для того, чтобы узнать какой идентификатор хука использовать делаем следующее:
1) Ищем файл, который генерирует интересующий нас контент. (header.php)
2) Находим блок кода в который нам нужно влезть.

...
// Forum Title
$gen_elements['<!-- forum_title -->'] = <-- Переменная заголовка форума, которую нам нужно изменить.
...
($hook = get_hook('hd_gen_elements')) ? eval($hook) : null; <-- Объявление хука, который поможет это сделать.
...

3) Видим идентификатор хука. (hd_gen_elements)

Таким образом объявление хука примет такой вид:

<hooks>
    <hook id="hd_gen_elements"><![CDATA[
        ИСХОДНЫЙ КОД НА PHP...
    ]]></hook>
</hooks>

Исходный код должен помещаться в CDATA. Что это такое: На википедии
______________________________

Для замены заголовка логотипом нужно выполнить следующий код:

$gen_elements['<!-- forum_title -->'] = '<div id="logo"> <a href="'.forum_link($forum_url['index']).'" title="'.forum_htmlencode($forum_config['o_board_title']).'"><img src="'.$base_url.'/style/'.$forum_user['style'].'/logo.png" alt="'.forum_htmlencode($forum_config['o_board_title']).'" /></a> </div>';

Который заменит текст заголовка на файл logo.png, который нужно положить в папку со стилем. (стадартный - /style/Oxygen)
______________________________

Итогом будет файл manifest.xml с таким содержанием:

<?xml version="1.0" encoding="utf-8"?>

<extension engine="1.0">
    <id>forum_logo</id>
    <title>Замена заголовка на логотип</title>
    <description>Замена заголовка на логотип.</description>
    <version>1.0</version>
    <author>andrew(punbb.ru)</author>
    <minversion>1.3.3</minversion>
    <maxtestedon>1.3.4</maxtestedon>
    <hooks>
        <hook id="hd_gen_elements"><![CDATA[
            $gen_elements['<!-- forum_title -->'] = '<div id="logo"> <a href="'.forum_link($forum_url['index']).'" title="'.forum_htmlencode($forum_config['o_board_title']).'"><img src="'.$base_url.'/style/'.$forum_user['style'].'/logo.png" alt="'.forum_htmlencode($forum_config['o_board_title']).'" /></a> </div>';
        ]]></hook>
    </hooks>
</extension>

Готовое расширение в аттаче.

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

1) Смайлы определены в фале parser.php. Строка 17 (в версии 1.3.4)

$smilies = array(':)' => 'smile.png', '=)' => 'smile.png', ':|' => 'neutral.png', '=|' => 'neutral.png', ':(' => 'sad.png', '=(' => 'sad.png', ':D' => 'big_smile.png', '=D' => 'big_smile.png', ':o' => 'yikes.png', ':O' => 'yikes.png', ';)' => 'wink.png', ':/' => 'hmm.png', ':P' => 'tongue.png', ':p' => 'tongue.png', ':lol:' => 'lol.png', ':mad:' => 'mad.png', ':rolleyes:' => 'roll.png', ':cool:' => 'cool.png');

2) Размеры смайлов определены соответствующим аттибутом тега IMG. Чтобы от этого избавиться можно редактировать файлы include/parser.php, help.php и если установлено расширение pun_bbcode, то и bar.php в папке расширения.

Также можно почитать тему:
http://punbb.ru/topic3322-razmery-smail … lpphp.html

Начнемс...
1) Хук co_common в расширении является служебным и должен выглядеть так(всегда!):

        <hook id="co_common"><![CDATA[
            $pun_extensions_used = array_merge(isset($pun_extensions_used) ? $pun_extensions_used : array(), array($ext_info['id']));
        ]]></hook>

Никогда его не изменяй, или не используй вообще.
2) Тебе нужен(как я писал) хук hd_gen_elements. Т.е. код будет выглядеть так:

        <hook id="hd_gen_elements"><![CDATA[
            $gen_elements['<!-- forum_title -->'] = '';
        ]]></hook>

3) Ошибка

syntax error, unexpected T_STRING

возникла потому, что ты не поставил точку с запятой после

$gen_elements['<!-- forum_title -->'] = ''

Перечитай еще раз: http://punbb.ru/post24987.html#p24987. Можно добавить в уже существующее расширение код, который я написал в пункте 2, но для того чтобы все заработало расширение нужно переустановить в админке форума.

Фуххх. Надеюсь разберешься.

насчет расширения не скажу, но из редакторов советую TinyMCE, у которого есть плагин bbcode. По поводу интеграции, как вариант, переделать расширение pun_bbcode, вместо его javascript вписав свой(TinyMCE).

Ну например:

1) Для начала отредактируйте main.tpl таким образом:

<div id="brd-about" class="gen-content">
  <!-- forum_about -->
</div>

<!-- forum_debug -->

</div>

<div id="sape-block">
  <!-- my_sape_block -->
</div>

</div>

</body>
</html>

где

<div id="sape-block">
  <!-- my_sape_block -->
</div>

вставляется перед последним дивом.
(Для того, чтобы быть спокойным при обновлениях (чтоб новые файлы не заменили отредактированные) лучше поместить main.tpl в папку темы и редактировать там. Например: style/Oxygen/main.tpl)

2) Теперь нужно вставить содержимое блока:
Используем хук: ft_about_end (не обязательно его, но думаю подойдет.):

$sape_content = /* здесь нужно сформировать содержимое блока в HTML */
$tpl_main = str_replace('<!-- my_sape_block -->', $sape_content, $tpl_main);

О использовании хука и создании расширений можно почитать тут: http://punbb.ru/post24987.html#p24987.

Решение http://punbb.ru/post25037.html#p25037

А если задуматься, то возникает вопрос: а зачем вообще для тега img атрибуты width и height?! Браузеру они нафик не нужны. XHTML их тоже не просит. Зачем?

Насчет хука: в parser.php есть красивый хук. А вот в help.php приходится использовать str_replace!

ПС: может кто-нибудь запостит проблему на http://punbb.informer.com/forums/ , а то очень лениво регистрироваться там! Думаю лучший вариант: удалить width="15" height="15" вообще!

Странно. Этот файл должен быть. Попробуйте скачать дистрибутив форума:
http://punbb.informer.com/downloads.php#1.3.4
И сравнить с ним содержимое папки вашего форума. Файл Essentials должен быть 100%. Возможно вы не там ищете!

*** Хуки ***

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

Пример использования хука (решение вопроса The pun_repository official extension is installed ...)
1) создаете папку no_pun_ext в папке extensions.
2) в ней создаете файл manifest.xml с таким содержанием:

<?xml version="1.0" encoding="utf-8"?>

<extension engine="1.0">
    <id>no_pun_ext</id>
    <title>Откючение показа расширений</title>
    <description>Сокрытие строки с расширениями в forum-about.</description>
    <version>1.0</version>
    <author>Andrew</author>
    <minversion>1.3.4</minversion>
    <maxtestedon>1.3.4</maxtestedon>
    <hooks>
        <hook id="co_common"><![CDATA[
            $pun_extensions_used = array_merge(isset($pun_extensions_used) ? $pun_extensions_used : array(), array($ext_info['id']));
        ]]></hook>
        
    <!-- HIDE LIST OF EXTENSIONS -->
    <hook id="es_essentials"><![CDATA[
      define('PUN_EXTENSIONS_USED', 1);
        ]]></hook>
        
    </hooks>
</extension>

Где
1) <id>no_pun_ext</id> - идентификатор расширения. Должен совпадать с именем папки в которой находится файл manifest.xml.

2)

<hook id="co_common"><![CDATA[
  $pun_extensions_used = array_merge(isset($pun_extensions_used) ? $pun_extensions_used : array(), array($ext_info['id']));
]]></hook>

Служебный хук. Его нельзя изменять, если Вы не знаете что он делает.

3)

<hook id="es_essentials"><![CDATA[

Хук(идентификатор или имя хука(в данном случае это: "es_essentials")).

4)

define('PUN_EXTENSIONS_USED', 1);

Код PHP, который будет выполнен при вызове хука ядром форума.

5)

]]></hook>

Закрывающий тег для хука.

Затем в браузере заходите в "Администрирование >> Расширения" своего форума и там устанавливаете созданное расширение.

Надеюсь помог разобраться.