Jeśli Twoje produkty zawierają dodatkowe dane w ACF lub innych niestandardowych polach, możesz je bezpośrednio umieścić w kanałach produktów. Ten przewodnik pokazuje, jak wyświetlić te niestandardowe pola na liście mapowalnych pól i zmapować je do kanału, w tym używać ich w regułach i filtrach. AdTribes nie ma oficjalnej integracji ACF, ale małe obejście sprawia, że działa zarówno z Advanced Custom Fields (ACF), jak i innymi niestandardowymi metadanymi produktu.
Najczęstszym problemem, z jakim borykają się właściciele sklepów, jest to, że pola ACF nie pojawiają się w sekcji Mapowalne pola podczas tworzenia kanału. Dzieje się tak, ponieważ wtyczka buforuje atrybuty produktu, a nowo utworzone niestandardowe pola nie są automatycznie wykrywane. Wyczyść bufor, aby wymusić ponowne skanowanie produktów i wykrycie nowych pól.
Gdy pola ACF będą widoczne na liście mapowalnych pól, możesz ich używać dokładnie tak samo jak każdego innego atrybutu produktu – mapować je do pól kanału, uwzględniać w regułach i stosować jako filtry.
Wymagania
- Zainstalowany i aktywny Product Feed Pro lub Product Feed Elite firmy AdTribes
- Zainstalowana i aktywna wtyczka Advanced Custom Fields (ACF) – wystarczy darmowa wersja z repozytorium WordPress.org
- Co najmniej jedna grupa pól ACF skonfigurowana do wyświetlania na produktach WooCommerce
- Co najmniej jeden produkt z wypełnionymi wartościami pól ACF
Krok 1: Utwórz grupę pól ACF
Zacznij od utworzenia nowej grupy pól ACF. Przejdź do Niestandardowe pola > Dodaj nowe w panelu administracyjnym WordPress. Nadaj grupie nazwę, a następnie skonfiguruj Reguły lokalizacji, aby pola pojawiały się w Typie postu > jest równy > Produkt. Zapewni to, że niestandardowe pola będą powiązane z produktami WooCommerce.
Dodaj potrzebne pola do grupy – na przykład pole tekstowe dla niestandardowej etykiety lub pole liczbowe dla niestandardowej wartości wagi. Zapisz grupę pól, gdy skończysz.
Krok 2: Wypełnij pola na swoich produktach
Po zapisaniu grupy pól przejdź do dowolnego produktu w Produkty > Wszystkie produkty i otwórz go do edycji. Przewiń w dół, aby znaleźć niestandardowe pola ACF pod standardowymi danymi produktu. Wprowadź wartości dla każdego pola, które chcesz uwzględnić w swoim kanale.
Pamiętaj, aby zaktualizować produkt po wprowadzeniu wartości. Powtórz tę czynność dla wszystkich produktów, na których chcesz, aby pojawiło się niestandardowe pole.
Krok 3: Wyczyść bufor niestandardowych atrybutów
Domyślnie pola ACF nie będą widoczne na liście Mapowalnych pól podczas konfigurowania kanału produktów. Dzieje się tak, ponieważ AdTribes buforuje niestandardowe atrybuty w celu zwiększenia wydajności i nie wykrywa automatycznie nowych pól dodanych przez wtyczki innych firm.
Aby Twoje pola ACF były widoczne, przejdź do Product Feed Pro/Elite > Ustawienia i kliknij przycisk Wyczyść bufor niestandardowych atrybutów.
Krok 4: Mapowanie pól ACF w kanale
Po wyczyszczeniu bufora wróć do konfiguracji kanału i otwórz sekcję Mapowalne pola. Twoje pola ACF powinny teraz pojawić się na liście – mogą pojawić się jako dwa oddzielne wpisy (z nieco innymi nazwami kluczy).
Wybierz pierwszy wpis dla swojego pola ACF i zmapuj go do odpowiedniego atrybutu kanału. Zapisz kanał i odśwież go, aby sprawdzić, czy niestandardowe pole poprawnie wypełnia wartość w wyjściu kanału.
Jeśli wartość nie pojawi się po odświeżeniu, wróć do mapowalnych pól i spróbuj użyć drugiego wpisu dla tego samego pola ACF. Poprawny klucz zależy od tego, jak ACF przechowuje pole wewnętrznie.
Używanie pól ACF w regułach i filtrach
Gdy Twoje pola ACF będą widoczne na liście mapowalnych pól, będą również dostępne do użycia w Regułach i Filtrach. Pozwala to na uwzględnianie lub wykluczanie produktów na podstawie wartości pól niestandardowych lub manipulowanie wyjściem pola przed jego pojawieniem się w kanale.
Często zadawane pytania
Wyczyściłem bufor, ale moje pola ACF nadal nie pojawiają się w Mapowalnych polach. Co powinienem spróbować?
Najpierw upewnij się, że co najmniej jeden produkt ma pole ACF wypełnione wartością – wtyczka wykrywa tylko pola, które mają zapisane dane dla produktu. Jeśli pole jest puste we wszystkich produktach, nie zostanie zaindeksowane. Po wypełnieniu wartości co najmniej w jednym produkcie, przejdź do Product Feed Pro/Elite > Ustawienia i ponownie kliknij Wyczyść bufor niestandardowych atrybutów, a następnie wróć do konfiguracji kanału i sprawdź listę Mapowalnych pól.
Dlaczego moje pole ACF pojawia się dwukrotnie na liście Mapowalnych pól?
ACF przechowuje dane pól na dwa sposoby: raz pod kluczem nazwy pola i raz pod wewnętrznym kluczem referencyjnym poprzedzonym podkreśleniem. Oba klucze mogą pojawić się na liście mapowalnych pól. Pierwszy wpis jest zazwyczaj tym właściwym do użycia, ale jeśli wartości nie są uzupełniane w Twoim kanale, przełącz się na drugi wpis i odśwież kanał.
Czy będę musiał/a czyścić pamięć podręczną za każdym razem, gdy dodam nowe pole ACF?
Tak. Za każdym razem, gdy dodajesz nowe pole niestandardowe – czy to z ACF, czy z innego wtyczki – musisz wyczyścić pamięć podręczną atrybutów niestandardowych, aby AdTribes mógł wykryć nowe pole. Istniejące pola, które są już w pamięci podręcznej, nie zostaną naruszone.
Moje pole ACF mapuje się poprawnie, ale wartość jest pusta w wynikach kanału. Dlaczego?
Zazwyczaj oznacza to, że produkt, który testujesz, nie ma zapisanej wartości dla tego pola ACF, lub wybrałeś/aś niewłaściwy klucz z dwóch dostępnych wpisów. Sprawdź produkt w edytorze, aby potwierdzić, że wartość jest zapisana, a następnie spróbuj przełączyć się na alternatywny klucz na liście mapowalnych pól i odświeżyć kanał.
Czy mogę używać pól ACF zawierających tablice lub dane z pól powtarzalnych?
AdTribes niezawodnie mapuje proste pola tekstowe, liczbowe i wybieralne ACF. Złożone typy pól ACF, takie jak pola powtarzalne (Repeaters), elastyczna zawartość (Flexible Content) i relacje (Relationship), przechowują dane jako serializowane tablice, które nie są łatwe do zmapowania na pojedynczy atrybut kanału. Dla tych typów pól może być potrzebny programista do stworzenia niestandardowego fragmentu kodu, który spłaszcza dane do prostej wartości, zanim będzie można ich użyć w kanale.
Czy to działa z ACF Pro, czy tylko z darmową wersją?
Rozwiązanie tymczasowe działa zarówno z darmową wtyczką ACF, jak i z ACF Pro. Kluczową różnicą jest to, że ACF Pro zawiera dodatkowe typy pól (takie jak Repeater i Gallery), które mogą nie mapować się czysto, jak wspomniano powyżej. Standardowe typy pól z obu wersji działają w ten sam sposób.
Czy mogę użyć tego samego podejścia dla niestandardowych pól meta dodanych przez inne wtyczki?
Tak. Proces czyszczenia pamięci podręcznej atrybutów niestandardowych działa dla wszelkich niestandardowych danych produktów, nie tylko pól ACF. Jeśli inna wtyczka dodaje niestandardowe dane do Twoich produktów i nie pojawiają się one na liście mapowalnych pól, czyszczenie pamięci podręcznej jest właściwym pierwszym krokiem. Pole musi mieć zapisaną wartość na co najmniej jednym produkcie, aby zostało wykryte.
Czy wartości moich pól ACF aktualizują się automatycznie w kanale po edycji produktu?
Pliki kanałów są generowane według harmonogramu lub na żądanie. Aktualizacja wartości pól ACF produktu nie aktualizuje natychmiast pliku kanału na żywo – musisz ręcznie odświeżyć kanał z poziomu AdTribes > Feeds klikając Refresh, lub poczekać na następny zaplanowany cykl generowania.
Widzę pole ACF na liście Mappable Fields, ale nie jest ono dostępne w Rules lub Filters. Czy to normalne?
Nie – jeśli pole pojawia się na liście Mappable Fields po wyczyszczeniu pamięci podręcznej, powinno być również dostępne w Rules i Filters. Jeśli go brakuje, spróbuj ponownie wyczyścić pamięć podręczną, a następnie ponownie otwórz konfigurację kanału. Jeśli problem będzie się utrzymywał, upewnij się, że pole ma zapisaną wartość na co najmniej jednym produkcie i skontaktuj się z pomocą techniczną.
Czy planowana jest oficjalna integracja ACF dla AdTribes?
Obecnie nie ma oficjalnej integracji ACF. Rozwiązanie tymczasowe opisane w tym artykule jest obsługiwaną metodą używania pól ACF w kanałach produktów. Jeśli oficjalna integracja stanie się dostępna, zostanie ona ogłoszona w informacjach o wydaniu wtyczki.
Potrzebujesz pomocy?
Jeśli potrzebujesz dalszej pomocy w mapowaniu pól ACF lub niestandardowych metadanych produktu w kanałach produktów, skontaktuj się z naszym zespołem wsparcia, otwierając zgłoszenie.
Należy pamiętać, że system zgłoszeń jest wyłącznie dla użytkowników Product Feed Elite.
Jeśli używasz tylko wtyczki Product Feed Pro, możesz otworzyć nowy temat na forum WordPress.org.
