Changeset 61546

Timestamp:

01/28/2026 08:54:36 PM (2 months ago)

Author:

johnbillion

Message:

Docs: Document the contentOnly value for the $template_lock argument when registering a post type.

Props ocean90, mukesh27, johnbillion

See #64224

Location:

trunk/src/wp-includes

Files:

• class-wp-post-type.php (modified) (1 diff)
• post.php (modified) (1 diff)

trunk/src/wp-includes/class-wp-post-type.php

@@ -304 +304 @@
      * - If set to 'insert', the user is able to move existing blocks but is unable to insert
      *   new blocks and delete blocks.
+     * - If set to 'contentOnly', the user is only able to edit the content of existing blocks.
      *
      * Default false.

trunk/src/wp-includes/post.php

@@ -1800 +1800 @@
  *                                                        optional attributes. Default empty array.
  *     @type string|false $template_lock                  Whether the block template should be locked if $template is set.
- *                                                        * If set to 'all', the user is unable to insert new blocks,
- *                                                          move existing blocks and delete blocks.
- *                                                       * If set to 'insert', the user is able to move existing blocks
- *                                                         but is unable to insert new blocks and delete blocks.
- *                                                         Default false.
- *     @type bool         $_builtin                     FOR INTERNAL USE ONLY! True if this post type is a native or
- *                                                      "built-in" post_type. Default false.
- *     @type string       $_edit_link                   FOR INTERNAL USE ONLY! URL segment to use for edit link of
- *                                                      this post type. Default 'post.php?post=%d'.
+ *                                                          * If set to 'all', the user is unable to insert new blocks,
+ *                                                            move existing blocks and delete blocks.
+ *                                                          * If set to 'insert', the user is able to move existing blocks
+ *                                                            but is unable to insert new blocks and delete blocks.
+ *                                                          * If set to 'contentOnly', the user is only able to edit the content
+ *                                                            of existing blocks.
+ *                                                        Default false.
+ *     @type bool         $_builtin                       FOR INTERNAL USE ONLY! True if this post type is a native or
+ *                                                        "built-in" post_type. Default false.
+ *     @type string       $_edit_link                     FOR INTERNAL USE ONLY! URL segment to use for edit link of
+ *                                                        this post type. Default 'post.php?post=%d'.
  * }
  * @return WP_Post_Type|WP_Error The registered post type object on success,