Config::getTheme() - Code Metrics - Inspection of "Update Render.php" - Cecilapp/Cecil - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — extensions ( c4b8a6...6ceec0 )

by Arnaud

created 2023-04-19 10:22 UTC

Config::getTheme() A

↳ Parent: Config

Complexity

Conditions	3
Paths	3

Size

Total Lines	11
Code Lines	5

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	5
CRAP Score	3.0416

Importance

Changes

Metric	Value
cc	3
eloc	5
c	0
b	0
f	0
nc	3
nop	0
dl	0
loc	11
ccs	5
cts	6
cp	0.8333
crap	3.0416
rs	10

<?php

declare(strict_types=1);

/*
 * This file is part of Cecil.
 *
 * Copyright (c) Arnaud Ligny <[email protected]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Cecil;

use Cecil\Exception\RuntimeException;
use Cecil\Util\Plateform;
use Dflydev\DotAccessData\Data;

/**
 * Class Config.
 */
class Config
{
    /** @var Data Configuration is a Data object. */
    protected $data;

    /** @var array Configuration. */
    protected $siteConfig;

    /** @var string Source directory. */
    protected $sourceDir;

    /** @var string Destination directory. */
    protected $destinationDir;

    /** @var array Languages. */
    protected $languages = null;

    public const LANG_CODE_PATTERN = '([a-z]{2}(-[A-Z]{2})?)'; // "fr" or "fr-FR"
    public const LANG_LOCALE_PATTERN = '[a-z]{2}(_[A-Z]{2})?(_[A-Z]{2})?'; // "fr" or "fr_FR" or "no_NO_NY"

    /**
     * Build the Config object with the default config + the optional given array.
     */
    public function __construct(?array $config = null)
    {
        // load default configuration
        $defaultConfig = realpath(Util::joinFile(__DIR__, '..', 'config/default.php'));
        if (Plateform::isPhar()) {
            $defaultConfig = Util::joinPath(Plateform::getPharPath(), 'config/default.php');
        }
        $this->data = new Data(include $defaultConfig);

        // import site config
        $this->siteConfig = $config;
        $this->importSiteConfig();
    }

    /**
     * Imports site configuration.
     */
    private function importSiteConfig(): void
    {
        $this->data->import($this->siteConfig);

        /**
         * Overrides configuration with environment variables.
         */
        $data = $this->getData();
        $applyEnv = function ($array) use ($data) {
            $iterator = new \RecursiveIteratorIterator(
                new \RecursiveArrayIterator($array),
                \RecursiveIteratorIterator::SELF_FIRST
            );
            $iterator->rewind();
            while ($iterator->valid()) {
                $path = [];
                foreach (range(0, $iterator->getDepth()) as $depth) {
                    $path[] = $iterator->getSubIterator($depth)->key();
                }
                $sPath = implode('_', $path);
                if ($getEnv = getenv('CECIL_' . strtoupper($sPath))) {
                    $data->set(str_replace('_', '.', strtolower($sPath)), $this->castSetValue($getEnv));
                }
                $iterator->next();
            }
        };
        $applyEnv($data->export());
    }

    /**
     * Casts boolean value given to set() as string.
     *
     * @param mixed $value
     *
     * @return bool|mixed
     */
    private function castSetValue($value)
    {
        if (is_string($value)) {
            switch ($value) {
                case 'true':
                    return true;
                case 'false':
                    return false;
                default:
                    return $value;
            }
        }

        return $value;
    }

    /**
     * Imports (theme) configuration.
     */
    public function import(array $config): void
    {
        $this->data->import($config);

        // re-import site config
        $this->importSiteConfig();
    }

    /**
     * Set a Data object as configuration.
     */
    protected function setData(Data $data): self
    {
        if ($this->data !== $data) {
            $this->data = $data;
        }

        return $this;
    }

    /**
     * Get configuration as a Data object.
     */
    protected function getData(): Data
    {
        return $this->data;
    }

