[FEATURE] Allowed Record Types for Page Types

nhovratov · nhovratov · commit bbda7127ff07 · 2026-03-20T11:56:52.000+01:00
diff --git a/Build/JsonSchema/SchemaSources/page-type.json b/Build/JsonSchema/SchemaSources/page-type.json
@@ -16,7 +16,8 @@
 		"basics": {},
 		"fields": {},
 		"table": {},
-		"typeField": {}
+		"typeField": {},
+		"allowedRecordTypes": {}
 	},
 	"allOf": [
 		{
@@ -54,6 +55,13 @@
 							"pattern": "^[0-9]+$"
 						}
 					]
+				},
+				"allowedRecordTypes": {
+					"description": "List of allowed records, which may be created on this Page",
+					"type": "array",
+					"items": {
+						"type": "string"
+					}
 				}
 			}
 		},
diff --git a/Build/content_blocks_examples/ContentBlocks/PageTypes/example/config.yaml b/Build/content_blocks_examples/ContentBlocks/PageTypes/example/config.yaml
@@ -1,5 +1,7 @@
 name: example/example-page-type
 typeName: 942
+allowedRecordTypes:
+  - tx_hov_domain_model_notype
 fields:
   - identifier: additional_field
     type: Text
diff --git a/Classes/Definition/ContentType/PageTypeDefinition.php b/Classes/Definition/ContentType/PageTypeDefinition.php
@@ -48,6 +48,8 @@ public function __construct(
         public string $languagePathDescription,
         public ?string $group,
         public PageIconSet $pageIconSet,
+        /** @var string[] */
+        public array $allowedRecordTypes,
     ) {}
 
     public function getPageIconSet(): PageIconSet
diff --git a/Classes/Definition/Factory/ContentTypeFactory.php b/Classes/Definition/Factory/ContentTypeFactory.php
@@ -72,6 +72,7 @@ private function createPageTypeDefinition(array $typeDefinition, string $table):
         $arguments['table'] = $table;
         $iconHideInMenu = ContentTypeIcon::fromArray($typeDefinition['typeIconHideInMenu'] ?? []);
         $iconRoot = ContentTypeIcon::fromArray($typeDefinition['typeIconRoot'] ?? []);
+        $arguments['allowedRecordTypes'] = $typeDefinition['allowedRecordTypes'] ?? [];
         $pageIconSet = new PageIconSet($iconHideInMenu, $iconRoot);
         $arguments['pageIconSet'] = $pageIconSet;
         $pageTypeDefinition = new PageTypeDefinition(...$arguments);
diff --git a/Classes/Definition/Factory/Processing/ProcessedContentType.php b/Classes/Definition/Factory/Processing/ProcessedContentType.php
@@ -86,6 +86,9 @@ public function toArray(bool $isRootTable, string $identifier): array
         if ($this->contentBlock->getContentType() === ContentType::CONTENT_ELEMENT) {
             $contentType['saveAndClose'] = (bool)($yaml['saveAndClose'] ?? false);
         }
+        if ($this->contentBlock->getContentType() === ContentType::PAGE_TYPE) {
+            $contentType['allowedRecordTypes'] = $this->contentBlock->getYaml()['allowedRecordTypes'] ?? [];
+        }
         return $contentType;
     }
 }
diff --git a/Classes/Generator/TcaGenerator.php b/Classes/Generator/TcaGenerator.php
@@ -328,12 +328,21 @@ protected function processContentElement(ContentTypeInterface $typeDefinition, a
 
     protected function processPageType(ContentTypeInterface $typeDefinition, array $columnsOverrides): array
     {
+        if (!$typeDefinition instanceof PageTypeDefinition) {
+            throw new \InvalidArgumentException(
+                'Expected PageTypeDefinition, got ' . get_class($typeDefinition),
+                1774000611
+            );
+        }
         $typeDefinitionArray = [
             'showitem' => $this->getPageTypeStandardShowItem($typeDefinition->getShowItems(), $typeDefinition->getTypeName()),
         ];
         if ($columnsOverrides !== []) {
             $typeDefinitionArray['columnsOverrides'] = $columnsOverrides;
         }
+        if ($typeDefinition->allowedRecordTypes !== []) {
+            $typeDefinitionArray['allowedRecordTypes'] = $typeDefinition->allowedRecordTypes;
+        }
         return $typeDefinitionArray;
     }
 
diff --git a/Documentation/ChangeLog/2.2/Index.rst b/Documentation/ChangeLog/2.2/Index.rst
@@ -0,0 +1,39 @@
+.. include:: /Includes.rst.txt
+.. _changelog-2.2:
+
+===
+2.2
+===
+
+Content Blocks version 2.2 adds compatibility for TYPO3 v14.2.
+
+..  contents::
+
+Feature
+=======
+
+Allowed Record Types for Page Types
+-----------------------------------
+
+A new option :yaml:`allowedRecordTypes` has been added for Page Types, which
+allows you to define a set of Record Types (tables), that should be allowed
+on this specific Page Type.
+
+Example: Extending the default allowed values with custom ones.
+
+.. code-block:: yaml
+
+   allowedRecordTypes:
+     - pages
+     - sys_category
+     - sys_file_reference
+     - my_custom_table
+
+Example: Allow all records with an asterisk:
+
+.. code-block:: yaml
+
+   allowedRecordTypes:
+     - *
+
+Read more :ref:`here <confval-page-type-allowedRecordTypes>`.
diff --git a/Documentation/YamlReference/ContentTypes/PageTypes/Index.rst b/Documentation/YamlReference/ContentTypes/PageTypes/Index.rst
@@ -68,3 +68,41 @@ Here you can find all :ref:`common root options <yaml_reference_common>`.
    *  `default`
    *  `link`
    *  `special`
+
+.. confval:: allowedRecordTypes
+   :name: page-type-allowedRecordTypes
+   :required: false
+   :type: array<string>
+
+   List of allowed Record Types (tables) for this specific Page Type. If defined,
+   only this list of records can be created on this Page Type. This is also
+   evaluated when switching a Page Type to another one. Per default the tables
+   `pages`, `sys_category`, `sys_file_reference` and `sys_file_collection` are
+   allowed, if not configured otherwise.
+
+   .. hint::
+
+      If a Record Type ignores Page Type restrictions, then you don't need to
+      list it here. It will be allowed regardless of this setting.
+
+      .. code-block:: yaml
+
+       security:
+           ignorePageTypeRestriction: true
+
+   Example: Extending the default allowed values with custom ones.
+
+   .. code-block:: yaml
+
+       allowedRecordTypes:
+         - pages
+         - sys_category
+         - sys_file_reference
+         - my_custom_table
+
+   Example: Allow all records with an asterisk:
+
+   .. code-block:: yaml
+
+       allowedRecordTypes:
+         - *
diff --git a/JsonSchema/page-type.schema.json b/JsonSchema/page-type.schema.json
@@ -16,7 +16,8 @@
     "basics": {},
     "fields": {},
     "table": {},
-    "typeField": {}
+    "typeField": {},
+    "allowedRecordTypes": {}
   },
   "allOf": [
     {
@@ -58,6 +59,13 @@
               "pattern": "^[0-9]+$"
             }
           ]
