Wtyczka Soflyy WP All Import Pro ACF Advanced Custom Fields - 4.0.1

WP All Import – ACF Add-On Pro to płatny dodatek Soflyy do WP All Import Pro, który masowo importuje dane z plików CSV, Excel, XML i Google Sheets prosto do pól Advanced Custom Fields. Obsługuje każdy typ pola ACF, łącznie z tymi najtrudniejszymi: Repeater, Flexible Content, Gallery i Relationship.

Czym jest WP All Import – ACF Add-On Pro i co dokłada do importu

WP All Import – ACF Add-On Pro rozszerza WP All Import o pełną, natywną obsługę pól Advanced Custom Fields. Serializuje wartości i tworzy ukryte pola referencyjne ACF (_field-slug), których ręczna obsługa bywa zawodna. Darmowy dodatek ACF zatrzymuje się na polach podstawowych – wersja Pro pokazuje wszystkie grupy pól w osobnym panelu i obsługuje każdy typ pola.

To nie jest samodzielna wtyczka. Dodatek działa jako warstwa integracji między silnikiem importu a wtyczką ACF. Sam WP All Import zapisuje dane do surowych custom fields (post meta), ale pola złożone wymagają poprawnej serializacji wartości i powiązania ich z ukrytymi polami referencyjnymi. Tę pracę dodatek przejmuje automatycznie.

Czym różni się od podstawowej obsługi custom fields w WP All Import

Podstawowa obsługa custom fields w WP All Import zapisuje wartości do post meta jako zwykłe pary klucz-wartość, bez wiedzy o strukturze pól ACF. Przy prostym polu tekstowym to wystarcza. Złożone pole ACF to już inna historia – wymaga zapisu ukrytego pola referencyjnego (_field-slug), które wskazuje na definicję pola. Bez niego ACF nie rozpozna danych jako swoich.

WP All Import – ACF Add-On Pro odczytuje definicje grup pól z ACF i pokazuje je w osobnym, czytelnym panelu w trzecim kroku importu. Mapowanie danych ze źródła na konkretne pola przypomina ręczne wypełnianie formularza w panelu ACF. Serializacja i pola referencyjne powstają w tle.

Darmowy dodatek ACF a wersja Pro — co dokłada Pro

W ekosystemie WP All Import działają dwa osobne dodatki ACF. Darmowy „Import Add-On for ACF” (slug csv-xml-import-for-acf) importuje wyłącznie pola podstawowe: tekst, liczbę, zakres, e-mail, URL i hasło. Działa nawet z darmowym silnikiem.

Wersja Pro dokłada obsługę wszystkich pozostałych typów, w tym Repeater, Flexible Content, Gallery, Relationship i Post Object. Do tego import obrazów i galerii, import z adresów URL (także chronionych uwierzytelnianiem HTTP), importy cykliczne, inline custom PHP oraz wsparcie premium. Darmowy dodatek pozostaje przy tym wymaganą zależnością – wersja Pro nadbudowuje na nim brakujące możliwości.

Co potrafi WP All Import – ACF Add-On Pro

WP All Import – ACF Add-On Pro importuje dane do każdego typu pola ACF: Repeater, Flexible Content, Gallery, Relationship, Post Object, Google Map, Date Picker, WYSIWYG i pozostałych. Dorzuca trzy tryby importu repeaterów, mapowanie drag and drop w osobnym panelu ACF, import obrazów z URL, inline custom PHP oraz importy cykliczne. Czyta pliki CSV, Excel, XML i Google Sheets bez wymogu konkretnej struktury.

Pełna obsługa wszystkich typów pól ACF

Dodatek pokrywa cały katalog typów pól Advanced Custom Fields – od prostych pól tekstowych po struktury zagnieżdżone. To główny wyróżnik wobec darmowej wersji, która zatrzymuje się na polach podstawowych.

