614 lines
19 KiB
PHP
614 lines
19 KiB
PHP
<?php
|
|
|
|
use Kirby\Cms\App;
|
|
use Kirby\Cms\Blocks;
|
|
use Kirby\Cms\Field;
|
|
use Kirby\Cms\Files;
|
|
use Kirby\Cms\Html;
|
|
use Kirby\Cms\Layouts;
|
|
use Kirby\Cms\Structure;
|
|
use Kirby\Cms\Url;
|
|
use Kirby\Data\Data;
|
|
use Kirby\Exception\Exception;
|
|
use Kirby\Exception\InvalidArgumentException;
|
|
use Kirby\Toolkit\Str;
|
|
use Kirby\Toolkit\V;
|
|
use Kirby\Toolkit\Xml;
|
|
|
|
/**
|
|
* Field method setup
|
|
*/
|
|
return function (App $app) {
|
|
return [
|
|
|
|
// states
|
|
|
|
/**
|
|
* Converts the field value into a proper boolean and inverts it
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return bool
|
|
*/
|
|
'isFalse' => function (Field $field): bool {
|
|
return $field->toBool() === false;
|
|
},
|
|
|
|
/**
|
|
* Converts the field value into a proper boolean
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return bool
|
|
*/
|
|
'isTrue' => function (Field $field): bool {
|
|
return $field->toBool() === true;
|
|
},
|
|
|
|
/**
|
|
* Validates the field content with the given validator and parameters
|
|
*
|
|
* @param string $validator
|
|
* @param mixed ...$arguments A list of optional validator arguments
|
|
* @return bool
|
|
*/
|
|
'isValid' => function (Field $field, string $validator, ...$arguments): bool {
|
|
return V::$validator($field->value, ...$arguments);
|
|
},
|
|
|
|
// converters
|
|
/**
|
|
* Converts a yaml or json field to a Blocks object
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Blocks
|
|
*/
|
|
'toBlocks' => function (Field $field) {
|
|
try {
|
|
$blocks = Blocks::factory(Blocks::parse($field->value()), [
|
|
'parent' => $field->parent(),
|
|
]);
|
|
|
|
return $blocks->filter('isHidden', false);
|
|
} catch (Throwable $e) {
|
|
if ($field->parent() === null) {
|
|
$message = 'Invalid blocks data for "' . $field->key() . '" field';
|
|
} else {
|
|
$message = 'Invalid blocks data for "' . $field->key() . '" field on parent "' . $field->parent()->title() . '"';
|
|
}
|
|
|
|
throw new InvalidArgumentException($message);
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Converts the field value into a proper boolean
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param bool $default Default value if the field is empty
|
|
* @return bool
|
|
*/
|
|
'toBool' => function (Field $field, $default = false): bool {
|
|
$value = $field->isEmpty() ? $default : $field->value;
|
|
return filter_var($value, FILTER_VALIDATE_BOOLEAN);
|
|
},
|
|
|
|
/**
|
|
* Parses the field value with the given method
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param string $method [',', 'yaml', 'json']
|
|
* @return array
|
|
*/
|
|
'toData' => function (Field $field, string $method = ',') {
|
|
switch ($method) {
|
|
case 'yaml':
|
|
case 'json':
|
|
return Data::decode($field->value, $method);
|
|
default:
|
|
return $field->split($method);
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Converts the field value to a timestamp or a formatted date
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param string|null $format PHP date formatting string
|
|
* @param string|null $fallback Fallback string for `strtotime` (since 3.2)
|
|
* @return string|int
|
|
*/
|
|
'toDate' => function (Field $field, string $format = null, string $fallback = null) use ($app) {
|
|
if (empty($field->value) === true && $fallback === null) {
|
|
return null;
|
|
}
|
|
|
|
if (empty($field->value) === false) {
|
|
$time = $field->toTimestamp();
|
|
} else {
|
|
$time = strtotime($fallback);
|
|
}
|
|
|
|
$handler = $app->option('date.handler', 'date');
|
|
return Str::date($time, $format, $handler);
|
|
},
|
|
|
|
/**
|
|
* Returns a file object from a filename in the field
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\File|null
|
|
*/
|
|
'toFile' => function (Field $field) {
|
|
return $field->toFiles()->first();
|
|
},
|
|
|
|
/**
|
|
* Returns a file collection from a yaml list of filenames in the field
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param string $separator
|
|
* @return \Kirby\Cms\Files
|
|
*/
|
|
'toFiles' => function (Field $field, string $separator = 'yaml') {
|
|
$parent = $field->parent();
|
|
$files = new Files([]);
|
|
|
|
foreach ($field->toData($separator) as $id) {
|
|
if ($file = $parent->kirby()->file($id, $parent)) {
|
|
$files->add($file);
|
|
}
|
|
}
|
|
|
|
return $files;
|
|
},
|
|
|
|
/**
|
|
* Converts the field value into a proper float
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param float $default Default value if the field is empty
|
|
* @return float
|
|
*/
|
|
'toFloat' => function (Field $field, float $default = 0) {
|
|
$value = $field->isEmpty() ? $default : $field->value;
|
|
return (float)$value;
|
|
},
|
|
|
|
/**
|
|
* Converts the field value into a proper integer
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param int $default Default value if the field is empty
|
|
* @return int
|
|
*/
|
|
'toInt' => function (Field $field, int $default = 0) {
|
|
$value = $field->isEmpty() ? $default : $field->value;
|
|
return (int)$value;
|
|
},
|
|
|
|
/**
|
|
* Parse layouts and turn them into
|
|
* Layout objects
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Layouts
|
|
*/
|
|
'toLayouts' => function (Field $field) {
|
|
return Layouts::factory(Layouts::parse($field->value()), [
|
|
'parent' => $field->parent()
|
|
]);
|
|
},
|
|
|
|
/**
|
|
* Wraps a link tag around the field value. The field value is used as the link text
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param mixed $attr1 Can be an optional Url. If no Url is set, the Url of the Page, File or Site will be used. Can also be an array of link attributes
|
|
* @param mixed $attr2 If `$attr1` is used to set the Url, you can use `$attr2` to pass an array of additional attributes.
|
|
* @return string
|
|
*/
|
|
'toLink' => function (Field $field, $attr1 = null, $attr2 = null) {
|
|
if (is_string($attr1) === true) {
|
|
$href = $attr1;
|
|
$attr = $attr2;
|
|
} else {
|
|
$href = $field->parent()->url();
|
|
$attr = $attr1;
|
|
}
|
|
|
|
if ($field->parent()->isActive()) {
|
|
$attr['aria-current'] = 'page';
|
|
}
|
|
|
|
return Html::a($href, $field->value, $attr ?? []);
|
|
},
|
|
|
|
/**
|
|
* Returns a page object from a page id in the field
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Page|null
|
|
*/
|
|
'toPage' => function (Field $field) {
|
|
return $field->toPages()->first();
|
|
},
|
|
|
|
/**
|
|
* Returns a pages collection from a yaml list of page ids in the field
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param string $separator Can be any other separator to split the field value by
|
|
* @return \Kirby\Cms\Pages
|
|
*/
|
|
'toPages' => function (Field $field, string $separator = 'yaml') use ($app) {
|
|
return $app->site()->find(false, false, ...$field->toData($separator));
|
|
},
|
|
|
|
/**
|
|
* Converts a yaml field to a Structure object
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Structure
|
|
*/
|
|
'toStructure' => function (Field $field) {
|
|
try {
|
|
return new Structure(Data::decode($field->value, 'yaml'), $field->parent());
|
|
} catch (Exception $e) {
|
|
if ($field->parent() === null) {
|
|
$message = 'Invalid structure data for "' . $field->key() . '" field';
|
|
} else {
|
|
$message = 'Invalid structure data for "' . $field->key() . '" field on parent "' . $field->parent()->title() . '"';
|
|
}
|
|
|
|
throw new InvalidArgumentException($message);
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Converts the field value to a Unix timestamp
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return int
|
|
*/
|
|
'toTimestamp' => function (Field $field): int {
|
|
return strtotime($field->value);
|
|
},
|
|
|
|
/**
|
|
* Turns the field value into an absolute Url
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return string
|
|
*/
|
|
'toUrl' => function (Field $field): string {
|
|
return Url::to($field->value);
|
|
},
|
|
|
|
/**
|
|
* Converts a user email address to a user object
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\User|null
|
|
*/
|
|
'toUser' => function (Field $field) {
|
|
return $field->toUsers()->first();
|
|
},
|
|
|
|
/**
|
|
* Returns a users collection from a yaml list of user email addresses in the field
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param string $separator
|
|
* @return \Kirby\Cms\Users
|
|
*/
|
|
'toUsers' => function (Field $field, string $separator = 'yaml') use ($app) {
|
|
return $app->users()->find(false, false, ...$field->toData($separator));
|
|
},
|
|
|
|
// inspectors
|
|
|
|
/**
|
|
* Returns the length of the field content
|
|
*/
|
|
'length' => function (Field $field) {
|
|
return Str::length($field->value);
|
|
},
|
|
|
|
/**
|
|
* Returns the number of words in the text
|
|
*/
|
|
'words' => function (Field $field) {
|
|
return str_word_count(strip_tags($field->value));
|
|
},
|
|
|
|
// manipulators
|
|
|
|
/**
|
|
* Applies the callback function to the field
|
|
* @since 3.4.0
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param Closure $callback
|
|
*/
|
|
'callback' => function (Field $field, Closure $callback) {
|
|
return $callback($field);
|
|
},
|
|
|
|
/**
|
|
* Escapes the field value to be safely used in HTML
|
|
* templates without the risk of XSS attacks
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param string $context Location of output (`html`, `attr`, `js`, `css`, `url` or `xml`)
|
|
*/
|
|
'escape' => function (Field $field, string $context = 'html') {
|
|
$field->value = esc($field->value, $context);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Creates an excerpt of the field value without html
|
|
* or any other formatting.
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param int $cahrs
|
|
* @param bool $strip
|
|
* @param string $rep
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'excerpt' => function (Field $field, int $chars = 0, bool $strip = true, string $rep = ' …') {
|
|
$field->value = Str::excerpt($field->kirbytext()->value(), $chars, $strip, $rep);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Converts the field content to valid HTML
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'html' => function (Field $field) {
|
|
$field->value = Html::encode($field->value);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Strips all block-level HTML elements from the field value,
|
|
* it can be safely placed inside of other inline elements
|
|
* without the risk of breaking the HTML structure.
|
|
* @since 3.3.0
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'inline' => function (Field $field) {
|
|
// List of valid inline elements taken from: https://developer.mozilla.org/de/docs/Web/HTML/Inline_elemente
|
|
// Obsolete elements, script tags, image maps and form elements have
|
|
// been excluded for safety reasons and as they are most likely not
|
|
// needed in most cases.
|
|
$field->value = strip_tags($field->value, Html::$inlineList);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Converts the field content from Markdown/Kirbytext to valid HTML
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param array $options
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'kirbytext' => function (Field $field, array $options = []) use ($app) {
|
|
$field->value = $app->kirbytext($field->value, A::merge($options, [
|
|
'parent' => $field->parent(),
|
|
'field' => $field
|
|
]));
|
|
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Converts the field content from inline Markdown/Kirbytext
|
|
* to valid HTML
|
|
* @since 3.1.0
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param array $options
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'kirbytextinline' => function (Field $field, array $options = []) use ($app) {
|
|
$field->value = $app->kirbytext($field->value, A::merge($options, [
|
|
'parent' => $field->parent(),
|
|
'field' => $field,
|
|
'markdown' => [
|
|
'inline' => true
|
|
]
|
|
]));
|
|
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Parses all KirbyTags without also parsing Markdown
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'kirbytags' => function (Field $field) use ($app) {
|
|
$field->value = $app->kirbytags($field->value, [
|
|
'parent' => $field->parent(),
|
|
'field' => $field
|
|
]);
|
|
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Converts the field content to lowercase
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'lower' => function (Field $field) {
|
|
$field->value = Str::lower($field->value);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Converts markdown to valid HTML
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param array $options
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'markdown' => function (Field $field, array $options = []) use ($app) {
|
|
$field->value = $app->markdown($field->value, $options);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Converts all line breaks in the field content to `<br>` tags.
|
|
* @since 3.3.0
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'nl2br' => function (Field $field) {
|
|
$field->value = nl2br($field->value, false);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Uses the field value as Kirby query
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param string|null $expect
|
|
* @return mixed
|
|
*/
|
|
'query' => function (Field $field, string $expect = null) use ($app) {
|
|
if ($parent = $field->parent()) {
|
|
return $parent->query($field->value, $expect);
|
|
}
|
|
|
|
return Str::query($field->value, [
|
|
'kirby' => $app,
|
|
'site' => $app->site(),
|
|
'page' => $app->page()
|
|
]);
|
|
},
|
|
|
|
/**
|
|
* It parses any queries found in the field value.
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param array $data
|
|
* @param string $fallback Fallback for tokens in the template that cannot be replaced
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'replace' => function (Field $field, array $data = [], string $fallback = '') use ($app) {
|
|
if ($parent = $field->parent()) {
|
|
// never pass `null` as the $template to avoid the fallback to the model ID
|
|
$field->value = $parent->toString($field->value ?? '', $data, $fallback);
|
|
} else {
|
|
$field->value = Str::template($field->value, array_replace([
|
|
'kirby' => $app,
|
|
'site' => $app->site(),
|
|
'page' => $app->page()
|
|
], $data), ['fallback' => $fallback]);
|
|
}
|
|
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Cuts the string after the given length and
|
|
* adds "…" if it is longer
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @param int $length The number of characters in the string
|
|
* @param string $appendix An optional replacement for the missing rest
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'short' => function (Field $field, int $length, string $appendix = '…') {
|
|
$field->value = Str::short($field->value, $length, $appendix);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Converts the field content to a slug
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'slug' => function (Field $field) {
|
|
$field->value = Str::slug($field->value);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Applies SmartyPants to the field
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'smartypants' => function (Field $field) use ($app) {
|
|
$field->value = $app->smartypants($field->value);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Splits the field content into an array
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return array
|
|
*/
|
|
'split' => function (Field $field, $separator = ',') {
|
|
return Str::split((string)$field->value, $separator);
|
|
},
|
|
|
|
/**
|
|
* Converts the field content to uppercase
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'upper' => function (Field $field) {
|
|
$field->value = Str::upper($field->value);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Avoids typographical widows in strings by replacing
|
|
* the last space with ` `
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'widont' => function (Field $field) {
|
|
$field->value = Str::widont($field->value);
|
|
return $field;
|
|
},
|
|
|
|
/**
|
|
* Converts the field content to valid XML
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return \Kirby\Cms\Field
|
|
*/
|
|
'xml' => function (Field $field) {
|
|
$field->value = Xml::encode($field->value);
|
|
return $field;
|
|
},
|
|
|
|
// aliases
|
|
|
|
/**
|
|
* Parses yaml in the field content and returns an array
|
|
*
|
|
* @param \Kirby\Cms\Field $field
|
|
* @return array
|
|
*/
|
|
'yaml' => function (Field $field): array {
|
|
return $field->toData('yaml');
|
|
},
|
|
|
|
];
|
|
};
|