# Niestandardowe tło na stronie logowania

Podczas przejścia na stronę logowania może wyświetlać się tło dostosowane do potrzeb klienta.

## Skąd wiemy, jaki to klient, skoro to strona logowania i nikt nie jest zalogowany?

1. Jeśli użytkownik był wcześniej zalogowany i się wylogował/został wylogowany, w przeglądarce w `localStorage` zostaje informacja o ostatnim aktywnym pryncypale: ![](<https://docs.logintegra.com/apollo-backend/static/Authorities &amp; Settings/custom-login-page/principal-alias.png>)
2. Jeśli użytkownik wchodzi na stronę z domeny klienta, na której serwowany jest `iframe` przekierowujący do apollo, to nazwę pryncypała bierzemy z atrybutu `iframe'a` (jeśli nie jest ustawiony `principalAlias` w `localStorage` - `principalAlias` jest nadrzędny). Taka konfiguracja występuje tylko w środowisku produkcyjnym w przypadku niektórych klientów: ![](<https://docs.logintegra.com/apollo-backend/static/Authorities &amp; Settings/custom-login-page/iframe.png>)

## Skąd wiemy, jakie tło wyświetlić?

- szukamy firmy o podanym aliasie,
- szukamy dla niej settingsu `AVAILABLE_LOGIN_PAGE_BACKGROUND_FILE_NAMES` - są tam nazwy dostępnych plików oddzielone przecinkami,
- wybieramy losowy z dostępnych plików,
- jeśli pryncypał nie ma dostępnego żadnego tła w settingsie `AVAILABLE_LOGIN_PAGE_BACKGROUND_FILE_NAMES` szukamy wtedy tego ustawienia dla firmy `DEFAULT_PRINCIPAL`

## Jak ustawić nowe niestandardowe tło dla pryncypała?

### Google Storage

1. Wchodzimy na Google Storage do odpowiedniego zasobnika (test/prod)
2. Odszukujemy folder `loginPageBackground`
3. Wchodzimy w folder o nazwie wybranego pryncypała lub dodajemy taki folder
4. Do folderu o nazwie pryncypała dodajemy nowy plik z tłem

![](<https://docs.logintegra.com/apollo-backend/static/Authorities &amp; Settings/custom-login-page/google-storage-background-files.png>)

### Aplikacja

1. Odszukujemy setting `AVAILABLE_LOGIN_PAGE_BACKGROUND_FILE_NAMES` ("Nazwy plików z dostępnymi tłami logowania dla pryncypała") dla wybranego pryncypała
2. Dopisujemy tam dodane tło po przecinku

Np. dla Hochlandu dostępne są 3 tła na Google Storage:

![](<https://docs.logintegra.com/apollo-backend/static/Authorities &amp; Settings/custom-login-page/google-storage-options.png>)

Żeby wyświetlane tło było wybierane spośród tych trzech plików, wszystkie trzy muszą znaleźć się w ustawieniu `AVAILABLE_LOGIN_PAGE_BACKGROUND_FILE_NAMES`:

```
   id     | version | company_id |      date_created       |      last_updated       |                    name                    |        value         | editable 
-----------+---------+------------+-------------------------+-------------------------+--------------------------------------------+----------------------+----------
 242645623 |       0 |   20786523 | 2022-01-05 14:39:42.559 | 2022-01-05 14:39:42.559 | AVAILABLE_LOGIN_PAGE_BACKGROUND_FILE_NAMES | 1.jpeg,2.jpeg,3.jpeg | t
```

## Jak ustawić domyślne tło dla wszystkich firm bez settingu dot. tła?

### Google Storage

1. Wchodzimy na Google Storage do odpowiedniego zasobnika (test/prod)
2. Odszukujemy folder `loginPageBackground`
3. Wchodzimy w folder o nazwie `default`
4. Do folderu dodajemy nowy plik z tłem

### Aplikacja

1. Logujemy się na konto `super-admin`
2. Odszukujemy setting `AVAILABLE_LOGIN_PAGE_BACKGROUND_FILE_NAMES` ("Nazwy plików z dostępnymi tłami logowania z folderu `default` na Google Storage")
3. Dopisujemy tam dodane tło po przecinku
