Znakowanie wodne plików do pobrania
Moduł znakowania wodnego automatycznie dodaje dane kupującego do plików do pobrania (PDF i EPUB) w momencie pobierania. Każdy pobrany plik zawiera spersonalizowany watermark identyfikujący nabywcę.
Jak to działa
Dział zatytułowany „Jak to działa”- Klient kupuje produkt z plikami do pobrania
- W momencie kliknięcia linku pobierania plugin przechwytuje żądanie
- Na podstawie formatu pliku stosowany jest odpowiedni mechanizm znakowania
- Plik tymczasowy ze znakiem wodnym jest generowany i wysyłany do klienta
- Plik tymczasowy jest usuwany po zakończeniu procesu (cleanup na shutdown)
Znakowanie wodne jest stosowane automatycznie do wszystkich produktów z plikami do pobrania - nie wymaga dodatkowej konfiguracji per produkt.
Obsługiwane formaty
Dział zatytułowany „Obsługiwane formaty”PDF (TCPDF)
Dział zatytułowany „PDF (TCPDF)”Znakowanie wodne plików PDF wykorzystuje bibliotekę TCPDF:
- Na każdej stronie dokumentu nakładany jest tekst watermarku
- Tekst jest półprzezroczysty i umieszczony po przekątnej strony
- Watermark nie wpływa na czytelność oryginalnej treści
- Obsługiwane są wielostronicowe dokumenty PDF
EPUB (ZipArchive)
Dział zatytułowany „EPUB (ZipArchive)”Znakowanie wodne plików EPUB wykorzystuje rozszerzenie PHP ZipArchive:
- Plik EPUB jest otwierany jako archiwum ZIP
- Do plików HTML wewnątrz archiwum wstrzykiwany jest element
<div>z danymi kupującego - Wstrzyknięcie odbywa się przed zamykającym tagiem
</body> - Oryginalna struktura EPUB jest zachowana
Placeholdery
Dział zatytułowany „Placeholdery”W treści znaku wodnego można używać następujących placeholderów:
| Placeholder | Opis | Przykład |
|---|---|---|
[FIRSTNAME] |
Imię kupującego | Jan |
[LASTNAME] |
Nazwisko kupującego | Kowalski |
[EMAIL] |
Adres e-mail kupującego | [email protected] |
[DATE] |
Data pobrania pliku | 2026-04-06 |
[ORDER_ID] |
Numer zamówienia | 12345 |
Przykład tekstu znaku wodnego:
Licencjonowano dla: [FIRSTNAME] [LASTNAME] ([EMAIL])Zamówienie #[ORDER_ID] z dnia [DATE]Pliki tymczasowe
Dział zatytułowany „Pliki tymczasowe”Znakowany plik jest tworzony jako kopia tymczasowa w katalogu wp-content/uploads/polski-pro-temp/:
- Plik tymczasowy jest generowany z unikalnym identyfikatorem
- Po wysłaniu pliku do klienta plik tymczasowy jest usuwany
- Czyszczenie odbywa się automatycznie przez hook
register_shutdown_function - W przypadku błędu pliki tymczasowe są również usuwane
Konfiguracja
Dział zatytułowany „Konfiguracja”Moduł nie ma ekranu w kokpicie. Jego ustawienia trzyma opcja polski_pro_watermark, a w tym wydaniu nic tej opcji nie zapisuje, ani ekran w kokpicie, ani trasa PUT /wp-json/polski-pro/v1/settings, więc trzeba ustawić ją bezpośrednio.
| Ustawienie | Opis |
|---|---|
| Włącz znakowanie wodne | Aktywuje moduł dla wszystkich plików do pobrania |
| Tekst znaku wodnego | Treść watermarku z placeholderami |
| Rozmiar czcionki (PDF) | Rozmiar tekstu znaku wodnego w PDF |
| Przezroczystość (PDF) | Poziom przezroczystości watermarku w PDF |
| Styl CSS (EPUB) | Styl CSS elementu div ze znakiem wodnym w EPUB |
Włączanie modułu
Dział zatytułowany „Włączanie modułu”Moduł jest kontrolowany kluczem enabled w tej samej opcji polski_pro_watermark, a nie na ekranie modułów Polski:
polski_pro_watermark => [ 'enabled' => true, ... ]