Yleiskatsaus

Edistyneen mukautetun kentän API:n avulla kentän tietojen näyttäminen teemassa on erittäin helppoa. Käytettävissä on monia funktioita ja kaikki on dokumentoitu hyvin resurssisivulla.

Perusteet

Kun olet luonut kenttäryhmän ja syöttänyt tietoja, voit nyt ladata ja näyttää tiedot teemassasi.

Kaikki arvot tallennetaan natiivina post_meta:na (kun ne tallennetaan postaukseen) ja vaikka voit käyttää WP:n natiivia funktiota get_post_meta(), on parempi käytäntö käyttää asiaankuuluvaa ACF:n funktiota, esim. funktiota get_field(). Miksi? Koska ACF muotoilee arvon kentän tyypin mukaan ja tekee kehityksestä nopeampaa ja helpompaa!

Kentän arvon hakemiseksi muuttujana käytä get_field()-funktiota. Tämä on monipuolisin funktio, joka palauttaa aina arvon mille tahansa kenttätyypille.

Kentän näyttämiseksi käytä vastaavalla tavalla funktiota the_field().

Tässä on peruskäyttöesimerkki, ja muista katsoa koodiesimerkkisivulta lisää.

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

Onko ACF:ssä lyhytkoodi?

Kyllä, voit käyttää sitä samalla tavalla kuin the_field()-funktiota. Se näyttää jotakuinkin tältä:

Voit myös määrittää $post_id:n, josta arvo haetaan.