Как перевести расширение PunBB на русский язык

В некоторых расширениях английские или же слова на каком либо другом сложном языке вшиты в сам код расширения. В этом случае вначале нам потребуется создать патч на английском, так как это исходный язык форума punbb, ну так уж сложилось   

Итак, в корне какого либо безязычного расширения создаем php файл и следующие папки:

/lang/English/имя_расширения.php

К примеру:

/lang/English/pan_icons.php

/lang/ это директория где будут хранится наши языковые пэкэджи.
/English/ это обязательная директория на английском с файлами.
/pan_icons.php наш языковой файл.
В данном примере в директории содержится один файл, но если расширение довольно объемное, то есть смысл разделить на два файла: один для админки или разных настроек, а второй публичный. Так же в папке может присутствовать файл для перевода слов содержащихся в JS скриптах. На примере это можно увидеть в таком расширении как Pan Uploader.

Открываем файл pan_icons.php и пишем такой код:

<?php 

if (!defined('FORUM')) die();
// Называем массив по принципу: $lang_имя_расширения, то есть его id. Таким образом мы избежим путаницы между расширениями.
$lang_pan_icons = array(

    // добавляем ключ => значение для каждого слова или предложения и закрываем запятой
    'icons_uploading' => 'Loading icon',
    'icons_delete' => 'Delete icon',
    // ...и так далее
);

Сохраняем файл.
Так у нас есть пару ключей и значений. Попробуем теперь вывести Loading icon по ключу icons_uploading.

Чтобы мы смогли получить данные из файла pan_icons.php, нам потребуется его подключить. Вот универсальный способ, практически для любого расширения:

   if (file_exists($ext_info['path'].'/lang/'.$forum_user['language'].'/'.$ext_info['id'].'.php'))
      require $ext_info['path'].'/lang/'.$forum_user['language'].'/'.$ext_info['id'].'.php';
   else
      require $ext_info['path'].'/lang/English/'.$ext_info['id'].'.php';

Буквально этот код говорит о том, что если файл для установленного в профиле языка не существует, то подключить английский, чем мы как раз и занимаемся 

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

Выводим слова и предложения на экран

Теперь, когда мы подключили языковой файл, то можем обращаться к массиву, в нашем случае с именем $lang_pan_icons. Рассмотрим наш случай на примере кнопок: Загрузить иконку  и Удалить иконку.

Таким образом выглядит код со вшитыми словами:

         <div class="frm-buttons">
            <span class="submit primary"><input type="submit" name="load_icon" value="'Loading icon'" /></span>
            <span class="submit primary"><input type="submit" name="delete_icon" value="Delete icon" /></span>
         </div>

Так выглядит код с переведенными словами:

         <div class="frm-buttons">
            <span class="submit primary"><input type="submit" name="load_icon" value="<?php echo $lang_pan_icons['icons_uploading'] ?>" /></span>
            <span class="submit primary"><input type="submit" name="delete_icon" value="<?php echo $lang_pan_icons['icons_delete'] ?>" /></span>
         </div>

Надеюсь, вы заметили разницу 

То есть если мы заменяем слова в HTML коде, то меняем слово Loading icon на:

<?php echo $lang_pan_icons['icons_uploading'] ?>

В итоге, в настройках категорий в самом низу мы увидим следующее:

Точно также производим замену и в коде php, в этом случае открывать и закрывать  интерпретаторы php <?php ....  ?> не нужно.

Если есть вопросы, пишите ниже