WordPress: ACF Shortcode

przez

Wprowadzenie:

ACF (Advan­ced Custom Fields) Short­co­de to specjal­ny rodzaj skrótu (short­co­de) używa­ny w popular­nym dodat­ku WordPress o nazwie Advan­ced Custom Fields.

Advan­ced Custom Fields to narzę­dzie, które umożli­wia tworze­nie i zarzą­dza­nie niestan­dar­do­wy­mi polami (custom fields) w syste­mie WordPress. Pozwa­la użytkow­ni­kom dodawać dodat­ko­we pola do stron, wpisów, typów wpisów niestan­dar­do­wych i innych elemen­tów strony WordPress. Dzięki temu można łatwo dosto­so­wać zawar­tość strony i przecho­wy­wać dodat­ko­we informacje.

ACF Short­co­de jest rozsze­rze­niem funkcjo­nal­no­ści ACF, które pozwa­la na wykorzy­sta­nie niestan­dar­do­wych pól wewnątrz kodu skrótu (short­co­de). Można go używać na stronach, w treści wpisów lub w szablo­nach, aby wstawić warto­ści pól niestan­dar­do­wych w wybra­ne miejsca na stronie.

Przykład użycia ACF Shortcode:

Załóż­my, że stworzy­łeś niestan­dar­do­we pole ACF o nazwie "Opis produk­tu" dla typu wpisu "Produkt". Możesz użyć ACF Short­co­de, aby wstawić wartość tego pola w treść strony lub wpisu.

  1. Przykład 1: Wstawia­nie warto­ści pola "Opis produk­tu" na stronie:
<div class="product-description">
   <?php echo do_shortcode('[acf field="opis_produktu"]'); ?>
</div>

W powyż­szym przykła­dzie używa­my ACF Short­co­de, aby wstawić wartość pola "Opis produk­tu" wewnątrz elemen­tu <div> o klasie "product-descrip­tion". Podczas wyświe­tla­nia strony, skrót zosta­nie zamie­nio­ny na odpowia­da­ją­cą wartość pola.

  1. Przykład 2: Użycie ACF Short­co­de w treści wpisu:

W treści wpisu możemy wstawić ACF Short­co­de bezpośrednio:

Opis produktu: [acf field="opis_produktu"]

Podczas wyświe­tla­nia wpisu, skrót zosta­nie zamie­nio­ny na wartość pola "Opis produktu".

  1. Przykład 3: Wykorzy­sta­nie ACF Short­co­de w szablo­nie strony:
<div class="page-content">
   <h2>Tytuł: <?php echo get_the_title(); ?></h2>
   <p>Opis: <?php echo do_shortcode('[acf field="opis_produktu"]'); ?></p>
</div>

W tym przykła­dzie używa­my ACF Short­co­de, aby wstawić wartość pola "Opis produk­tu" wewnątrz elemen­tu <p>. Dodat­ko­wo, wstawia­my tytuł strony korzy­sta­jąc z funkcji get_the_title(). Podczas rende­ro­wa­nia strony, skróty zosta­ną zastą­pio­ne odpowied­ni­mi warto­ścia­mi pól.

Parametry shortcodu ACF

ACF Short­co­de dla Advan­ced Custom Fields posia­da kilka parame­trów, które mogą być używa­ne do dosto­so­wa­nia wyświe­tla­nia warto­ści pola. Oto lista podsta­wo­wych parame­trów, które można użyć w ACF Shortcode:

  1. field (wymaga­ny): Określa nazwę pola niestan­dar­do­we­go, które­go wartość chcesz wstawić. Na przykład: [acf field="opis_produktu"].
  2. post_id (opcjo­nal­ny): Określa ID wpisu, dla które­go chcesz pobrać wartość pola. Domyśl­nie używa­ne jest ID aktual­ne­go wpisu. Możesz jednak podać konkret­ne ID, np.: [acf field="opis_produktu" post_id="123"].
  3. format_value (opcjo­nal­ny): Określa, czy wartość pola powin­na być sforma­to­wa­na zgodnie z ustawie­nia­mi pola (jeśli istnie­ją). Domyśl­nie ma wartość "true". Możesz ustawić go na "false", jeśli chcesz pobrać surową wartość pola, np.: [acf field="opis_produktu" format_value="false"].
  4. return (opcjo­nal­ny): Określa, jak powin­na być zwróco­na wartość pola. Domyśl­nie ma wartość "true". Jeśli chcesz, aby wartość zosta­ła zwróco­na jako wynik, pozostaw go jako "true". Jeśli chcesz, aby wartość zosta­ła wyświe­tlo­na bezpo­śred­nio (bez zwraca­nia), ustaw go na "false", np.: [acf field="opis_produktu" return="false"].
  5. show_label (opcjo­nal­ny): Określa, czy należy wyświe­tlić etykie­tę pola wraz z warto­ścią. Domyśl­nie ma wartość "true". Możesz ustawić go na "false", jeśli chcesz ukryć etykie­tę pola, np.: [acf field="opis_produktu" show_label="false"].

Te parame­try umożli­wia­ją dosto­so­wa­nie sposo­bu wyświe­tla­nia warto­ści pola niestan­dar­do­we­go za pomocą ACF Short­co­de w zależ­no­ści od potrzeb.

Dodaj komentarz

Ta strona używa Akismet do redukcji spamu. Dowiedz się, w jaki sposób przetwarzane są dane Twoich komentarzy.