Advanced Custom Fields (ACF) to wtyczka WordPress, która jest doskonałym narzędziem do konfigurowania niestandardowej meta postu. Umożliwia łatwe tworzenie i konfigurowanie złożonych i przyjaznych dla użytkownika metaboxów z wszelkiego rodzaju polami i ustawieniami dla typów postów, taksonomii, ekranów użytkownika i stron opcji. I jest bardzo przyjazny dla programistów.
Teraz możesz ręcznie skonfigurować własne meta pola lub ustawienia, ale w przypadku bardziej złożonych ustawień wymaga to sporo kodowania, w tym stylizacji, JavaScriptu, walidacji i zapisywania obsługi. Wyobraź sobie na przykład ręczne pisanie repeatera z grupą ustawień, wielokrotny wybór postów przez określone zapytanie. Lub obsługa ustawień wyświetlania, które zależą od pewnych zmiennych, takich jak przypisany termin lub szablon strony (co wymaga JavaScript). Zaawansowane pola niestandardowe obsługują to wszystko i robią to pięknie.
Pamiętaj, że zaawansowane pola niestandardowe w rzeczywistości nie będą wyświetlać żadnych niestandardowych meta w szablonach. Wydawanie lub robienie czegoś w oparciu o pola i ustawienia skonfigurowane za pomocą ACF należy do Ciebie jako programisty. Ale można to łatwo zrobić przy użyciu dowolnej metody ACF. Miło jest również wiedzieć, że ACF wykorzystuje podstawową meta funkcjonalność WordPress (post, termin, użytkownik). Oznacza to, że faktycznie zapisuje np. ustawienia postów jako meta postu – co można uzyskać za pomocą podstawowych funkcji, takich jak get_post_meta().
Zaawansowane pola niestandardowe są dostępne w wersji bezpłatnej i płatnej wersji Pro. Darmowa wersja jest więcej niż wystarczająca w większości przypadków, ale w wersji Pro masz dodatkowe funkcje, takie jak pole repeatera, pole galerii, bloki Gutenberga (patrz później) oraz możliwość użycia ACF do skonfigurowania własnego niestandardowego administratora strony opcji. ACF jest również tak popularny, że można łatwo znaleźć wysokiej jakości rozszerzenia do wszystkiego, czego nie obejmuje rdzeń ACF.
Zaawansowane pola niestandardowe: część administracyjna
Po zainstalowaniu wtyczki Advanced Custom Fields otrzymasz nowe menu administratora dla "Pola niestandardowe". Tutaj możesz skonfigurować i skonfigurować swoje "meta pola" lub grupy ustawień.
W ramach grupy możesz skonfigurować dowolną liczbę pól różnych typów. Najczęstsze z nich to wprowadzanie tekstu, obszar tekstowy, edytor tekstu sformatowanego, plik, obraz, prawda/fałsz (przełącznik), pola wyboru, przyciski radiowe i pole wyboru. Inne popularne to wiele sposobów wyboru postów, wybieranie taksonomii, wybieranie użytkowników, selektor dat, selektor kolorów, Mapy Google i wiele, wiele innych. W zależności od wybranego typu pola otrzymujesz szereg dodatkowych opcji dostosowywania pola. Możesz również dodać logikę warunkową do dowolnego pola. Logika warunkowa służy do ukrywania lub wyświetlania pól w zależności od innych opcji w grupie.
Dla każdej grupy ustawień możesz określić, w jakich przypadkach te ustawienia mają się pojawiać. Przykładami są edytowanie postów, termin taksonomii lub edytowanie użytkownika. Możesz dodatkowo dostosować widoczność swoich ustawień, na przykład typu postu. Lub jeśli wpis ma przypisany określony termin lub szablon strony, jeśli wpis jest autorstwa określonego autora, jeśli rola użytkownika jest taka lub taka, rola aktualnie zalogowanego użytkownika lub jeśli strona jest stroną nadrzędną albo nie. Możesz także dostosować miejsce, w którym powinno pojawić się pole meta. Jednak ta funkcjonalność jest teraz nieco ograniczona dzięki nowemu edytorowi Gutenberga.
Zakładanie grupy
Ustawienia dla jednego pola
Zaawansowane pola niestandardowe: część kodu
Przyjrzyjmy się bardziej interesującej części: jak wykorzystać zaawansowane pola niestandardowe według kodu. Jak wspomniano wcześniej, ACF jest bardzo przyjazny dla programistów i oferuje szeroki zakres możliwości dostosowywania.
Uzyskiwanie wartości i umieszczanie ich w szablonach jest łatwe dzięki metodom ACF. Na przykład the_field('your_meta_key')do bezpośredniego wywoływania go lub get_field('your_meta_key')przechowywania go w zmiennej PHP. Podaj identyfikator posta jako drugi argument, jeśli chcesz pobrać dane poza pętlę. Bułka z masłem. Możesz użyć get_post_meta(), ale zaleca się korzystanie z metod ACF – ponieważ ACF może przekształcić wartość w coś bardziej znaczącego przed zwróceniem jej do Ciebie.
Kolejną rzeczą, o której powinieneś wiedzieć, jest narzędzie eksportu w ACF. Utworzone grupy można eksportować do dwóch formatów; albo plik JSON do pobrania, albo czysty kod PHP. Plik JSON jest przydatny, jeśli chcesz wyeksportować ustawienia między serwerem testowym a serwerem live lub innym WordPressem. Eksportowanie w czystym PHP daje możliwość bezpośredniego wklejenia go do motywu lub wtyczki plików PHP.
Jak można z tego wywnioskować; możesz użyć kodu PHP, pisząc go ręcznie lub eksportując go po skonfigurowaniu w admin, aby dodać swoje grupy i pola. Pozwala to na większą kontrolę i sposoby generowania niestandardowych wyborów.
Ale czekaj, jest więcej! ACF oferuje również szeroki zakres działań i filtrów do dalszego dostosowywania pól lub ich wartości. Istnieją zaczepy do zapisywania lub renderowania pola, a także zaczepy do rejestrowania grup według kodu (wspomniane powyżej) oraz filtry do dostosowywania wartości, ustawień lub wyborów pola przed zapisaniem lub przed renderowaniem. Możesz dodatkowo określić, czy filtr powinien wpływać na wszystkie pola, pola według określonego typu, czy pola według określonego metaklucza. Wszystkie haki i filtry są poprzedzone znakiem acf/.
Zajrzyj na stronę dokumentacji ACF ; kliknij „Funkcje", „Działania” lub „Filtry”, aby zobaczyć przegląd. Na tej stronie znajdziesz również świetne samouczki i przewodniki.
Uwaga na temat zaawansowanych pól niestandardowych i Gutenberga
Tworzenie niestandardowych bloków Gutenberga jest w tej chwili dość trudne. Dokumentacja nie jest na miejscu, zmiany w niej pojawiają się często, a kodowanie wymaga sporej wiedzy na temat Javascript. Najlepiej, jeśli potrzebujesz znajomości Reacta i tego, jak skonfigurować kompilator z JSX/ES6 z webpackiem i Babel.
Jednak w wersji 5.8 ACF Pro wprowadził funkcję konfiguracji grupy pól jako bloku Gutenberga – umożliwiając dodawanie niestandardowych bloków wyłącznie z kodem ACF i PHP. Nie jest wymagana znajomość Javascriptu!
Wszystko, co musisz zrobić, to skonfigurować grupy w admin lub kodem jak zwykle. Ale potem zdefiniuj ich lokalizację jako blok Gutenberga. Pozostaje tylko dodać trochę kodu PHP, aby zarejestrować je jako niestandardowy blok Gutenberga acf_register_block(). Do tej funkcji definiujesz wywołanie zwrotne do funkcji PHP lub pliku szablonu, który jest odpowiedzialny za renderowanie wyjścia bloku. Piszesz tę funkcję lub część szablonu w całości w PHP i używasz znanych metod, takich jak get_field()pobieranie wartości ustawień.
Jak wygląda blok ACF w edytorze Gutenberg
Bądź na bieżąco w kategorii Zaawansowane pola niestandardowe, aby uzyskać samouczki dotyczące korzystania z tej wtyczki!