wieni/wmcontent

Adds configurable content 'containers' to entity types (for eg.paragraphs)

Monday, July 2, 2018
by Wieni
Repository
8 Watchers
0 Stars
1,066 Installations

PHP
0 Dependents
0 Suggesters
1 Forks
3 Open issues
51 Versions
28 % Grown

The README.md

wmcontent

, _(*1)

Adds configurable entity containers to entity types (for e.g. paragraphs), _(*2)

Why?

In Drupal 7 we noticed a couple of shortcomings with the Paragraphs module (that are still not solved in Drupal 8 AFAWK)., _(*3)

Backend performance improvements: Paragraphs creates a widget within the default entity edit forms. This did not only clutter the interface when using > 10 paragraphs, the form itself would regularly become too large and break any decent PHP memory setting on submitting/saving. This module provides a separate tab for its content, instead of mixing it in with the node edit form through inline entity forms or similar solutions.
Frontend performance improvements: The paragraphs of an entity are loaded separately from the standard entity data, which solves memory issues when displaying a lot of entities on a page.
UI improvements: Features like cloning/duplication of paragraphs as well as drag and drop sorting of paragraphs become easier when not integrated in the default entity edit form.
More flexibility: This module allows multiple lists of paragraphs (containers) to be attached to entities, where one can limit the available entity types and bundles on a per-container basis. This allows for e.g. a Content tab and a Program tab for activity/event content types.

Installation

This package requires PHP 8.1 and Drupal 10.0 or higher. It can be installed using Composer:, _(*4)

 composer require wieni/wmcontent

How does it work?

Terminology

A container connects hosts of a certain type to children of a certain type.
A host is an entity with containers, e.g. a node with a paragraph container. A host can have multiple children per container.
A child is an entity attached to a host through a container, e.g. a paragraph. Every entity can only be attached to a single container.

Children and hosts can be entities of any type with a canonical route, implementing Drupal\Core\Entity\ContentEntityTypeInterface., _(*5)

When updating a child entity, the changed time of the host entity is updated as well., _(*6)

Get started

Before you begin, make sure your user role has the administer wmcontent permission. After that, you can get started by creating a new container. You can do this by going to /admin/config/wmcontent/containers or by following the Structure > WmContent > WmContent Containers menu link., _(*7)

After creating the container, go to the (edit) page of a possible host entity. A new tab should have appeared with the name of the container you just created., _(*8)

Clicking that link brings you to the master form, where you can add children to and edit/delete/reorder children from this host., _(*9)

Displaying children

If you use Display Suite to build your pages, you can use the WmContent: Content blocks field to display the content of the children entities on a host., _(*10)

You can change the way wmcontent containers are rendered by overriding the wmcontent theme implementation., _(*11)

If you build your pages manually using Twig templates, you can load the children of a host using WmContentManagerInterface::getContent., _(*12)

Changelog

All notable changes to this project will be documented in the CHANGELOG file., _(*13)

Security

If you discover any security-related issues, please email security@wieni.be instead of using the issue tracker., _(*14)

License

Distributed under the MIT License. See the LICENSE file for more information., _(*15)

The Versions

02/07 2018

dev-release/0.4

Adds configurable content 'containers' to entity types (for eg.paragraphs)

drupal-module wmcontent

Adds configurable content 'containers' to entity types (for eg.paragraphs)

wieni/wmcontent

The README.md

wmcontent

Why?

Installation

How does it work?

Terminology

Get started

Displaying children

Changelog

Security

License

The Versions

dev-release/0.4

by Wieni

0.4.17

by Wieni

dev-feature/0.4/content-block-access-checks

by Wieni

0.4.16

by Wieni

0.4.15

by Wieni

0.4.14

by Wieni

0.1.2

0.1.3

0.1.4

0.1.1

0.4.13

by Wieni

0.4.12

by Wieni

0.4.11

by Wieni

0.4.10

by Wieni

0.4.9

by Wieni

0.4.8

by Wieni

0.4.7

by Wieni

0.4.6

by Wieni

dev-fix/0.4/wmcontent-operation-links-multilingual

by Wieni

0.4.5

by Wieni

dev-fix/update-parent-host-on-contentblock-insert

by Wieni

0.4.4

by Wieni

dev-fix/v0.4/fix-undefined-method-getContentBlocks

by Wieni

0.4.3

by Wieni

dev-feature/0.4/wmcontent_weight

by Wieni

0.4.2

by Wieni

dev-fix/v0.4/call-to-undefined-method-hostclearcache

by Wieni

0.4.1

by Wieni

dev-fix/v0.4/isContentBlock-typeError

by Wieni

0.4.0

by Wieni

dev-release/0.3

by Wieni

0.3.4

by Wieni

0.3.3

by Wieni

0.3.2

by Wieni

dev-hotfix/0.3/better-titles-in-blocks