CEDC / node_layout

Layouts per node on the Backdrop.

node_layout

Layouts per node for the Backdrop CMS.

Motivation

In Drupal 7, I was able to have a layout per node that I could edit via "node/%/layout". In Backdrop, I can make layouts for patterns of paths, e.g. "content/foo/*" but not per node. Adding one per node via the layout tool becomes unmanageable. The goal for this module is to provide a way for users to create a layout per node managed by the same tabs they are used to view/edit.

Installation

1. Install the module like you would any Backdrop module. No content types will be selected on install to inherit node layouts.

2. You will need to go to admin/config/content/node-layout and select which node types can have layouts.

3. After you save the form, it will reload and you can select which regions the content type can use for layout placement.

4. Remove in future You will need to add the layout blocks to the default layout, admin/structure/layouts/manage/default, in order for the placed blocks to show up when viewing nodes. This will be automated in the future with a layout per node type.

5. Node Layout needs to have "hidden path" content types to be able to create and edit the blocks. You can create them at admin/structure/types/add and make sure that "Hide path display" is checked.

6. Create some content with the "hidden path" content type so you can use it in the layout tool. We'll call them "blocks" from now on.
7. Create a node that has the node layout functionality enabled and go to the node/%/layout path to create your node layout.

Creating A Block

The Node Layout module allows you to create blocks via the layout interface. It is currently done via an iframe implemention but will be switched to loading the form via AJAX with a smoother UX to navigate away from the created node.

Simply click "Create Block" to show a listing of the block types you can choose to create content for. You will create content with exactly the same form as you see in the normal node/add UI, except the modal will only include the form needed and not the theme of the site...eventually.

Once you are done creating content, close the modal and the layout data will be refreshed to allow you to add the newly create block to a region via the search input.

Editing Blocks

Once you add a block to a region, you might want to edit it and the layout interface allows you to do this without having to switch screens and lose context.

Click "Edit" on any block to see the node/edit form for that hidden path node. This is loaded in an iframe for now but will use AJAX in the future. Once you save your edit, close the modal to complete the edit.

Feature Roadmap

There isn't really a roadmap for this module yet since it is in heavy development, but some features have been discussed in addition to cleaning up the code and removing the iframes for modals.

• Remove CSS and make Themeable - Currently, the Bootstap CSS framework is used to provide basic theming, but to fit into existing admin themes, the classes used will need to be configurable. Also, the regions should visually reflect the what the final output looks like at least in rows and column widths.

• Add A Preview In-line - Just looking at a title/label of a block might not give you a good idea of what it includes. When adding a block or looking at what's currently in a region, the rendered nodes can be inserted just like they are on node/%/view for the layout.

• Create A Listing Feature - A user might want to see a list of where a specific type of block is used on any given site. There is a table in the database to store references when editing a layout, but nothing has been implemented yet. Some sort of cache invalidation strategy could be derived from that listing feature.