WordPress.org

Make WordPress Core

Ticket #47466: 47466.3.diff

File 47466.3.diff, 1.6 KB (added by SergeyBiryukov, 19 months ago)
  • src/wp-admin/includes/misc.php

     
    7979                        $state = false;
    8080                }
    8181                if ( $state ) {
     82                        if ( '#' === substr( $markerline, 0, 1 ) ) {
     83                                continue;
     84                        }
    8285                        $result[] = $markerline;
    8386                }
    8487                if ( false !== strpos( $markerline, '# BEGIN ' . $marker ) ) {
     
    119122                $insertion = explode( "\n", $insertion );
    120123        }
    121124
     125        $switched_locale = switch_to_locale( get_locale() );
     126
     127        $instructions = sprintf(
     128                /* translators: 1: marker */
     129                __( 'The directives (lines) between `BEGIN %1$s` and `END %1$s` are
     130dynamically generated, and should only be modified via WordPress filters.
     131Any changes to the directives between these markers will be overwritten.' ),
     132                $marker
     133        );
     134
     135        $instructions = explode( "\n", $instructions );
     136        foreach ( $instructions as $line => $text ) {
     137                $instructions[ $line ] = '# ' . $text;
     138        }
     139
     140        /**
     141         * Filters the inline instructions inserted before the dynamically generated content.
     142         *
     143         * @since 5.3.0
     144         *
     145         * @param string[] $instructions Array of lines with inline instructions.
     146         * @param string   $marker       The marker being inserted.
     147         */
     148        $instructions = apply_filters( 'insert_with_markers_inline_instructions', $instructions, $marker );
     149
     150        if ( $switched_locale ) {
     151                restore_previous_locale();
     152        }
     153
     154        $insertion = array_merge( $instructions, $insertion );
     155
    122156        $start_marker = "# BEGIN {$marker}";
    123157        $end_marker   = "# END {$marker}";
    124158