Przegląd

API Advanced Custom Field’s sprawia, że bardzo łatwo jest wyświetlać dane pól w twoim motywie. Istnieje wiele dostępnych funkcji i wszystkie są dobrze udokumentowane na stronie zasobów.

Podstawy

Po utworzeniu grupy pól i wprowadzeniu niektórych danych, możesz teraz załadować i wyświetlić dane w swoim motywie.

Wszystkie wartości są zapisywane jako natywne post_meta (gdy są zapisywane do postu) i chociaż możesz użyć natywnej funkcji WP get_post_meta(), lepszą praktyką jest użycie odpowiedniej funkcji ACF, takiej jak get_field(). Dlaczego? Ponieważ ACF sformatuje wartość w zależności od typu pola i sprawi, że rozwój będzie szybszy i łatwiejszy!

Aby pobrać wartość pola jako zmienną, użyj funkcji get_field(). Jest to najbardziej uniwersalna funkcja, która zawsze zwróci wartość dla dowolnego typu pola.

Aby wyświetlić pole, użyj funkcji the_field() w podobny sposób.

Oto podstawowy przykład użycia, i upewnij się, że przejrzysz stronę z przykładami kodu, aby dowiedzieć się więcej.

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

Czy ACF posiada Shortcode?

Tak, możesz go użyć w taki sam sposób jak funkcji the_field(). Wygląda to mniej więcej tak:

Możesz również określić $post_id, z którego ma zostać pobrana wartość.

.