Начать новую тему Ответить на тему
АвторСообщение

 Сообщение Пример простейшего расширения phpBB 3.1 / Ascraeus 
#1 

Аватар пользователя

Всем привет, сегодня мы рассмотрим пример простейшего расширения для phpBB 3.1 / Ascraeus. Простейшее оно потому, что в нем будут использоваться только события шаблонов и ничего более. Для примера разберем расширение от нашего форума .

В данном расширении использовано всего лишь одно шаблонное событие, а именно overall_header_head_append, событие добавляющее нужный код перед закрывающим тегом </head>. Конечно, предыдущее предложение мало кто поймет, поэтому обьясню еще подробней :-00):

В phpBB 3.1 / Ascraeus при установке расширений вам не надо делать правки кода, никогда и ни при каких обстоятельствах. Потому мы используем события, полный список которых , нас интересуют события Template Events (они же шаблонные события или события в шаблонах). Как оно работает ??? А работает оно следующим образом....

Мы ставим задачу себе подключить скрипт в шапку, без правок кода. Следовательно нам нужно вставить код до закрывающего тега </head>, идем в список шаблонных событий и видим, что нам подходит overall_header_head_append. Как им воспользоваться ??? А пользуемся им следующим образом....

Создаем html-файл с именем, аналогичным названию события, в нашем случае нам нужно создать файл overall_header_head_append.html со следующим содержимым
<script type="text/javascript" src="путь до скрипта/snowstorm.js"></script>
 


Тобишь имя файла задает тип события, а его содержимое вставляется в место, положенное по событию... Но этого мало для полноценного расширения, ложим наш overall_header_head_append.html в папку имя_автора/имя_расширения/styles/имя_поддерживаемого_стиля/template/event/ либо если событие не зависит от верстки стиля - имя_автора/имя_расширения/styles/all/template/event/. Потом в папке имя_автора/имя_расширения/ создаем 2 файла, первый - composer.json с таким содержимым
{
   "name": "имя_автора/имя_расширения",
   "type": "phpbb-extension",
   "description": "Описание вашего расширения",
   "homepage": "Адрес по которому можно скачать его",
   "version": "Версия расширения в численном виде",
   "time": "Дата создания расширения",
   "license": "GPL-2.0",
   "authors": [{
         "name": "Имя автора ",
         "username": "Ник автора",
         "email": "Контактный емейл",
         "homepage": "Домашняя страница автора",
         "role": "Роль "
      }],
   "require": {
      "php": ">=5.3.3"
   },
   "extra": {
      "display-name": "Имя расширения в админке",
         "soft-require": {
         "phpbb/phpbb": "3.1.*@dev"
      }
   }
}
 

И второй - ext.php
<?php
/**
*
* @package phpBB Extension
* @copyright (c) 2013 phpBB Group
* @license http://opensource.org/licenses/gpl-2.0.php GNU General Public License v2
*
*/

namespace имя_автора/имя_расширения;

/**
* @ignore
*/

class ext extends \phpbb\extension\base
{
}
 


имя_автора/имя_расширения - всегда должно быть написано на английской раскладке !!!

Собственно и все, наше маленькое расширение готово, осталось разложить все файлы по правильным папкам, ничего сложного, никаких правок, все через события шаблонов :hi_hi_hi:


_________________
Подпись:
-_- -_-
На вопросы, связанные с phpBB, по ЛС не отвечаю !!!
          Вернуться наверх  
 
 
Начать новую тему Ответить на тему


Дополнительные возможности

  Похожие темы  Автор  Ответов  Просмотров  Последнее сообщение 
Аватар пользователя Проверка версии расширения в phpBB 3.1
Статья о том, как организовать проверку наличия новых версий ваших расширений в phpBB 3.1 / Ascraeus

DeaDRoMeO

0

95

Аватар пользователя

02 мар 2017, 18:02

DeaDRoMeO

Аватар пользователя phpBB 3.1.x/Ascraeus
Итак, дорогие дамы и господа, данная тема носит статус открывающей раздел и возможно эру нового phpBB - phpBB 3.1.x/Ascraeus. phpBB 3.1.x/Ascraeus - это продолжение серии популярных форумов phpBB, новая версия, скачок в будущее.
Тема закрыта
Аватар пользователя Конвертируем мод в расширение phpBB 3.1 / Ascraeus
Статья о том, как сконвертировать модификацию в расширение phpBB 3.1 / Ascraeus

DeaDRoMeO

0

176

Аватар пользователя

04 мар 2017, 08:55

DeaDRoMeO

Аватар пользователя Требования к хостингу phpBB 3.1 / Ascraeus
Минимальные системные требования для установки phpBB 3.1 / Ascraeus

DeaDRoMeO

0

107

Аватар пользователя

28 фев 2017, 18:44

DeaDRoMeO

Аватар пользователя Что такое расширение в phpBB 3.1 / Ascraeus ?
Разбираемся в понятии и струтуре расширений в phpBB 3.1 / Ascraeus

DeaDRoMeO

0

127

Аватар пользователя

01 мар 2017, 13:56

DeaDRoMeO

Оставить свой комментарий

Поделиться темой с помощью

Ссылки на тему

Прямая ссылка:
BB-код для форумов, сайтов, блогов:
HTML ссылка:
 


cron

Самая неформальная поддержка phpBB :P