2017 © Pedro Peláez
 

drupal-module kalagraphs

Facilitates rapid development of components from kalastatic (styleguide/prototype) to CMS (Drupal) implementation.

image

derekderaps/kalagraphs

Facilitates rapid development of components from kalastatic (styleguide/prototype) to CMS (Drupal) implementation.

  • Tuesday, January 23, 2018
  • by derekderaps
  • Repository
  • 12 Watchers
  • 5 Stars
  • 3,178 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 1 Forks
  • 7 Open issues
  • 14 Versions
  • 2 % Grown

The README.md

Kalagraphs (Kalamuna Paragraphs)

Kalagraphs aims to empower front-end developers with the tools to maintain a warchest of components available to Drupal site editors. It accomplishes this by making components cheap and easy to create and manage. No longer must you have badass PHP developer skills with intimate knowledge of Features module voodoo just to get your components on a CMS page. Let the component names be specific and let the markup do its thing, all without needing to create an unmanagable number of Paragraph types!, (*1)

In practice, Kalagraphs facilitates rapid development of components from a styleguide (e.g., kalastatic, kss, or Pattern Lab) to implementation (Drupal via Paragraphs)., (*2)

Table of Contents

Rationale

Benefits

  1. Decrease the development time and effort required to "CMSify" new components (make them available in Drupal) by removing the need for creation of new Paragraph types., (*3)

  2. Improve the editorial UX by decluttering the edit form (fewer Paragraph types) and adding logos/icons to help editors identify each type (planned)., (*4)

  3. Make it possible to switch between component types without data loss / having to re-input the field data., (*5)

Life without Kalagraphs

  1. Probably okay but potentially miserable., (*6)

  2. Necessitates availability of backend development resources with intricate knowledge of the Drupal 8 theming layer., (*7)

Contra-indications

Don't attempt to shoehorn Kalagraphs onto very complex components; just create a new, custom Paragraphs bundle to fit the data model. One great thing about this module: Kalagraphs doesn't interfere with a standard Paragraphs workflow, so developers who wish to may continue using their familiar tools without any trouble. Furthermore, they can even leverage some of Kalagraphs utility functions with the other Paragraph bundles or with entirely different entity types., (*8)

For example, it's often necessary to output node teasers as components on a page, in lists or otherwise. By adjusting the teaser view mode's field display formatters to use the Kalagraphs versions, developers may leverage the same field processing magic that informs template variables on all the Kalagraphs-enabled components., (*9)

Usage

Getting Started

  1. Install the module (@todo Add link to Drupal documentation on installing modules).
  2. @todo Fill in more steps here.

Field Formatting

To render individual fields with various atom components, manually create theme hooks for each of the Twig files. Then, extend each of the the Kalagraphs field formatters in src/Plugin/Field/FieldFormatters and override viewValue() to assign the appropriate theme hook to the $value render array. More documentation and links forthcoming to this section., (*10)

The Versions

23/01 2018

dev-7.x-1.x

dev-7.x-1.x

Facilitates rapid development of components from kalastatic (styleguide/prototype) to CMS (Drupal) implementation.

  Sources   Download

MIT

The Requires

  • drupal/entityreference *
  • drupal/fences *
  • drupal/link *
  • drupal/paragraphs *@rc
  • drupal/variable *
  • drupal/viewfield *
  • drupal/twigshim *@beta
  • drupal/entityreference_view_widget *@rc

 

by Derek DeRaps

23/01 2018

7.1.0-beta1

7.1.0.0-beta1

Facilitates rapid development of components from kalastatic (styleguide/prototype) to CMS (Drupal) implementation.

  Sources   Download

MIT

The Requires

  • drupal/twigshim *@beta
  • drupal/entityreference *
  • drupal/entityreference_view_widget *@rc
  • drupal/fences *
  • drupal/link *
  • drupal/paragraphs *@rc
  • drupal/variable *
  • drupal/viewfield *

 

by Derek DeRaps

23/01 2018

dev-7-composer

dev-7-composer

Facilitates rapid development of components from kalastatic (styleguide/prototype) to CMS (Drupal) implementation.

  Sources   Download

MIT

