المظهر
كل ما يقع ضمن مظهر الودجت في لوحة التحكم. المعاينة الحية تتحدّث فور تغيير القيم؛ ولا شيء يُطبَّق على موقعك حتى تحفظ التغييرات.
المعاينة
كل شيء في هذه الصفحة يظهر في المعاينة أعلاها أثناء الكتابة — الألوان والخط والشعار والنص، إضافةً إلى رسالة الترحيب ونموذج ما قبل المحادثة عند تفعيلهما.
تفعيل السؤال قبل بدء المحادثة يقسّم المعاينة إلى جزأين: المحادثة على اليسار و قبل بدء المحادثة على اليمين، بحيث يبقى تنسيق رسائلك ظاهرًا أثناء كتابة النموذج. على الشاشات الضيقة يتراصّ الجزآن فوق بعضهما.
إنها تقريب دقيق، وليست الودجت نفسها. اختبر التموضع وأي شيء يعتمد على CSS على صفحة حقيقية — راجع دقة المعاينة.
الهوية
| الإعداد | الافتراضي | ملاحظات |
|---|---|---|
| اسم المساعد | Minaya | يظهر في الرأس ويُستخدم في رسالة الترحيب الافتراضية. للخطط المدفوعة. |
| رابط الشعار | شعار Minaya | أي رابط صورة عام. للخطط المدفوعة. |
| رسالة الترحيب | مرحبًا، أنا Minaya مساعدك الذكي… | أول رسالة يراها الزائر. تُدرج اسم المساعد تلقائيًا. |
إعادة تسمية المساعد تغيّر رسالة الترحيب الافتراضية أيضًا، بحيث لا يقدّم نفسه تحت اسم خاطئ أبدًا.
السمة
تحتفظ Minaya بلوحتَي ألوان — فاتحة وداكنة. لست مضطرًا لملء كلتيهما: اختر نمطًا جاهزًا أو لون علامتك التجارية وتُشتق كل قيمة أخرى تلقائيًا، في اللوحتين معًا.
الأنماط الجاهزة ولون العلامة التجارية
تُعرض ستة أنماط جاهزة كودجت مصغّرة، بحيث تختار مظهرًا لا اسمًا. أسفلها، أو استخدم لون علامتك التجارية يأخذ لونًا واحدًا ويطابق البقية معه:
- يتحول نص الرأس إلى أسود أو أبيض، أيهما أوضح للقراءة.
- فقاعة الرد تأخذ درجة فاتحة من لون علامتك التجارية بدلًا من البقاء رماديًا محايدًا.
- بالنسبة للوحة الداكنة، أي لون علامة تجارية داكن جدًا بحيث لا يُقرأ على لوحة قريبة من السواد يُفتَّح حتى يصبح مقروءًا.
كل زوج مُشتق يتجاوز عتبة تباين WCAG AA البالغة 4.5:1، بحيث تبقى السمة مقروءة حتى لو لم تعدّلها أبدًا.
الضبط الدقيق
ضبط الألوان الفردية بدقة يفتح المجموعة الكاملة. كل قيمة اختيارية — ما لا تعدّله يحتفظ بقيمته المُشتقة.
| الإعداد | ينطبق على |
|---|---|
| لون العلامة التجارية | شريط الرأس، فقاعات الزائر، زر الإرسال، زر الإطلاق |
| نص الرأس | اسم المساعد والأيقونات في الشريط العلوي |
| نافذة المحادثة | الخلفية خلف المحادثة |
| خلفية الرد | خلف كل رسالة من المساعد |
| نص الرد | النص داخل ردود المساعد |
| نص رسالة الزائر | النص داخل فقاعات الزائر نفسه |
| نص العنصر النائب | تلميح “اكتب رسالة” وعناصر الواجهة الأخرى |
إذا انخفض زوج ضبطته يدويًا عن 4.5:1، تنبّهك لوحة التحكم مباشرة مع نسبة التباين المقاسة. إنه تحذير لا حظر — يمكنك الحفظ إذا كان التباين مقصودًا.
مطابقة سمة الصفحة
مطابقة سمة الصفحة تجعل الودجت يتبع ما يعرضه الموقع المحيط. يتحقق بالترتيب التالي:
- إشارة سمة على
<html>أو<body>— صنفdarkأوdark-modeأوtheme-dark، أو خاصيةdata-themeأوdata-color-schemeأوdata-modeأوdata-bs-theme. - وإلا فإعداد نظام تشغيل الزائر، عبر
prefers-color-scheme.
هذا مهم لأن prefers-color-scheme يبلّغ فقط عن نظام التشغيل. موقع له مفتاح تبديل فاتح/داكن خاص به يمكن أن يكون داكنًا بينما نظام التشغيل فاتح، وودجت يعتمد على استعلام الوسائط وحده سيبقى فاتحًا على صفحة داكنة.
يراقب الودجت التغييرات، بحيث يؤدي النقر على مفتاح تبديل السمة الخاص بموقعك إلى إعادة رسم الودجت فورًا — دون إعادة تحميل.
ما تنظر إليه Minaya
لست بحاجة لإعادة كتابة ألوانك في أي مكان. كلتا اللوحتين تأتيان من لوحة التحكم؛ الاكتشاف يقرر فقط أيّهما يُعرض. تتحقق Minaya بالترتيب التالي:
- إشارة سمة على
<html>أو<body>— صنفdark،dark-mode،theme-dark،is-darkأوnight، أو خاصيةdata-theme،data-color-scheme،data-modeأوdata-bs-theme. - لون خلفية الصفحة الفعلي. إذا لم تُنشر أي إشارة، تقرأ Minaya ما ترسمه الصفحة فعليًا وتطابقه. يعمل هذا أيًا كانت الآلية — صنف لا نتعرّف عليه، عنصر غلاف، متغيرات CSS، أو أنماط مضمّنة.
- نظام التشغيل، عبر
prefers-color-scheme، عندما لا تقدّم الصفحة أي دليل.
تُراقَب التغييرات، بحيث يؤدي النقر على مفتاح التبديل الخاص بموقعك إلى إعادة رسم الودجت فورًا — دون إعادة تحميل.
WordPress
تتعرّف Minaya على الإشارات التي تنشرها هذه الإضافات والقوالب، بحيث يعمل الوضع الداكن دون أي إعداد:
| الإضافة أو القالب | الإشارة |
|---|---|
| WP Dark Mode | data-wp-dark-mode-active و.wp-dark-mode-active على <html> |
| Darklup / Darklup Lite | .darkluplite-dark-mode-enabled على <html> |
| Droit Dark Mode | .drdt-dark-mode على <html> |
| Blocksy | data-color-mode على <html> |
| Astra | .astra-dark-mode-enable على <html> أو <body> |
كما تُطلق WP Dark Mode وDroit أحداثهما الخاصة عند تبديل الزائر للوضع، وتستمع Minaya لها — بحيث يعيد الودجت رسم نفسه فورًا بدلًا من انتظار ملاحظة تغيّر في الصنف.
قوالب الكتل (Block themes)
قوالب الكتل — مثل Twenty Twenty-Four وTwenty Twenty-Five وغيرها من قوالب التحرير الكامل للموقع — هي الحالة المهمة. التبديل إلى نمط داكن مثل Midnight يغيّر فقط قيم خصائص CSS المخصّصة؛ قائمة أصناف <body> تبقى متطابقة حرفيًا. لا شيء لاستشعاره.
لهذا تقرأ Minaya الخلفية المرسومة فعليًا للصفحة بدلًا من الاعتماد على الأصناف وحدها. يُكتشف قالب الكتل في نمط داكن بشكل صحيح حتى لو لم ينشر أي إشارة إطلاقًا.
عكس الألوان
إضافات الوضع الداكن تعكس الألوان عبر الصفحة بأكملها. Minaya تطبّق سمتها الخاصة بالفعل، لذا فإن عكسًا ثانيًا سيُلغي لوحة ألوانك — يحمل الودجت صنف الاستبعاد الخاص بكل إضافة (wp-dark-mode-ignore وما يعادله) بحيث يبقى دون تغيير. لا شيء لإعداده.
أمر واحد يجدر معرفته: منشئو الصفحات مسألة مختلفة. الوضع الداكن في Elementor ينطبق على واجهة المحرر، وليس الصفحة المنشورة، ولا يملك Divi وضعًا داكنًا مدمجًا للواجهة الأمامية — فلا يغيّر أي منهما ما يراه زوّارك.
إخبار Minaya مباشرة
إذا كان موقعك يطبّق سمته بطريقة لا يلتقطها أي مما سبق، أطلق حدثًا وستتبعه Minaya:
// Force a palette.
window.dispatchEvent(
new CustomEvent("minaya:theme", { detail: { theme: "dark" } })
);
// Or just ask Minaya to re-check the page.
window.dispatchEvent(new CustomEvent("minaya:theme"));مع jQuery، لا تصل $(window).trigger() إلى المستمعين الأصليين — أطلق الحدث كما هو موضح أعلاه.
التموضع والسلوك
- الموضع — أسفل اليسار أو أسفل اليمين.
- الفتح التلقائي — يفتح اللوحة عند تحميل الصفحة بدلًا من انتظار نقرة. معطّل افتراضيًا. الفتح التلقائي يُحتسب أيضًا كفتح للودجت في التحليلات.
تحديد المسافة من حافة الشاشة يتم عبر CSS وليس حقل نموذج — راجع CSS المخصص.
التصغير
رمز سهمي (chevron) في رأس الودجت يطوي اللوحة عائدًا إلى زر الإطلاق. إنه تصغير وليس إغلاقًا: تُحفظ المحادثة، وإعادة الفتح تستعيدها تمامًا من حيث تركها الزائر. النقر على زر الإطلاق يؤدي الأمر نفسه.
فقاعة الترحيب
رسالة قصيرة أعلى زر الإطلاق، تظهر قبل فتح الودجت — “مرحبًا، كيف يمكنني مساعدتك اليوم؟” افتراضيًا. النقر عليها يفتح المحادثة.
فعّلها ضمن التموضع واكتب نصك الخاص. تتبع سمتك، بحيث تُقرأ بشكل صحيح في الوضعين الفاتح والداكن، ويمكن ضبطها لكل لغة ضمن اللغات.
ثلاثة سلوكيات يجدر معرفتها:
- تظهر مرة واحدة لكل زيارة. إغلاقها، أو فتح المحادثة، يبقيها مخفية لبقية الجلسة — لا تظهر مجددًا في كل صفحة.
- مخفية على الهواتف، حيث ستغطي فقاعة بجانب زر الإطلاق الصفحة.
- لا تظهر عند فتح الودجت تلقائيًا، لأن اللوحة تكون موجودة بالفعل.
الأسئلة المقترحة
حتى أربعة اقتراحات بنقرة واحدة، تظهر أعلى مربع الرسائل حتى يسأل الزائر شيئًا. تخبر الزائر بغرض Minaya، وهو أكثر فائدة من مربع فارغ — استخدم الأسئلة التي تجيب عنها أكثر ما يكون.
النقر على أحدها يرسله فورًا. تختفي بمجرد بدء المحادثة، بحيث لا تتنافس أبدًا مع النص المكتوب على المساحة، ولا يراها زائر عائد لديه سجل سابق.
اضبطها ضمن نظرة عامة. أربعة هو الحد الأقصى لأن أكثر من ذلك يدفع حقل الإدخال خارج لوحة قصيرة.
السؤال قبل بدء المحادثة
بعض الفرق تريد الاسم والبريد الإلكتروني قبل بدء المحادثة. فعّل السؤال قبل بدء المحادثة ضمن التموضع ويعرض الودجت نموذجًا قصيرًا عند فتح الزائر له لأول مرة.
العنوان والرسالة من كتابتك أنت. طلب بريد إلكتروني يحدد ما إذا كان النموذج يمنع المحادثة أو يكتفي بعرض نفسه — عند تعطيله، يحصل الزوار على زر تخطّي ويمكنهم بدء المحادثة فورًا.
يُسأل الزائر مرة واحدة فقط. الجلسة العائدة تحمل بياناته بالفعل، لذا لا يظهر النموذج مجددًا.
ما يُدخله يُخزَّن مع المحادثة ويظهر في لوحة التحكم إلى جانب النص. إذا فشل إرسال النموذج لأي سبب، يُسمح للزائر بالمتابعة بدلًا من حظره — بياناته وسيلة راحة لك، وليست شرطًا للحصول على المساعدة.
العلامة التجارية
ودجتات الخطة المجانية تحمل رابطًا صغيرًا مقدَّم من Minaya أسفل مربع الكتابة. يتبع ألوانك ويظهر بتباين منخفض، بحيث يُقرأ كإشارة نسب لا كإعلان.
أي خطة مدفوعة تزيله. لا يوجد إعداد لهذا — إنه مرتبط بخطتك، فترقية الخطة تزيله دون أي إعداد إضافي.
الخط
اختر افتراضي النظام لوراثة خط موقعك، أو اختر خط Google (Poppins، Roboto، Open Sans، Lato، Montserrat، Inter). الوراثة عادة ما تبدو الأكثر انسجامًا مع الموقع.
رسالة الاحتياط
تظهر عندما لا تستطيع Minaya الإجابة. راجع جودة الإجابات لمعرفة كيفية كتابة رسالة جيدة.