Panoramica
L’API di Advanced Custom Field rende molto facile la visualizzazione dei dati dei campi nel tuo tema. Ci sono molte funzioni disponibili e tutte sono ben documentate nella pagina delle risorse.
Le basi
Una volta creato un gruppo di campi e inseriti alcuni dati, ora puoi caricare e visualizzare i dati nel tuo tema.
Tutti i valori vengono salvati come post_meta nativi (quando vengono salvati in un post) e sebbene tu possa usare la funzione nativa di WP get_post_meta()
, è meglio usare la relativa funzione ACF come get_field()
. Perché? Perché ACF formatterà il valore a seconda del tipo di campo e renderà lo sviluppo più facile e veloce!
Per recuperare il valore di un campo come variabile, usa la funzione get_field(). Questa è la funzione più versatile che restituirà sempre un valore per qualsiasi tipo di campo.
Per visualizzare un campo, usate the_field() in modo simile.
Qui c’è un esempio di utilizzo di base, e assicurati di vedere la pagina degli esempi di codice per saperne di più.
<?php/** * Template Name: Home Page */get_header(); ?><div><div role="main"><?php while ( have_posts() ) : the_post(); ?><h1><?php the_field('custom_title'); ?></h1><img src="<?php the_field('hero_image'); ?>" /><p><?php the_content(); ?></p><?php endwhile; // end of the loop. ?></div><!-- #content --></div><!-- #primary --><?php get_footer(); ?>
C’è uno Shortcode in ACF?
Sì, puoi usarlo nello stesso modo della funzione the_field(). Assomiglia a questo:
Puoi anche specificare il $post_id da cui recuperare il valore.