Reševanje težav z odvzemom vsebine WordPress Rest API

Zakaj vaše objave WordPress REST API izgubijo vsebino

Kot razvijalec ste verjetno naleteli na frustracije, ker je uporabil API WordPress REST za ustvarjanje objav po meri, le da bi ugotovili, da je del vaše vsebine skrivnostno izginil. Ta težava je lahko še posebej moteča, ko ste prepričani, da je vnos pravilen, vendar WordPress tega ne predstavlja po pričakovanjih.

Ta poseben izziv se pogosto pojavi pri uporabi naprednih blokov ali vtičnikov, kot je Kadence. V mnogih primerih WordPress uporablja notranje filtre ali postopke sanizacije, ki odstranijo nepodprto ali nepravilno oblikovano vsebino. Težava postane še bolj zapletena, ko so vključeni dinamični bloki ali nastavitve po meri.

Predstavljajte si, da preživite ure, ki izpopolnjujejo postavitev s slikami ozadja, edinstvenimi ID -ji in odzivnimi nastavitvami, le da vidite tiste skrbno oblikovane podrobnosti, ki izginejo v zraku. To je pogost scenarij za razvijalce, ki se zanašajo na vtičnike, kot je Kadence, da bi prek API -ja za preostale postavile bogate postavitve.

Toda ne skrbite, to ni nerešljiva skrivnost. Če razumete, kako WordPress obravnava čiščenje vsebine in uporabite nekaj najboljših praks, lahko zagotovite, da vaši klici API -ja prinesejo želene rezultate brez kakršnih koli nezaželenih presenečenj. 🚀 Potopimo se, kako to popraviti enkrat za vselej!

Kako preprečiti odstranjevanje vsebine v API -ju WordPress Rest

Prva rešitev, ki sem jo predstavil REST_PRE_INSERT_POST filter v WordPress. Ta filter omogoča razvijalcem, da spremenijo podatke o pošti, preden se shranijo v bazo podatkov prek API -ja REST. Z priklopom v ta filter lahko preglasite privzeto vedenje sanizacije WordPress in vstavite surovo vsebino točno tako, kot je predvideno. Na primer, v skriptu preverimo polje po meri, imenovano "Content_raw" v zahtevi API -ja in zagotovimo, da je vsebina RAW HTML ohranjena, ne da bi jo slekli. To je še posebej koristno za vtičnike, kot je Kadence, kjer se postavitev opira na strukture blokov po meri in metapodatke. 🚀

Druga rešitev uvaja končno točko API -ja po meri register_rest_route. Ta metoda daje razvijalcem popoln nadzor nad obdelavo in shranjevanjem podatkov o objavi. V tej končni točki po meri se surova vsebina iz zahteve API neposredno prenese v bazo podatkov WordPress s pomočjo wp_insert_post delovanje. Ta zaobide privzete filtre REST in zagotavlja, da se kompleksne konfiguracije HTML ali blokov shranijo brez sprememb. Na primer, postavitev po meri, ustvarjena z bloki Kadence, bo ostala nedotaknjena, tudi če vključuje napredne nastavitve, kot so slike ozadja ali odzivne postavitve.

Na Frontendu sem pokazal, kako uporabljati JavaScript za postavitev zahtevkov API -ja ob ohranjanju surove vsebine. Primer uporablja Pridobi API, sodoben način za obravnavo zahtev HTTP v JavaScript. V tem scenariju se vsebina RAW HTML posredova v parametru "vsebine" zahteve po objavi, overjanje pa se obravnava prek uporabniškega imena in gesla, ki je kodirano z Base64 v Pooblastilo glava. Ta metoda je bistvenega pomena za razvijalce, ki gradijo interaktivne ali dinamične fronte, ki morajo potisniti surovo vsebino na WordPress, ne da bi se zanašali na skrbniški vmesnik.

Vsi skripti vključujejo kritične funkcije, kot so ravnanje z napakami in preverjanje vhoda, da se zagotovijo pravilno v resničnih scenarijih. Na primer, končna točka po meri uporablja is_wp_error funkcija za zaznavanje in ravnanje z napakami, ki zagotavljajo smiselne povratne informacije, če gre kaj narobe. Ta pristop zagotavlja, da lahko razvijalci hitro odpravljajo težave in tako zagotovijo brezhibno dostavo vsebin. Predstavljajte si, da bi za stranko ustvarili vizualno osupljivo postavitev objav, le da bi jo našli v WordPress - ti skripti zagotavljajo, da se nikoli ne zgodi! 🛠️

