128 lines
3.2 KiB
PHP
128 lines
3.2 KiB
PHP
<?php
|
|
|
|
namespace Kirby\Cms;
|
|
|
|
use Kirby\Exception\DuplicateException;
|
|
use Kirby\Exception\InvalidArgumentException;
|
|
use Kirby\Exception\LogicException;
|
|
use Kirby\Exception\PermissionException;
|
|
use Kirby\Toolkit\Str;
|
|
|
|
/**
|
|
* Validators for all language actions
|
|
*
|
|
* @package Kirby Cms
|
|
* @author Bastian Allgeier <bastian@getkirby.com>
|
|
* @link https://getkirby.com
|
|
* @copyright Bastian Allgeier
|
|
* @license https://getkirby.com/license
|
|
*/
|
|
class LanguageRules
|
|
{
|
|
/**
|
|
* Validates if the language can be created
|
|
*
|
|
* @throws \Kirby\Exception\DuplicateException If the language already exists
|
|
* @throws \Kirby\Exception\PermissionException If current user has not sufficient permissions
|
|
*/
|
|
public static function create(Language $language): void
|
|
{
|
|
static::validLanguageCode($language);
|
|
static::validLanguageName($language);
|
|
|
|
if ($language->exists() === true) {
|
|
throw new DuplicateException(
|
|
key: 'language.duplicate',
|
|
data: ['code' => $language->code()]
|
|
);
|
|
}
|
|
|
|
if ($language->permissions()->can('create') !== true) {
|
|
throw new PermissionException(
|
|
key: 'language.create.permission'
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Validates if the language can be deleted
|
|
*
|
|
* @throws \Kirby\Exception\LogicException If the language cannot be deleted
|
|
* @throws \Kirby\Exception\PermissionException If current user has not sufficient permissions
|
|
*/
|
|
public static function delete(Language $language): void
|
|
{
|
|
if ($language->permissions()->can('delete') !== true) {
|
|
throw new PermissionException(
|
|
key: 'language.delete.permission'
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Validates if the language can be updated
|
|
*/
|
|
public static function update(
|
|
Language $newLanguage,
|
|
Language|null $oldLanguage = null
|
|
): void {
|
|
static::validLanguageCode($newLanguage);
|
|
static::validLanguageName($newLanguage);
|
|
|
|
$kirby = App::instance();
|
|
|
|
// if language was the default language and got demoted…
|
|
if (
|
|
$oldLanguage?->isDefault() === true &&
|
|
$newLanguage->isDefault() === false &&
|
|
$kirby->defaultLanguage()->code() === $oldLanguage?->code()
|
|
) {
|
|
// ensure another language has already been set as default
|
|
throw new LogicException(
|
|
message: 'Please select another language to be the primary language'
|
|
);
|
|
}
|
|
|
|
if ($newLanguage->permissions()->can('update') !== true) {
|
|
throw new PermissionException(
|
|
key: 'language.update.permission'
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Validates if the language code is formatted correctly
|
|
*
|
|
* @throws \Kirby\Exception\InvalidArgumentException If the language code is not valid
|
|
*/
|
|
public static function validLanguageCode(Language $language): void
|
|
{
|
|
if (Str::length($language->code()) < 2) {
|
|
throw new InvalidArgumentException(
|
|
key: 'language.code',
|
|
data: [
|
|
'code' => $language->code(),
|
|
'name' => $language->name()
|
|
]
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Validates if the language name is formatted correctly
|
|
*
|
|
* @throws \Kirby\Exception\InvalidArgumentException If the language name is invalid
|
|
*/
|
|
public static function validLanguageName(Language $language): void
|
|
{
|
|
if (Str::length($language->name()) < 1) {
|
|
throw new InvalidArgumentException(
|
|
key: 'language.name',
|
|
data: [
|
|
'code' => $language->code(),
|
|
'name' => $language->name()
|
|
]
|
|
);
|
|
}
|
|
}
|
|
}
|