Gapli Pages
Pobiera z GAPLI strony sklepu (regulamin, polityki, informacje) i dane firmy, udostępnia je jako shortcody i ustawia polskie treści zgód w kasie WooCommerce.
Gdzie go znajdziesz
Gapli → Gapli Pages (do wersji 1.6.6 pozycja nazywała się „Pages Sync”). Na liście Strony w WordPressie pojawia się dodatkowa kolumna i filtry stron pobranych z GAPLI.
Pierwsze uruchomienie
- Włącz moduł. Rynek sklepu przychodzi z modułu Status Połączenia — niczego nie wpisujesz.
- Kliknij „Force Sync Pages Now”, żeby od razu pobrać strony, i „Sync Company Data”, żeby pobrać dane firmy.
Co dzieje się automatycznie
- Dwa razy dziennie synchronizuje strony z GAPLI. Synchronizacja nadpisuje ręczne zmiany w tych stronach — zmieniaj je w GAPLI, nie w WordPressie.
- Co godzinę odświeża dane firmy używane przez shortcody.
- Wyświetla strony produktów OnePage pod adresem /gapli-product/{id}/{slug}.
Wymagania i powiązane moduły
- Gapli Status Połączenia (dane rynku) i Gapli Full Dropshipping (ekran w menu).
Shortcody (57)
Jak działają
- Shortcode to znacznik w nawiasach kwadratowych, np. [gapli_company_nip]. Wpisujesz go w treść strony, wpisu, widżetu tekstowego albo w Regulamin — WordPress przy wyświetlaniu podmienia go na aktualną wartość. W edytorze blokowym użyj bloku „Shortcode” albo wpisz znacznik w zwykły akapit.
- Dane pochodzą z GAPLI: to dane sprzedawcy przypisanego do rynku sklepu (firma, adres, kontakt, rynek). Moduł pobiera je co godzinę i zapisuje lokalnie w bazie sklepu, więc strona nie odpytuje GAPLI przy każdym wyświetleniu. Od razu odświeżysz je przyciskiem „Sync Company Data” na ekranie Gapli → Gapli Pages.
- Danych nie zmienisz w WordPressie — zmiana w GAPLI trafia do wszystkich sklepów rynku przy najbliższej synchronizacji. Dzięki temu Regulamin i Polityka prywatności zawsze mają aktualny NIP, adres i kontakt.
- Firma ma dwa komplety kontaktów: dane rejestrowe (administracyjne) i obsługę klienta. Shortcody publiczne — [gapli_company_email], [gapli_company_telefon], [gapli_shop_email] i bloki — pokazują OBSŁUGĘ KLIENTA, a gdy jej nie ustawiono, dane rejestrowe. Dane rejestrowe bez podmiany dają tylko warianty z końcówką _glowny.
- Parametry wpisuj w prostych cudzysłowach: [gapli_company_email format="link"]. Moduł sam poprawia cudzysłowy drukarskie („ ” ’) wewnątrz [gapli_…], które wstawiają edytory tekstu, ale proste cudzysłowy są pewniejsze w innych miejscach.
- Gdy w danych GAPLI brakuje wartości, shortcode wstawia pusty tekst — strona się nie psuje, ale zostaje dziura. Wyjątki (z wartością zastępczą) opisano przy poszczególnych shortcodach.
- Starsze dokumenty z placeholderami {{TELEFON_FIRMY}}, {{EMAIL_FIRMY}}, {{KRS}}, {{kraje_dostawy}} i {{liczba_dni_na_platnosc}} są poprawiane automatycznie — także w Regulaminie wyświetlanym w kasie WooCommerce.
- Jeśli na stronie widać sam znacznik w nawiasach, moduł Gapli Pages jest wyłączony albo nieaktualny, albo w nazwie jest literówka.
Sklep
Dane samego sklepu internetowego — nie mylić z danymi rejestrowymi firmy.
[gapli_shop_name]Nazwa sklepu, czyli tytuł witryny z Ustawienia → Ogólne → „Tytuł witryny”. Używana w nagłówkach dokumentów, np. „Regulamin sklepu internetowego [gapli_shop_name]”. To nie jest nazwa rejestrowa firmy — do niej służy [gapli_company_name].
Gdy brak danych: Nazwa firmy z GAPLI, a gdy i jej brak — domena sklepu. Nigdy nie zostaje pusta.
Przykład:Regulamin sklepu internetowego [gapli_shop_name][gapli_shop_email]Adres e-mail, na który ma pisać kupujący — e-mail obsługi klienta firmy z GAPLI.
Gdy brak danych: E-mail rejestrowy firmy.
Parametr Wartości Domyślnie Działanie formatlink — (zwykły tekst) format="link" (albo równoważne link="true") wstawia klikalny odnośnik mailto: zamiast samego adresu. Przykład:Napisz do nas: [gapli_shop_email format="link"][gapli_store_domain]Domena sklepu bez https:// i końcowego ukośnika, np. mojsklep.pl.
Przykład:Sklep internetowy dostępny pod adresem [gapli_store_domain]
Rynek
Dane rynku, na którym działa sklep (kraj, waluta, warunki z Regulaminu).
[gapli_market_name]Nazwa rynku, np. Polska.
[gapli_market_country_code]Kod kraju rynku, np. PL.
[gapli_market_currency]Waluta rynku, np. PLN.
[gapli_market_flag]Flaga rynku (emoji).
[gapli_market_kraje_dostawy]Kraje, do których sklep wysyła — tekst do Regulaminu, np. „Polska, Czechy, Słowacja”.
Przykład:Dostawa realizowana jest na terenie: [gapli_market_kraje_dostawy].[gapli_market_dni_platnosc]Liczba dni, w których kupujący ma opłacić zamówienie — liczba do Regulaminu.
Przykład:Zamówienie należy opłacić w ciągu [gapli_market_dni_platnosc] dni.[gapli_market_id]Wewnętrzny identyfikator rynku w GAPLI — przydatny głównie przy diagnozie.
Firma — dane rejestrowe
[gapli_company_name]Pełna nazwa rejestrowa firmy sprzedawcy.
[gapli_company_forma_prawna]Forma prawna, np. prosta spółka akcyjna.
[gapli_company_nip]NIP.
[gapli_company_regon]REGON.
[gapli_company_krs]Numer KRS.
[gapli_company_vat_id]Numer VAT UE (z prefiksem kraju).
[gapli_company_number]Numer rejestrowy firmy w kraju rynku (dla rynków spoza Polski).
[gapli_company_data_zalozenia]Data założenia firmy.
Parametr Wartości Domyślnie Działanie formatformat daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i d.m.Y Jak zapisać datę. d = dzień, m = miesiąc, Y = rok, H:i = godzina i minuty. Przykład:Działamy od [gapli_company_data_zalozenia format="Y"] roku.[gapli_company_description]Opis firmy ustawiony w GAPLI.
[gapli_company_website]Adres strony WWW firmy.
Parametr Wartości Domyślnie Działanie formatlink — (zwykły tekst) format="link" (albo równoważne link="true") wstawia klikalny odnośnik otwierany w nowej karcie. [gapli_company_logo_url]Sam adres URL logo — do wstawienia np. w atrybut src własnego obrazka.
[gapli_company_logo]Logo firmy jako gotowy obrazek.
Parametr Wartości Domyślnie Działanie widthliczba pikseli — (oryginał) Szerokość obrazka. heightliczba pikseli — (oryginał) Wysokość obrazka. altdowolny tekst „Logo <nazwa firmy>” Tekst alternatywny dla czytników ekranu i SEO. classnazwa klasy CSS gapli-company-logo Klasa CSS bloku — przydaje się do własnego stylowania. Przykład:[gapli_company_logo width="160"][gapli_company_id]Wewnętrzny identyfikator firmy w GAPLI — przydatny głównie przy diagnozie.
Kontakt
Warianty bez końcówki _glowny pokazują obsługę klienta (a gdy jej nie ustawiono — dane rejestrowe). Do strony Kontakt, stopki i Regulaminu używaj właśnie ich.
[gapli_company_email]alias:[gapli_company_email_obslugi]E-mail obsługi klienta.
Gdy brak danych: E-mail rejestrowy firmy.
Parametr Wartości Domyślnie Działanie formatlink — (zwykły tekst) format="link" (albo równoważne link="true") wstawia klikalny odnośnik mailto: zamiast samego adresu. Przykład:E-mail: [gapli_company_email format="link"][gapli_company_telefon]alias:[gapli_company_telefon_obslugi]Telefon obsługi klienta.
Gdy brak danych: Telefon rejestrowy firmy.
Parametr Wartości Domyślnie Działanie formatlink — (zwykły tekst) format="link" (albo równoważne link="true") wstawia klikalny odnośnik tel: — na telefonie od razu wybiera numer. Przykład:Zadzwoń: [gapli_company_telefon format="link"][gapli_company_email_glowny]E-mail rejestrowy (administracyjny) firmy — bez podmiany na obsługę klienta. Na stronach dla klientów zwykle niepotrzebny.
Parametr Wartości Domyślnie Działanie formatlink — (zwykły tekst) format="link" (albo równoważne link="true") wstawia klikalny odnośnik mailto: zamiast samego adresu. [gapli_company_telefon_glowny]Telefon rejestrowy (administracyjny) firmy — bez podmiany na obsługę klienta.
Parametr Wartości Domyślnie Działanie formatlink — (zwykły tekst) format="link" (albo równoważne link="true") wstawia klikalny odnośnik tel: — na telefonie od razu wybiera numer. [gapli_company_email_iod]E-mail Inspektora Ochrony Danych — do Polityki prywatności.
Parametr Wartości Domyślnie Działanie formatlink — (zwykły tekst) format="link" (albo równoważne link="true") wstawia klikalny odnośnik mailto: zamiast samego adresu. Przykład:W sprawach danych osobowych: [gapli_company_email_iod format="link"]
Adres
Adres rejestrowy firmy — pełny albo w częściach — oraz osobny adres do zwrotów.
[gapli_address_full]Pełny adres rejestrowy w jednym ciągu.
[gapli_return_address]Adres, na który klient odsyła towar przy zwrocie lub reklamacji — domyślny magazyn firmy. Często inny niż adres rejestrowy, dlatego w formularzu odstąpienia i dokumentach zwrotów używaj tego shortcodu, a nie [gapli_address_full].
Gdy brak danych: Adres rejestrowy firmy, żeby dokument nigdy nie został bez adresu.
Przykład:Towar należy odesłać na adres: [gapli_return_address][gapli_address_street]Ulica.
[gapli_address_building_number]Numer budynku.
[gapli_address_apartment_number]Numer lokalu.
[gapli_address_postal_code]Kod pocztowy.
[gapli_address_city]Miejscowość.
[gapli_address_wojewodztwo]Województwo / region.
[gapli_address_country]Kraj.
[gapli_address_name]Nazwa adresu (np. nazwa siedziby), jeśli ustawiono.
[gapli_address_type]Typ adresu w GAPLI (np. siedziba).
[gapli_address_opening_hours]Godziny otwarcia — każdy dzień w osobnej linii, np. „Poniedziałek: 9:00–17:00”. Dni bez godzin są pomijane.
[gapli_address_contact_data]Dodatkowe dane kontaktowe przypisane do adresu — każda pozycja w osobnej linii.
[gapli_address_gps]Współrzędne GPS adresu.
[gapli_address_notes]Notatki do adresu.
[gapli_address_id]Wewnętrzny identyfikator adresu w GAPLI — przydatny głównie przy diagnozie.
Gotowe bloki
Wstawiają od razu sformatowany fragment HTML — najszybszy sposób na stronę Kontakt albo stopkę.
[gapli_company_info]Wizytówka firmy: nazwa jako nagłówek, a pod nią NIP, REGON, KRS, e-mail i telefon obsługi klienta (klikalne) oraz strona WWW. Pozycje bez wartości są pomijane.
Gdy brak danych: Gdy moduł nie pobrał jeszcze danych firmy — tekst „Brak danych firmy.”
Parametr Wartości Domyślnie Działanie show_niptrue / false true Czy pokazać NIP. show_regontrue / false true Czy pokazać REGON. show_krstrue / false true Czy pokazać KRS. show_emailtrue / false true Czy pokazać e-mail. show_phonetrue / false true Czy pokazać telefon. show_websitetrue / false true Czy pokazać stronę WWW. classnazwa klasy CSS gapli-company-info Klasa CSS bloku — przydaje się do własnego stylowania. Przykład:[gapli_company_info show_regon="false" show_website="false"][gapli_company_contact]Blok kontaktowy: nagłówek, e-mail 📧 i telefon 📞 obsługi klienta oraz strona WWW 🌐 — wszystko klikalne.
Parametr Wartości Domyślnie Działanie titledowolny tekst lub pusty Kontakt Nagłówek bloku. title="" usuwa nagłówek. classnazwa klasy CSS gapli-company-contact Klasa CSS bloku — przydaje się do własnego stylowania. Przykład:[gapli_company_contact title="Obsługa klienta"][gapli_company_address_block]Blok adresowy: nagłówek, pogrubiona nazwa firmy i pełny adres rejestrowy.
Gdy brak danych: Nic — gdy firma nie ma adresu, blok się nie pojawia.
Parametr Wartości Domyślnie Działanie titledowolny tekst lub pusty Adres Nagłówek bloku. title="" usuwa nagłówek. classnazwa klasy CSS gapli-company-address Klasa CSS bloku — przydaje się do własnego stylowania. Przykład:[gapli_company_address_block title="Siedziba"]
Daty i stan synchronizacji
Daty dotyczące bieżącej strony i danych firmy — np. „Regulamin obowiązuje od …”.
[gapli_page_updated_at]Kiedy treść tej strony zmieniono w GAPLI. Działa na stronach pobranych z GAPLI.
Parametr Wartości Domyślnie Działanie formatformat daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i d.m.Y H:i Jak zapisać datę. d = dzień, m = miesiąc, Y = rok, H:i = godzina i minuty. Przykład:Ostatnia zmiana regulaminu: [gapli_page_updated_at format="d.m.Y"][gapli_page_last_sync]Kiedy sklep ostatnio pobrał tę stronę z GAPLI.
Parametr Wartości Domyślnie Działanie formatformat daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i d.m.Y H:i Jak zapisać datę. d = dzień, m = miesiąc, Y = rok, H:i = godzina i minuty. [gapli_page_force_updated]Kiedy stronę ostatnio pobrano przyciskiem „Force Sync Pages Now”.
Parametr Wartości Domyślnie Działanie formatformat daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i d.m.Y H:i Jak zapisać datę. d = dzień, m = miesiąc, Y = rok, H:i = godzina i minuty. [gapli_page_wordpress_updated]Data ostatniej zmiany strony w WordPressie (także zmiany zrobionej przez synchronizację).
Parametr Wartości Domyślnie Działanie formatformat daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i d.m.Y H:i Jak zapisać datę. d = dzień, m = miesiąc, Y = rok, H:i = godzina i minuty. [gapli_company_synced_at]Kiedy sklep ostatnio pobrał dane firmy z GAPLI.
Parametr Wartości Domyślnie Działanie formatformat daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i d.m.Y H:i Jak zapisać datę. d = dzień, m = miesiąc, Y = rok, H:i = godzina i minuty. [gapli_company_updated_at]Kiedy dane firmy zmieniono w GAPLI.
Parametr Wartości Domyślnie Działanie formatformat daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i d.m.Y H:i Jak zapisać datę. d = dzień, m = miesiąc, Y = rok, H:i = godzina i minuty. [gapli_company_active]Czy firma jest aktywna w GAPLI.
Parametr Wartości Domyślnie Działanie yes_textdowolny tekst Aktywna Tekst, gdy warunek jest spełniony. no_textdowolny tekst Nieaktywna Tekst, gdy warunek nie jest spełniony. [gapli_company_is_default]Czy to domyślna firma rynku.
Parametr Wartości Domyślnie Działanie yes_textdowolny tekst Domyślna Tekst, gdy warunek jest spełniony. no_textdowolny tekst Zwykła Tekst, gdy warunek nie jest spełniony.
Gdy coś nie działa
- „Market not found”
- Sklep nie jest połączony z GAPLI. Sprawdź ekran Gapli → Status Połączenia.
- „Gapli Pages – Błąd synchronizacji”
- Wykonaj kroki podane w komunikacie, a potem kliknij „Force Sync Pages Now”.
- Na stronie widać shortcode jako zwykły tekst albo pole jest puste
- Tekst w nawiasach kwadratowych oznacza wyłączony lub nieaktualny moduł — włącz go i zaktualizuj. Puste pole — kliknij „Sync Company Data”.