Dostosuj motyw i branding Element Web

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:

CelKonfiguracjaCo zmienia
Pokaż nazwę swojej usługibrandNazwa aplikacji w różnych ciągach i lokalizacjach
Ustaw jasny, ciemny lub niestandardowy motyw początkowydefault_themeDomyślny motyw kolorów dla wdrożenia
Zmiana logowania i wyglądu powitaniabrandingLogo strony autoryzacyjnej, tło, link do logo i linki stopki
Ustaw niestandardowe kolory i czcionkisetting_defaults.custom_themesOpcje 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

  1. 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.
  2. 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.
  3. 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.
  4. 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 .

Zostaw komentarz

Skonfiguruj niestandardowy alias pokoju macierzy w swojej własnej domenie

Nadaj pokojowi Matrix łatwy do udostępniania adres w swojej domenie, korzystając z Element lub interfejsu API Matrix, ze sprawdzaniem uprawnień, nazewnictwem Synapse i federacją.

Skonfiguruj coturn, aby zapewnić niezawodne połączenia głosowe i wideo Matrix

Skonfiguruj coturn i Synapse przy użyciu zgodnych poświadczeń TURN, otwórz wymagane porty przekaźnikowe i sprawdź, czy klienci Matrix mogą uzyskać kandydatów na przekaźniki.

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Wdrażanie Matrix Synapse z Docker Compose i PostgreSQL

Skonfiguruj trwały serwer domowy Synapse z Docker Compose, PostgreSQL, prywatną konfiguracją i sprawdź, czy jest on udostępniany przez HTTPS.

Dostosuj motyw i branding Element Web

Ustaw nazwę marki, niestandardowe kolory i zasoby logowania dla wdrożenia Element Web, pamiętając jednocześnie, które części pozostaną markowe dla Element.

Podnieś limit plików Systemd w Synapse bez zgadywania

Podnieś limit plików Systemd w Synapse bez zgadywania

Sprawdź, czy Synapse osiągnął limit otwartych plików dla każdego procesu, ustaw drop-in systemd dla właściwej usługi lub pracownika i zweryfikuj limit aktywności.

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

Element wyświetla komunikat „Nie udało się odszyfrować”? Przywróć brakujący klucz do pokoju

Sprawdź, czy błąd dotyczy jednej przeglądarki lub jednego zdarzenia, a następnie użyj klucza odzyskiwania Element lub zaufanego urządzenia, nie ryzykując utraty zaszyfrowanej historii.

Oczyść stare wiadomości i media Synapse bez utraty danych

Użyj interfejsów API Synapse do czyszczenia historii i multimediów lub ustawień przechowywania, aby bezpiecznie usunąć nieaktualne dane, a następnie zweryfikuj ukończenie operacji i odzyskanie miejsca na dysku.

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zbuduj bota Matrix Echo w Pythonie za pomocą Simple-Matrix-Bot-Lib

Zainstaluj aktualną bibliotekę, podłącz dedykowane konto Matrix i uruchom małego bota !echo z bezpieczniejszą obsługą poświadczeń i przejrzystym testem.

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Połącz Matrix z WhatsApp, Telegramem i Discordem za pomocą oddzielnych mostów

Skonfiguruj trzy mosty Mautrix z oddzielnymi rejestracjami, logowaniami i testami, aby uniknąć niespodzianek związanych z siecią Docker, polityką kont i synchronizacją.

Odzyskaj miejsce na dysku Synapse Media bez naruszania współdzielonych plików

Znajdź elementy zapełniające pamięć masową Synapse, ustaw bezpieczne przechowywanie multimediów i wyczyść zdalną pamięć podręczną bez konieczności usuwania plików bezpośrednio z dysku.