Comment créer des articles et des pages en utilisant du code

Les fonctionnalités de WordPress vous permettent d’ajouter des articles et des pages facilement avec l’éditeur sur votre site web. Savez-vous qu’il est également très simple de le faire en quelques lignes de code via votre thème ou un plugin personnalisé ?

Vous pouvez ajouter des articles, des pages et des types d’articles personnalisés avec une seule fonction et quelques paramètres. Rien de plus n’est nécessaire. Voyons ensemble ce code.

Créer un article avec la fonction wp_insert_post

La fonction à utiliser est wp_insert_post() ; vous pouvez en trouver la documentation complète ici (en anglais).

Il existe un autre moyen de créer des articles par programmation avec SQL (avec $wpdb->prepare & $wpdb->query), mais nous ne recommandons pas cette méthode puisque wp_insert_post devrait couvrir tous vos besoins.

Les paramètres et un exemple sont expliqués ci-dessous.

Les paramètres de la fonction wp_insert_post expliqués

Exemple d’un nouvel article simple ajouté en développant quelques lignes :

$post_id = wp_insert_post( 
		array( 
			'post_content'          => 'Mon contenu ici', 
			'post_category'         => array( 1, 2 ), 
			'post_title'            => 'Mon titre ici', 
			'post_status'           => 'publish',
			'post_author'           => 1
		) 
	);

Vous pouvez constater que seuls cinq paramètres (et même moins) peuvent faire l’affaire !

Dans l’exemple ci-dessus, la variable $post_id renverra l’ID du nouvel article, ou false si l’article ne peut être créé.

Voyons chaque paramètre d’importation :

• ID : si vous voulez créer un nouvel article, n’incluez pas ce paramètre, il sera généré automatiquement. Si vous fournissez l’ID d’un article existant, celui-ci sera mis à jour avec le nouveau contenu fourni.
• post_author : l’ID de l’auteur. Si vous ne fournissez pas ce paramètre, l’article ne sera attribué à aucun auteur WordPress.
• post_date : la date de la article. Si vous ne fournissez pas ce paramètre, ce sera la date actuelle. Si vous voulez une autre date, vous devez mettre une date selon ce format : date( ‘Y-m-d H:i:s’, time() ).
• post_content : le contenu de l’article.
• post_title : le titre l’article.
• post_excerpt : l’extrait de l’article.
• post_type : votre type d’élément. Par défaut, il s’agit d’un “article”, mais vous pouvez également définir “page” ou votre type de post personnalisé.
• post_category : les identifiants de catégorie, dans un tableau.
• tags_input: les identifiants des tags dans un tableau. Vous pouvez aussi mettre des noms de tags ou des slugs.
• post_status : le statut de votre message. Par exemple, publié (par défaut), brouillon ou programmé.
• post_parent : id d’un article parent, si fourni.

Si vous avez besoin de plus d’options, vous pouvez lire la description ici.

Où mettre ce code ?

Les bonnes pratiques de WordPress suggèrent d’ajouter vos fonctionnalités personnalisées dans un nouveau plugin personnalisé (et non dans le thème).

Si vous ajoutez votre code dans le fichier functions.php de votre thème, cela fonctionnera sans problème même si ce n’est pas là façon de faire la plus recommandée.

Vous pouvez également utiliser un hook pour insérer un nouvel article ; la plupart des hooks sont listés ici (en anglais).