ปรับแต่งธีมและแบรนด์ของ Element Web

สำหรับการติดตั้ง Element Web บนเซิร์ฟเวอร์ของคุณเอง ให้ตั้งชื่อแอปและธีมเริ่มต้นในไฟล์ `<app.web>` config.jsonจากนั้นใช้brandingตัวเลือกที่ระบุไว้สำหรับโลโก้การเข้าสู่ระบบ พื้นหลัง ลิงก์โลโก้ และลิงก์ส่วนท้าย สำหรับสีที่กำหนดเอง ให้กำหนดธีมภายใต้ `<app.web>` setting_defaults.custom_themesและชี้default_themeไปยังcustom-ชื่อของธีมนั้น การตั้งค่าเหล่านี้ช่วยปรับแต่ง Element แต่ไม่ได้ทำให้ Element กลายเป็นผลิตภัณฑ์ไวท์เลเบลอย่างสมบูรณ์

ทราบว่าคุณต้องการการควบคุมการสร้างแบรนด์แบบใดบ้าง

การตั้งค่าของ Element จะแยกส่วนต่างๆ ออกจากกัน เช่น เอกลักษณ์ของผลิตภัณฑ์ ธีมสี และเนื้อหาของหน้าเว็บ เลือกการเปลี่ยนแปลงที่เล็กที่สุดที่ช่วยให้บรรลุเป้าหมายของคุณ:

เป้าหมายการกำหนดค่าสิ่งที่มันเปลี่ยนแปลง
แสดงชื่อบริการของคุณbrandชื่อแอปในรูปแบบและตำแหน่งต่างๆ
ตั้งค่าธีมเริ่มต้นแบบสว่าง มืด หรือแบบกำหนดเองdefault_themeธีมสีเริ่มต้นสำหรับการใช้งาน
เปลี่ยนรูปแบบการเข้าสู่ระบบและหน้าจอต้อนรับbrandingโลโก้หน้ายืนยันตัวตน, พื้นหลัง, ลิงก์โลโก้ และลิงก์ส่วนท้าย
ตั้งค่าสีและแบบอักษรเองได้setting_defaults.custom_themesตัวเลือกธีม เช่น โทเค็นสีและตระกูลฟอนต์

ตรวจสอบแล้ว:เอกสารของ Element ระบุว่ารองรับการปรับแต่งบางส่วน แต่ไม่รองรับการเปลี่ยนแบรนด์หรือการติดฉลากส่วนตัวทั้งหมดผลกระทบในทางปฏิบัติ:การเปลี่ยนแปลงbrandจะไม่แทนที่โลโก้ ไอคอน รูปภาพ หรือข้อมูลอ้างอิงผลิตภัณฑ์ทั้งหมด หากคุณต้องการเปลี่ยนภาพและข้อความทั้งหมด คุณจะต้องดูแลรักษาเวอร์ชันที่ปรับแต่งเองและตรวจสอบอีกครั้งหลังจากการอัปเกรด เริ่มต้นด้วยการระบุองค์ประกอบ UI ที่ผู้ใช้ของคุณต้องการเห็นอย่างแม่นยำก่อนที่จะเลือกวิธีการปรับแต่งเพียงอย่างเดียว

อัปเดตการกำหนดค่าที่ใช้งานอยู่ได้อย่างปลอดภัย

Element Web จะอ่านconfig.jsonไฟล์นี้เมื่อเริ่มต้นระบบ สำรองไฟล์ปัจจุบันไว้ก่อน แล้วแก้ไขไฟล์ในตำแหน่งเดิม เพื่อให้คุณเก็บการตั้งค่าที่จำเป็น เช่น โฮมเซิร์ฟเวอร์เริ่มต้น สำหรับไฟล์ tarball เวอร์ชันเผยแพร่ ไฟล์จะอยู่ในไดเร็กทอรีเว็บที่ติดตั้งไว้ สำหรับแพ็คเกจ Debian จะใช้/etc/element-web/config.json. หากใช้ Docker ให้เมานต์การกำหนดค่าของคุณที่/app/config.json. ตำแหน่งที่ถูกต้องขึ้นอยู่กับวิธีการติดตั้ง Element ดังนั้นตรวจสอบวิธีการติดตั้งของคุณก่อนแก้ไข

