Przejdź do treści

ACF w WordPress – konfiguracja Advanced Custom Fields krok po kroku

Opublikowano: 19 stycznia 2026 | Zaktualizowano: 17 marca 2026

Advanced Custom Fields (ACF) to wtyczka, ktora zamienia WordPressa z platformy blogowej w pełny CMS. Dodajesz własne pola – tekst, galerie, relacje, mapy, powtarzalne grupy – i wyświetlasz je w szablonie motywu. W 2026 ACF jest zainstalowany na ponad 2 milionach stron [WordPress](/wordpress/). Poniżej pokazuje, jak go skonfigurować od zera, z konkretnymi przykładami z projektów klienckich.

Krótka odpowiedź

Zainstaluj ACF z repozytorium WordPress, wejdź do ACF > Grupy Pol, utwórz nowa grupę i dodaj pola (tekst, obraz, galeria, prawda/fałsz). Przypisz grupę do typu postu (np. Strony).

W szablonie motywu użyj get_field('nazwa_pola') do wyświetlania danych. ACF Pro (49 USD/rok) dodaje Repeater, Flexible Content i Gallery – kluczowe dla profesjonalnych projektów.

Usługi KC Mobile

Sprawdź naszą ofertę

Potrzebujesz pomocy specjalisty? Skorzystaj z naszych usług i rozwiń swój biznes online.

Instalacja ACF i pierwszy kontakt z interfejsem

ACF instalujesz z repozytorium WordPress: Wtyczki > Dodaj nowa > szukaj Advanced Custom Fields. Po aktywacji w menu pojawia się pozycja ACF (lub Custom Fields w nowszych wersjach). Główne sekcje: Grupy Pol (Field Groups) – tu definiujesz zestawy pol i zasady ich wyświetlania, Typy Postów (Post Types, ACF 6.1+) – tworzenie custom post types bez kodu, Taksonomie (Taxonomies, ACF 6.1+) – rejestracja taksonomii przez GUI. Kazda grupa pol ma Location Rules – warunki okreslajace, gdzie grupa się pojawia. Przykład: pokazuj te pola jeśli typ postu = Strona i szablon strony = O nas. Możesz łączyć warunki operatorami AND/OR, co daje precyzyjna kontrolę. ACF przechowuje konfigurację w bazie danych, ale możesz eksportować do PHP – wtedy konfiguracja jest w kodzie i działa bez wtyczki na froncie (jeśli używasz natywnych funkcji get_post_meta). To najlepsza praktyka dla stron produkcyjnych.

Potrzebujesz profesjonalnej strony WordPress?

Tworzymy strony WordPress, które są szybkie, bezpieczne i zoptymalizowane pod SEO. Od 3000 zł.

Typy pol – które używać i kiedy

ACF oferuje 30+ typów pol. Najczęściej używane: Text i Textarea – proste pola tekstowe (tytuły, opisy), Number – ceny, wymiary, ilości, Image i Gallery – zdjęcia z penym kontrol rozmiaru i formatu, Wysiwyg Editor – pole z edytorem wizualnym (jak główny content, ale oddzielne), Select i Checkbox – listy wyboru (np. status projektu, dostępne opcje), Relationship i Post Object – relacje między postami (np. powiązane produkty), Google Map – pole z mapa (wymaga klucza API), True/False – przełączniki (np. Czy wyświetlać baner?), Datę Picker – wybór daty (np. data wydarzenia). Dla bardziej złożonych struktur ACF Pro oferuje: Repeater – powtarzalna grupa pol (np. lista członków zespołu, FAQ, harmonogram), Flexible Content – elastyczne bloki treści (klient sam wybiera, jakie sekcje dodać na stronie), Clone – wielokrotne użycie tej samej grupy pol. Dobór typów pol wpływa na wydajność – pozycjonowanie SEO wymaga szybko ładujących się stron.

Warto zapoznac się także z wordpress rest api – konfiguracja, endpointy i praktyczne zastosowania.

Uzupelnieniem tego tematu jest optymalizacja url – jak tworzyć adresy przyjazne dla seo.

Wyświetlanie danych ACF w szablonie motywu

