„WordPress REST“ API turinio pašalinimo problemos sprendimas

Kodėl jūsų „WordPress REST“ API įrašai praranda turinį

Kaip kūrėjas, jūs greičiausiai susidūrėte su nusivylimu naudoti „WordPress REST“ API, kad sukurtumėte pasirinktinius įrašus, tik norėdami sužinoti, kad jūsų turinio dalis paslaptingai išnyko. Ši problema gali būti ypač erzinanti, kai esate įsitikinęs, kad įvestis yra teisingas, tačiau „WordPress“ jo nepadaro taip, kaip tikėtasi.

Šis konkretus iššūkis dažnai kyla naudojant pažangius blokus ar papildinius, tokius kaip „Kadence“. Daugeliu atvejų „WordPress“ taiko vidinius filtrus arba sanitarijos procesus, kurie pašalina nepalaikomą ar netinkamai suformatuotą turinį. Problema tampa dar sudėtingesnė, kai dalyvauja dinaminiai blokai ar pasirinktiniai parametrai.

Įsivaizduokite, kad praleisite valandas tobulinant išdėstymą su fono vaizdais, unikaliais ID ir reaguojančiais nustatymais, tik norėdami pamatyti, kad kruopščiai suprojektuotos detalės išnyksta į ploną orą. Tai yra įprastas scenarijus kūrėjams, kurie remiasi tokiais papildiniais kaip „Kadence“, kad pateiktų turtingus išdėstymus per REST API.

Nesijaudinkite, tai nėra neišsprendžiama paslaptis. Suprasdami, kaip „WordPress“ tvarko turinio sanitariją ir pritaikydami keletą geriausių praktikų, galite užtikrinti, kad jūsų API skambučiai pateiktų norimus rezultatus be jokių nepageidaujamų netikėtumų. 🚀 Pasinerkime į tai, kaip tai ištaisyti kartą ir visiems laikams!

Kaip užkirsti kelią turiniui nuimti „WordPress REST“ API

Pirmasis mano pateiktas sprendimas apima naudojimą REST_PRE_INSERT_POST Filtruokite „WordPress“. Šis filtras leidžia kūrėjams modifikuoti įrašų duomenis, kol jis nėra išsaugomas duomenų bazėje per REST API. Prisirišę prie šio filtro, galite nepaisyti „WordPress“ numatytojo sanitarijos elgesio ir įterpti neapdorotą turinį tiksliai taip, kaip numatyta. Pvz., Scenarijuje API užklausoje patikriname pasirinktinį lauką, pavadintą „Content_Raw“, užtikrinant, kad RAW HTML turinys būtų išsaugotas neišnaikinus. Tai ypač naudinga tokiems papildiniams kaip „Kadence“, kur išdėstymas priklauso nuo pasirinktinių blokų struktūrų ir metaduomenų. 🚀

Antrasis sprendimas pristato pasirinktinį REST API baigtį naudojant registre_rest_route. Šis metodas suteikia kūrėjams visiškai valdyti, kaip įrašymo duomenys yra apdorojami ir saugomi. Šiame pasirinktiniame taške neapdorotas API užklausos turinys tiesiogiai perduodamas „WordPress“ duomenų bazei naudojant wp_insert_post funkcija. Tai apeina numatytuosius REST API filtrus ir užtikrina, kad sudėtingos HTML ar blokų konfigūracijos būtų išsaugotos be modifikavimo. Pvz., Individualizuotas išdėstymas, sukurtas su „Kadence“ blokais, išliks nepažeistas, net jei jame bus pažangių nustatymų, tokių kaip fono vaizdai ar reaguojantys išdėstymai.