เพิ่มคีย์ต่อไปนี้ลงในออบเจ็กต์ JSON ที่มีอยู่ โดยผสานรวมกับการตั้งค่าที่มีอยู่แล้ว อย่าคัดลอกและวางแทนที่การกำหนดค่าทั้งหมด:

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

แทนที่ชื่อตัวอย่าง ชื่อโฮสต์ และไฟล์ต่างๆ ด้วยของคุณเอง การเปลี่ยนแปลงนี้ brandจะเปลี่ยนชื่อแอปในหลายๆ ที่ และpermalink_prefixทำให้ลิงก์ถาวรที่ใช้ร่วมกันชี้ไปยังการใช้งาน Element ของคุณแทนที่จะเป็นmatrix.to. รายการโลโก้และพื้นหลังเป็น URL ที่โหลดโดยเบราว์เซอร์ ให้บริการผ่าน HTTPS จากตำแหน่งที่ผู้ใช้ของคุณสามารถเข้าถึงได้ และตรวจสอบให้แน่ใจว่าการควบคุมการเข้าถึง นโยบายความปลอดภัยของเนื้อหา และการแคชไม่ได้บล็อก URL เหล่านั้น เอกสารไม่ได้ระบุขนาดภาพมาตรฐานสำหรับโลโก้การตรวจสอบสิทธิ์ ดังนั้นให้ดูตัวอย่างไฟล์จริงของคุณแทนที่จะสมมติขนาดคงที่

ขึ้นอยู่กับการใช้งาน:ไฟล์การกำหนดค่าจะมีผลต่ออินสแตนซ์ Element Web ที่ให้บริการไฟล์นั้น มันจะไม่เปลี่ยนแปลงapp.element.ioบริการอย่างเป็นทางการหรือเปลี่ยนแปลงแอปมือถือหรือเดสก์ท็อปของ Element โดยอัตโนมัติ โปรดแก้ไขบนโฮสต์หรือคอนเทนเนอร์ที่ให้บริการอินสแตนซ์ของคุณเอง

เพิ่มธีมสีแบบกำหนดเอง

สำหรับธีมสีและแบบอักษรที่เรียบง่าย Element จะบันทึกคำจำกัดความธีมแบบกำหนดเองไว้ในเอกสาร <meta> setting_defaults.custom_themesชื่อภายในของธีมจะขึ้นต้นด้วย <meta> custom-; ให้ใช้ชื่อเต็มนั้นในdefault_theme<meta> ตัวอย่างนี้แสดงธีมแบบกำหนดเองขนาดกะทัดรัด เป็นเพียงจุดเริ่มต้น ไม่ใช่ชุดสีและแบบอักษรที่สมบูรณ์:

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

รวมคีย์เหล่านี้เข้ากับ JSON ที่มีอยู่แล้วของคุณ แทนที่จะสร้างsetting_defaultsอ็อบเจ็กต์ที่สอง รักษาความแตกต่างระหว่างข้อความ พื้นหลัง และส่วนควบคุมให้สามารถอ่านได้ชัดเจนทั้งในสถานะปกติและสถานะไฮไลต์ เอกสารอ้างอิงธีมของ Element ประกอบด้วยสีเพิ่มเติมที่เป็นตัวเลือก ชุดสีชื่อผู้ใช้และรูปประจำตัว แบบอักษรที่กำหนดเอง และโทเค็นการออกแบบ Compound เพิ่มเฉพาะค่าที่คุณได้ตรวจสอบแล้วในเอกสารอ้างอิงปัจจุบันเท่านั้น จานสีที่ไม่สมบูรณ์อาจทำให้บางส่วนของอินเทอร์เฟซใช้ค่าเริ่มต้น

ความเข้าใจผิดที่พบบ่อย:การตั้งค่าdefault_themeจะเลือกค่าเริ่มต้นของการใช้งาน ไม่ใช่ว่าเอกสารอธิบายว่าเป็นนโยบายที่ล็อกการตั้งค่าลักษณะที่ปรากฏของผู้ใช้ทุกคน หากคุณต้องการธีมที่บังคับใช้อย่างเคร่งครัด โปรดตรวจสอบพฤติกรรมนั้นกับ Element Web เวอร์ชันที่คุณใช้งานจริง แทนที่จะคิดว่าค่าเริ่มต้นคือการล็อก

