Jak manipulować DOM za pomocą PHP

Jeśli chodzi o manipulowanie DOM, pierwszą rzeczą, o której wielu z nas prawdopodobnie pomyśli, jest użycie JavaScript do robienia tego, co musimy zrobić.

Język nie tylko natywnie obsługuje funkcje do tego celu, ale nowsze funkcje ES6 dają nam bardziej zaawansowane sposoby tworzenia skryptów po stronie klienta. A jeśli używasz jQuery z WordPressem, masz taką samą bibliotekę funkcji do, hm, odpytywania DOM, którą mamy od lat.

Ale manipulowanie DOM po stronie klienta nie zawsze jest najlepszą opcją. Zamiast tego możesz to zrobić po stronie serwera. A ze względu na niektóre funkcje wbudowane w PHP, nie różni się on zbytnio od tego, jak robimy rzeczy przy użyciu JavaScript.

Poza tym oczywiście robimy to na serwerze.

Więc jeśli kiedykolwiek pracujesz z treścią posta (typ posta lub niestandardowy typ posta, jeśli o to chodzi) i musisz manipulować tagami podobnie jak w przypadku JavaScript, użycie DomDocumentbiblioteki jest jednym z najpotężniejszych narzędzia są do Twojej dyspozycji.

Załóżmy na przykład, że chcesz przejść przez wszystkie elementy akapitu, które istnieją w treści posta.

Łatwo to zrobić za pomocą wspomnianej biblioteki. Najpierw upewnij się, że masz skonfigurowaną bibliotekę w swojej klasie (lub po prostu w swojej kolekcji funkcji):

Następnie skonfiguruj hak dla treści:

<?php

add_filter('the_content', __NAMESPACE__. 'updateParagraphElements');

W ramach tej funkcji upewnij się, że załadowałeś treść posta do biblioteki, a następnie poszukaj wszystkich pelementów, podobnie jak przy użyciu JavaScript (z jedną ważną uwagą, że musisz poprawnie zakodować informacje na wypadek, gdyby indeksy górne lub emotikony były używany):

<?php

function updateParagraphElements($content) 
{
    /* If we're not on a single page or it's not the main query, 
     * we won't do anything.
     */
    if (!is_single() || !is_main_query()) {
        return $content;
    }

    // Make sure there is content to parse (and properly encode the HTML entities).
    $domDocument = new DOMDocument();
    $domContent = $domDocument->loadHTML(mb_convert_encoding($content, 'HTML-ENTITIES'));
    if (false === $domContent) {
        return $content;
    }

    $paragraphs = $domDocument->getElementsByTagName('p');
    if (0 === count($paragraphs)) {
        return $content;
    }

    // More to come...
}

Z tego miejsca możesz zrobić kilka różnych rzeczy, takich jak dodanie identyfikatora posta do niestandardowego atrybutu każdego elementu akapitu. Pełna funkcja wyglądałaby wtedy mniej więcej tak:

<?php

namespace Acme;

use DOMDocument;

add_filter('the_content', __NAMESPACE__. 'updateParagraphElements');
/**
 * Updates the content by locating all of the `p` elements in the content,
 * then adds a class attribute of the post ID to them.
 *
 * The gist of the work is done in this function.
 *
 * @param string $content the post content
 *
 * @return string the updated post content with the aforemented markup.
 */
function updateParagraphElements($content) 
{
    /* If we're not on a single page or it's not the main query, 
     * we won't do anything.
     */
    if (!is_single() || !is_main_query()) {
        return $content;
    }

    // Make sure there is content to parse (and properly encode the HTML entities).
    $domDocument = new DOMDocument();
    $domContent = $domDocument->loadHTML(mb_convert_encoding($content, 'HTML-ENTITIES'));
    if (false === $domContent) {
        return $content;
    }

    $paragraphs = $domDocument->getElementsByTagName('p');
    if (0 === count($paragraphs)) {
        return $content;
    }

    // If so, iterate through the elements and add the post ID as a custom attribute.
    $updatedContent = '';
    foreach ($paragraphs as $paragraph) {
        $paragraph->setAttribute('data-id', get_the_ID());
    }

    return wp_kses_post($domDocument->saveHTML());
}

Oczywiście są też inne rzeczy, które możesz zrobić. Jedną rzeczą jest manipulowanie znacznikami przed wysłaniem ich do przeglądarki. Inną rzeczą jest jednak dodawanie atrybutów do danych, jeśli jeszcze nie istnieją.

To znaczy, żadna gra słów nie przeznaczona – z wyjątkiem może tylko pewnego rodzaju – treści do innego posta.