# Gapli Pages

> Moduł WordPress/WooCommerce GAPLI (`gapli-pages`) · kategoria: Strony i treści · aktualna wersja 1.6.7 · WordPress 6.2+ · WooCommerce 10.0+ · PHP 8.0+  
> Wersja HTML: https://gapli.com/docs/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

1. Włącz moduł. Rynek sklepu przychodzi z modułu Status Połączenia — niczego nie wpisujesz.
2. 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

### 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 `format` (link; domyślnie: — (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 `format` (format daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i; domyślnie: 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 `format` (link; domyślnie: — (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 `width` (liczba pikseli; domyślnie: — (oryginał)) — Szerokość obrazka.
  - Parametr `height` (liczba pikseli; domyślnie: — (oryginał)) — Wysokość obrazka.
  - Parametr `alt` (dowolny tekst; domyślnie: „Logo <nazwa firmy>”) — Tekst alternatywny dla czytników ekranu i SEO.
  - Parametr `class` (nazwa klasy CSS; domyślnie: 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 `format` (link; domyślnie: — (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 `format` (link; domyślnie: — (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 `format` (link; domyślnie: — (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 `format` (link; domyślnie: — (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 `format` (link; domyślnie: — (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 `show_nip` (true / false; domyślnie: true) — Czy pokazać NIP.
  - Parametr `show_regon` (true / false; domyślnie: true) — Czy pokazać REGON.
  - Parametr `show_krs` (true / false; domyślnie: true) — Czy pokazać KRS.
  - Parametr `show_email` (true / false; domyślnie: true) — Czy pokazać e-mail.
  - Parametr `show_phone` (true / false; domyślnie: true) — Czy pokazać telefon.
  - Parametr `show_website` (true / false; domyślnie: true) — Czy pokazać stronę WWW.
  - Parametr `class` (nazwa klasy CSS; domyślnie: 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 `title` (dowolny tekst lub pusty; domyślnie: Kontakt) — Nagłówek bloku. title="" usuwa nagłówek.
  - Parametr `class` (nazwa klasy CSS; domyślnie: 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 `title` (dowolny tekst lub pusty; domyślnie: Adres) — Nagłówek bloku. title="" usuwa nagłówek.
  - Parametr `class` (nazwa klasy CSS; domyślnie: 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 `format` (format daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i; domyślnie: 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 `format` (format daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i; domyślnie: 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 `format` (format daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i; domyślnie: 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 `format` (format daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i; domyślnie: 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 `format` (format daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i; domyślnie: 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 `format` (format daty PHP, np. d.m.Y, Y-m-d, d.m.Y H:i; domyślnie: 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 `yes_text` (dowolny tekst; domyślnie: Aktywna) — Tekst, gdy warunek jest spełniony.
  - Parametr `no_text` (dowolny tekst; domyślnie: Nieaktywna) — Tekst, gdy warunek nie jest spełniony.

- `[gapli_company_is_default]` — Czy to domyślna firma rynku.
  - Parametr `yes_text` (dowolny tekst; domyślnie: Domyślna) — Tekst, gdy warunek jest spełniony.
  - Parametr `no_text` (dowolny tekst; domyślnie: 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”.