    /**
     * Get configuration as an array.
     */
    public function getAsArray(): array
    {
        return $this->data->export();
    }

    /**
     * Is configuration's key exists?
     */
    public function has(string $key): bool
    {
        return $this->data->has($key);
    }

    /**
     * Get the value of a configuration's key.
     *
     * @param string $key      Configuration key
     * @param string $language Language code (optionnal)
     * @param bool   $fallback Set to false to not return the value in the default language as fallback
     *
     * @return mixed|null
     */
    public function get(string $key, ?string $language = null, bool $fallback = true)
    {
        if ($language !== null) {
            $langIndex = $this->getLanguageIndex($language);
            $keyLang = "languages.$langIndex.config.$key";
            if ($this->data->has($keyLang)) {
                return $this->data->get($keyLang);
            }
            if ($language !== $this->getLanguageDefault() && $fallback === false) {
                return null;
            }
        }
        if ($this->data->has($key)) {
            return $this->data->get($key);
        }

        return null;
    }

    /**
     * Set the source directory.
     *
     * @throws \InvalidArgumentException
     */
    public function setSourceDir(string $sourceDir = null): self
    {
        if ($sourceDir === null) {
            $sourceDir = getcwd();
        }
        if (!is_dir($sourceDir)) {
            throw new \InvalidArgumentException(\sprintf('The directory "%s" is not a valid source!', $sourceDir));
        }
        $this->sourceDir = $sourceDir;

        return $this;
    }

    /**
     * Get the source directory.
     */
    public function getSourceDir(): string
    {
        return $this->sourceDir;
    }

    /**
     * Set the destination directory.
     *
     * @throws \InvalidArgumentException
     */
    public function setDestinationDir(string $destinationDir = null): self
    {
        if ($destinationDir === null) {
            $destinationDir = $this->sourceDir;
        }
        if (!is_dir($destinationDir)) {
            throw new \InvalidArgumentException(\sprintf(
                'The directory "%s" is not a valid destination!',
                $destinationDir
            ));
        }
        $this->destinationDir = $destinationDir;

        return $this;
    }

    /**
     * Get the destination directory.
     */
    public function getDestinationDir(): string
    {
        return $this->destinationDir;
    }

    /*
     * Path helpers.
     */

    /**
     * Returns the path of the pages directory.
     */
    public function getPagesPath(): string
    {
        $path = Util::joinFile($this->getSourceDir(), (string) $this->get('pages.dir'));

        // legacy support
        if (!is_dir($path)) {
            $path = Util::joinFile($this->getSourceDir(), 'content');
        }

        return $path;
    }

    /**
     * Returns the path of the output directory.
     */
    public function getOutputPath(): string
    {
        return Util::joinFile($this->getDestinationDir(), (string) $this->get('output.dir'));
    }

    /**
     * Returns the path of the data directory.
     */
    public function getDataPath(): string
    {
        return Util::joinFile($this->getSourceDir(), (string) $this->get('data.dir'));
    }

    /**
     * Returns the path of templates directory.
     */
    public function getLayoutsPath(): string
    {
        return Util::joinFile($this->getSourceDir(), (string) $this->get('layouts.dir'));
    }

    /**
     * Returns the path of internal templates directory.
     */
    public function getLayoutsInternalPath(): string
    {
        return Util::joinPath(__DIR__, '..', (string) $this->get('layouts.internal.dir'));
    }

    /**
     * Returns the path of themes directory.
     */
    public function getThemesPath(): string
    {
        return Util::joinFile($this->getSourceDir(), (string) $this->get('layouts.themes.dir'));
    }

    /**
     * Returns the path of translations directory.
     */
    public function getTranslationsPath(): string
    {
        return Util::joinFile($this->getSourceDir(), (string) $this->get('layouts.translations.dir'));
    }

    /**
     * Returns the path of internal translations directory.
     */
    public function getTranslationsInternalPath(): string
    {
        if (Util\Plateform::isPhar()) {
            return Util::joinPath(Plateform::getPharPath(), (string) $this->get('translations.internal.dir'));
        }

        return realpath(Util::joinPath(__DIR__, '..', (string) $this->get('translations.internal.dir')));
    }