+        },
+        "allowedRecordTypes": {
+          "description": "List of allowed records, which may be created on this Page",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
         }
       }
     },
diff --git a/Tests/Unit/Generator/TcaGeneratorTest.php b/Tests/Unit/Generator/TcaGeneratorTest.php
@@ -1677,6 +1677,10 @@ public static function pageTypesGenerateCorrectTcaDataProvider(): iterable
                         'table' => 'pages',
                         'typeField' => 'doktype',
                         'typeName' => 1700156757,
+                        'allowedRecordTypes' => [
+                            'foo',
+                            'bar',
+                        ],
                     ],
                 ],
             ],
@@ -1706,6 +1710,10 @@ public static function pageTypesGenerateCorrectTcaDataProvider(): iterable
                                     'description' => 'LLL:EXT:my_sitepackage/ContentBlocks/PageTypes/custom-page-type/language/labels.xlf:nav_title.description',
                                 ],
                             ],
+                            'allowedRecordTypes' => [
+                                'foo',
+                                'bar',
+                            ],
                         ],
                     ],
                     'columns' => [],
diff --git a/Tests/Unit/JsonSchemaValidation/PageTypeSchemaTest.php b/Tests/Unit/JsonSchemaValidation/PageTypeSchemaTest.php
@@ -31,6 +31,10 @@ public static function pageTypeSchemaValidationWorksAsExpectedDataProvider(): it
                 'name' => 'json/page-test',
                 'typeName' => 123,
                 'group' => 'default',
+                'allowedRecordTypes' => [
+                    'foo',
+                    'bar',
+                ],
             ],
             'valid' => true,
         ];

Original file line number	Diff line number	Diff line change
`@@ -16,7 +16,8 @@`
`16`	`16`	`"basics": {},`
`17`	`17`	`"fields": {},`
`18`	`18`	`"table": {},`
`19`		`- "typeField": {}`
	`19`	`+ "typeField": {},`
	`20`	`+ "allowedRecordTypes": {}`
`20`	`21`	`},`
`21`	`22`	`"allOf": [`
`22`	`23`	`{`
`@@ -54,6 +55,13 @@`
`54`	`55`	`"pattern": "^[0-9]+$"`
`55`	`56`	`}`
`56`	`57`	`]`
	`58`	`+ },`
	`59`	`+ "allowedRecordTypes": {`
	`60`	`+ "description": "List of allowed records, which may be created on this Page",`
	`61`	`+ "type": "array",`
	`62`	`+ "items": {`
	`63`	`+ "type": "string"`
	`64`	`+ }`
`57`	`65`	`}`
`58`	`66`	`}`
`59`	`67`	`},`
Original file line number	Diff line number	Diff line change
`@@ -86,6 +86,9 @@ public function toArray(bool $isRootTable, string $identifier): array`
`86`	`86`	`if ($this->contentBlock->getContentType() === ContentType::CONTENT_ELEMENT) {`
`87`	`87`	`$contentType['saveAndClose'] = (bool)($yaml['saveAndClose'] ?? false);`
`88`	`88`	`}`
	`89`	`+ if ($this->contentBlock->getContentType() === ContentType::PAGE_TYPE) {`
	`90`	`+ $contentType['allowedRecordTypes'] = $this->contentBlock->getYaml()['allowedRecordTypes'] ?? [];`
	`91`	`+ }`
`89`	`92`	`return $contentType;`
`90`	`93`	`}`
`91`	`94`	`}`