• Pola złożone — Repeater, Flexible Content, Gallery, Relationship, Post Object i Clone, czyli struktury wymagające serializacji i pól referencyjnych.
• Pola wyboru i logiczne — Select, Checkbox, Radio, True/False oraz Page Link, mapowane bezpośrednio ze źródła.
• Pola mediów i daty — Image, File, Gallery, Date Picker, Date and Time Picker oraz Color Picker.
• Pola treści i lokalizacji — WYSIWYG, Taxonomy, User oraz Google Map / Location Map.
• Pola z integracji — typy dokładane przez Contact Form 7, Gravity Forms i PayPal Item.

Trzy tryby importu pól Repeater

Pola Repeater to najtrudniejszy przypadek importu do ACF. Dlatego dodatek udostępnia trzy tryby dopasowane do faktycznego układu pliku źródłowego. Wybór trybu rozstrzyga, jak wiersze i kolumny przekładają się na powtarzalne elementy.

• Fixed Repeater Mode — każdy element powtarzalny ma własną kolumnę lub węzeł w pliku, o stałej, znanej liczbie powtórzeń.
• Variable Repeater Mode (XML) — dane czytane z elementów-rodzeństwa w pliku XML, gdy liczba powtórzeń jest zmienna.
• Variable Repeater Mode (CSV) — wiele wartości w jednej kolumnie rozdzielonych separatorem, rozbijanych na osobne wiersze repeatera.

Import obrazów i galerii oraz mapowanie drag and drop

W trzecim kroku importu pojawia się osobny panel z grupami pól ACF. Dane ze źródła przeciąga się na niego metodą drag and drop. Taki układ odzwierciedla strukturę pól dokładnie tak, jak widać ją w panelu edycji ACF.

Obrazy do pól Image i Gallery dodatek pobiera z komputera, z innego serwera, z adresu URL (również chronionego uwierzytelnianiem HTTP) albo z biblioteki mediów. Po pobraniu przypisuje je do właściwych pól i zapisuje powiązania jako identyfikatory załączników.

Custom PHP, importy cykliczne i synchronizacja danych

Każdą wartość i opcję importu można przepuścić przez własną funkcję PHP zapisem [my_function({data})]. To otwiera drogę do transformacji danych w locie: formatowania cen, łączenia kolumn czy normalizowania tekstów. Funkcje pisze się i testuje bezpośrednio na stronie edycji importu.

Importy cykliczne uruchamiają się przez usługę Automatic Scheduling Service lub własne zadania cron. Regularnie sprawdzają plik źródłowy i dodają, edytują albo usuwają rekordy. Przy ponownym imporcie merge po unikalnym kluczu aktualizuje istniejące wpisy i potrafi usunąć rekordy, które zniknęły ze źródła.

Typowe wdrożenia WP All Import – ACF Add-On Pro

WP All Import – ACF Add-On Pro sprawdza się przy masowym wypełnianiu rozbudowanych pól ACF danymi z plików zewnętrznych. Od portali nieruchomości z galeriami i mapą, przez katalogi liczące tysiące rekordów, po sklepy WooCommerce zasilane feedem dostawcy. Importy cykliczne i merge po kluczu utrzymują dane aktualne bez ręcznej dłubaniny.

Portale nieruchomości, katalogi i portfolia

Biuro nieruchomości dostaje od pośrednika regularny eksport ofert: cena, metraż, lokalizacja na mapie, galeria zdjęć i lista udogodnień w polu Repeater. Dodatek mapuje te dane na grupę pól ACF typu „Oferta”, importuje galerie z adresów URL i ustawia cykliczną aktualizację. Oferty pozostają świeże bez ręcznego przepisywania.

Podobnie wygląda to przy katalogach, bazach wiedzy i portfoliach – stronach opartych na wielu polach ACF na rekord. Dane przychodzą z arkusza, import wypełnia wszystkie pola naraz. A przy przenoszeniu zmian ze stagingu na produkcję synchronizuje rekordy po wspólnym kluczu.

Sklepy WooCommerce zasilane feedem i programmatic SEO

