Het thema en de huisstijl van Element Web aanpassen

Voor een zelfgehoste Element Web-implementatie stelt u de app-naam en het standaardthema in het configuratiebestand in config.jsonen gebruikt u vervolgens de gedocumenteerde brandingopties voor het inloglogo, de achtergrond, de logolink en de links in de footer. Voor aangepaste kleuren definieert u een thema onder het configuratiebestand setting_defaults.custom_themesen verwijst u default_themenaar de custom-naam ervan. Deze instellingen personaliseren Element, maar maken er geen volledig whitelabelproduct van.

Weet welke merkbeheerfuncties je nodig hebt.

De configuratie van Element scheidt productidentiteit, kleurenthema's en pagina-elementen. Kies de kleinste wijziging die uw doel bereikt:

DoelConfiguratieWat het verandert
Toon uw servicenaambrandAppnaam in verschillende tekenreeksen en op verschillende locaties
Stel een licht, donker of aangepast startthema in.default_themeStandaard kleurenthema voor de implementatie
Wijzig de weergave van het inlogscherm en het welkomstscherm.brandingLogo, achtergrond, logolink en links in de footer van de authenticatiepagina
Stel aangepaste kleuren en lettertypen in.setting_defaults.custom_themesThema-opties zoals kleurcodes en lettertypefamilies

Geverifieerd: De documentatie van Element geeft aan dat het enige aanpassingsmogelijkheden biedt, maar geen volledige rebranding of private labeling. Praktische implicatie: een wijziging brandvervangt niet elk logo, pictogram, afbeelding of productreferentie. Als u alle visuele elementen en tekst wilt wijzigen, moet u een aangepaste build onderhouden en deze na upgrades opnieuw controleren. Begin met het opsommen van de exacte UI-elementen die uw gebruikers moeten zien voordat u kiest voor een aanpak die alleen configuratie mogelijk maakt.

De geïmplementeerde configuratie veilig bijwerken

Element Web leest het configuratiebestand config.jsonbij het opstarten. Maak een back-up van het huidige bestand en bewerk het ter plekke, zodat je de benodigde instellingen behoudt, zoals de standaard homeserver. Voor een release-tarball bevindt het bestand zich in de geïmplementeerde webdirectory; het Debian-pakket gebruikt /etc/element-web/config.json. Met Docker koppel je je configuratiebestand aan /app/config.json. De juiste locatie is afhankelijk van hoe je Element hebt geïnstalleerd, dus controleer je implementatiemethode voordat je het bestand bewerkt.

Voeg de volgende sleutels toe aan het bestaande JSON-object en combineer ze met eventuele reeds aanwezige instellingen. Plak dit niet als vervanging voor de volledige configuratie:

{
  "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" }
    ]
  }
}

Vervang de voorbeeldnaam, hostnamen en assets door uw eigen gegevens. brandDe appnaam wordt op verschillende plaatsen gewijzigd; permalink_prefixgedeelde permalinks verwijzen nu naar uw Element-implementatie in plaats van naar matrix.to. Het logo en de achtergrond zijn URL's die door de browser worden geladen. Zorg ervoor dat deze via HTTPS beschikbaar zijn vanaf een locatie die uw gebruikers kunnen bereiken en controleer of toegangsbeheer, contentbeveiligingsbeleid en caching deze niet blokkeren. De documentatie specificeert geen universele afbeeldingsgrootte voor het authenticatielogo, dus bekijk uw daadwerkelijke asset in plaats van uit te gaan van een vaste afmeting.

Afhankelijk van de implementatie: een configuratiebestand heeft invloed op de Element Web-instantie die het host. Het wijzigt de officiële app.element.ioservice niet en past de afzonderlijke mobiele of desktop-apps van Element ook niet automatisch aan. Voer de wijziging door op de host of container die uw eigen instantie host.

Voeg een aangepast kleurenthema toe

Voor een eenvoudig kleuren- en lettertypethema documenteert Element aangepaste themadefinities in het `<thema>`-bestand setting_defaults.custom_themes. De interne naam van het thema wordt voorafgegaan door `<thema>` custom-; gebruik die volledige naam in het ` default_theme<thema>`-bestand. Dit voorbeeld toont een compact aangepast thema. Het is een uitgangspunt, geen compleet kleurenpalet:

{
  "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"
        }
      }
    ]
  }
}

Voeg deze sleutels samen met uw bestaande JSON in plaats van een tweede setting_defaultsobject te creëren. Zorg ervoor dat het contrast tussen tekst, achtergronden en besturingselementen leesbaar blijft, zowel in de normale als in de gemarkeerde staat. De themareferentie van Element bevat extra optionele kleuren, arrays met gebruikersnaam- en avatar-kleuren, aangepaste lettertypen en Compound-ontwerptokens. Voeg alleen waarden toe die u in de huidige referentie hebt bekeken; een onvolledig kleurenpalet kan ertoe leiden dat sommige delen van de interface de standaardwaarden gebruiken.