// Solution 1: Disable REST API content sanitization and allow raw HTML// Add this code to your WordPress theme's functions.php file<code>add_filter('rest_pre_insert_post', function ($data, $request) {
    // Check for specific custom post type or route
    if (isset($request['content_raw'])) {
        $data['post_content'] = $request['content_raw']; // Set the raw content
    }
    return $data;
}, 10, 2);

// Make sure you’re passing the raw content in your request
// Example POST request:
// In your API request, ensure `content_raw` is passed instead of `content`.
let data = {
    title: 'My Post Title',
    content_raw: my_post,
    status: 'draft'
};
// Send via an authenticated REST client

// Add this code to your theme's functions.php or a custom plugin file<code>add_action('rest_api_init', function () {
    register_rest_route('custom/v1', '/create-post', array(
        'methods' => 'POST',
        'callback' => 'custom_create_post',
        'permission_callback' => '__return_true',
    ));
});
function custom_create_post($request) {
    $post_data = array(
        'post_title' => sanitize_text_field($request['title']),
        'post_content' => $request['content'], // Raw content passed here
        'post_status' => $request['status'],
    );
    $post_id = wp_insert_post($post_data);
    if (is_wp_error($post_id)) {
        return new WP_Error('post_error', 'Failed to create post', array('status' => 500));
    }
    return new WP_REST_Response(array('post_id' => $post_id), 200);
}

// Example using JavaScript to post raw content via the WordPress REST API<code>const rawContent = `<!-- wp:kadence/rowlayout {\"uniqueID\":\"5331_605d8b-3f\"} -->`;
const data = {
    title: "My Custom Post",
    content: rawContent,
    status: "draft"
};
fetch('https://mywp.xyz/wp-json/wp/v2/posts', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Basic ' + btoa('username:password')
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));

Razumevanje WordPress REST API -ja

WordPress REST API je močno orodje, ki razvijalcem omogoča, da programsko ustvarjajo, berejo, posodabljajo in brišejo objave. Vendar pa je en manj razpravljan vidik, kako WordPress obdeluje vsebino, preden jo shrani v bazo podatkov. Pri uporabi API -ja REST WordPress uporabi vrsto filtrov in korakov za čiščenje, da se zagotovi varna vsebina in združljiva z njegovimi notranjimi sistemi. Čeprav je to odlično za varnost, lahko povzroči težave razvijalcem, ki delajo s HTML po meri ali bloke iz vtičnikov, kot je Kadence. Na primer, zapletene postavitve z metapodatki po meri ali konfiguracije blokov so lahko delno odstranjene, saj jih WordPress nepravilno razlaga. 🛠️

Drug kritični dejavnik je, kako sodeluje API REST dinamični bloki. Ti bloki so na sprednji strani predstavljeni z uporabo PHP, namesto da bi bili shranjeni kot statični HTML. Če vaš blok po meri ni pravilno registriran ali ga API ne prepozna, nekatere konfiguracije blokov morda ne bodo pravilno shranjene. To se zgodi, ker WordPress poskuša razčleniti in potrditi oznako bloka med postopkom shranjevanja, kar lahko nenamerno odstrani bistvene dele vsebine. Da bi to preprečili, je pomembno, da uporabite pravilno registracijo blokov z atributi, ki ustrezajo vaši vsebini API -ja.

Za reševanje teh izzivov razvijalci pogosto zaobidejo standardne filtre REST API z ustvarjanjem končnih točk po meri ali prevladujejo v določenem vedenju WordPress. Na primer uporaba filtrov, kot so REST_PRE_INSERT_POST Omogoča vam vbrizgavanje surovega HTML brez motenj. S skrbnim prilagajanjem teh rešitev lahko obdelate privzeto obdelavo WordPresa in zagotovite, da bodo vaše zapletene postavitve in modeli ostale nedotaknjene. Predstavljajte si, da ustvarite osupljiv transparent z blokom Kadence, le da bi ga videli, da je napačno na sprednji strani - te rešitve preprečujejo, da bi se to zgodilo! 🚀