    /**
     * Returns the path of static files directory.
     */
    public function getStaticPath(): string
    {
        return Util::joinFile($this->getSourceDir(), (string) $this->get('static.dir'));
    }

    /**
     * Returns the path of static files directory, with a target.
     */
    public function getStaticTargetPath(): string
    {
        $path = $this->getStaticPath();

        if (!empty($this->get('static.target'))) {
            $path = substr($path, 0, -strlen((string) $this->get('static.target')));
        }

        return $path;
    }

    /**
     * Returns the path of assets files directory.
     */
    public function getAssetsPath(): string
    {
        return Util::joinFile($this->getSourceDir(), (string) $this->get('assets.dir'));
    }

    /**
     * Returns cache path.
     *
     * @throws RuntimeException
     */
    public function getCachePath(): string
    {
        if (empty((string) $this->get('cache.dir'))) {
            throw new RuntimeException(\sprintf('The cache directory ("%s") is not defined in configuration.', 'cache.dir'));
        }

        if ($this->isCacheDirIsAbsolute()) {
            $cacheDir = Util::joinFile((string) $this->get('cache.dir'), 'cecil');
            Util\File::getFS()->mkdir($cacheDir);

            return $cacheDir;
        }

        return Util::joinFile($this->getDestinationDir(), (string) $this->get('cache.dir'));
    }

    /**
     * Returns cache path of templates.
     */
    public function getCacheTemplatesPath(): string
    {
        return Util::joinFile($this->getCachePath(), (string) $this->get('cache.templates.dir'));
    }

    /**
     * Returns cache path of translations.
     */
    public function getCacheTranslationsPath(): string
    {
        return Util::joinFile($this->getCachePath(), (string) $this->get('cache.translations.dir'));
    }

    /**
     * Returns cache path of assets.
     */
    public function getCacheAssetsPath(): string
    {
        return Util::joinFile($this->getCachePath(), (string) $this->get('cache.assets.dir'));
    }

    /**
     * Returns cache path of remote assets.
     */
    public function getCacheAssetsRemotePath(): string
    {
        return Util::joinFile($this->getCacheAssetsPath(), (string) $this->get('cache.assets.remote.dir'));
    }

    /*
     * Output helpers.
     */

    /**
     * Returns the property value of an output format.
     *
     * @throws RuntimeException
     *
     * @return string|array|null
     */
    public function getOutputFormatProperty(string $name, string $property)
    {
        $properties = array_column((array) $this->get('output.formats'), $property, 'name');

        if (empty($properties)) {
            throw new RuntimeException(\sprintf('Property "%s" is not defined for format "%s".', $property, $name));
        }

        return $properties[$name] ?? null;
    }

    /*
     * Assets helpers.
     */

    /**
     * Returns asset image widths.
     */
    public function getAssetsImagesWidths(): array
    {
        return count((array) $this->get('assets.images.responsive.widths')) > 0 ? (array) $this->get('assets.images.responsive.widths') : [480, 640, 768, 1024, 1366, 1600, 1920];
    }

    /**
     * Returns asset image sizes.
     */
    public function getAssetsImagesSizes(): array
    {
        return count((array) $this->get('assets.images.responsive.sizes')) > 0 ? (array) $this->get('assets.images.responsive.sizes') : ['default' => '100vw'];
    }

    /*
     * Theme helpers.
     */

    /**
     * Returns theme(s) as an array.
     */
    public function getTheme(): ?array
    {
        if ($themes = $this->get('theme')) {
            if (is_array($themes)) {
                return $themes;
            }

            return [$themes];
        }

        return null;
    }

