mikopbx/ModuleJapaneseLanguagePack

App/Controllers/ModuleJapaneseLanguagePackController.php
130 строк5 KB
Nikolai Beketov
feat(ui): add sound files browser with conversion progress
04 май 2026, 13:05
04 май 2026, 13:057b9749d
<?php

declare(strict_types=1);

/*
 * MikoPBX - free phone system for small business
 * Copyright © 2017-2026 Alexey Portnov and Nikolay Beketov
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along with this program.
 * If not, see <https://www.gnu.org/licenses/>.
 */

namespace Modules\ModuleJapaneseLanguagePack\App\Controllers;

use MikoPBX\AdminCabinet\Controllers\BaseController;
use MikoPBX\Modules\PbxExtensionUtils;

/**
 * ModuleJapaneseLanguagePackController
 *
 * Controller for Japanese Language Pack module information page
 */
class ModuleJapaneseLanguagePackController extends BaseController
{
    private string $moduleUniqueID = 'ModuleJapaneseLanguagePack';
    private string $moduleDir;

    /**
     * Basic initialization
     */
    public function initialize(): void
    {
        $this->moduleDir = PbxExtensionUtils::getModuleDir($this->moduleUniqueID);
        parent::initialize();
    }

    /**
     * Renders the information page for the module
     *
     * This page displays information about the Language Pack:
     * - What it does
     * - What files it provides
     * - How to use it
     *
     * @return void
     */
    public function indexAction(): void
    {
        // Get module info
        $this->view->moduleUniqueID = $this->moduleUniqueID;
        $this->view->moduleDir = $this->moduleDir;

        // Count sound files
        $soundsDir = $this->moduleDir . '/Sounds/ja-jp';
        $soundFileCount = 0;
        if (is_dir($soundsDir)) {
            $files = new \RecursiveIteratorIterator(
                new \RecursiveDirectoryIterator($soundsDir, \RecursiveDirectoryIterator::SKIP_DOTS)
            );
            foreach ($files as $file) {
                if ($file->isFile()) {
                    $soundFileCount++;
                }
            }
        }
        $this->view->soundFileCount = $soundFileCount;

        // Count translation files and strings
        $messagesDir = $this->moduleDir . '/Messages/ja';
        $translationFileCount = 0;
        $translationStringCount = 0;
        if (is_dir($messagesDir)) {
            $files = scandir($messagesDir);
            foreach ($files as $file) {
                if (is_file($messagesDir . '/' . $file) && pathinfo($file, PATHINFO_EXTENSION) === 'php') {
                    $translationFileCount++;
                    // Count translation strings in file
                    $translations = include $messagesDir . '/' . $file;
                    if (is_array($translations)) {
                        $translationStringCount += count($translations);
                    }
                }
            }
        }
        $this->view->translationFileCount = $translationFileCount;
        $this->view->translationStringCount = $translationStringCount;

        // Set view path (Modules/ModuleJapaneseLanguagePack/ModuleJapaneseLanguagePack/index)
        // Conversion-progress widget on the overview page so the user sees
        // it before navigating to General Settings to switch language.
        $footer = $this->assets->collection('footerJS');
        $footer->addJs("js/cache/{$this->moduleUniqueID}/module-japanese-language-pack-sounds-api.js", true);
        $footer->addJs("js/cache/{$this->moduleUniqueID}/module-japanese-language-pack-progress.js", true);

        $this->view->pick('Modules/' . $this->moduleUniqueID . '/' . $this->moduleUniqueID . '/index');
    }

    /**
     * Renders the sound files browser page (DataTable + conversion progress).
     */
    public function soundsAction(): void
    {
        $this->view->moduleUniqueID = $this->moduleUniqueID;

        $footer = $this->assets->collection('footerJS');
        $footer->addJs('js/vendor/datatable/dataTables.semanticui.js', true);
        $footer->addJs('js/vendor/range/range.min.js', true);
        $footer->addJs('js/pbx/main/pbx-data-table-index.js', true);
        $footer->addJs('js/pbx/SoundFiles/sound-files-index-player.js', true);
        $footer->addJs("js/cache/{$this->moduleUniqueID}/module-japanese-language-pack-sounds-api.js", true);
        $footer->addJs("js/cache/{$this->moduleUniqueID}/module-japanese-language-pack-sounds-index.js", true);

        $headerCss = $this->assets->collection('headerCSS');
        $headerCss->addCss('css/vendor/datatable/dataTables.semanticui.min.css', true);
        $headerCss->addCss('css/vendor/range/range.css', true);

        $this->view->pick('Modules/' . $this->moduleUniqueID . '/' . $this->moduleUniqueID . '/sounds');
    }

}