Download the PHP package hananils/kirby-choices without Composer
On this page you can find all versions of the php package hananils/kirby-choices. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hananils/kirby-choices
More information about hananils/kirby-choices
Files in hananils/kirby-choices
Package kirby-choices
Short Description Choices is a plugin for Kirby 3 that provides methods to manage field options in the frontend.
License MIT
Informations about the package kirby-choices
Choices is a plugin for Kirby 3 that provides methods to manage field options
in the frontend. For any field – like select, multiselect or checkboxlist – that offers options
settings in the blueprint, this plugin will load and return the readable text values for the keys stored in the content file. It works with static options directly set in the blueprint as well as dynamic ones loaded via query
or api
settings.
Example
Field
Content
Template
Installation
Download
Download and copy this repository to /site/plugins/choices
.
Git submodule
Composer
Field methods
toChoices()
Converts the field value to a Choices collection featuring the text values of the selected options:
If the method is passed an optional value of true
, it will return text values for all options specified in the blueprint:
Choices collection
The Choices collection can be used to loop over all given options and return their values. It offers all methods known to the default Kirby collection like first()
, last()
, shuffle()
, sort()
and the like. Additionally, it provides three methods to simplify content output:
join($separator)
The join method concatenates all field value by a given separator.
$separator
: optional separator, uses,
as default.
If you want to have more control on how to join values – e. g. to have the last item joined by and
– have a look at the List methods plugin.
missing($required)
The missing method compare the current field values with an array of required values and return the missing ones.
$required
: array of required values to be checked.
average($decimals)
The average method will calculate the average of all selected value, useful when handling numeric values.
$decimals
: the number of decimals to return.
License
This plugin is provided freely under the hana+nils · Büro für Gestaltung.
We create visual designs for digital and analog media.