Dokumentacja

Przewodnik po aplikacji KSeFka

Personalizacja (PRO)#

Personalizacja pozwala dostosować branding firmy w dwóch miejscach: na generowanej fakturze PDF oraz w bocznym menu wyboru firmy. To funkcja licencji PRO — dla statusów Free, Trial i TrialExpired personalizacja nie jest aktywna.

Sekcję Personalizacja znajdziesz w ustawieniach firmy (Ustawienia → Firmy → wybierz firmę → edytuj). Dla użytkowników Free sekcja jest widoczna, ale pola są nieaktywne — obok nagłówka jest odznaka PRO i link do aktywacji licencji.

Co można personalizować#

Logo na fakturze#

  • Format: PNG o wymiarach dokładnie 800×300 pikseli albo dowolny plik SVG.
  • Gdzie widać: w nagłówku wygenerowanego PDF faktury (oraz w podglądzie w ustawieniach).

Format landscape (800×300) pasuje do nagłówka faktury. Ścisłe wymiary wymuszają świadome przygotowanie pliku zamiast nieprzewidywalnego skalowania.

Logo w menu bocznym#

  • Format: PNG o wymiarach dokładnie 128×128 pikseli albo dowolny plik SVG.
  • Gdzie widać: wyłącznie w sidebarze aplikacji.
  • Jeśli nie wgrasz tego logo, sidebar pokazuje domyślne logo KSeFki — landscape logo z faktury nie jest używane w sidebarze, bo po zmniejszeniu byłoby nieczytelne.

Dodatkowy tekst na fakturze#

  • Pole na dodatkowe informacje kontaktowe (strona www, dane bankowe itp.), renderowane pod blokiem sprzedawcy/nabywcy na PDF.
  • Limit: 500 znaków; każda nowa linia to osobny wiersz.
  • Emoji i znaki spoza podstawowego alfabetu nie są renderowane (czcionka Liberation Sans ma ograniczony zestaw glifów).
  1. Otwórz ustawienia firmy → sekcja Personalizacja.
  2. W odpowiednim panelu kliknij Wgraj logo i wybierz plik PNG lub SVG zgodny z wymaganiami. Podgląd aktualizuje się natychmiast.
  3. W sidebarze logo pojawia się od razu; na fakturze — przy następnej generacji PDF.
  4. Usuń logo czyści dany slot bez wpływu na drugi.

Co się dzieje, gdy licencja PRO wygaśnie#

Dane personalizacji pozostają w bazie — nie są usuwane. Jednak do czasu ponownej aktywacji:

  • PDF faktury nie zawiera logo ani dodatkowego tekstu,
  • sidebar pokazuje domyślne logo KSeFki.

Po ponownej aktywacji licencji PRO personalizacja wraca automatycznie, bez konieczności ponownego wgrywania plików.

Często zadawane pytania#

Czy mogę mieć jedno uniwersalne logo dla obu kontekstów?

Technicznie tak — wgraj ten sam plik SVG w obu slotach (SVG nie ma ograniczeń wymiarów). Ale uważaj: plik musi dobrze wyglądać zarówno jako 32-pikselowa ikona w menu bocznym, jak i jako ~2,5-centymetrowy element nagłówka faktury. Dla większości wordmarków jest to trudne — zwykle wychodzi lepiej, gdy wgrasz dwa różne pliki.

Dlaczego dwa sloty, skoro inne aplikacje zwykle mają jeden?

Inne aplikacje najczęściej akceptują tylko kwadratową ikonę lub tylko wordmark. KSeFka obsługuje oba konteksty (dokument drukowany + interfejs aplikacji) — każdy ma osobny slot logo, więc możesz wgrać jedno z nich, oba albo żadne.

Co jeśli mam tylko kwadratowe logo (np. profilowe firmy)?

Wgraj je jako logo w menu bocznym, a logo na fakturze zostaw puste — PDF będzie generowany bez loga, ale nadal wygląda profesjonalnie dzięki blokowi danych firmy w nagłówku.

Co jeśli mam tylko landscape wordmark?

Wgraj go jako logo na fakturze. Menu boczne pokaże domyślne logo KSeFki — to świadomy wybór projektowy: nie zmniejszamy landscape wordmarku do 32 pikseli, bo wynik jest nieczytelny.

Zobacz też#