GoogleQR – lekki generator kodów QR dla PrestaShop

Najważniejsze zalety

• Offline i niezależność: generowanie QR po stronie serwera, bez wywołań do API zewnętrznych.
• Zgodność z CSP: obraz QR jest serwowany z Twojej domeny, więc nie blokuje go Content Security Policy.
• Lekki i szybki: brak ciężkich zależności – paczka modułu waży ~80 KB.
• Jakość i czytelność: PNG generowany przez PHP GD, automatyczne skalowanie do zadanych wymiarów.
• Wysoka kompatybilność: integracja z hookiem displayProductButtons w PrestaShop 1.7/8/9.
• Elastyczność: parametry rozmiaru, marginesu i poziomu korekcji błędów (L/M/Q/H).
• Fallback bez GD: jeśli PHP GD jest niedostępne, moduł zwraca czytelny SVG.

Jak to działa

Moduł wstrzykuje tag <img> przy przyciskach produktu. Źródłem obrazu jest endpoint modułu, który generuje QR na serwerze i zwraca go jako obraz PNG (lub SVG, gdy brak GD).

Funkcje

• Automatyczne pobranie adresu URL aktualnego produktu i zakodowanie w QR.
• Parametry: size (np. 128x128), ecc (L/M/Q/H), margin (px).
• Serwowanie z tej samej domeny – brak ostrzeżeń CSP i mieszanej zawartości.
• Brak zależności Composer/vendor – bardzo mały rozmiar paczki.
• Możliwość prostej rozbudowy o konfigurację w BO (np. domyślny rozmiar czy ECC).

Wymagania techniczne

• PHP 7.2+ (zalecane wyższe, zgodnie z wersją Twojego PrestaShop).
• PHP GD (opcjonalne, dla PNG). Bez GD moduł zwróci SVG.

Korzyści biznesowe

• Łatwe udostępnianie kart produktu w offline i retail (skan z ekranu).
• Szybsze przejście klientów mobilnych na stronę konkretnego produktu.
• Brak kosztów i ryzyk związanych z usługami zewnętrznymi.

FAQ

Czy QR działa bez internetu? Tak – generowanie jest lokalne. Jedynie skanowanie i przejście na stronę wymaga sieci po stronie użytkownika.

Co jeśli serwer nie ma GD? Moduł automatycznie zwróci QR w formacie SVG, czytelnym dla skanerów.

Czy rozmiar mogę zmienić? Tak – parametr size w adresie obrazka lub przez konfigurację modułu (jeśli ją włączysz).