Ticket #47466: 47466.diff

src/wp-admin/includes/misc.php

@@ -119 +119 @@
                 $insertion = explode( "\n", $insertion );
         }
 
+        $instructions_markers = array();
+        $instructions_markers[] = "#";
+        $instructions_markers[] = "# The directives (lines) between `BEGIN {$marker}` and `END {$marker}` are dynamically generated,";
+        $instructions_markers[] = "# and should only be modified through the use of WordPress filters.";
+        $instructions_markers[] = "# Any changes to the directives between these markers will be overwritten.";
+
+        /**
+         * Filters the inline instructions which are shown alongside dynamically generated markers.
+         *
+         * @since x.x.x
+         *
+         * @param string[] $instructions_markers Array of lines, containing inline instructions for insertion into the file.
+         * @param string $marker The marker being inserted.
+         */
+        $instructions_markers = apply_filters( 'insert_with_markers_inline_instructions', $instructions_markers, $marker );
+
+        $insertion = array_merge($instructions_markers, $insertion);
+
         $start_marker = "# BEGIN {$marker}";
         $end_marker   = "# END {$marker}";