ACF (Advanced Custom Fields) & CPT (Custom Post Types) - Modul PrestaShop

Opis

ACF Field Builder to modul PrestaShop, ktory zamienia Twoj sklep w prawdziwy, elastyczny CMS. Dodawaj niestandardowe pola do produktow, kategorii, stron CMS i kart klientow, a nastepnie tworzwlasne typy tresci — wszystko bez pisania ani jednej linii kodu.

PrestaShop oferuje ograniczone pola dla produktow i kategorii. Dodanie informacji specyficznych dla Twojej dzialalnosci, takich jak specyfikacje techniczne, FAQ, odznaki czy certyfikaty, zwykle wymaga modyfikacji bazy danych i tworzenia niestandardowych szablonow. ACF Field Builder eliminuje te zlozonosc: tworzdownolny typ pola w kilka klikniec z poziomu back office, a dane sa automatycznie dostepne w szablonach Smarty przez proste i intuicyjne API.

Glowne zalety:

• Ponad 15 typow pol dostepnych (tekst, obraz, wideo, repeater, relacja...)
• Custom Post Types z konfigurowalnymi adresami URL i wbudowanym SEO
• Taksonomie do kategoryzacji i filtrowania tresci
• Natywna obsluga wielojezycznosci we wszystkich polach
• Interfejs drag & drop do zmiany kolejnosci pol
• Konfigurowalne szablony przez system nadpisywania PrestaShop

Funkcjonalnosci

Advanced Custom Fields

Sercem modulu jest system grup pol, ktore swobodnie przypisujesz do encji PrestaShop. Utworz grupe, zdefiniuj reguly lokalizacji (produkty, kategorie, strony CMS, klienci lub Custom Post Types), a nastepnie dodaj potrzebne pola. Kazde pole posiada opcje walidacji, prezentacji i tlumaczenia wielojezycznego.

Dostepne typy pol pokrywaja kazda potrzebe: pola podstawowe (tekst, textarea, edytor WYSIWYG, liczba, email, URL), pola wyboru (select, checkbox, radio, true/false, ocena gwiazdkowa), pola mediow (obraz, galeria, wideo YouTube/Vimeo, plik do pobrania) oraz pola zaawansowane (repeater dla powtarzalnych grup, relacja do produktow lub kategorii, selektor kolorow, data i datetime).

Custom Post Types

Tworzwlasne typy tresci niezalezne od katalogu PrestaShop. Ogloszenia nieruchomosci, portfolia, referencje, przewodniki, wydarzenia, przepisy — mozliwosci sa nieograniczone. Kazdy typ tresci ma wlasny slug, konfigurowalne adresy URL z prefiksem, opcjonalna strone archiwum oraz konfigurowalne meta tagi SEO ze zmiennymi dynamicznymi, takimi jak {title}, {shop_name} i {type_name}.

Taksonomie

Taksonomie pozwalaja kategoryzowac i filtrowac niestandardowe tresci. Dzialaja jak kategorie produktow, ale dotycza Twoich Custom Post Types. Tworzaksonomie (Transakcja, Typ nieruchomosci, Budzet...) i definiuj przypisane terminy (Sprzedaz, Wynajem, Dom, Mieszkanie...). Taksonomie pojawiaja sie na pasku bocznym podczas edycji wpisu, umozliwiajac szybki wybor.

Integracja front-office ze Smarty

Zmienna $acf jest automatycznie dostepna we wszystkich szablonach Smarty. Kilka metod umozliwia wyswietlanie danych: field() dla zabezpieczonych wartosci tekstowych, raw() dla surowych danych, render() dla sformatowanego renderowania HTML obrazow i wideo, label() dla przetlumaczonych etykiet pol wyboru, has() do sprawdzania istnienia wartosci, oraz repeater() do iteracji po powtarzalnych polach.

Shortcodes

Wstawiaj pola bezposrednio na stronach CMS lub w opisach produktow za pomoca edytora WYSIWYG, uzywajac shortcodow: [acf field="marka"], [acf_render field="image"], [acf_group id="1"] lub [acf_repeater slug="specs"]...[/acf_repeater].

Instalacja

1. Pobierz plik ZIP modulu z PrestaShop Addons
2. W back office PrestaShop przejdz do Moduly > Menedzer modulow
3. Kliknij Zaladuj modul i wybierz plik ZIP
4. Po zainstalowaniu kliknij Konfiguruj

Modul automatycznie tworzy wymagane tabele w bazie danych podczas instalacji i jest natychmiast gotowy do uzycia.

