Рано чи пізно адміністратор форуму стикається з проблемами, для вирішення яких стандартної функціональності phpBB 3 вже не вистачає.
Один зі способів отримати бажану функціональність - це написати модуль самому.
У цьому уроці ми з Вами розглянемо процес створення простого модуля для phpBB 3, виводить на екран рядок «HelloWorld».
Ми не будемо використовувати мовні файли для простоти викладу. Однак якщо Ви збираєтеся робити якісний модуль, то Вам в обов'язковому порядку треба буде виносити всі Ваші мовні вирази в окремий файл. А також, при необхідності, використовувати шаблони.
Справа в тому, що підприємницькі кола phpBB 3 інтернаціонально, і це зроблено спеціально для того, щоб модуль написаний в одній країні міг легко використовуватися в інших країнах. Для цього буде достатньо просто перевести мовні файли.
Наведений нижче код зберігайте в UTF-8!
// Ця функція викликається при установці модуля в
// адміністраторській панелі.
// У цьому місці Ваш модуль може створювати необхідні
// йому файли, таблиці в базі даних та інші дії.
function install ()
>
// Ця функція викликається при деактивації Вашого модуля
// в адміністративній панелі.
// Подбайте, будь ласка, щоб Ваш модуль не залишав
// після себе ніякого сміття в системі.
function uninstall ()
>
>
крок другий
-
Створимо другий файл ucp_hello.php, розташований в Директорії includes / ucp /, що містить безпосередньо сам код модуля:
class ucp_hello
// Функція, що викликається ядром phpBB 3
function main ($ id. $ mode)
global $ template;
// Параметр $ mode - це ім'я підрозділу,
// який запитує користувач.
switch ($ mode)
// У нас є тільки один підрозділ: main.
case 'main':
// Встановлюємо заголовок сторінки
page_header ( 'HelloWorld!');
// Вказуємо, які файли шаблонів потрібно підключати.
$ Template -> set_filenames (array (
'Body' => 'helloworld.html',
));
// Слід зауважити, що ось так використовувати мовні
// конструкції англійською, російською і т.д. прямо в
// коді модуля можна тільки індусам.
// Я Вам показав такий код лише для простоти розуміння.
// В робочому модулі на цьому місці зазвичай виконуються
// будь-які дії, і потім результати роботи модуля
// передаються в шаблон, який вже і займається виведенням
// інформації користувачеві, підключаючи необхідні
// мовні файли.
-
Тепер залишилося створити файл шаблону, що містить нашу рядок «HelloWorld». Для цього потрібно перейти в директорію, де розташовані шаблони Вашої поточної теми оформлення.
Наприклад, для теми оформлення prosilver потрібно перейти в директорію styles / prosilver / template /. Створіть у цій директорії файл helloworld.html наступного змісту:
The HelloWorld page
HelloWorld!
Тепер потрібно додати наш модуль. Для цього введіть його назву. Наприклад, «Привіт, світ!»:
Після цього необхідно лише відредагувати параметри модуля наступним чином: