Функция parse_blocks() в WordPress: Парсинг контента и возврат массива блоков

В этой статье мы рассмотрим функцию parse_blocks() в WordPress, которая используется для парсинга контента и возврата массива блоков Gutenberg. Эта функция полезна для разработчиков, которые хотят анализировать или модифицировать структуру блоков в постах и страницах.

Описание функции

Функция parse_blocks() разбирает контент поста, содержащий блоки Gutenberg, и возвращает его в виде массива блоков.

parse_blocks( $content )

Параметры:

• $content (строка): Контент, который нужно распарсить.

Возвращаемое значение:

• Массив блоков.

Примеры использования

Рассмотрим несколько примеров использования функции parse_blocks().

Парсинг контента поста и вывод названий блоков

Этот пример показывает, как распарсить контент поста и вывести названия всех блоков:

function display_block_names( $post_id ) {
    $post = get_post( $post_id );
    $blocks = parse_blocks( $post->post_content );

    foreach ( $blocks as $block ) {
        echo '<p>Block Name: ' . esc_html( $block['blockName'] ) . '</p>';
    }
}

Получение всех абзацев из контента

Вы можете получить все абзацы из контента, распарсив его и отфильтровав блоки типа core/paragraph:

function get_all_paragraphs( $content ) {
    $blocks = parse_blocks( $content );
    $paragraphs = array();

    foreach ( $blocks as $block ) {
        if ( $block['blockName'] === 'core/paragraph' ) {
            $paragraphs[] = $block['innerHTML'];
        }
    }

    return $paragraphs;
}

// Пример использования:
$content = '<!-- wp:paragraph --><p>Первый абзац.</p><!-- /wp:paragraph --><!-- wp:paragraph --><p>Второй абзац.</p><!-- /wp:paragraph -->';
$paragraphs = get_all_paragraphs( $content );

foreach ( $paragraphs as $paragraph ) {
    echo $paragraph;
}

Изменение контента определённого блока

Этот пример показывает, как изменить контент всех блоков типа core/heading в посте:

function modify_heading_blocks( $content ) {
    $blocks = parse_blocks( $content );

    foreach ( $blocks as &$block ) {
        if ( $block['blockName'] === 'core/heading' ) {
            $block['innerHTML'] = '<h2>Modified Heading</h2>';
        }
    }

    return serialize_blocks( $blocks );
}

// Пример использования:
$content = '<!-- wp:heading --><h2>Original Heading</h2><!-- /wp:heading -->';
$modified_content = modify_heading_blocks( $content );
echo $modified_content;

Подсчёт количества блоков в контенте

Этот пример показывает, как подсчитать количество блоков в контенте:

function count_blocks( $content ) {
    $blocks = parse_blocks( $content );
    return count( $blocks );
}

// Пример использования:
$content = '<!-- wp:paragraph --><p>Текст</p><!-- /wp:paragraph --><!-- wp:heading --><h2>Заголовок</h2><!-- /wp:heading -->';
$block_count = count_blocks( $content );
echo 'Количество блоков: ' . $block_count;

Заключение по parse_blocks

Функция parse_blocks() предоставляет разработчикам мощный инструмент для анализа и модификации структуры блоков в контенте WordPress. Используя её, можно легко извлекать, изменять и подсчитывать блоки в постах и страницах.

Попробуйте интегрировать parse_blocks() в ваши проекты, чтобы улучшить управление контентом и создать более динамичные и интерактивные сайты. Если у вас есть вопросы или предложения, оставляйте комментарии ниже!