Aperçu

L’API d’Advanced Custom Field permet d’afficher très facilement les données des champs dans votre thème. Il existe de nombreuses fonctions disponibles et toutes sont bien documentées sur la page des ressources.

Les bases

Une fois que vous avez créé un groupe de champs et entré quelques données, vous pouvez maintenant charger et afficher les données dans votre thème.

Toutes les valeurs sont enregistrées en tant que post_meta natif (lorsqu’elles sont enregistrées dans un post) et bien que vous puissiez utiliser la fonction WP native get_post_meta(), il est préférable d’utiliser la fonction ACF correspondante telle que get_field(). Pourquoi ? Parce que ACF va formater la valeur en fonction du type de champ et rendre le développement plus rapide et plus facile!

Pour récupérer la valeur d’un champ en tant que variable, utilisez la fonction get_field(). C’est la fonction la plus polyvalente qui retournera toujours une valeur pour n’importe quel type de champ.

Pour afficher un champ, utilisez la fonction the_field() de manière similaire.

Voici un exemple d’utilisation de base, et assurez-vous de consulter la page d’exemples de code pour en savoir plus.

<?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(); ?>

L’ACF a-t-il un Shortcode ?

Oui, vous pouvez l’utiliser de la même manière que la fonction the_field(). Cela ressemble à quelque chose comme ceci:

Vous pouvez également spécifier le $post_id pour récupérer la valeur de.

.