Download the PHP package daandelange/clavisverbum without Composer
On this page you can find all versions of the php package daandelange/clavisverbum. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download daandelange/clavisverbum
More information about daandelange/clavisverbum
Files in daandelange/clavisverbum
Package clavisverbum
Short Description A multilanguage taxonomy field for Kirby.
License MIT
Homepage https://github.com/Daandelange/kirby-clavisverbum
Informations about the package clavisverbum
Clavis Verbum
A duo of 2 fields for managing your multilanguage keywords (and other simple taxonomy).
Clavis verbum is the literal latin translation of "key-word".
Benefits compared to the native structure and tag fields :
- Multilanguage support.
- Centralised taxonomy storage.
- Easily modify your taxonomy.
Provided
Fields:
translatedstructure: An extended structure field with translateable entries.
All content is stored in the default language and translateable fields are automatically cloned for each language and.taxonomystructure: A field for handling your multilanguage keywords and other taxonomy.taxonomytags: An extended tags field for selecting and creating keywords.
Frontend tools:
- Utilities to sanitize and translate a list of taxonomy.
- Utilities to bind a field to another field.
Requirements
A Kirby 5 multilanguage website. Using this plugin in a single language setup is not tested. This plugin depends on daandelange/kirby-helpers.
Install
- Composer :
composer require daandelange/clavisverbum -
GIT :
git submodule add https://github.com/Daandelange/kirby-ClavisVerbum.git ./site/plugins/clavisverbumcd /site/plugins/clavisverbum && composer installgit submodule add https://github.com/Daandelange/kirby-helpers.git ./site/plugins/daans-helperscd /site/plugins/daans-helpers && composer install -
Usage
Plugin options
You can change the plugin behaviour using the following options :
``
Field : Translated Structure
This field tries to solve translation issues often encountered with the native structure field.
It's simply a structure field with translateable field entries. All content is stored in the default language and translateable fields are automatically cloned for each language.
This field is used by the taxonomystructure field, but you can also use it standalone.
Blueprint Properties
Blueprint options are inherited from the native structure field, except the following ones :
Note: Some defaults have been changed for convenience.
Frontend template
You can use toTranslatedStructure() to fetch the data; usage is like toStucture() but it sanitizes the data, restricting the data fields to the available fields. Also, you can call $translatedStructureObject->mytranslatedfieldname($lang=null) to automatically grab the current language.
``
Note: You can also use the native $translatedStructureField->toStucture() and fetch the translated fields manually.
Note that this doesn't sanitize any data. More information on the native structure field.
Field: Taxonomy Structure
A multilanguage taxonomy structure field for managing your keywords and other simple taxonomy.
Put this field in a centralised place on your website; in site.yml for example.
Blueprint properties
Blueprint options are inherited from the translatedstructure field, except the following ones :
`
The tabsbinding lets you map structure fields to option fields.
This is automatically set if you use the recommended fields id,name and description. For custom fields, use the extra field prop to set this right.
Frontend template
``
You can also use $taxonomyStructure->toTags() to feed a native tags field (and other fields with options). Also see your fields' tagsbinding props for usage with custom fields.
`
Field: taxonomytags
An extended tags field to select from your centralised taxonomystructure field.
It also allows to add new entries to your taxonomy.
The fields is "bound" to the taxonomystructure field using the Kirby query language.
Blueprint properties
`
Frontend template
``
Alternatives & Similar
-
sylvainjule/Kirby-categories : A similar plugin that uses another approach : Syncs all taxonomy changes down to their respective content files, heavily relying on panel hooks to sync/apply changes.
-
hananils/Kirby-choice : A fontend tool to sanitize data from fields with
options. (no true multilanguage support) -
bvdputte/kirby-taxonomy : Another taxonomy plugin (probably for older Kirby versions).
-
lukaskleinschmidt/synced-structure : Very simple but powerful translateable structure by syncing on save.
-
License
MIT
Let's make this great together : Specially for commercial usage, try to contribute back some improvements.