node package manager

@nymdev/clay-kiln

clay-kiln

Coverage Status

🔥 Editing tools for Clay

Kiln

Install

npm install --save @nymdev/clay-kiln

Kiln will automatically compile scripts and styles after installing.

Usage

To include it in your site, add it to your bootstrap:

components:
  clay-kiln:
      allow: true

Then add it to any layouts you want to use it on:

components:
  layout:
    instances:
      article-layout:
        top:
          -
            _ref: /components/clay-kiln

Kiln will automatically display its toolbar (and load its scripts and styles) when you visit a page with ?edit=true as a query param.

Extending Kiln

Kiln has a simple client-side api that is used to extend its functionality. It consists of a global kiln object, with behaviors (object), decorators (array), and validators (array).

  • Behaviors — run on each field when opening forms
  • Decorators — run on each field (elements with data-editable) when the page is loaded
  • Validators — run when clicking the PUBLISH button and block publishing if they don't validate

To add custom behaviors, decorators, and validators, simply add them to the kiln object before the page's DOMContentLoaded event fires.

Contributing

Inside The Kiln

As behvaiors, decorators, and validators are standardized, we may add them into the kiln directly. They live in their respective folders, and can be overridden by clay instances as needed.

  • Behaviors — scripts and styles for standard behaviors
  • Controllers — handlers attached to editable components, forms, toolbars, etc
  • Decorators — scripts for standard decorators, including focus and placeholder
  • Media — svgs used by standard behaviors, decorators, and other kiln elements
  • Services — internal services including editing, database access, and form creation
  • Styleguide — Kiln styleguide, used by standard behaviors, decorators, validators, and other kiln elements
  • Validators — scripts for standard validators

Client.js

This file bootstraps internal and external behaviors, decorators, and validators. When the DOMContentLoaded event fires it instantiates a component-edit controller for each component on the page. This controller calls the decorators it needs (to attach click events to editable elements, or add placeholders, etc) and instantiates any services required (like component selectors).

Testing

  • npm test will run eslint and karma tests (the latter being run on browserify).
  • npm run lint will run eslint locally on the script folders, as well as client.js
  • npm run test-local will run karma tests locally (using karma.local.conf.js) and auto-watch for changes
  • gulp watch will automatically re-compile scripts and styles on change