ACF udostępnia dwie główne funkcje: get_field('nazwa_pola') zwraca wartość pola, the_field('nazwa_pola') wyświetla wartość bezpośrednio. Dla obrazów get_field zwraca ID, URL lub tablice (zalezenie od ustawień) – najlepsza praktyka to zwracanie tablicy z rozmiarem, alt i URL. W pętli Repeater używasz have_rows('nazwa_repeater') i the_sub_field('nazwa_podpola'). Flexible Content działa podobnie, ale z get_row_layout() sprawdzasz typ bloku. Przykład strony O nas z ACF: sekcja hero (Image + Text), zespół (Repeater z Image, Text, Text), wartości (Flexible Content z różnymi layoutami). Każde pole wymaga warunkowego sprawdzenia – `if(get_field('pole'))` – bo wyświetlanie pustego pola psuje layout. ACF wspiera też Options Pages (strony opcji) – globalne pola dostępne na całej stronie (np. numer telefonu, adres, godziny otwarcia). Konfiguracja wymaga ACF Pro.

Polecamy również artykuł aktualizacje wordpress – jak bezpiecznie zarządzać aktualizacjami w.

Może Cię również zainteresowac jak poprawić meta tagi na stronie – przewodnik seo na 2026 rok.

ACF i Gutenberg – tworzenie własnych bloków

Od ACF 6.0 możesz tworzyć bloki Gutenberg bez pisania React. Rejestrujesz blok funkcja acf_register_block_type() i tworzysz szablon PHP z polami ACF. Klient widzi blok w edytorze z podgląd na żywo i może go dodać na dowolnej stronie. Przykłady bloków: Testimonial (zdjęcie, cytat, autor), CTA (nagłówek, tekst, przycisk, kolor tła), Cennik (Repeater z nazwa planu, cena, lista funkcji), FAQ Accordion (Repeater z pytaniem i odpowiedzią). Zalety bloków ACF nad Flexible Content: klient używa natywnego edytora Gutenberg (znajomy interfejs), bloki można wielokrotnie użyć na różnych stronach i szablonach, lepsze SEO – treść jest w standardowym HTML, nie w meta polach. W 2026 bloki ACF to rekomendowany sposób budowania stron WordPressa z niestandardowymi layoutami. Jeśli potrzebujesz profesjonalnych stron internetowych z własnymi blokami – możemy pomóc.

Więcej na ten temat przeczytasz w artykule crocoblock na wordpress – konfiguracja i przegląd wtyczek jetplugins.

Wydajność i najlepsze praktyki ACF na produkcji

ACF przechowuje każde pole jako oddzielny wiersz w wp_postmeta. Przy 50 polach na post i 1000 postów to 50 000 wierszy metadanych – zapytania spowalniają. Najlepsze praktyki: eksportuj konfigurację do PHP (ACF > Narzędzia > Eksport do PHP) – eliminujesz zapytania o definicje pol, użyj select2 load z AJAX dla pol Relationship z duza liczba postów (1000+), ogranicz liczbę pol do minimum – jeśli dane można przechowac w jednym polu JSON zamiast 10 oddzielnych, zrób to, włącz acf/fields/wysiwyg/toolbars filter – usuń nieużywane przyciski z edytora, zmniejsz rozmiar zwracanych danych. Cache obiektowy (Redis) jest obowiązkowy na stronach z duzą ilością pol ACF – redukuje zapytania do bazy o 70-90%. Testuj wydajność Query Monitor – wtyczka pokazuje dokładnie, ile zapytań generuje kazda strona. Więcej niż 100 zapytań? Czas na optymalizację. Skontaktuj się z nami po audyt wydajności.

Potrzebujesz pomocy z WordPress?

Tworzymy i naprawiamy strony na WordPress. Optymalizacja prędkości, bezpieczeństwo, aktualizacje. 20+ lat doświadczenia.

Zdjęcie autora: Krzysztof Czapnik
O autorze

Krzysztof Czapnik

Founder & Technical Lead, KC Mobile

20 lat WordPress + 12 lat WooCommerce. Specjalizuję się w technicznej stronie e-commerce: automatyzacje WooCommerce, Google Ads dla SMB, migracje sklepów i optymalizacja konwersji.

Potrzebujesz pomocy z tym tematem? Napisz – odpowiem osobiście w 24h.

Potrzebujesz pomocy?

Potrzebujesz profesjonalnej strony WordPress?

Tworzymy strony WordPress, które są szybkie, bezpieczne i zoptymalizowane pod SEO. Od 3000 zł.

Bezpłatna wycena