Résolution des problèmes de décapage de contenu de l'API de repos wordpress

Pourquoi vos articles API WordPress REST perdent du contenu

En tant que développeur, vous avez probablement rencontré la frustration d'utiliser l'API WordPress REST pour créer des publications personnalisées, seulement pour constater que la partie de votre contenu a mystérieusement disparu. Ce problème peut être particulièrement ennuyeux lorsque vous êtes convaincu que l'entrée est correcte, mais WordPress ne le rend pas comme prévu.

Ce défi spécifique survient souvent lors de l'utilisation de blocs avancés ou de plugins comme Kadence. Dans de nombreux cas, WordPress applique des filtres internes ou des processus de désinfection qui éliminent le contenu non pris en charge ou mal formaté. Le problème devient encore plus délicat lorsque des blocs dynamiques ou des paramètres personnalisés sont impliqués.

Imaginez passer des heures à perfectionner une disposition avec des images d'arrière-plan, des identifiants uniques et des paramètres réactifs, uniquement pour voir ces détails soigneusement conçus disparaître dans l'air. C'est un scénario commun pour les développeurs qui s'appuient sur des plugins comme Kadence pour offrir des dispositions riches via l'API REST.

Mais ne vous inquiétez pas, ce n'est pas un mystère insoluble. En comprenant comment WordPress gère la désinfection du contenu et en appliquant quelques meilleures pratiques, vous pouvez vous assurer que vos appels API fournissent les résultats souhaités sans aucune surprise indésirable. 🚀 Plongeons comment réparer ceci une fois pour toutes!

Comment empêcher le décapage du contenu dans API REST WordPress

La première solution que j'ai présentée implique d'utiliser le rest_pre_insert_post Filtre dans WordPress. Ce filtre permet aux développeurs de modifier les données du post avant d'être enregistrées dans la base de données via l'API REST. En vous connectant à ce filtre, vous pouvez remplacer le comportement de désinfection par défaut de WordPress et insérer le contenu brut exactement comme prévu. Par exemple, dans le script, nous vérifions un champ personnalisé appelé "content_raw" dans la demande de l'API, garantissant que le contenu HTML brut est conservé sans être dépouillé. Ceci est particulièrement utile pour les plugins comme Kadence, où la disposition s'appuie sur des structures de blocs personnalisées et des métadonnées. 🚀

La deuxième solution introduit un point de terminaison API REST personnalisé à l'aide registre_rest_route. Cette méthode donne aux développeurs un contrôle complet sur la façon dont les données du post sont traitées et stockées. Dans ce point de terminaison personnalisé, le contenu brut de la demande d'API est directement transmis à la base de données WordPress à l'aide du wp_insert_post fonction. Cela contourne les filtres API REST par défaut et garantit que les configurations HTML ou blocs complexes sont enregistrées sans modification. Par exemple, une disposition personnalisée créée avec des blocs Kadence restera intacte, même si elle comprend des paramètres avancés comme des images d'arrière-plan ou des dispositions réactives.

Sur le frontend, j'ai démontré comment utiliser JavaScript pour faire des demandes d'API tout en préservant le contenu brut. L'exemple utilise le aller chercher API, une façon moderne de gérer les demandes HTTP en JavaScript. Dans ce scénario, le contenu HTML brut est passé dans le paramètre "Contenu" de la demande de post, et l'authentification est gérée via un nom d'utilisateur et un mot de passe codés en base de base64 dans le Autorisation en-tête. Cette méthode est essentielle pour les développeurs qui construisent des fronts interactifs ou dynamiques qui doivent pousser le contenu brut sur WordPress sans compter sur l'interface administrateur.

Tous les scripts incluent des fonctionnalités critiques comme la gestion des erreurs et la validation d'entrée pour s'assurer qu'ils fonctionnent correctement dans les scénarios du monde réel. Par exemple, le point de terminaison personnalisé utilise le is_wp_error Fonctionne pour détecter et gérer les erreurs, en fournissant des commentaires significatifs en cas de problème. Cette approche garantit que les développeurs peuvent résoudre rapidement les problèmes, garantissant une livraison de contenu transparente. Imaginez créer une disposition de post visuellement époustouflante pour un client, pour la trouver partiellement dépouillé dans WordPress - ces scripts garantissent que cela ne se produit jamais! 🛠️

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

Comprendre la manipulation du contenu de l'API WordPress REST

L'API WordPress REST est un outil puissant qui permet aux développeurs de créer, de lire, de mettre à jour et de supprimer les articles par programme. Cependant, un aspect moins discuté est la façon dont WordPress traite le contenu avant de l'enregistrer dans la base de données. Lorsque vous utilisez l'API REST, WordPress applique une série de filtres et d'étapes de désinfection pour garantir que le contenu est sûr et compatible avec ses systèmes internes. Bien que cela soit excellent pour la sécurité, cela peut entraîner des problèmes pour les développeurs travaillant avec HTML ou des blocs personnalisés de plugins comme Kadence. Par exemple, des dispositions complexes avec des métadonnées personnalisées ou des configurations de blocs peuvent être partiellement éliminées, car WordPress les interprète incorrectement. 🛠️

Un autre facteur critique est la façon dont l'API REST interagit blocs dynamiques. Ces blocs sont rendus sur le frontend en utilisant PHP au lieu d'être enregistrés comme HTML statique. Si votre bloc personnalisé n'est pas enregistré correctement ou si l'API ne le reconnaît pas, certaines de vos configurations de bloc peuvent ne pas enregistrer correctement. Cela se produit parce que WordPress essaie d'analyser et de valider le balisage de blocs pendant le processus de sauvegarde, qui peut retirer par inadvertance les parties essentielles de votre contenu. Pour éviter cela, il est important d'utiliser un enregistrement de bloc approprié avec des attributs qui correspondent à votre contenu API.

Pour relever ces défis, les développeurs contournent souvent les filtres API REST standard en créant des points de terminaison personnalisés ou en dépassant des comportements WordPress spécifiques. Par exemple, l'utilisation de filtres comme rest_pre_insert_post vous permet d'injecter du HTML brut sans interférence. En adaptant soigneusement ces solutions, vous pouvez contourner le traitement par défaut de WordPress et vous assurer que vos dispositions et conceptions complexes restent intacts. Imaginez créer une bannière étonnante avec un bloc Kadence, seulement pour le voir incorrectement sur le frontend - ces solutions empêchent cela de se produire! 🚀