W sklepach WooCommerce produkty często mają dodatkowe pola ACF: rozszerzone specyfikacje czy atrybuty spoza standardowego modelu produktu. Dane z feedu dostawcy trafiają do tych pól i synchronizują się cyklicznie. To dokładnie scenariusz dropshippingu i datafeedu.

Przy programmatic SEO dodatek tworzy masowo wpisy lub strony z ustrukturyzowanych danych – na przykład strony lokalizacyjne. Liczy się tu dowolna struktura pliku, custom PHP do transformacji wartości oraz harmonogram, który powtarza generowanie przy każdej aktualizacji źródła.

Migracje treści z rozbudowanymi metadanymi

Przy przenoszeniu wpisów i własnych typów treści (CPT) z polami ACF między instalacjami WordPress dodatek odwzorowuje dane w polach docelowych, zwykle w parze z komplementarnym WP All Export. Uwaga przy polach przechowujących identyfikatory: Image, Gallery, Relationship i Post Object zapisują ID obiektów, które muszą się zgadzać po obu stronach.

Integracje WP All Import – ACF Add-On Pro z popularnymi narzędziami

WP All Import – ACF Add-On Pro integruje się z ACF i ACF Pro (wersje 4, 5 i 6) i działa na wszystkich wtyczkach oraz motywach korzystających z ACF. W tym z WooCommerce (pola ACF na produktach, pola zamówień w trybie HPOS) oraz z WPML przy importach wielojęzycznych. Współpracuje też z Google Sheets, harmonogramem cron i komplementarnym WP All Export.

WooCommerce, WPML i motywy korzystające z ACF

Dane ACF importują się do dowolnego motywu lub wtyczki używającej Advanced Custom Fields: motywów katalogowych i listingowych, wtyczek członkostwa czy WooCommerce. Wsparcie dla pól zamówień WooCommerce w trybie HPOS dodał changelog darmowego dodatku w wersji 1.0.5.

W witrynach wielojęzycznych dodatek importuje dane ACF z deklarowanym wsparciem zespołu WPML. Praktyka pokazuje, że tłumaczenia wiąże się po identyfikatorach, a przy ponownych importach liczy się dobór trybu aktualizacji pól.

Uwaga o wielojęzyczności: potwierdzone jest wsparcie WPML – dla Polylang i TranslatePress Soflyy nie deklaruje oficjalnej integracji.

Google Sheets, harmonogramowanie i WP All Export

Dane importują się bezpośrednio z adresu URL arkusza Google Sheets, bez wcześniejszego pobierania pliku. Import rusza ręcznie albo cyklicznie – przez usługę Automatic Scheduling Service Soflyy lub własne zadania cron na serwerze.

Dla deweloperów dostępne jest Rapid Add-On API wraz z Action Reference: udokumentowanymi akcjami i filtrami (na przykład pmai_only_show_acf_groups_for_target_post_type), które pozwalają uruchamiać kod przed importem, w jego trakcie i po nim. Do eksportu danych ACF służy komplementarny WP All Export, często używany w parze przy migracjach i masowej edycji.

Dla kogo sprawdza się WP All Import – ACF Add-On Pro

WP All Import – ACF Add-On Pro to naturalny wybór dla agencji, deweloperów oraz twórców portali nieruchomości, katalogów i portfoliów opartych na złożonych polach ACF, którzy regularnie importują dane z plików zewnętrznych. Witrynom importującym wyłącznie proste pola tekstowe wystarczy darmowy dodatek ACF – wersja Pro byłaby przerostem formy nad treścią.

Agencje, deweloperzy i twórcy rozbudowanych witryn

Dla kogo WP All Import – ACF Add-On Pro sprawdza się najlepiej:

• Twórcy portali nieruchomości, katalogów, ogłoszeń i portfoliów opartych na rozbudowanych grupach pól ACF.
• Agencje i freelancerzy obsługujący wielu klientów, gdzie prosty interfejs drag and drop pozwala przeszkolić nawet klienta.
• Sklepy i witryny z danymi z zewnętrznych źródeł (datafeed, dropshipping) wymagającymi cyklicznej synchronizacji.
• Deweloperzy budujący niestandardowe procesy importu z użyciem inline PHP i Rapid Add-On API.
• Zespoły migrujące treści z rozbudowanymi metadanymi między instalacjami WordPress.

