avoskitchen / kirby-kitchen
Installs: 43
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 4
Forks: 1
Open Issues: 0
Type:kirby-plugin
Requires
- php: >=8.0.0
- getkirby/cms: >=3.6.0
- getkirby/composer-installer: ^1.2
This package is auto-updated.
Last update: 2024-10-18 08:38:13 UTC
README
⚠️ This is beta software, use at you own risk! ⚠️
A complete recipe manager with knowledge base, we wrote for ourselves. This is currently more or less a semi-public plugin, as we cannot provide any support for it. But if you’re interested in using it on your site, feel free to use or adapt the code to your needs. But use at you own risk, of course ;-) If you got any idea of how this can be improved, feel free to create a ticket or pull request.
How it works
The plugin provides a set of templates that can be used as a starting point for your recipe collection, food blog or whatsoever. To start using the plugin, just tune the settings below to your needs, then go to the panel and create two new top-level pages:
- One or more pages with the
recipes
template. Each of these holds a recipe collection. For most users, one recipe directory should be enough. Note that having more than one recipe page - If you want to use the knowledge-base, also create a page with the
knowledge
template. The knowledge base can be used to store information about different ingredients, preparation methods etc. There can only be one knowledge base on your site.
System Requirements
- Kirby 4.1.0+
- PHP 8.1+
- A locale must be set (for future versions)
intl
must be used as date formatter
Installation
composer require avoskitchen/kirby-kitchen
Available Options
KirbyTags
Use the following Kirbytags to spice up your recipes:
(recipe: …)
Embeds a recipe (⚠️ not ready yet!)
Attributes
(term: …)
Inserts a link to a term page. This could be extended with a tooltip (like e.g. on Wikipedia) or additional features. Currently, it just provides a handier version of the link tag.
Attributes
Make it Yours
The Kitchen plugin comes with its own set of default templates, located in site/plugins/kitchen/templates
. You can override these defaults by placing template files with the same name into site/templates/
:
You can also extend the plugin’s blueprints. Let’s say you want to extend the recipes
blueprint; just create a new file site/blueprints/pages/recipes.yml
and add a tab to the blueprint, containing your own field definitions:
extends: kitchen/pages/recipes tabs: settings: label: Settings icon: settings fields: hero: label: Hero image type: files multiple: false …
Credits
This plugin uses code from the following Kirby 3 plugins:
- Kirby Last Edited by Dennis Kerzig.
License
This plugin is licensed under the MIT license with the exception of the included icons from the Nucleo set. See index.js for further information on the icons’ license.
However, it is strongly discouraged to use it in any project, that promotes racism, sexism, homophobia, animal abuse or any other form of hate-speech or violence.