<?php

namespace plugins\help;

use Module;
use Plugin_Help_p042aa7;
use bff\db\Publicator;
use bff\traits\Macroable;

/**
 * @property HelpModel $model
 * @property Plugin_Help_p042aa7 $extension
 * @mixin Plugin_Help_p042aa7
 */
abstract class HelpBase_ extends Module implements Consts
{
    use Macroable;

    protected $securityKey = '4457c6146acb85560448b6bd3ddc47fb';

    public function init()
    {
        parent::init();

        $this->module_title = $this->lang('Help');
    }

    /**
     * Системные настройки модуля
     * @param array $options @ref
     * @return string
     */
    public function settingsSystem(array &$options = []): string
    {
        return $this->template('admin/settings.sys', ['options' => &$options]);
    }

    /**
     * Формирование URL
     * @param string $key ключ
     * @param array $params доп. параметры
     * @param bool $dynamic динамическая ссылка
     * @return string
     */
    public function url(string $key, array $params = [], $dynamic = false): string
    {
        return $this->router->url('help-' . $key, $params, ['dynamic' => $dynamic, 'module' => 'help']);
    }

    /**
     * Инициализируем компонент Publicator
     * @return Publicator
     */
    public function initPublicator()
    {
        $settings = [
            'title'           => false,
            'langs'           => $this->locale->getLanguages(),
            'images_path'     => $this->app->path('help', 'images'),
            'images_path_tmp' => $this->app->path('tmp', 'images'),
            'images_url'      => $this->app->url('help', 'images'),
            'images_url_tmp'  => $this->app->url('tmp', 'images'),
            # photo
            'photo_sz_view'   => ['width' => 800],
            # gallery
            'gallery_sz_view' => [
                'width'    => 800,
                'height'   => false,
                'vertical' => ['width' => false, 'height' => 400],
                'quality'  => 95,
                'sharp'    => [], // no sharp
            ],
        ];

        return $this->attachComponent('publicator', new Publicator($this->module_name, $settings));
    }

    /**
     * Формирование списка директорий/файлов требующих проверки на наличие прав записи
     * @return array
     */
    public function writableCheck()
    {
        return array_merge(parent::writableCheck(), [
            $this->app->path('help', 'images') => 'dir', # изображения
            $this->app->path('tmp', 'images')  => 'dir', # tmp
        ]);
    }
}