W przypadku wdrożenia Element Web z własnym hostingiem, ustaw nazwę aplikacji i domyślny motyw w jej pliku config.json. Następnie użyj udokumentowanych brandingopcji dla logo logowania, tła, linku do logo i linków stopki. W przypadku niestandardowych kolorów zdefiniuj motyw w sekcji setting_defaults.custom_themesi wskaż default_themejego custom-nazwę. Te ustawienia personalizują Element, ale nie zmieniają go w kompletny produkt white-label.
Dowiedz się, jakich kontroli marki potrzebujesz
Konfiguracja Elementu oddziela tożsamość produktu, motywy kolorystyczne i zasoby strony. Wybierz najmniejszą zmianę, która spełni Twój cel:
| Cel | Konfiguracja | Co zmienia |
| Pokaż nazwę swojej usługi | brand | Nazwa aplikacji w różnych ciągach i lokalizacjach |
| Ustaw jasny, ciemny lub niestandardowy motyw początkowy | default_theme | Domyślny motyw kolorów dla wdrożenia |
| Zmiana logowania i wyglądu powitania | branding | Logo strony autoryzacyjnej, tło, link do logo i linki stopki |
| Ustaw niestandardowe kolory i czcionki | setting_defaults.custom_themes | Opcje motywu, takie jak tokeny kolorów i rodziny czcionek |
Zweryfikowano: Dokumentacja Elementu informuje, że obsługuje on pewną personalizację, ale nie pełny rebranding ani prywatne etykietowanie. Praktyczne implikacje: zmiana brandnie spowoduje zastąpienia każdego logo, ikony, obrazu ani odniesienia do produktu. Jeśli potrzebujesz zmienić każdy element wizualny i ciąg znaków, spodziewaj się, że będziesz musiał zachować niestandardową wersję i ponownie ją sprawdzić po aktualizacjach. Zacznij od wyszczególnienia elementów interfejsu użytkownika, które użytkownicy muszą zobaczyć, zanim zdecydujesz się na podejście oparte wyłącznie na konfiguracji.
Bezpieczna aktualizacja wdrożonej konfiguracji
Element Web odczytuje dane config.jsonpodczas uruchamiania. Utwórz kopię zapasową bieżącego pliku i edytuj go w tym samym miejscu, aby zachować wymagane ustawienia, takie jak domyślny serwer domowy. W przypadku archiwum tarball, plik znajduje się w katalogu „wdrożony web”; pakiet Debiana używa /etc/element-web/config.json. W przypadku Dockera zamontuj swoją konfigurację w /app/config.json. Prawidłowa lokalizacja zależy od sposobu instalacji Element, więc przed edycją sprawdź metodę wdrożenia.
Dodaj poniższe klucze do istniejącego obiektu JSON, łącząc je z wszelkimi już istniejącymi ustawieniami. Nie wklejaj ich jako zamienników dla całej konfiguracji:
{
"brand": "Northstar Chat",
"default_theme": "dark",
"permalink_prefix": "https://chat.example.org",
"branding": {
"logo_link_url": "https://example.org",
"auth_header_logo_url": "https://chat.example.org/assets/logo.svg",
"welcome_background_url": "https://chat.example.org/assets/welcome.jpg",
"auth_footer_links": [
{ "text": "Help", "url": "https://example.org/help" },
{ "text": "Privacy", "url": "https://example.org/privacy" }
]
}
}
Zastąp przykładową nazwę, nazwy hostów i zasoby swoimi. brandZmienia nazwę aplikacji w różnych miejscach; permalink_prefixsprawia, że współdzielone linki trwałe wskazują na wdrożenie elementu, a nie na matrix.to. Wpisy logo i tła to adresy URL ładowane przez przeglądarkę. Udostępniaj je przez HTTPS z lokalizacji dostępnej dla użytkowników i upewnij się, że kontrola dostępu, polityka bezpieczeństwa treści i buforowanie ich nie blokują. Dokumentacja nie określa jednego uniwersalnego rozmiaru obrazu dla logo uwierzytelniania, więc zamiast zakładać stały rozmiar, obejrzyj podgląd rzeczywistego zasobu.
Zależy od wdrożenia: plik konfiguracyjny wpływa na instancję Element Web, która go obsługuje. Nie zmienia on oficjalnej app.element.iousługi ani nie zmienia automatycznie oddzielnych aplikacji mobilnych lub desktopowych Element. Edytuj na hoście lub kontenerze obsługującym Twoją instancję.
Dodaj niestandardowy motyw kolorów
W przypadku prostego motywu kolorów i czcionek, Element dokumentuje definicje motywów niestandardowych w pliku setting_defaults.custom_themes. Wewnętrzna nazwa motywu jest poprzedzona prefiksem custom-; w pliku default_theme. Ten przykład przedstawia kompaktowy motyw niestandardowy. To punkt wyjścia, a nie kompletna paleta:
{
"default_theme": "custom-Northstar",
"setting_defaults": {
"custom_themes": [
{
"name": "Northstar",
"is_dark": false,
"fonts": {
"general": "Inter, sans-serif",
"monospace": "'Courier New'"
},
"colors": {
"accent-color": "#3157A4",
"primary-color": "#3157A4",
"warning-color": "#B5473C",
"sidebar-color": "#202A3B",
"roomlist-background-color": "#F3F5F8",
"roomlist-text-color": "#202938",
"timeline-background-color": "#FFFFFF",
"timeline-text-color": "#202938"
}
}
]
}
}
Scal te klucze z istniejącym plikiem JSON zamiast tworzyć drugi setting_defaultsobiekt. Zachowaj czytelność kontrastu między tekstem, tłem i elementami sterującymi zarówno w stanie normalnym, jak i podświetlonym. Referencje motywu Element zawierają dodatkowe opcjonalne kolory, tablice kolorów nazw użytkowników i awatarów, niestandardowe kroje czcionek oraz tokeny projektu Compound. Dodawaj tylko wartości sprawdzone w bieżącej referencji; niekompletna paleta może spowodować, że niektóre części interfejsu będą korzystać z wartości domyślnych.
Częste nieporozumienie: ustawienie default_themewybiera domyślne ustawienia wdrożenia; dokumentacja nie opisuje tego jako polityki blokującej ustawienia wyglądu każdego użytkownika. Jeśli potrzebujesz ściśle egzekwowanego motywu, zweryfikuj to zachowanie w odniesieniu do konkretnej wersji Element Web, z której korzystasz, zamiast zakładać, że domyślna wartość to blokada.
Zastosuj zmianę i sprawdź wynik
- Sprawdź poprawność składni JSON przed wdrożeniem. Brak przecinka lub niedopasowany cudzysłów może uniemożliwić załadowanie konfiguracji. Zachowaj poprawność JSON: komentarze nie są obsługiwane.
- Po opublikowaniu pliku odśwież stronę internetową. Jeśli przeglądarka nadal wyświetla starą identyfikację marki, przetestuj odświeżenie twarde lub okno prywatne i sprawdź, czy przeglądarka może poprawnie pobrać adres URL każdego zasobu.
- Sprawdź ekran logowania i interfejs logowania. Upewnij się, że nazwa aplikacji, wybrany motyw, miejsce docelowe logo, tło i linki stopki są poprawne, a także sprawdź kontrast tekstu na liście pokoi i osi czasu.
- Sprawdź narzędzia programistyczne przeglądarki i logi serwera WWW pod kątem nieudanych żądań konfiguracji lub zasobów. Jeśli korzystasz z CDN lub odwrotnego proxy, wyczyść lub odczekaj, aż kopie konfiguracji i zasobów z pamięci podręcznej zostaną usunięte, zgodnie z konfiguracją.
W przypadku testu motywu w czasie wykonywania, w notatkach dotyczących motywów Element opisano ładowanie adresu URL motywu JSON z /devtoolssekcji „Motywy niestandardowe”. Należy to traktować jako proces testowania lub przepływ pracy po stronie użytkownika, a nie jako substytut wdrażania docelowej konfiguracji na wszystkich klientach. Aby zapewnić łatwość obsługi, należy utrzymywać konfigurację i zasoby pod kontrolą wersji i powtarzać tę kontrolę podczas aktualizacji Element Web.
Opisane tutaj zachowanie jest zgodne z oficjalną dokumentacją konfiguracji i motywów Element Web sprawdzoną 10 października 2026 r. Przed skorzystaniem z któregokolwiek z ustawień zapoznaj się z materiałami referencyjnymi dotyczącymi zainstalowanej wersji: dokumentacją konfiguracji Element Web , dokumentacją motywów Element Web i dokumentacją instalacji Element Web .