„Frontend“ pademonstravau, kaip naudoti „JavaScript“ norint pateikti API užklausas, tuo pačiu išsaugodamas neapdorotą turinį. Pavyzdyje naudojamas Fetch API, modernus būdas tvarkyti HTTP užklausas „JavaScript“. Šiame scenarijuje neapdorotas HTML turinys perduodamas „turinio“ parametrui, o autentifikavimas yra tvarkomas naudojant bazę64 koduotą vartotojo vardą ir slaptažodį Leidimas antraštė. Šis metodas yra būtinas kūrėjams, kurianti interaktyvius ar dinaminius frontendus, kuriems reikia perkelti neapdorotą turinį į „WordPress“, nepasikliaujant administratoriaus sąsaja.

Visi scenarijai apima kritines funkcijas, tokias kaip klaidų tvarkymas ir įvesties patvirtinimas, kad jie teisingai veiktų realaus pasaulio scenarijuose. Pavyzdžiui, pasirinktinis galas naudoja IS_WP_ERROR Funkcija aptikti ir tvarkyti klaidas, teikiant prasmingą grįžtamąjį ryšį, jei kažkas nutinka ne taip. Šis požiūris garantuoja, kad kūrėjai gali greitai pašalinti problemas, užtikrindami sklandų turinio pristatymą. Įsivaizduokite, kad sukurkite vizualiai stulbinantį kliento išdėstymą, tik norėdami jį iš dalies nuimti „WordPress“ - šie scenarijai užtikrina, kad niekada neįvyks! 🛠️

// 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));

Suprasti „WordPress REST API“ turinio tvarkymą

„WordPress REST“ API yra galingas įrankis, leidžiantis kūrėjams programiškai kurti, skaityti, atnaujinti ir ištrinti įrašus. Tačiau vienas mažiau aptariamas aspektas yra tai, kaip „WordPress“ apdoroja turinį prieš išsaugodamas jį į duomenų bazę. Naudojant REST API, „WordPress“ taiko filtrų ir sanitarinių veiksmų seriją, kad užtikrintų saugų ir suderinamą turinį su jo vidinėmis sistemomis. Nors tai puikiai tinka saugumui, tai gali sukelti problemų kūrėjams, dirbantiems su pasirinktine HTML, arba blokus nuo papildinių, tokių kaip „Kadence“. Pvz., Sudėtingi išdėstymai su pasirinktiniais metaduomenimis ar blokų konfigūracijomis gali būti iš dalies pašalinami, nes „WordPress“ juos neteisingai interpretuoja. 🛠️

Kitas kritinis veiksnys yra tai, kaip LEST API sąveikauja su dinaminiai blokai. Šie blokai pateikiami priekyje naudojant PHP, o ne išsaugojami kaip statinis HTML. Jei jūsų pasirinktinis blokas nėra tinkamai registruotas arba API jo neatpažįsta, kai kurios jūsų bloko konfigūracijos gali netinkamai išsaugoti. Taip atsitinka todėl, kad „WordPress“ bando išanalizuoti ir patvirtinti bloko žymėjimą išsaugojimo proceso metu, o tai gali netyčia pašalinti esmines jūsų turinio dalis. Norėdami to išvengti, svarbu naudoti tinkamą bloko registraciją su atributais, atitinkančiais jūsų API turinį.

Norėdami išspręsti šiuos iššūkius, kūrėjai dažnai apeina standartinius REST API filtrus, sukurdami pasirinktinius galinius taškus arba viršijant konkretų „WordPress“ elgesį. Pavyzdžiui, filtrų naudojimas patinka REST_PRE_INSERT_POST Leidžia švirkšti RAW HTML be trikdžių. Atidžiai pritaikydami šiuos sprendimus, galite dirbti pagal „WordPress“ numatytąjį apdorojimą ir įsitikinti, kad sudėtingi išdėstymai ir dizainai išliks nepažeisti. Įsivaizduokite, kad sukurkite stulbinantį reklamjuostę su „Kadence“ bloku, tik norėdami pamatyti, kad ji neteisingai pateikta ant priekinės dalies - šie sprendimai neleidžia tai įvykti! 🚀