Konfiguracja

Grupy pol

Przejdz do interfejsu przez Moduly > ACF Field Builder, zakladka Advanced Custom Fields. Kliknij + Add Group, aby utworzyc nowa grupe. Wpisz tytul, sprawdz automatycznie wygenerowany slug, dodaj opcjonalny opis, a nastepnie zdefiniuj reguly lokalizacji, aby przypisac grupe do wybranych encji (produkty, kategorie, strony CMS, klienci lub Custom Post Types).

Ustawienia pol

Kazde pole konfiguruje sie przez trzy zakladki: General Settings (wielojezyczny tytul, slug, instrukcje kontekstowe, aktywacja), Validation (pole wymagane, wartosci min/max, wyrazenie regularne) oraz Presentation (wyswietlanie etykiety w front office, tlumaczalna wartosc, niestandardowa klasa CSS i ID HTML).

Niestandardowe typy tresci

W zakladce Custom Post Types tworzwlasne typy tresci z wielojezyczna nazwa, technicznym slugiem, opisem i ikona Material Design. Nastepnie skonfiguruj adresy URL (prefiks, strona archiwum) oraz meta tagi SEO, korzystajac z dostepnych zmiennych dynamicznych.

Wymagania

• PrestaShop 8.0+ lub 9.x
• PHP 8.1 lub nowszy
• Rozszerzenie PHP intl wlaczone (dla obslugi wielojezycznosci)
• Dostep do back office z uprawnieniami administratora

FAQ

Czy modul jest kompatybilny z trybem multisklep?

Tak, pola moga byc konfigurowane dla poszczegolnych sklepow lub wspoldzielone miedzy wieloma sklepami w trybie multisklep.

Czy moje dane sa zachowywane podczas aktualizacji?

Tak, wszystkie dane sa przechowywane w dedykowanych tabelach bazy danych i nigdy nie sa usuwane podczas aktualizacji modulu.

Czy moge uzywac ACF na kilku typach encji jednoczesnie?

Tak, pojedyncza grupe pol mozna przypisac do wielu typow tresci za pomoca regul lokalizacji. Na przyklad grupa moze byc stosowana jednoczesnie do produktow i kategorii.

Czy moge eksportowac i importowac konfiguracje?

Tak, zakladka Sync umozliwia eksport grup pol w formacie JSON i import ich do innego sklepu.

Czy modul jest kompatybilny z moim motywem?

Tak, modul jest kompatybilny z motywami Classic, Hummingbird oraz wszystkimi motywami zgodnymi ze standardami PrestaShop.

Jakie typy Custom Post Types moge tworzyc?

Modul jest w pelni elastyczny: ogloszenia nieruchomosci, artykuly blogowe, portfolia, referencje klientow, przewodniki, wydarzenia, przepisy, karty techniczne — dowolny typ ustrukturyzowanej tresci, ktorego potrzebuje Twoja dzialalnosc.

Wsparcie

W przypadku pytan technicznych lub prosb o pomoc, skontaktuj sie z nami przez system wiadomosci PrestaShop Addons lub zapoznaj sie z dokumentacja dolaczona do modulu.

Changelog

Version 1.4.0

Nowa struktura nawigacji

• Sekcja „ACF / CPT” w panelu bocznym back-office, zastępująca starą kartę „WePresta”.
• Oddzielne karty ACF i CPT, z których każda może być rozbudowana o dynamiczne podkarty.
• Dynamiczne podkarty dla każdej utworzonej grupy ACF (pojawiają się pod kartą ACF).
• Dynamiczne podkarty dla każdego utworzonego typu CPT (pojawiają się pod kartą CPT).
• Podkarty są automatycznie tworzone, zmieniane i usuwane podczas operacji CRUD.

Version 1.2.0

• Added custom fields on product thumbnails
• New Smarty helper for category pages integration
• Improved field rendering performance

To use them, insert these lines into your template: {assign var='pAcf' value=$acf->forProduct($product.id_product)} followed by {$pAcf->field('field_slug')}

Wersja 1.0.0

• Wersja poczatkowa
• 15+ typow pol niestandardowych
• Custom Post Types z adresami URL zoptymalizowanymi pod SEO
• System taksonomii
• Natywna obsluga wielojezycznosci
• Interfejs drag & drop
• Konfigurowalne szablony
• Shortcody dla stron CMS
• Eksport/import konfiguracji w formacie JSON
• Kompatybilnosc z PrestaShop 8.x i 9.x