donquixote / drupal-renderkit Goto Github PK

Currently there is work in progress for a Drupal 8 version.
At the time of this writing, I just pushed this preview branch: https://github.com/donquixote/drupal-renderkit/tree/8.x-1.x-PREVIEW-001

This branch is absolutely not meant to be used in any productive way.
I will break everything in this branch! I will rename classes, interfaces and namespaces. i will change method signatures.
I will rewrite the git history with rebase. I think I will then use a new branch name, so at least existing branches will keep their history.. but the final 8.x-1.x branch will likely not be a descendent of 8.x-1.x-PREVIEW-001

Even so, small pull requests can work:
Pick one class, e.g. EntityToEntity_EntityReferenceField, and try to port the logic to Drupal 8.

The are two major changes to the current stable D7 version:

1. Integration with Drupal 8 APIs. E.g. entities now implement EntityInterface, and know their own type.
2. A change of the plugin architecture for cfr. A lot of logic will go into separate libraries libraries, allowing cross-platform plugins with UI-driven configuration. "Configurator*" is largely replaced with "CfSchema*" (which I will likely rename to "FactorySchema"). For now, my advice would be to just ignore this part.

To try the components in Drupal 8, one would normally use them in combination with entdisp and cfrplugin.
However, since the D8 versions of those modules are not out yet, not even in preview, one can simply test the components separately. E.g. in devel code execution.
Of course it would be a good idea to actually write some tests cases...

To get an idea how the entire system is supposed to work in the end, just try the Drupal 7 version of renderkit, cfrplugin, entdisp and friends.

Currently: EntityTitle, EntityFixedHtml, NodeCreatedDate, EntityViewMode.
Proposed: TitleEntityDisplay,FixedHtmlEntityDisplay, CreatedDateNodeDisplay, ViewModeEntityDisplay.

I am undecided..

Library:

• ListFormat interface
  • ItemList / ul / ol
  • ContainerList
  • SeparatorList
• EntityDisplay contextual links
• EntityToEntity relationship

Drupal integration:

• EntityDisplay Views row plugin
• EntityDisplay Views field plugin
• EntityDisplay Entityreference formatter
• EntityDisplay field type
• Listformat plugin type
• Listformat views style plugin
• Listformat field theme function (ds)
• Listformat field type

Bikeshed / future:

• Object instead of render array?
• EntityWrapper object, instead of specifying type name + entity?
• RenderElement, PreRenderInterface, ThemePreprocessInterface, ThemeProcessInterface?