Kiedy wystarczy darmowy dodatek ACF

Witrynom importującym wyłącznie proste pola tekstowe i liczbowe darmowy dodatek ACF pokrywa cały zakres potrzeb. Obsługuje pola podstawowe: tekst, liczbę, zakres, e-mail, URL i hasło. Działa nawet z darmowym silnikiem WP All Import, bez kosztu wersji Pro.

Dla kogo WP All Import – ACF Add-On Pro nie jest najlepszym wyborem:

• Witryny importujące tylko proste pola tekstowe lub liczbowe — darmowy dodatek ACF wystarczy.
• Projekty bez WP All Import Pro lub bez gotowości na utrzymywanie zależności.
• Osoby oczekujące, że import sam utworzy pola i grupy pól ACF — to dodatek wypełnia istniejące pola, nie tworzy field groups.

Czego WP All Import – ACF Add-On Pro nie zrobi (ograniczenia)

Dodatek wypełnia danymi istniejące pola ACF przypisane do danego typu wpisu, ale nie tworzy field groups w trakcie importu. Definicje pól trzeba przygotować wcześniej w ACF, a do ich przeniesienia służy wbudowane Custom Fields › Tools. Drugie ograniczenie to scalanie repeatera z wielu wierszy: wszystkie dane powtarzalne dla jednego wpisu muszą znaleźć się w tym samym rekordzie pliku.

Dane jednego repeatera rozrzucone na wiele wierszy albo utworzą osobne wpisy, albo nadpiszą się nawzajem. Istnieją obejścia przez custom PHP z funkcją add_row, ale natywnie scenariusz nie działa. Z kolei pola przechowujące identyfikatory – Image, Gallery, Relationship i Post Object – utrudniają migrację między witrynami, bo ID muszą się zgadzać po obu stronach.

Wymagania techniczne i kompatybilność

WP All Import – ACF Add-On Pro wymaga aktywnego WP All Import Pro oraz darmowego dodatku ACF jako zależności, a także zainstalowanego Advanced Custom Fields w wersji 4, 5 lub 6 (edycja darmowa albo Pro). Dziedziczy wymagania serwerowe silnika: WordPress 5.0+, PHP 7.4+, MySQL 5.5+ oraz rozszerzenia cURL, libxml, SimpleXML i ZipArchive.

Wtyczki wymagane i zależności

Dodatek nie działa samodzielnie. Import do pól ACF wymaga jednoczesnej aktywności trzech elementów: WP All Import Pro jako silnika, darmowego dodatku ACF (csv-xml-import-for-acf) jako warstwy pośredniej oraz samej wtyczki Advanced Custom Fields.

Wspierane wersje ACF i formaty plików

Dodatek współpracuje z ACF w wersjach 4, 5 i 6, zarówno w edycji darmowej, jak i ACF Pro. Jako źródło danych przyjmuje pliki CSV, Excel (XLS/XLSX), XML oraz arkusze Google Sheets. Typ pliku rozpoznaje samodzielnie i dopasowuje do niego interfejs.

Zalecane ustawienia serwera przy dużych importach

Przy importach liczących tysiące rekordów Soflyy zaleca podniesienie kilku parametrów PHP, żeby uniknąć przerwań. Dotyczy to przede wszystkim max_input_vars (około 6000, wyżej przy dużej liczbie atrybutów), odpowiednio dobranych upload_max_filesize, post_max_size i memory_limit oraz podniesionego max_execution_time.

Dla samego rozmiaru pliku nie ma narzuconego limitu. Import dzieli się automatycznie na części (chunki), a ograniczeniem pozostają zasoby serwera. Obowiązuje tu prosta zasada: jeśli serwer uruchamia WordPressa, uruchomi też import.

Najczęściej zadawane pytania