avoskitchen/kirby-kitchen

0.6.1 2022-01-22 20:45 UTC

This package is auto-updated.

Last update: 2024-10-18 08:38:13 UTC


README

GitHub release

⚠️ 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:

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.