Si inserisce un post all’interno del cms wordpress grazie ad una semplice funzione che adesso vi illustro ed e` wp_insert_post().
Come usare la funzione wp_insert_post in WordPress per inserire post personalizzati
La funzione wp_insert_post di WordPress ti consente di inserire post personalizzati nel database del tuo sito web tramite codice. Con questo potente strumento, puoi creare e gestire senza sforzo contenuti dinamici, superando i limiti del processo di creazione di post standard.
Se hai bisogno di automatizzare la generazione di contenuti, gestire tipi di post personalizzati o assegnare metadati e tassonomie tramite codice, wp_insert_post è la soluzione che stavi cercando.
Questo articolo svelerà i vantaggi dell’utilizzo della funzione wp_insert_post ed esplorerà i suoi parametri. Ti guideremo anche attraverso esempi pratici, illustrando come utilizzare questa funzione per creare, personalizzare e gestire vari tipi di post.
Perché usare la funzione wp_insert_post
Creare e gestire manualmente i post può richiedere molto tempo, soprattutto con un volume di contenuti elevato. È particolarmente evidente quando si esportano i post di WordPress su un nuovo sito web.
Fortunatamente, con la funzione wp_insert_post, puoi semplificare il flusso di lavoro di creazione dei post e automatizzare in modo efficiente la generazione di contenuti. Ciò non solo fa risparmiare tempo, ma riduce anche al minimo il rischio di errori umani durante l’immissione dei dati, garantendo che i tuoi contenuti siano costantemente accurati.
Inoltre, WordPress supporta vari tipi di post per scopi diversi, come post di blog, pagine, prodotti o tipi di post personalizzati. La versatilità di wp_insert_post ti consente di personalizzare la struttura dei tuoi contenuti in base ai requisiti specifici del tuo sito web.
Parametri per wp_insert_post
Come altre funzioni di WordPress come get_posts, anche la funzione wp_insert_post ha vari parametri per facilitare l’inserimento di post personalizzati. Ecco alcuni dei parametri chiave con cui dovresti avere familiarità:
ID: l’ID del post da aggiornare. Se fornito, la funzione tenterà di modificare il post con l’ID specificato. Il valore predefinito è 0 (nessun aggiornamento).
post_author: l’ID dell’autore del post. Il valore predefinito è l’ID utente corrente.
post_content: il contenuto del post. Il valore predefinito è una stringa vuota.
post_content_filtered: il contenuto del post filtrato. Il valore predefinito è una stringa vuota.
post_title: il titolo del post. Il valore predefinito è una stringa vuota.
post_status: lo stato del post (ad esempio, pubblica, bozza, privato). Lo stato predefinito del post è pubblica.
post_type: il tipo di post (ad esempio, post, pagina, tipo di post personalizzato). Il valore predefinito è post.
post_date: la data del post. Il valore predefinito è la data e l’ora correnti.
post_excerpt: L’estratto del post. L’estratto del post predefinito è una stringa vuota.
post_name: Lo slug del post (versione URL-friendly del titolo). Il valore predefinito è il titolo del post sanificato.
post_parent: L’ID del post padre (se il post è figlio di un altro post). Il post padre predefinito è 0 (nessun genitore).
post_password: La password per proteggere il post (se protetto da password). Il valore predefinito è una stringa vuota.
post_category: Un array di ID categoria da assegnare al post. Il valore predefinito è un array vuoto.
tags_input: Un array di tag da assegnare al post. Il valore predefinito è un array vuoto.
tax_input: Un array di tassonomie e termini da assegnare al post. Il valore predefinito è un array vuoto.
meta_input: Un array di valori meta del post codificati dalla chiave meta del post. Il valore predefinito è un array vuoto.
La sintassi di base della funzione wp_insert_post è la seguente:
$post_id = wp_insert_post( $args, $wp_error );
$args è un array contenente i dati del post e i relativi parametri, mentre $wp_error è impostato su true per restituire un oggetto WP_Error in caso di errore. Quando viene eseguita, la funzione restituisce l’ID del post appena inserito in caso di successo o un oggetto di gestione degli errori in caso contrario.
$my_post = array( 'post_title'=> 'Titolo', 'post_content'=>'Testo contenuto', 'post_type'=>'post', 'post_status'=> 'publish', 'post_date'=> date( 'Y-m-d H:i:s', time() ), ); $new_post_id=wp_insert_post($my_post);