تخصيص مظهر وعلامة Element Web التجارية
قم بتعيين اسم ذي علامة تجارية وألوان مخصصة وأصول تسجيل دخول لنشر Element Web الخاص بك مع فهم الأجزاء التي ستظل تحمل علامة Element التجارية.
لنشر Element Web على خادم ذاتي، حدد اسم التطبيق والسمة الافتراضية في ملف .html config.json، ثم استخدم brandingالخيارات الموثقة لشعار تسجيل الدخول والخلفية ورابط الشعار وروابط التذييل. لتخصيص الألوان، حدد سمة ضمن ملف .html setting_defaults.custom_themesوأشر default_themeإلى custom-اسمها. تُضفي هذه الإعدادات طابعًا شخصيًا على Element، لكنها لا تحوله إلى منتج جاهز للاستخدام بالكامل.
يفصل إعداد Element بين هوية المنتج، وأنظمة الألوان، وموارد الصفحة. اختر أصغر تغيير يحقق هدفك:
| الهدف | التكوين | ما الذي يغيره |
|---|---|---|
| أظهر اسم الخدمة الخاصة بك | brand | اسم التطبيق في سلاسل ومواقع مختلفة |
| اختر سمة بداية فاتحة أو داكنة أو مخصصة | default_theme | نظام الألوان الافتراضي للنشر |
| تغيير مظهر تسجيل الدخول والترحيب | branding | شعار صفحة المصادقة، والخلفية، ورابط الشعار، وروابط التذييل |
| قم بتعيين الألوان والخطوط المخصصة | setting_defaults.custom_themes | خيارات السمات مثل رموز الألوان وعائلات الخطوط |
تم التحقق: تشير وثائق Element إلى دعمها لبعض التخصيصات، ولكن ليس لإعادة تصميم العلامة التجارية بالكامل أو وضع علامات تجارية خاصة. النتيجة العملية: لن يؤدي التغيير brandإلى استبدال جميع الشعارات والأيقونات والصور ومراجع المنتجات. إذا كنت بحاجة إلى تغيير جميع العناصر المرئية والنصوص، فتوقع الاحتفاظ بنسخة مخصصة وإعادة فحصها بعد التحديثات. ابدأ بتحديد عناصر واجهة المستخدم التي يحتاج المستخدمون إلى رؤيتها قبل اختيار نهج يعتمد على الإعدادات فقط.
يقرأ 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 من موقع يمكن لمستخدميك الوصول إليه، وتأكد من أن عناصر التحكم في الوصول وسياسة أمان المحتوى والتخزين المؤقت لا تحظرها. لا تُحدد الوثائق حجم صورة موحدًا لشعار المصادقة، لذا عاين الأصل الفعلي بدلاً من افتراض بُعد ثابت.
يعتمد ذلك على طريقة النشر: يؤثر ملف الإعدادات على نسخة Element Web التي تُشغّله. ولا يُغيّر app.element.ioالخدمة الرسمية أو تطبيقات Element المنفصلة للهواتف المحمولة أو أجهزة الكمبيوتر تلقائيًا. قم بإجراء التعديل على المضيف أو الحاوية التي تُشغّل نسختك الخاصة.
للحصول على سمة بسيطة للألوان والخطوط، يوفر Element تعريفات السمات المخصصة داخل ملف setting_defaults.custom_themes. يُسبق الاسم الداخلي للسمة بـ custom-؛ استخدم هذا الاسم الكامل في default_theme. يوضح هذا المثال سمة مخصصة مختصرة. إنها نقطة انطلاق، وليست مجموعة ألوان كاملة.
{
"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كائن ثانٍ. حافظ على وضوح التباين بين النصوص والخلفيات وعناصر التحكم في كلتا الحالتين: العادية والمميزة. يتضمن مرجع سمات العنصر ألوانًا اختيارية إضافية، ومصفوفات ألوان اسم المستخدم والصورة الرمزية، وأنواع خطوط مخصصة، ورموز تصميم مركبة. أضف فقط القيم التي راجعتها في المرجع الحالي؛ فقد يؤدي عدم اكتمال لوحة الألوان إلى ترك بعض أجزاء الواجهة تستخدم الإعدادات الافتراضية.
سوء فهم شائع: يحدد الإعداد default_themeالإعدادات الافتراضية للنشر؛ ولا تصفه الوثائق بأنه سياسة تُقفل إعدادات مظهر كل مستخدم. إذا كنت بحاجة إلى سمة مُطبقة بشكل صارم، فتحقق من هذا السلوك على إصدار Element Web الذي تستخدمه تحديدًا، بدلًا من افتراض أن الإعداد الافتراضي هو قفل.
لإجراء اختبار سمة أثناء التشغيل، توضح ملاحظات السمات في Element كيفية تحميل رابط JSON للسمة من /devtoolsقسم "السمات المخصصة". تعامل مع هذا كإجراء اختبار أو سير عمل من جانب المستخدم، وليس كبديل لنشر الإعدادات المطلوبة لجميع العملاء. لضمان سهولة الصيانة، احتفظ بالإعدادات والأصول تحت نظام التحكم في الإصدارات، وكرر هذا الفحص عند ترقية Element Web.
يتبع السلوك الموصوف هنا وثائق تكوين وتصميم Element Web الرسمية التي تم التحقق منها في 10 أكتوبر 2026. راجع المراجع الخاصة بالإصدار المثبت لديك قبل الاعتماد على أي إعداد: مرجع تكوين Element Web ، ووثائق تصميم Element Web ، ووثائق تثبيت Element Web .
قم بتعيين اسم ذي علامة تجارية وألوان مخصصة وأصول تسجيل دخول لنشر Element Web الخاص بك مع فهم الأجزاء التي ستظل تحمل علامة Element التجارية.
قم بتشخيص ما إذا كان برنامج Synapse قد وصل إلى الحد الأقصى للملفات المفتوحة لكل عملية، وقم بتعيين ملف systemd drop-in للخدمة أو العامل المناسب، وتحقق من الحد الأقصى للتشغيل.
اكتشف ما إذا كان الخطأ يقتصر على متصفح واحد أو حدث واحد، ثم استخدم مفتاح استرداد Element أو جهازًا موثوقًا به دون المخاطرة بسجل التصفح المشفر المتبقي.
استخدم واجهات برمجة تطبيقات Synapse الخاصة بحذف السجلات والوسائط أو إعدادات الاحتفاظ لإزالة البيانات القديمة بأمان، ثم تحقق من اكتمال العملية واستعادة مساحة القرص.
قم بتثبيت المكتبة الحالية، وقم بتوصيل حساب Matrix مخصص، وقم بتشغيل روبوت !echo صغير مع معالجة بيانات اعتماد أكثر أمانًا واختبار واضح.
قم بإعداد ثلاثة جسور mautrix مع تسجيلات وتسجيلات دخول واختبارات منفصلة - وتجنب مفاجآت شبكات Docker وسياسة الحساب والمزامنة.
ابحث عن الأشياء التي تملأ مساحة تخزين Synapse، وقم بتعيين الاحتفاظ الآمن بالوسائط، وقم بمسح ذاكرة التخزين المؤقت عن بعد دون حذف الملفات مباشرة من القرص.
راجع نشاط الجهاز، وقم بتعطيل حسابات Synapse غير النشطة المؤكدة من خلال واجهة برمجة تطبيقات المسؤول، وتعرف على ما الذي تزيله علامة المسح الاختيارية فعليًا.
حدد ما إذا كانت ذاكرة PostgreSQL تأتي من عمليات الاستعلام، أو المخازن المؤقتة المشتركة، أو الاتصالات، أو الصيانة، ثم قم بإجراء تغييرات مستهدفة آمنة لـ Synapse.
تتبع عمليات انضمام غرفة المصفوفة البطيئة إلى خادم منزلي بعيد واحد، أو تراجع الاتحاد، أو تحميل قاعدة البيانات المحلية، أو قائمة انتظار المرسل الصادر قبل تغيير إعدادات Synapse.