บันทึกการเปลี่ยนแปลงและตรวจสอบผลลัพธ์

  1. ตรวจสอบความถูกต้องของไวยากรณ์ JSON ก่อนนำไปใช้งาน การขาดเครื่องหมายจุลภาคหรือเครื่องหมายอัญประกาศที่ไม่ตรงกันอาจทำให้การโหลดการตั้งค่าล้มเหลว โปรดรักษารูปแบบ JSON ให้ถูกต้อง: ไม่รองรับการใส่ความคิดเห็น
  2. หลังจากเผยแพร่ไฟล์แล้ว ให้รีโหลดหน้าเว็บ หากเบราว์เซอร์ยังคงแสดงโลโก้หรือตราสินค้าแบบเก่า ให้ลองรีเฟรชหน้าเว็บแบบเต็มรูปแบบ หรือใช้โหมดส่วนตัว แล้วตรวจสอบว่าเบราว์เซอร์สามารถดึง URL ของแต่ละไฟล์ได้สำเร็จหรือไม่
  3. ตรวจสอบทั้งหน้าจอเข้าสู่ระบบและอินเทอร์เฟซที่ลงชื่อเข้าใช้แล้ว ยืนยันว่าชื่อแอป ธีมที่เลือก ปลายทางของโลโก้ พื้นหลัง และลิงก์ส่วนท้ายถูกต้อง และตรวจสอบความคมชัดของข้อความในรายการห้องและไทม์ไลน์
  4. ตรวจสอบเครื่องมือสำหรับนักพัฒนาเบราว์เซอร์และบันทึกของเว็บเซิร์ฟเวอร์เพื่อหาคำขอการกำหนดค่าหรือไฟล์ที่ไม่สำเร็จ หากคุณใช้ CDN หรือพร็อกซีแบบย้อนกลับ ให้ล้างหรือรอให้แคชการกำหนดค่าและไฟล์ต่างๆ หมดลงตามการตั้งค่าของคุณ

สำหรับการทดสอบธีมขณะรันไทม์ บันทึกเกี่ยวกับธีมของ Element อธิบายถึงการโหลด URL ของธีมในรูปแบบ JSON จาก/devtoolsส่วน “ธีมที่กำหนดเอง” ให้ถือว่านี่เป็นขั้นตอนการทดสอบหรือการทำงานฝั่งผู้ใช้ ไม่ใช่การทดแทนการปรับใช้การกำหนดค่าที่ต้องการกับไคลเอนต์ทั้งหมด เพื่อการปรับใช้ที่ยั่งยืน ควรเก็บการกำหนดค่าและไฟล์ต่างๆ ไว้ภายใต้ระบบควบคุมเวอร์ชัน และตรวจสอบซ้ำอีกครั้งเมื่ออัปเกรด Element Web

พฤติกรรมที่อธิบายไว้ในที่นี้เป็นไปตามเอกสารการกำหนดค่าและธีมอย่างเป็นทางการของ Element Web ที่ตรวจสอบเมื่อวันที่ 10 ตุลาคม 2026 โปรดตรวจสอบเอกสารอ้างอิงสำหรับเวอร์ชันที่คุณติดตั้งก่อนที่จะนำการตั้งค่าไปใช้: เอกสารอ้างอิงการกำหนดค่า Element Web , เอกสารธีม Element Webและเอกสารการติดตั้ง Element Web

ฝากความเห็น

ตั้งค่านามแฝงห้องเมทริกซ์แบบกำหนดเองบนโดเมนของคุณเอง

กำหนดที่อยู่เว็บไซต์ที่แชร์ได้ง่ายให้กับห้อง Matrix บนโดเมนของคุณโดยใช้ Element หรือ Matrix API พร้อมการตรวจสอบสิทธิ์ การตั้งชื่อ Synapse และการเชื่อมโยงระบบ

ตั้งค่า coturn เพื่อการโทรด้วยเสียงและวิดีโอผ่าน Matrix ที่เชื่อถือได้

กำหนดค่า coturn และ Synapse ด้วยข้อมูลรับรอง TURN ที่ตรงกัน เปิดพอร์ตรีเลย์ที่จำเป็น และตรวจสอบว่าไคลเอ็นต์ Matrix สามารถรับผู้สมัครรีเลย์ได้