    /**
     * Has a (valid) theme(s)?
     *
     * @throws RuntimeException
     */
    public function hasTheme(): bool
    {
        if ($themes = $this->getTheme()) {
            foreach ($themes as $theme) {
                if (!Util\File::getFS()->exists($this->getThemeDirPath($theme, 'layouts')) && !Util\File::getFS()->exists(Util::joinFile($this->getThemesPath(), $theme, 'config.yml'))) {
                    throw new RuntimeException(\sprintf('Theme "%s" not found. Did you forgot to install it?', $theme));
                }
            }

            return true;
        }

        return false;
    }

    /**
     * Returns the path of a specific theme's directory.
     * ("layouts" by default).
     */
    public function getThemeDirPath(string $theme, string $dir = 'layouts'): string
    {
        return Util::joinFile($this->getThemesPath(), $theme, $dir);
    }

    /*
     * Language helpers.
     */

    /**
     * Returns an array of available languages.
     *
     * @throws RuntimeException
     */
    public function getLanguages(): array
    {
        if ($this->languages !== null) {
            return $this->languages;
        }

        $languages = (array) $this->get('languages');

        if (!is_int(array_search($this->getLanguageDefault(), array_column($languages, 'code')))) {
            throw new RuntimeException(\sprintf('The default language "%s" is not listed in "languages" key configuration.', $this->getLanguageDefault()));
        }

        $languages = array_filter($languages, function ($language) {
            return !(isset($language['enabled']) && $language['enabled'] === false);
        });

        $this->languages = $languages;

        return $this->languages;
    }

    /**
     * Returns the default language code (ie: "en", "fr-FR", etc.).
     *
     * @throws RuntimeException
     */
    public function getLanguageDefault(): string
    {
        if (!$this->get('language')) {
            throw new RuntimeException('There is no default "language" key in configuration.');
        }

        return $this->get('language');
    }

    /**
     * Returns a language code index.
     *
     * @throws RuntimeException
     */
    public function getLanguageIndex(string $code): int
    {
        $array = array_column($this->getLanguages(), 'code');

        if (false === $index = array_search($code, $array)) {
            throw new RuntimeException(\sprintf('The language code "%s" is not defined.', $code));
        }

        return $index;
    }

    /**
     * Returns the property value of a (specified or default) language.
     *
     * @throws RuntimeException
     */
    public function getLanguageProperty(string $property, ?string $code = null): string
    {
        $code = $code ?? $this->getLanguageDefault();

        $properties = array_column($this->getLanguages(), $property, 'code');

        if (empty($properties)) {
            throw new RuntimeException(\sprintf('Property "%s" is not defined for language "%s".', $property, $code));
        }

        return $properties[$code];
    }

    /*
     * Cache helpers.
     */

    /**
     * Is cache dir is absolute to system files
     * or relative to project destination?
     */
    public function isCacheDirIsAbsolute(): bool
    {
        $path = (string) $this->get('cache.dir');
        if (Util::joinFile($path) == realpath(Util::joinFile($path))) {
            return true;
        }

        return false;
    }
}


