Dokumentacja dla programistów: Jak to działa
Asystent przesyłania
Asystent przesyłania
Koniec z błędami „plik jest za duży”: pliki PDF, zdjęcia i obrazy HEIC z iPhone’a są zmniejszane w przeglądarce odwiedzającego i przekazywane do formularza, który otrzymuje plik mieszczący się w limicie.
Gdzie ustawić limit
Dodaj data-pdfkind-max tam, gdzie trafiają pliki. Pierwszeństwo ma najbliższy element z tym atrybutem, więc jedno pole może mieć własny limit w formularzu, który ma inny.
| Miejsce przesyłania | Gdzie dodać data-pdfkind-max | Przykład |
|---|---|---|
| Pole pliku | w polu input | <input type="file" data-pdfkind-max="5MB"> |
| Obszar przeciągania i upuszczania | w tym obszarze (obejmuje upuszczanie i jego przycisk „przeglądaj”) | <div class="dropzone" data-pdfkind-max="5MB"> |
| Cały formularz | w elemencie form | <form data-pdfkind-max="5MB"> |
| Wszystkie pola na stronie | w tagu script, jako data-max | <script src="…/embed.js" data-max="5MB" defer> |
Zapis limitu
Zapisz go jako 5MB, 500KB, 2.5 MB lub 800ko albo jako liczbę bajtów, np. 5000000. 1 MB to 1 000 000 bajtów.
5MB: to nieco mniej, więc zmniejszone pliki zawsze przejdą Twoją weryfikację.Co dzieje się z każdym plikiem
| Plik | Co robi asystent |
|---|---|
| Poniżej limitu | Nic. Plik trafia od razu do formularza, żadne okno się nie otwiera. |
| PDF powyżej limitu | Zmniejszany: najpierw odchudzane są czcionki i zduplikowane dane, a potem obrazy, tylko w niezbędnym stopniu. Tekst pozostaje ostry i można go zaznaczać. |
| JPG, PNG, WebP powyżej limitu | Ponownie kodowane i skalowane tylko w niezbędnym stopniu. PNG bez przezroczystości, którego nie da się zmieścić w limicie, staje się plikiem JPG. |
| HEIC lub HEIF (zdjęcia z iPhone’a) | Zawsze zamieniane na JPG, nawet poniżej limitu, bo większość formularzy nie akceptuje HEIC. |
| Każdy inny plik (Word, ZIP…) | Pozostaje bez zmian. |
| Kilka plików naraz | Każdy jest przetwarzany po kolei; pole otrzymuje wszystkie. |
Co widzi odwiedzający
Nad stroną otwiera się małe okno PDFkind z komunikatem „Zmniejszanie pliku…”, następnie pokazuje wynik („Zmniejszono z 8,2 MB do 3,9 MB”) i samo się zamyka. Większość plików zajmuje od 1 do 5 sekund; długi skan na starszym telefonie może potrwać około 15.
| Jeśli | Wtedy |
|---|---|
| pliku nie da się zmniejszyć poniżej limitu | Okno wyjaśnia dlaczego, a potem przekazywany jest oryginalny plik, więc formularz pokaże swój zwykły błąd. |
| odwiedzający zamknie okno | Przekazywany jest oryginalny plik. |
| okno nie załaduje się w ciągu 8 sekund | Od razu przekazywany jest oryginalny plik (brak połączenia lub blokada przez Twoje reguły bezpieczeństwa). |
| sam skrypt nie może się załadować | Na stronie nic się nie zmienia: formularz działa jak dotychczas. |
Język okna
Okno używa języka z atrybutu <html lang> Twojej strony. Aby wybrać inny, ustaw data-lang="fr" w polu lub w skrypcie. Zobacz Języki.
Frameworki
Ostatnia aktualizacja: 3 listopada 2026 · Pytania: contact@pdfkind.com