ติดตั้งใช้งาน Matrix Synapse ด้วย Docker Compose และ PostgreSQL

ติดตั้งใช้งาน Matrix Synapse ด้วย Docker Compose และ PostgreSQL

ตั้งค่าโฮมเซิร์ฟเวอร์ Synapse แบบถาวรด้วย Docker Compose, PostgreSQL, การกำหนดค่าส่วนตัว และการตรวจสอบต่างๆ ก่อนที่จะเปิดเผยผ่าน HTTPS

ปรับแต่งธีมและแบรนด์ของ Element Web

กำหนดชื่อแบรนด์ สีที่กำหนดเอง และองค์ประกอบการเข้าสู่ระบบสำหรับการใช้งาน Element Web ของคุณ พร้อมทั้งทำความเข้าใจว่าส่วนใดบ้างที่ยังคงใช้แบรนด์ Element อยู่

เพิ่มขีดจำกัดไฟล์ Systemd ของ Synapse โดยไม่ต้องคาดเดา

เพิ่มขีดจำกัดไฟล์ Systemd ของ Synapse โดยไม่ต้องคาดเดา

ตรวจสอบว่า Synapse ถึงขีดจำกัดการเปิดไฟล์ต่อกระบวนการแล้วหรือไม่ ตั้งค่า systemd drop-in สำหรับบริการหรือ worker ที่ถูกต้อง และตรวจสอบขีดจำกัดแบบเรียลไทม์

หากพบข้อความ “ถอดรหัสไม่สำเร็จ” ให้กู้คืนรหัสห้องที่หายไป

หากพบข้อความ “ถอดรหัสไม่สำเร็จ” ให้กู้คืนรหัสห้องที่หายไป

ตรวจสอบว่าข้อผิดพลาดนั้นเกิดขึ้นเฉพาะกับเบราว์เซอร์เดียวหรือเหตุการณ์เดียวหรือไม่ จากนั้นใช้รหัสกู้คืนของ Element หรืออุปกรณ์ที่เชื่อถือได้โดยไม่ต้องเสี่ยงกับประวัติการเข้ารหัสที่เหลืออยู่ของคุณ

ล้างข้อความและไฟล์มีเดียเก่าๆ ของ Synapse โดยไม่สูญเสียข้อมูล

ใช้ API สำหรับล้างประวัติและสื่อของ Synapse หรือการตั้งค่าการเก็บรักษาข้อมูลเพื่อลบข้อมูลที่ล้าสมัยอย่างปลอดภัย จากนั้นตรวจสอบความสมบูรณ์และการกู้คืนพื้นที่ดิสก์

สร้างบอท Matrix Echo ในภาษา Python โดยใช้ Simple-Matrix-Bot-Lib

สร้างบอท Matrix Echo ในภาษา Python โดยใช้ Simple-Matrix-Bot-Lib

ติดตั้งไลบรารีเวอร์ชันปัจจุบัน เชื่อมต่อบัญชี Matrix เฉพาะ และเรียกใช้บอท !echo ขนาดเล็กที่มีการจัดการข้อมูลประจำตัวที่ปลอดภัยยิ่งขึ้นและการทดสอบที่ชัดเจน

เชื่อมต่อ Matrix กับ WhatsApp, Telegram และ Discord ด้วยบริดจ์แยกต่างหาก

เชื่อมต่อ Matrix กับ WhatsApp, Telegram และ Discord ด้วยบริดจ์แยกต่างหาก

ตั้งค่าบริดจ์ Mautrix สามตัว โดยแยกการลงทะเบียน การเข้าสู่ระบบ และการทดสอบออกจากกัน เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นจากการเชื่อมต่อเครือข่าย Docker นโยบายบัญชี และการซิงค์ข้อมูล

เรียกคืนพื้นที่ดิสก์ Synapse Media โดยไม่ทำให้ไฟล์ที่แชร์เสียหาย

ค้นหาสิ่งที่กำลังทำให้พื้นที่เก็บข้อมูลของ Synapse เต็ม ตั้งค่าการเก็บรักษาข้อมูลสื่ออย่างปลอดภัย และล้างแคชระยะไกลโดยไม่ต้องลบไฟล์โดยตรงจากดิสก์