child_entity 2.1.0

Child Entity 2.1.0 modernizes the module for Drupal 10.3+, Drupal 11, and Drupal 12 with PHP 8.4+ strict typing, OOP hooks, dedicated HTML and revision route providers, multi-level hierarchy fixes, and a comprehensive kernel and functional test suite.

Highlights & New Features

• Drupal 11 & 12 / PHP 8.4 Modernization:
  • Updated core compatibility to ^10.3 || ^11 || ^12 and minimum PHP requirement to >=8.4.
  • Enforced declare(strict_types=1); and native parameter, property, and return type hints across the entire module.
  • Migrated procedural hooks (hook_entity_presave(), hook_entity_type_alter()) to an OOP hook class (Drupal\child_entity\Hook\ChildEntityHooks) using #[Hook] attributes, with #[LegacyHook] procedural shims in child_entity.module for backward compatibility.
• Dedicated Route Providers & Revision Support:
  • Added ChildDefaultHtmlRouteProvider, ChildAdminHtmlRouteProvider, and ChildRevisionHtmlRouteProvider (for revision history, view, revert, and delete routes prefixed with parent parameters).
  • Extracted shared route preparation and parent parameter upcasting logic into ChildEntityRouteProviderTrait.
  • Added ChildEntityHelper for static entity type validation (validateChildEntityType(), isChildEntityType()) without triggering PHP 8.4/8.5 static trait call deprecations.
• Data Integrity & Form Enforcement:
  • hook_entity_presave() now attempts to recover a missing parent reference from the active route match before throwing a \LogicException if a child entity is saved without a parent.
  • hook_entity_type_alter() validates that non-confirm content entity forms (default, add, edit) on child entities extend ChildContentEntityForm.
  • Marked the parent entity_reference base field in ChildEntityTrait::childBaseFieldDefinitions() as required and revisionable (when the child entity type is revisionable).
• Automated Test Suite:
  • Added the child_entity_test test module and automated PHPUnit Kernel and Functional tests covering 2-level and 3-level entity hierarchies, routing, route contexts, access delegation, dynamic permissions, presave integrity, and UI workflows.

Bug Fixes

• Fixed multi-level parent parameter recursion: Fixed infinite recursion in ChildEntityTrait::buildParentParams() and updated ChildEntityController::addPage() to walk the full ancestor chain when building bundle add links and single-bundle redirects.
• Fixed route context resolution: Fixed ChildEntityRouteContext::getRuntimeContexts() key mismatches between child and parent entity type IDs and registered ChildEntityRouteSubscriber in child_entity.services.yml.
• Fixed bundle & revision permission generation: Fixed bundle key iteration in ChildEntityPermissions::generatePermissions() and restricted revision permissions to revisionable child entity types.
• Fixed bundle-less add-form route errors: Guarded ChildEntityController::addPage() when a bundle config entity type does not define an add-form link template.

API Changes & Deprecations

• ChildEntityInterface now explicitly extends Drupal\Core\Entity\ContentEntityInterface, allows nullable returns on getParentEntity(): ?EntityInterface and getParentId(): int|string|null, and uses : static return types on setParentId() and setParentEntity().
• ChildContentEntityHtmlRouteProvider is deprecated in child_entity:2.1.0 and will be removed in child_entity:3.0.0. Use Drupal\child_entity\Routing\ChildAdminHtmlRouteProvider or Drupal\child_entity\Routing\ChildDefaultHtmlRouteProvider instead.