Automatyczny Znak Wodny na Zdjęciach Produktów

Prezentacja

Moduł Automatyczny Znak Wodny nakłada Twoje logo lub nazwę na miniatury zdjęć produktów, bez ręcznej pracy. Znak wodny jest nakładany, gdy tylko zdjęcie zostaje dodane do produktu oraz przy każdej regeneracji miniatur. Kluczowy punkt: Twoje pliki oryginalne nigdy nie są modyfikowane. Stemplowane są wyłącznie warianty per typ obrazu (large, home, kategoria itd.), dzięki czemu kolejna regeneracja zawsze startuje od czystego źródła.

Moduł oferuje dwa tryby, przezroczyste logo PNG lub tekst, z precyzyjną regulacją krycia, rozmiaru, pozycji i przetwarzanych formatów. Jest zgodny z PrestaShop 1.7, 8 i 9 i wymaga jedynie rozszerzenia PHP GD, obecnego na niemal wszystkich hostingach.

Instalacja

1. W zapleczu otwórz Moduły > Menedżer modułów.
2. Kliknij Zainstaluj moduł i prześlij archiwum ZIP modułu.
3. Po zakończeniu instalacji kliknij Konfiguruj.

Przy instalacji moduł rejestruje hook actionWatermark i stosuje gotowe ustawienia domyślne (krycie 60%, pozycja w prawym dolnym rogu, rozmiar logo 25% szerokości, wszystkie typy obrazów zaznaczone). Rozszerzenie GD jest sprawdzane: jeśli go brakuje, instalacja jest przerywana z czytelnym komunikatem.

Konfiguracja

Strona konfiguracji jest podzielona na trzy panele: Typ znaku wodnego, Wygląd i pozycja oraz Zastosowanie. Na górze strony wyświetlany jest podgląd aktualnie przesłanego logo oraz bezpośredni przycisk do regeneracji miniatur.

Typ znaku wodnego

• Tryb: wybierz między Logo (obraz PNG) a Tekstem.
• Logo znaku wodnego: prześlij obraz (zalecany przezroczysty PNG, maksymalnie 4 MB). Plik jest konwertowany do PNG, aby zachować przezroczystość. Pozostaw pole puste, aby zachować aktualne logo.
• Usuń logo: zaznacz to pole, aby usunąć zapisane logo.
• Tekst znaku wodnego: tekst do naniesienia w trybie tekstowym (nazwa sklepu, copyright, URL…).
• Kolor tekstu: kolor tekstu w trybie tekstowym.

Wygląd i pozycja

• Krycie (%): od 1 (bardzo przezroczysty) do 100 (nieprzezroczysty).
• Rozmiar logo (% szerokości obrazu): szerokość logo wyrażona jako procent szerokości obrazu. Wartość 0 zachowuje natywny rozmiar logo. Wyrażenie rozmiaru w procentach pozwala znakowi wodnemu zachować spójne proporcje na wszystkich formatach obrazu, od dużej karty produktu po miniaturę kategorii.
• Rozmiar tekstu (% szerokości obrazu): ta sama zasada, dla trybu tekstowego.
• Kąt tekstu (°): nachylenie tekstu w trybie tekstowym.
• Pozycja: dziewięć zakotwiczeń (góra/środek/dół × lewa/środek/prawa) lub tryb Mozaika, który powtarza znak wodny na całym obrazie.
• Marginesy poziomy i pionowy (px): odstęp w pikselach od krawędzi, dla pozycji zakotwiczenia.
• Odstęp mozaiki (%): odstęp między powtórzeniami, używany tylko z pozycją Mozaika.

Zastosowanie

• Szerokość minimalna (px): obrazy węższe niż ta wartość nie są stemplowane. Zapobiega to nakładaniu znaku na mikrominiatury (koszyk, wyszukiwarka), gdzie byłby nieczytelny.
• Typy obrazów do stemplowania: wybierz typy obrazów, których dotyczy znak wodny (large_default, home_default itd.). Każdy typ pokazuje swoje wymiary, co ułatwia wybór.
• Formaty do przetwarzania: JPG, PNG, WebP i AVIF. Zaznacz formaty generowane przez Twój sklep. PrestaShop 8 i 9 często produkują WebP i AVIF obok formatu głównego.

Jak działa znak wodny

