# Gapli External Images

> Moduł WordPress/WooCommerce GAPLI (`gapli-external-images`) · kategoria: Produkty i kategorie · aktualna wersja 1.0.14 · WordPress 6.0+ · WooCommerce 10.0+ · PHP 8.0+  
> Wersja HTML: https://gapli.com/docs/external-images

Wyświetla zdjęcia produktów prosto z CDN GAPLI lub serwera hurtowni, bez kopiowania ich do biblioteki mediów WordPressa. Odciąża bazę danych i dysk sklepu i przyspiesza import produktów.

## Gdzie go znajdziesz

Gapli → External Images. W edycji produktu pojawia się też okno „🌐 Zdjęcia External (Gapli)”.

## Pierwsze uruchomienie

1. Włącz moduł. Domyślny „Tryb pracy” to External Images — nowe zdjęcia z GAPLI nie trafiają już do biblioteki mediów.
2. „Lazy Loading” (domyślnie włączony) i „Domyślne wymiary” (800×800 px) zwykle zostawiasz bez zmian.
3. Jeśli sklep ma już produkty ze zdjęciami w bibliotece mediów, przejdź migrację w sekcji migracji: „Skanuj”, potem „Migracja” (paczki po 100 produktów).
4. Dopiero po sprawdzeniu, że zdjęcia w sklepie wyświetlają się poprawnie, użyj kroku „Usuń stare CDN attachments”. Tego kroku nie da się cofnąć.

## Co dzieje się automatycznie

- Gdy ręcznie zmienisz zdjęcie produktu w WordPressie, produkt dostaje oznaczenie „custom” i synchronizacja z GAPLI już go nie nadpisuje.
- Udostępnia zdjęcia modułom Product Image Studio, BWI Lider i Store Builder.

## Wymagania i powiązane moduły

- WooCommerce.
- Gapli Full Dropshipping — bez niej ekran modułu nie pojawi się w menu.

## Gdy coś nie działa

- **„Moduł działa w trybie media_library. Przełącz na external…”** — Zmień „Tryb pracy” na External Images i zapisz ustawienia, a dopiero potem uruchom migrację.
- **Produkt nie dostaje nowych zdjęć z GAPLI** — Produkt ma oznaczenie „custom”, bo jego zdjęcia zmieniono ręcznie. W oknie „🌐 Zdjęcia External (Gapli)” kliknij „🔄 Przywróć External Images”.