1		<?php
2
3		declare(strict_types=1);
4
5		/*
6		* This file is part of Cecil.
7		*
8		* Copyright (c) Arnaud Ligny <[email protected]>
9		*
10		* For the full copyright and license information, please view the LICENSE
11		* file that was distributed with this source code.
12		*/
13
14		namespace Cecil;
15
16		use Cecil\Exception\RuntimeException;
17		use Cecil\Util\Plateform;
18		use Dflydev\DotAccessData\Data;
19
20		/**
21		* Class Config.
22		*/
23		class Config
24		{
25		/** @var Data Configuration is a Data object. */
26		protected $data;
27
28		/** @var array Configuration. */
29		protected $siteConfig;
30
31		/** @var string Source directory. */
32		protected $sourceDir;
33
34		/** @var string Destination directory. */
35		protected $destinationDir;
36
37		/** @var array Languages. */
38		protected $languages = null;
39
40		public const LANG_CODE_PATTERN = '([a-z]{2}(-[A-Z]{2})?)'; // "fr" or "fr-FR"
41		public const LANG_LOCALE_PATTERN = '[a-z]{2}(_[A-Z]{2})?(_[A-Z]{2})?'; // "fr" or "fr_FR" or "no_NO_NY"
42
43		/**
44		* Build the Config object with the default config + the optional given array.
45		*/
46	1	public function __construct(?array $config = null)
47		{
48		// load default configuration
49	1	$defaultConfig = realpath(Util::joinFile(__DIR__, '..', 'config/default.php'));
50	1	if (Plateform::isPhar()) {
51		$defaultConfig = Util::joinPath(Plateform::getPharPath(), 'config/default.php');
52		}
53	1	$this->data = new Data(include $defaultConfig);
54
55		// import site config
56	1	$this->siteConfig = $config;
57	1	$this->importSiteConfig();
58		}
59
60		/**
61		* Imports site configuration.
62		*/
63	1	private function importSiteConfig(): void
64		{
65	1	$this->data->import($this->siteConfig);
66
67		/**
68		* Overrides configuration with environment variables.
69		*/
70	1	$data = $this->getData();
71	1	$applyEnv = function ($array) use ($data) {
72	1	$iterator = new \RecursiveIteratorIterator(
73	1	new \RecursiveArrayIterator($array),
74		\RecursiveIteratorIterator::SELF_FIRST
75		);
76	1	$iterator->rewind();
77	1	while ($iterator->valid()) {
78	1	$path = [];
79	1	foreach (range(0, $iterator->getDepth()) as $depth) {
80	1	$path[] = $iterator->getSubIterator($depth)->key();
81		}
82	1	$sPath = implode('_', $path);
83	1	if ($getEnv = getenv('CECIL_' . strtoupper($sPath))) {
84	1	$data->set(str_replace('_', '.', strtolower($sPath)), $this->castSetValue($getEnv));
85		}
86	1	$iterator->next();
87		}
88		};
89	1	$applyEnv($data->export());
90		}
91
92		/**
93		* Casts boolean value given to set() as string.
94		*
95		* @param mixed $value
96		*
97		* @return bool\|mixed
98		*/
99	1	private function castSetValue($value)
100		{
101	1	if (is_string($value)) {
102	1	switch ($value) {
103	1	case 'true':
104	1	return true;
105	1	case 'false':
106		return false;
107		default:
108	1	return $value;
109		}
110		}
111
112		return $value;
113		}
114
115		/**
116		* Imports (theme) configuration.
117		*/
118	1	public function import(array $config): void
119		{
120	1	$this->data->import($config);
121
122		// re-import site config
123	1	$this->importSiteConfig();
124		}
125
126		/**
127		* Set a Data object as configuration.
128		*/
129		protected function setData(Data $data): self
130		{
131		if ($this->data !== $data) {
132		$this->data = $data;
133		}
134
135		return $this;
136		}
137
138		/**
139		* Get configuration as a Data object.
140		*/
141	1	protected function getData(): Data
142		{
143	1	return $this->data;
144		}
145
146		/**
147		* Get configuration as an array.
148		*/
149		public function getAsArray(): array
150		{
151		return $this->data->export();
152		}
153
154		/**
155		* Is configuration's key exists?
156		*/
157	1	public function has(string $key): bool
158		{
159	1	return $this->data->has($key);
160		}
161
162		/**
163		* Get the value of a configuration's key.
164		*
165		* @param string $key Configuration key
166		* @param string $language Language code (optionnal)
167		* @param bool $fallback Set to false to not return the value in the default language as fallback
168		*
169		* @return mixed\|null
170		*/
171	1	public function get(string $key, ?string $language = null, bool $fallback = true)
172		{
173	1	if ($language !== null) {
174	1	$langIndex = $this->getLanguageIndex($language);
175	1	$keyLang = "languages.$langIndex.config.$key";
176	1	if ($this->data->has($keyLang)) {
177	1	return $this->data->get($keyLang);
178		}
179	1	if ($language !== $this->getLanguageDefault() && $fallback === false) {
180		return null;
181		}
182		}
183		if ($this->data->has($key)) {
184	1	return $this->data->get($key);
185	1	}
186
187		return null;
188		}
189
190		/**
191		* Set the source directory.
192		*
193		* @throws \InvalidArgumentException
194		*/
195		public function setSourceDir(string $sourceDir = null): self
196	1	{
197		if ($sourceDir === null) {
198	1	$sourceDir = getcwd();
199	1	}
200		if (!is_dir($sourceDir)) {
201	1	throw new \InvalidArgumentException(\sprintf('The directory "%s" is not a valid source!', $sourceDir));
202		}
203		$this->sourceDir = $sourceDir;
204	1
205		return $this;
206	1	}
207
208		/**
209		* Get the source directory.
210		*/
211		public function getSourceDir(): string
212	1	{
213		return $this->sourceDir;
214	1	}
215
216		/**
217		* Set the destination directory.
218		*
219		* @throws \InvalidArgumentException
220		*/
221		public function setDestinationDir(string $destinationDir = null): self
222	1	{
223		if ($destinationDir === null) {
224	1	$destinationDir = $this->sourceDir;
225	1	}
226		if (!is_dir($destinationDir)) {
227	1	throw new \InvalidArgumentException(\sprintf(
228		'The directory "%s" is not a valid destination!',
229		$destinationDir
230		));
231		}
232		$this->destinationDir = $destinationDir;
233	1
234		return $this;
235	1	}
236
237		/**
238		* Get the destination directory.
239		*/
240		public function getDestinationDir(): string
241	1	{
242		return $this->destinationDir;
243	1	}
244
245		/*
246		* Path helpers.
247		*/
248
249		/**
250		* Returns the path of the pages directory.
251		*/
252		public function getPagesPath(): string
253	1	{
254		$path = Util::joinFile($this->getSourceDir(), (string) $this->get('pages.dir'));
255	1
256		// legacy support
257		if (!is_dir($path)) {
258	1	$path = Util::joinFile($this->getSourceDir(), 'content');
259		}
260
261		return $path;
262	1	}
263
264		/**
265		* Returns the path of the output directory.
266		*/
267		public function getOutputPath(): string
268	1	{
269		return Util::joinFile($this->getDestinationDir(), (string) $this->get('output.dir'));
270	1	}
271
272		/**
273		* Returns the path of the data directory.
274		*/
275		public function getDataPath(): string
276	1	{
277		return Util::joinFile($this->getSourceDir(), (string) $this->get('data.dir'));
278	1	}
279
280		/**
281		* Returns the path of templates directory.
282		*/
283		public function getLayoutsPath(): string
284	1	{
285		return Util::joinFile($this->getSourceDir(), (string) $this->get('layouts.dir'));
286	1	}
287
288		/**
289		* Returns the path of internal templates directory.
290		*/
291		public function getLayoutsInternalPath(): string
292	1	{
293		return Util::joinPath(__DIR__, '..', (string) $this->get('layouts.internal.dir'));
294	1	}
295
296		/**
297		* Returns the path of themes directory.
298		*/
299		public function getThemesPath(): string
300	1	{
301		return Util::joinFile($this->getSourceDir(), (string) $this->get('layouts.themes.dir'));
302	1	}
303
304		/**
305		* Returns the path of translations directory.
306		*/
307		public function getTranslationsPath(): string
308	1	{
309		return Util::joinFile($this->getSourceDir(), (string) $this->get('layouts.translations.dir'));
310	1	}
311
312		/**
313		* Returns the path of internal translations directory.
314	1	*/
315		public function getTranslationsInternalPath(): string
316		{
317		if (Util\Plateform::isPhar()) {
318		return Util::joinPath(Plateform::getPharPath(), (string) $this->get('translations.internal.dir'));
319		}
320	1
321		return realpath(Util::joinPath(__DIR__, '..', (string) $this->get('translations.internal.dir')));
322	1	}
323
324		/**
325		* Returns the path of static files directory.
326		*/
327		public function getStaticPath(): string
328	1	{
329		return Util::joinFile($this->getSourceDir(), (string) $this->get('static.dir'));
330	1	}
331
332		/**
333		* Returns the path of static files directory, with a target.
334		*/
335		public function getStaticTargetPath(): string
336	1	{
337		$path = $this->getStaticPath();
338	1
339		if (!empty($this->get('static.target'))) {
340	1	$path = substr($path, 0, -strlen((string) $this->get('static.target')));
341		}
342
343		return $path;
344	1	}
345
346		/**
347		* Returns the path of assets files directory.
348		*/
349		public function getAssetsPath(): string
350	1	{
351		return Util::joinFile($this->getSourceDir(), (string) $this->get('assets.dir'));
352	1	}
353
354		/**
355		* Returns cache path.
356		*
357		* @throws RuntimeException
358		*/
359	1	public function getCachePath(): string
360		{
361	1	if (empty((string) $this->get('cache.dir'))) {
362	1	throw new RuntimeException(\sprintf('The cache directory ("%s") is not defined in configuration.', 'cache.dir'));
363		}
364
365		if ($this->isCacheDirIsAbsolute()) {
366	1	$cacheDir = Util::joinFile((string) $this->get('cache.dir'), 'cecil');
367		Util\File::getFS()->mkdir($cacheDir);
368
369		return $cacheDir;
370		}
371
372		return Util::joinFile($this->getDestinationDir(), (string) $this->get('cache.dir'));
373		}
374	1
375		/**
376	1	* Returns cache path of templates.
377		*/
378		public function getCacheTemplatesPath(): string
379		{
380	1	return Util::joinFile($this->getCachePath(), (string) $this->get('cache.templates.dir'));
381		}
382
383		/**
384		* Returns cache path of translations.
385		*/
386		public function getCacheTranslationsPath(): string
387	1	{
388		return Util::joinFile($this->getCachePath(), (string) $this->get('cache.translations.dir'));
389		}
390
391		/**
392		* Returns cache path of assets.
393	1	*/
394		public function getCacheAssetsPath(): string
395	1	{
396		return Util::joinFile($this->getCachePath(), (string) $this->get('cache.assets.dir'));
397		}
398
399		/**
400		* Returns cache path of remote assets.
401	1	*/
402		public function getCacheAssetsRemotePath(): string
403	1	{
404		return Util::joinFile($this->getCacheAssetsPath(), (string) $this->get('cache.assets.remote.dir'));
405		}
406
407		/*
408		* Output helpers.
409	1	*/
410
411	1	/**
412		* Returns the property value of an output format.
413		*
414		* @throws RuntimeException
415		*
416		* @return string\|array\|null
417		*/
418		public function getOutputFormatProperty(string $name, string $property)
419		{
420		$properties = array_column((array) $this->get('output.formats'), $property, 'name');
421	1
422		if (empty($properties)) {
423	1	throw new RuntimeException(\sprintf('Property "%s" is not defined for format "%s".', $property, $name));
424		}
425	1
426		return $properties[$name] ?? null;
427		}
428
429	1	/*
430		* Assets helpers.
431		*/
432
433		/**
434		* Returns asset image widths.
435		*/
436		public function getAssetsImagesWidths(): array
437		{
438		return count((array) $this->get('assets.images.responsive.widths')) > 0 ? (array) $this->get('assets.images.responsive.widths') : [480, 640, 768, 1024, 1366, 1600, 1920];
439	1	}
440
441	1	/**
442	1	* Returns asset image sizes.
443	1	*/
444		public function getAssetsImagesSizes(): array
445		{
446		return count((array) $this->get('assets.images.responsive.sizes')) > 0 ? (array) $this->get('assets.images.responsive.sizes') : ['default' => '100vw'];
447		}
448
449		/*
450		* Theme helpers.
451		*/
452
453		/**
454		* Returns theme(s) as an array.
455		*/
456		public function getTheme(): ?array
457	1	{
458		if ($themes = $this->get('theme')) {
459	1	if (is_array($themes)) {
460	1	return $themes;
461	1	}
462
463		return [$themes];
464		}
465
466	1	return null;
467		}
468
469		/**
470		* Has a (valid) theme(s)?
471		*
472		* @throws RuntimeException
473		*/
474		public function hasTheme(): bool
475		{
476	1	if ($themes = $this->getTheme()) {
477		foreach ($themes as $theme) {
478	1	if (!Util\File::getFS()->exists($this->getThemeDirPath($theme, 'layouts')) && !Util\File::getFS()->exists(Util::joinFile($this->getThemesPath(), $theme, 'config.yml'))) {
479		throw new RuntimeException(\sprintf('Theme "%s" not found. Did you forgot to install it?', $theme));
480		}
481		}
482
483		return true;
484		}
485
486		return false;
487		}
488
489		/**
490	1	* Returns the path of a specific theme's directory.
491		* ("layouts" by default).
492	1	*/
493	1	public function getThemeDirPath(string $theme, string $dir = 'layouts'): string
494		{
495		return Util::joinFile($this->getThemesPath(), $theme, $dir);
496	1	}
497
498	1	/*
499		* Language helpers.
500		*/
501
502	1	/**
503	1	* Returns an array of available languages.
504		*
505		* @throws RuntimeException
506	1	*/
507		public function getLanguages(): array
508	1	{
509		if ($this->languages !== null) {
510		return $this->languages;
511		}
512
513		$languages = (array) $this->get('languages');
514
515		if (!is_int(array_search($this->getLanguageDefault(), array_column($languages, 'code')))) {
516	1	throw new RuntimeException(\sprintf('The default language "%s" is not listed in "languages" key configuration.', $this->getLanguageDefault()));
517		}
518	1
519		$languages = array_filter($languages, function ($language) {
520		return !(isset($language['enabled']) && $language['enabled'] === false);
521		});
522	1
523		$this->languages = $languages;
524
525		return $this->languages;
526		}
527
528		/**
529		* Returns the default language code (ie: "en", "fr-FR", etc.).
530	1	*
531		* @throws RuntimeException
532	1	*/
533		public function getLanguageDefault(): string
534	1	{
535		if (!$this->get('language')) {
536		throw new RuntimeException('There is no default "language" key in configuration.');
537		}
538	1
539		return $this->get('language');
540		}
541
542		/**
543		* Returns a language code index.
544		*
545		* @throws RuntimeException
546	1	*/
547		public function getLanguageIndex(string $code): int
548	1	{
549		$array = array_column($this->getLanguages(), 'code');
550	1
551		if (false === $index = array_search($code, $array)) {
552	1	throw new RuntimeException(\sprintf('The language code "%s" is not defined.', $code));
553		}
554
555		return $index;
556	1	}
557
558		/**
559		* Returns the property value of a (specified or default) language.
560		*
561		* @throws RuntimeException
562		*/
563		public function getLanguageProperty(string $property, ?string $code = null): string
564		{
565		$code = $code ?? $this->getLanguageDefault();
566
567		$properties = array_column($this->getLanguages(), $property, 'code');
568
569		if (empty($properties)) {
570		throw new RuntimeException(\sprintf('Property "%s" is not defined for language "%s".', $property, $code));
571		}
572
573		return $properties[$code];
574		}
575
576		/*
577		* Cache helpers.
578		*/
579
580		/**
581		* Is cache dir is absolute to system files
582		* or relative to project destination?
583		*/
584		public function isCacheDirIsAbsolute(): bool
585		{
586		$path = (string) $this->get('cache.dir');
587		if (Util::joinFile($path) == realpath(Util::joinFile($path))) {
588		return true;
589		}
590
591		return false;
592		}
593		}
594

Cecilapp / Cecil

Push — extensions ( c4b8a6...6ceec0 )

Config::getTheme() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like