Download the PHP package sylvainjule/categories without Composer
On this page you can find all versions of the php package sylvainjule/categories. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sylvainjule/categories
More information about sylvainjule/categories
Files in sylvainjule/categories
Package categories
Short Description Create and manage multi-language categories in Kirby
License MIT
Informations about the package categories
Kirby Translated Categories
This plugin helps dealing with translated categories, adding UUIDs to structure fields and the ability to sync their content accross all languages.
Overview
This plugin is completely free and published under the MIT license. However, if you are using it in a commercial project and want to help me keep up with maintenance, you can consider making a donation of your choice.
- 1. Installation
- 2. Panel setup
- 3. Options
- 4. Frontend usage
- 5. Caveats
- 6. License
1. Installation
Version 2.0.0 introduces breaking changes from previous 1.x.x versions (explained and documented in the release), and is compatible with Kirby 5 only.
Download and copy this repository to
Alternatively, you can install it with composer:
2. Panel setup
This plugin allows an editor to easily create and manage multi-language categories, while keeping the field's content synced between languages in order to keep IDs unique. It will only work in multi-language setups.
Whenever a user adds a new item to a synced structure field, all languages inherit the new item.
Whenever a user deletes an item from a synced structure field, it is deleted from all languages.
Whenever a user sorts a synced structure field, the new sort order is applied in all languages.
It requires two steps:
First, add a structure field anywhere in your blueprints:
Second, you need to tell the plugin which template => fieldname
to watch and sync accross languages, by adding this option to your config file
For example, if you have a blog
template with a categories
field, and a projects
template with clients
+ techniques
fields, you will need to set:
You can then set the categories created with the field as dynamic options of select
, multiselect
, checkboxes
, etc. Refer to the official documentation about using structure field items as options.
Since the plugin makes sure that a given category shares the same UUID accross all languages, use {{ structureItem.uuid }}
as an immutable value. The text
property can be any field from your structure.
3. Options
3.1. Watch
An array of template => [fields]
pairs to watch (default is empty | []
). See above for examples.
3.2. Hook
Setting this option to false
(default is true
) will prevent the plugin to apply any change in the page.update:after
| site.update:after
hooks (you would then have to manually call it, see 5. Caveats).
4. Frontend usage
You can use the field like any other Structure, but knowing your categories share an immutable UUID accross languages. Few examples:
5. Caveats
The plugin registers two hooks (site.update:after
, page.update:after
) to save data in content files. To my understanding you should avoid running multiple hooks which save content in the same files to prevent any conflict.
If your project or another plugin registers these hooks, few options:
- Make sure it doesn't call the
$newPage->save()
or$newSite->save()
method. - Make sure it doesn't call the
$newPage->save()
method on a template watched by the plugin (ie. added in thesylvainjule.categories.watch
option). - Make sure you disable the plugin's hook by setting
'sylvainjule.categories.hook' => false
, and call its logic in your own hook, in order to call the->save()
method only once:
6. License
MIT