The Requires

  • drupal/twigshim *@beta
  • drupal/entityreference *
  • drupal/entityreference_view_widget *@rc
  • drupal/fences *
  • drupal/link *
  • drupal/paragraphs *@rc
  • drupal/variable *
  • drupal/viewfield *

 

by Derek DeRaps

26/10 2017

dev-8.x-2.x

dev-8.x-2.x https://github.com/kalamuna/kalagraphs

Kalagraphs provides a flexible Paragraph type that allows editors to choose with which Twig template to render it.

  Sources   Download

GPL-2.0+

The Requires

 

by Derek "Hawkeye Tenderwolf" DeRaps

drupal

06/10 2017

dev-8.x-1.x

dev-8.x-1.x https://github.com/kalamuna/kalagraphs

Kalagraphs provides a flexible Paragraph type that allows editors to choose with which Twig template to render it.

  Sources   Download

GPL-2.0+

The Requires

 

by Derek "Hawkeye Tenderwolf" DeRaps

drupal

01/10 2017

dev-backport

dev-backport https://github.com/kalamuna/kalagraphs

Kalagraphs provides a flexible Paragraph type that allows editors to choose with which Twig template to render it.

  Sources   Download

GPL-2.0+

The Requires

 

by Derek "Hawkeye Tenderwolf" DeRaps

drupal

01/10 2017

dev-layouts

dev-layouts https://github.com/kalamuna/kalagraphs

Kalagraphs provides a flexible Paragraph type that allows editors to choose with which Twig template to render it.

  Sources   Download

GPL-2.0+

The Requires

 

by Derek "Hawkeye Tenderwolf" DeRaps

drupal

15/09 2017

dev-8.x-2.x--bricks-ui

dev-8.x-2.x--bricks-ui https://github.com/kalamuna/kalagraphs

Kalagraphs provides a flexible Paragraph type that allows editors to choose with which Twig template to render it.

  Sources   Download

GPL-2.0+

The Requires

 

by Derek "Hawkeye Tenderwolf" DeRaps

drupal

30/08 2017

dev-bricks--abandoned

dev-bricks--abandoned https://github.com/kalamuna/kalagraphs

Kalagraphs provides a flexible Paragraph type that allows editors to choose with which Twig template to render it.

  Sources   Download

GPL-2.0+

The Requires

 

by Derek "Hawkeye Tenderwolf" DeRaps

drupal

09/08 2017

8.1.0-rc3

8.1.0.0-RC3 https://github.com/kalamuna/kalagraphs

Kalagraphs provides a flexible Paragraph type that allows editors to choose with which Twig template to render it.

  Sources   Download

GPL-2.0+

The Requires

 

by Derek "Hawkeye Tenderwolf" DeRaps

drupal

01/08 2017

8.1.0-rc2

8.1.0.0-RC2 https://github.com/kalamuna/kalagraphs

Kalagraphs provides a flexible Paragraph type that allows editors to choose with which Twig template to render it.

  Sources   Download

GPL-2.0+

The Requires

 

by Derek "Hawkeye Tenderwolf" DeRaps

drupal

18/06 2017

dev-feature/gremy/hero

dev-feature/gremy/hero https://github.com/kalamuna/kalagraphs

Kalagraphs provides a flexible Paragraph type that allows editors to choose with which Twig template to render it.

  Sources   Download

GPL-2.0+

The Requires

 

by Derek "Hawkeye Tenderwolf" DeRaps

drupal

18/06 2017

dev-feature/gremy/tout__cta

dev-feature/gremy/tout__cta https://github.com/kalamuna/kalagraphs

Kalagraphs provides a flexible Paragraph type that allows editors to choose with which Twig template to render it.

  Sources   Download

GPL-2.0+

The Requires

 

by Derek "Hawkeye Tenderwolf" DeRaps

drupal

07/06 2017

dev-sod

dev-sod https://github.com/kalamuna/kalagraphs

Kalagraphs provides a flexible Paragraph type that allows editors to choose with which Twig template to render it.

  Sources   Download

GPL-2.0+

The Requires

 

by Derek "Hawkeye Tenderwolf" DeRaps

drupal