Moduł podpina się do natywnego hooka actionWatermark PrestaShop, wyzwalanego przy każdej (re)generacji miniatur zdjęcia produktu. Dla każdego zaznaczonego typu obrazu i każdego aktywnego formatu moduł wczytuje wygenerowaną miniaturę, nakłada znak wodny, a następnie zapisuje plik ponownie, przejmując poziomy jakości zdefiniowane w ustawieniach obrazów Twojego sklepu.

Przetwarzane są wyłącznie warianty per typ obrazu: plik oryginalny pozostaje nietknięty. Możesz więc zmieniać znak wodny i regenerować tyle razy, ile potrzeba, nigdy nie degradując źródła.

Nakładanie znaku wodnego na istniejące produkty

Hook przetwarza obraz tylko w momencie jego generowania. Aby ostemplować cały katalog już opublikowany, uruchom regenerację miniatur:

1. Otwórz Wygląd > Ustawienia obrazów (bezpośredni przycisk jest dostępny na stronie modułu).
2. Uruchom regenerację miniatur dla zdjęć produktów.

Regeneracja odtwarza miniatury z oryginałów, a moduł nakłada na nie znak wodny. Przy bardzo dużych katalogach wybieraj natywną regenerację PrestaShop, zaprojektowaną do przetwarzania dużych wolumenów. Regeneracja jest też dostępna z linii poleceń:

bin/console prestashop:thumbnails:regenerate products

Tryb logo czy tryb tekstowy

Tryb logo sprawdza się, gdy masz mocną identyfikację wizualną: przezroczysty PNG umieszczony w prawym dolnym rogu, przy 60% krycia, wystarczy, by sygnować wizualizacje bez zakłócania odbioru produktu.

Tryb tekstowy jest idealny do szybkiej noty bez przygotowywania pliku. Czcionka DejaVuSans jest wbudowana w moduł, co gwarantuje identyczny rendering na każdym hostingu, niezależnie od czcionek zainstalowanych na serwerze.

Zgodność

• PrestaShop: 1.7, 8.x i 9.x. Zgodność z 9.x obejmuje nową regenerację opartą na Symfony: moduł defensywnie rozwiązuje ścieżki plików, aby działać nawet wtedy, gdy historyczne stałe nie są ładowane.
• PHP: 7.2 i nowsze, z rozszerzeniem GD.
• Formaty: JPG, PNG, WebP i AVIF, a także warianty wysokiej gęstości @2x. Przetwarzanie WebP i AVIF zależy od obsługi tych formatów przez bibliotekę GD serwera.

Odinstalowanie

Odinstalowanie usuwa konfigurację modułu i jego hook. Znaki wodne już nałożone pozostają na miniaturach do następnej regeneracji. Aby odzyskać obrazy bez znaku wodnego, odinstaluj moduł, a następnie zregeneruj miniatury: powstaną na nowo z plików oryginalnych, które pozostały nietknięte.

Rozwiązywanie problemów

• Logo jest za małe lub za duże: dostosuj Rozmiar logo (w % szerokości) lub ustaw go na 0, aby zachować rozmiar natywny.
• WebP lub AVIF bez znaku wodnego: serwer musi dysponować biblioteką GD skompilowaną z obsługą tych formatów. W przeciwnym razie odpowiednie pliki są po prostu pomijane, bez błędu.
• Znak wodny na maleńkich miniaturach: zwiększ Szerokość minimalną, aby wykluczyć małe formaty.

FAQ

Czy moje oryginalne zdjęcia są modyfikowane?

Nie. Stemplowane są wyłącznie miniatury generowane per typ obrazu. Plik oryginalny pozostaje nietknięty.

Jak nałożyć znak wodny na produkty już opublikowane?

Skonfiguruj moduł, a następnie uruchom regenerację miniatur z Wygląd > Ustawienia obrazów. Nowe przesłane zdjęcia są stemplowane automatycznie.

Czy moduł działa z WebP i AVIF?

Tak, a także z wariantami @2x, pod warunkiem że rozszerzenie GD serwera obsługuje te formaty.

Czy trzeba przygotować plik dla trybu tekstowego?

Nie. Wystarczy wpisać tekst; czcionka jest wbudowana w moduł.

Czy przezroczystość mojego logo PNG jest zachowana?

Tak, dzięki dedykowanemu łączeniu kanału alfa, które zachowuje przezroczystość, stosując jednocześnie wybrane krycie.

Czy moduł jest zgodny z PrestaShop 9?

Tak, moduł jest zgodny z PrestaShop 1.7, 8 i 9, w tym z nową regeneracją przez silnik Symfony.