Veelvoorkomend misverstand: de instelling default_themekiest de standaardinstelling van de implementatie; de ​​documentatie beschrijft het niet als een beleid dat de uiterlijke instellingen van elke gebruiker vergrendelt. Als u een strikt afgedwongen thema nodig hebt, controleer dan of dit gedrag overeenkomt met de exacte Element Web-versie die u gebruikt, in plaats van ervan uit te gaan dat de standaardinstelling een vergrendeling is.

Voer de wijziging door en controleer het resultaat.

  1. Controleer de JSON-syntaxis voordat u deze implementeert. Een ontbrekende komma of een verkeerd geplaatst aanhalingsteken kan ervoor zorgen dat de configuratie niet laadt. Gebruik alleen geldige JSON: commentaar wordt niet ondersteund.
  2. Vernieuw de webpagina na het publiceren van het bestand. Als de browser nog steeds de oude huisstijl weergeeft, test dan een harde vernieuwing of een privévenster en controleer of de browser de URL van elk bestand correct kan ophalen.
  3. Controleer zowel het inlogscherm als de gebruikersinterface. Controleer of de appnaam, het gekozen thema, de locatie van het logo, de achtergrond en de links in de voettekst correct zijn. Inspecteer ook het tekstcontrast in de kamerlijst en de tijdlijn.
  4. Controleer de ontwikkelaarstools van uw browser en de logboeken van de webserver op mislukte configuratie- of assetverzoeken. Als u een CDN of reverse proxy gebruikt, wis dan de in de cache opgeslagen configuratie- en assetkopieën, of wacht tot ze zijn gewist, afhankelijk van uw configuratie.

Voor een runtime-thematest beschrijft Element in zijn theming-handleiding hoe je een JSON-thema-URL laadt vanuit /devtools'Aangepaste thema's'. Beschouw dit als een test- of gebruikersworkflow, niet als een vervanging voor het uitrollen van de beoogde configuratie naar alle clients. Voor een onderhoudbare implementatie is het raadzaam om de configuratie en assets onder versiebeheer te houden en deze controle te herhalen bij het upgraden van Element Web.

Het hier beschreven gedrag volgt de officiële Element Web-configuratie- en themdocumentatie, gecontroleerd op 10 oktober 2026. Raadpleeg de documentatie voor uw geïnstalleerde versie voordat u op een instelling vertrouwt: Element Web-configuratiehandleiding , Element Web-themadocumentatie en Element Web-installatiedocumentatie .

Laat een reactie achter

Herstel Matrix Synapse veilig met een PostgreSQL-dump.

Maak een back-up van Synapse met pg_dump, bescherm de ondertekeningssleutel en de media, en herstel de back-up in een schone PostgreSQL-database zonder verouderde eenmalige sleutels opnieuw te gebruiken.

Mjölnir als Matrix Room Moderation Bot uitvoeren met Docker

Mjölnir als Matrix Room Moderation Bot uitvoeren met Docker

Configureer Mjölnir met een speciaal Matrix-account, een versleutelde beheerruimte, Docker Compose, een beleidslijst en toegangsrechtencontroles.

Schakel native Matrix Sliding Sync in voor sneller laden op mobiele apparaten.

Schakel native Matrix Sliding Sync in voor sneller laden op mobiele apparaten.

Sla de verouderde proxy over en configureer Synapse's ingebouwde Sliding Sync. Controleer de clientdetectie en meet vervolgens het laadgedrag van de kamerlijst en het herverbindingsgedrag op een compatibele telefoon.

Element Web hosten op Nginx met een aangepaste homeserver

Implementeer Element Web als een statische site, verwijs deze naar uw Matrix-homeserver, voeg HTTPS toe en configureer Nginx om updates te leveren zonder verouderde bestanden.

Een lichtgewicht Matrix-homeserver draaien op een Raspberry Pi 4

Configureer Conduit op een 64-bits Raspberry Pi 4 met permanente dataopslag, HTTPS-federatie, beveiligde registratie en controles voor een werkende thuisserver.

Stel een aangepaste Matrix-ruimtealias in op uw eigen domein.

Geef een Matrix-ruimte een eenvoudig te delen adres op uw domein met behulp van Element of de Matrix API, inclusief controles op machtigingen, Synapse-naamgeving en federatie.

Stel coturn in voor betrouwbare Matrix-spraak- en videogesprekken.

Configureer coturn en Synapse met overeenkomende TURN-gegevens, open de vereiste relaypoorten en controleer of Matrix-clients relaykandidaten kunnen verkrijgen.

Implementeer Matrix Synapse met Docker Compose en PostgreSQL.

Implementeer Matrix Synapse met Docker Compose en PostgreSQL.

Zet een permanente Synapse-homeserver op met Docker Compose, PostgreSQL, een privéconfiguratie en controles voordat je deze via HTTPS beschikbaar stelt.

Het thema en de huisstijl van Element Web aanpassen

Stel een merknaam, aangepaste kleuren en inloggegevens in voor uw Element Web-implementatie, en zorg ervoor dat u weet welke onderdelen het Element-merk behouden.

Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.

Verhoog de limiet voor systeembestanden in Synapse zonder te hoeven gissen.

Stel vast of Synapse de limiet voor geopende bestanden per proces heeft bereikt, stel een systemd drop-in in voor de juiste service of worker en controleer de actuele limiet.