HIKO Wish Keeper

يحتاج الأمر إلى خطوتين: تفعيل app embed في القالب، ثم تفعيل قائمة الرغبات في إعدادات التطبيق.

الخطوة 1 — تفعيل app embed

1. افتح HIKO Wish Keeper في لوحة إدارة Shopify
2. اضغط «تفعيل في القالب» أعلى الصفحة، فيُفتح محرر القوالب وقد حُدِّد app embed مسبقًا
3. تأكد أن المفتاح في وضع التشغيل ثم اضغط حفظ في محرر القوالب

الخطوة 2 — تفعيل قائمة الرغبات في الإعدادات

1. ارجع إلى صفحة الإعدادات في HIKO Wish Keeper
2. في صفحات المنتج فعِّل «قائمة الرغبات في صفحات المنتج»
3. في صفحات المجموعات فعِّل «قائمة الرغبات في شبكة المنتجات»
4. اضغط حفظ

بعد ذلك تظهر الأزرار في متجرك تلقائيًا، ولا حاجة إلى تعديل كود القالب.

app embed هو أكثر الأسباب شيوعًا لشكوى «لا يظهر أي شيء». فكل ما يرسمه هذا التطبيق في متجرك — الأزرار وصفحة الحساب وصفحات القوائم المشتركة — يُحمَّل من ذلك app embed الواحد.

نعم. في إعدادات HIKO Wish Keeper فعِّل «تسجيل الدخول مطلوب». وما دام الخيار مفعَّلًا، فإن قائمة الرغبات لا تُحمَّل إطلاقًا للزوار غير المسجَّلين ولا يظهر أي زر.

اتركه مُعطَّلًا إذا أردت أن يتمكن الزوار أيضًا من حفظ المنتجات. فقوائمهم تبقى في متصفحهم نفسه وتُدمج مع الحساب عند أول تسجيل دخول، فلا يضيع شيء.

تجمع صفحة التحليلات ما تحتاجه لفهم سلوك عملائك.

• كل العملاء الذين لديهم قائمة رغبات والمنتجات التي حفظوها
• أكثر المنتجات حفظًا في متجرك
• نسب الوصول والفتح والنقر للإشعارات
• نشاط المشاركة حسب المنصة (Facebook وTwitter وPinterest وWhatsApp وLINE)
• أنماط مشاهدة المنتجات واتجاهات الرواج
• التحويل وحالة الفوترة لمسودات الطلبات
• مقارنة النشاط يوميًا وأسبوعيًا
• تصدير بريد العملاء وبيانات القوائم إلى ملف CSV

صفحة الحساب صفحة في متجرك تجمع كل ما يحفظه هذا التطبيق لعميل واحد. عنوانها /apps/hwl/account وهي منظَّمة في تبويبات: قائمة الرغبات، وبعد تسجيل الدخول الطلبات والعناوين والملف الشخصي وتفضيلات الإشعارات ومسودات الطلبات.

وهي مفعَّلة تلقائيًا. يمكنك إيقافها من صفحة الحساب > صفحة الحساب؛ وما دامت موقوفة لا يعمل ذلك العنوان وتختفي الروابط المؤدية إليه من المتجر.

يرسم صفحة الحساب app embed، تمامًا كما يرسم الأزرار. فإذا كان app embed موقوفًا وصل العميل إلى الصفحة لكنه يرى رسالة تحميل قصيرة بدلًا من حسابه.

كلاهما، ولا حاجة إلى تفعيل أي شيء. لا يسأل التطبيق عن الإصدار الذي يستخدمه متجرك.

السبب هو المكان الذي توجد فيه صفحة الحساب. إنها صفحة ضمن واجهة متجرك على العنوان /apps/hwl/account، يرسمها قالبك — وليست صفحة داخل منطقة الحسابات التي تستضيفها Shopify. تقرأ الصفحة بيانات العميل المسجَّل دخوله وطلباته وعناوينه عبر القالب، تمامًا كما تفعل أي قالب آخر، وهذه البيانات تعمل بالطريقة نفسها في كلا الإصدارين.

وتسجيل الدخول يعمل في الحالتين أيضًا. رابط تسجيل الدخول الذي يوفّره التطبيق يشير إلى /customer_authentication/login، وتوجّه Shopify العميل إلى شاشة تسجيل الدخول المناسبة لإصدار متجرك، ثم تعيده إلى المكان الذي كان فيه.

هناك اختلاف واحد، وهو من جانب Shopify لا من جانبنا. في حسابات العملاء الجديدة لا تستطيع صفحات الحساب التي تستضيفها Shopify عرض أي محتوى من تطبيق قالب، لذا لا يوجد مدخل إلى قائمة الأمنيات هناك. ولهذا يوجّه التطبيق أيقونة الحساب في ترويسة قالبك إلى صفحة الحساب بدلًا من ذلك. أما في حسابات العملاء القديمة فتظل تلك الأيقونة تقود إلى صفحات الحساب الخاصة بـ Shopify، وهي تعمل بشكل طبيعي — ويصل العملاء إلى صفحة الحساب عبر أيقونة القلب أو أي رابط تضيفه أنت.

اذهب إلى صفحة الحساب > التبويبات. لكل تبويب مفتاح وأيقونة، والأسهم تغيِّر الترتيب. والترتيب الذي تضعه هو نفسه الترتيب الذي يراه عملاؤك.

التبويبات هي الملف الشخصي والعناوين وقائمة الرغبات والطلبات ومسودات الطلبات وتفضيلات الإشعارات. ويحتاج الأخيران إلى خطة مدفوعة؛ وما سواهما مفعَّل من البداية.

وهناك قاعدتان يحسن معرفتهما:

• باستثناء قائمة الرغبات، تتطلب كل التبويبات أن يكون العميل مسجَّل الدخول. فالزائر غير المسجَّل لا يرى إلا قائمة الرغبات، أيًّا كان ما فعَّلته.
• إيقاف تبويب يخفيه فقط ولا يحذف شيئًا. وإذا أعدت تفعيله وجدت البيانات كما هي.

كل ذلك في صفحة الحساب، والمعاينة الحية إلى جانبها تتبع كل تغيير.

1. التصميم — أربعة أشكال: شريط جانبي، وتبويبات، ولوحة مربعات، وقائمة قابلة للطي
2. الألوان — فاتح، أو غامق، أو دافئ، أو تلقائي (والتلقائي يتبع إعداد نظام الزائر)
3. لون العلامة — يُستخدم للأزرار والروابط والتبويب الحالي. ويُفتَّح تلقائيًا في النسق الغامق، حتى لا يختفي لون علامة غامق
4. CSS خاص بك — لما لا تغطيه الإعدادات، ولا يُطبَّق إلا داخل صفحة الحساب

نعم، مع خطة مدفوعة. في صفحة الحساب > التبويبات افتح الملف الشخصي وأضف الحقول: نص، أو قائمة منسدلة بخياراتك، أو تاريخ، أو مربع اختيار.

تُحفظ إجابات العملاء كـ metafields للعميل في Shopify، فتصبح متاحة في Shopify Flow وفي قطاعات العملاء وفي القالب. ولوحة أين تُحفظ الحقول في الصفحة نفسها تبيِّن لك الـ namespace والمفتاح بدقة لكل حقل.

ثلاثة أمور يحسن معرفتها قبل البدء:

• لا يمكن تغيير نوع الحقل لاحقًا. هذا قيد من Shopify. فاختره صحيحًا من البداية: تغييره يعني حقلًا جديدًا.
• إزالة حقل تُخرجه من النموذج فقط. فالإجابات المجموعة والتعريف نفسه يبقيان في Shopify. وهذا مقصود — نقرة واحدة بالخطأ لا ينبغي أن تمحو بيانات عملاء متجر كامل.
• في الخطة المجانية يمكنك تعديل الحقول الموجودة وإزالتها. الإضافة وحدها هي المقصورة على الخطط المدفوعة.

يأخذ القلب في رأس متجرك العميل إلى المكان الذي يستطيع فيه فعلًا رؤية قائمته.

• غير مسجَّل — إلى صفحة قائمة الرغبات المستقلة
• مسجَّل وتبويب قائمة الرغبات مفعَّل — إلى تبويب قائمة الرغبات في صفحة الحساب
• مسجَّل وتبويب قائمة الرغبات موقوف — إلى صفحة قائمة الرغبات المستقلة

وإذا اخترت أن تُعرض القائمة في نافذة منبثقة أو لوحة منسدلة، احتفظ القلب بذلك السلوك ولم يأخذ إلى أي صفحة.

في صفحة الحساب > بعد تسجيل الدخول تختار واحدًا من ثلاثة: صفحة الحساب (وهي الافتراضية)، أو الصفحة الرئيسية، أو صفحة من اختيارك.

وللوجهة الخاصة اكتب مسارًا يبدأ بشرطة مائلة، مثل /pages/members. أما العناوين الكاملة فتُرفض، لأن التحويل لا يقبل إلا مسارات داخل متجرك، والقيمة المرفوضة ترجع بهدوء إلى صفحة الحساب.

ينطبق هذا الإعداد على كل مدخل لتسجيل الدخول، بما في ذلك أيقونة الحساب في رأس قالبك.

لـ HIKO Wish Keeper خطة مدفوعة واحدة، تُفتَر شهريًا أو سنويًا.

• المجانية — قائمة الرغبات كاملة، بلا حد لعدد القوائم ولا لعدد المنتجات المحفوظة، ومعها تحليلات صفحة التحليلات والمشاركة على الشبكات الاجتماعية
• Professional — 6.99 دولار شهريًا أو 62 دولارًا سنويًا. ويضيف الإشعارات بالبريد، والوصول إلى API، ومسودات الطلبات مع الفوترة، وحقول الملف الشخصي من عندك في صفحة الحساب

تشمل الخطة المدفوعة 7 أيام تجربة مجانية، ويمكنك التغيير في أي وقت من صفحة الترقية.

لا. تحسب Shopify تلقائيًا بالتناسب وتخصم الجزء غير المستخدم من خطتك الحالية، فلا تدفع إلا الفرق.

وعند الانتقال من الشهري إلى السنوي تُخصم الأيام الباقية من الدورة الشهرية من السعر السنوي. فلو غيَّرت في منتصف الشهر مثلًا، خُصم نصف الشهر غير المستخدم من المبلغ السنوي.

كل ذلك يتولاه نظام الفوترة في Shopify، ولا شيء عليك فعله.

بعد 7 أيام ترسل إليك Shopify رسالة تطلب موافقتك على الاشتراك المتكرر. ولا يُخصم المال تلقائيًا، فـ Shopify تطلب دائمًا موافقة صريحة.

فإن وافقت استمر الاشتراك كالمعتاد. وإن لم توافق خلال يومين عاد المتجر إلى الخطة المجانية، وبقيت المزايا المدفوعة غير متاحة حتى اشتراك جديد.

يمكنك الاشتراك مجددًا في أي وقت من صفحة الترقية. والنزول إلى خطة أدنى لا يحذف شيئًا، فالقوائم والحقول الخاصة والإعدادات تبقى كلها في مكانها.

مظهر الزر قابل للضبط بتفصيل، وكل ذلك من صفحة الإعدادات.

1. غيِّر شكل الأيقونة ولونها وحجمها في الإعدادات > النمط العام
2. اضبط اللون النشط (المحفوظ) واللون غير النشط كلًّا على حدة
3. اختر تأثير الحركة: نبض، أو ارتداد، أو بلا تأثير
4. اضبط حجم الأيقونة وسماكة الخط
5. تابع التغييرات في المعاينة الحية

نعم، وبشكل منفصل لصفحات المجموعات وصفحات المنتج.

1. صفحات المجموعات: الموضع (أعلى اليمين، أعلى اليسار، أسفل اليمين، أسفل اليسار) والهوامش
2. صفحات المنتج: العرض «طبقة فوق الصورة» أو «زر عادي»
3. الموضع: بجانب «أضف إلى السلة»، أو تحت السعر، أو في مكان تختاره
4. نمط الزر: «أيقونة ونص» أو «أيقونة فقط»

يأتي التطبيق مترجمًا إلى 15 لغة: الإنجليزية، والصينية التقليدية، والصينية المبسطة، واليابانية، والكورية، والألمانية، والفرنسية، والإسبانية، والإيطالية، والبرتغالية، والروسية، والفيتنامية، والتايلندية، والعربية، والعبرية. ويرى كل عميل لغة متصفحه دون أن تضبط شيئًا.

وصفحة الترجمات ليست مكانًا لإضافة اللغات، بل لتغيير الصياغة.

1. افتح صفحة الترجمات من شريط التنقل
2. اختر لغتك الأساسية من القائمة المنسدلة
3. عدِّل عناوين الأزرار والرسائل وأسماء القوائم التي تريد صياغتها على نحو آخر
4. احفظ

يمكنك إضافة أي لغة بترجمة من عندك.

1. افتح صفحة الترجمات
2. اضغط «إضافة لغة»
3. أدخل رمز اللغة (ko للكورية وde للألمانية)
4. ترجم كل النصوص: عناوين الأزرار والرسائل وأسماء القوائم ونصوص النوافذ
5. اضغط حفظ

وعندما تتوافق لغة متصفح العميل مع الرمز الذي أدخلته، استُخدمت ترجمتك. فكل ما يراه العملاء يبقى في يدك.

يستطيع العملاء مشاركة أي قائمة من قوائمهم مع الأصدقاء والأهل برابط خاص.

1. فتح صفحة قائمة الرغبات واختيار قائمة خاصة
2. الضغط على «مشاركة» لنسخ الرابط
3. إرساله إلى أي شخص، ولا يحتاج المتلقي إلى حساب
4. تعرض الصفحة المشتركة كل العناصر مع بيانات المنتج والأسعار

تحصل كل قائمة خاصة تلقائيًا على رمز مشاركة فريد. وتُشارَك أيضًا القائمتان الافتراضيتان «المفضلة» و«لاحقًا».

نعم. فكل من يفتح رابط مشاركة يمكنه متابعة تلك القائمة.

1. فتح الرابط الذي أرسله صديق
2. الضغط على «متابعة» لإضافتها إلى صفحة قائمة الرغبات الخاصة به
3. تظهر القوائم المتابَعة إلى جانب قوائمه هو
4. وتصل تغييرات صاحب القائمة إلى المتابعين تلقائيًا

يستطيع العملاء مشاركة المنتجات المحفوظة على الشبكات الاجتماعية.

• Facebook — مشاركة المنتج بصورة ووصف
• Twitter / X — نشر رسالة مع رابط المنتج
• Pinterest — تثبيت صورة المنتج
• WhatsApp — إرسال الرابط في رسالة
• LINE — المشاركة عبر LINE
• البريد — إرسال رابط المنتج بالبريد
• نسخ الرابط — نسخ عنوان المنتج إلى الحافظة

تُفعَّل من الإعدادات > المشاركة الاجتماعية. وأنت تختار المنصات التي تظهر ويمكنك تغيير قالب الرسالة.

يُبلَّغ العملاء تلقائيًا عند انخفاض سعر منتج محفوظ.

1. اذهب إلى الإشعارات > الإعدادات
2. فعِّل «إشعارات انخفاض السعر»
3. حدِّد الحد (أي انخفاض، أو نسبة، أو مبلغ)
4. حدِّد وتيرة الفحص (كل ساعة، أو كل يوم…)
5. ويتلقى العملاء الذين وافقوا الرسائل تلقائيًا

أما إشعارات العودة إلى المخزون فلا تُرسل إلا عندما ينتقل المنتج من غير متوفر إلى متوفر. وفي أول مرة يسجِّل فيها التطبيق حالة المخزون لا يُرسل شيء، وذلك عن قصد: وإلا تلقَّى كل عملائك رسالة في يوم التثبيت.

لإرسال الإشعارات عليك ضبط مزوِّد بريد.

1. اذهب إلى الإشعارات > الإعدادات
2. اختر مزوِّدًا: Resend أو SendGrid أو Brevo أو SMTP خاص بك
3. أدخل مفتاح API وبيانات المُرسِل
4. تحقق من الضبط بـ «إرسال رسالة تجريبية»
5. فعِّل أنواع الإشعارات التي تريدها
6. حدِّد جدول الفحص التلقائي

وأبسط الطرق Resend، ويمكن الحصول على مفتاح API مجاني من resend.com.

نعم. يمكنك صياغة رسائل تلائم متجرك.

1. اذهب إلى الإشعارات > القوالب
2. اختر نوع الإشعار (انخفاض سعر، عودة إلى المخزون…)
3. اختر لغة القالب
4. عدِّل موضوع الرسالة
5. طوِّع متن HTML ليلائم علامتك
6. أضف نسخة نصية خالصة للبرامج التي لا تعرض HTML
7. استخدم متغيرات مثل {{product_title}} و{{new_price}} و{{product_url}} للمحتوى المتغير
8. عايِن قبل الحفظ

وتساعدك المعاونة بالذكاء الاصطناعي على إنتاج قالب متقن بسرعة.

تتيح لك مسودة الطلب أن تُعِدَّ طلبًا نيابة عن العميل من المنتجات التي حفظها. وهي من مزايا الخطط المدفوعة.

• إنشاء مسودة طلب من العناصر التي حفظها العميل مباشرة
• إرسال فاتورة ليُتِمَّ العميل الشراء
• متابعة الحالة: مسودة، أُرسلت، فُتحت، نُقر عليها، اكتملت
• إلغاء مسودة الطلب أو حذفها في أي وقت
• رؤية كل المسودات وحالاتها في صفحة مسودات الطلبات

في تبويب مسودات الطلبات من صفحة الحساب. فعِّله من صفحة الحساب > التبويبات؛ وهو موقوف افتراضيًا لأنه يحتاج إلى خطة مدفوعة.

يرى العميل هناك كل الفواتير التي لم تُسدَّد بعد، مع رابط للدفع وإمكانية الإلغاء. ورسائل الفواتير التي ترسلها تؤدي إلى ذلك المكان نفسه.

وفي الإصدارات السابقة كان هناك بلوك قالب تضيفه بنفسك في محرر القوالب. وقد أُزيلت تلك البلوكات، فتبويب صفحة الحساب يحل محلها ولم يبقَ شيء تضيفه إلى القالب.

كل ذلك يجري في صفحة مسودات الطلبات في HIKO Wish Keeper.

1. في صفحة مسودات الطلبات ابحث عن العميل
2. اضغط على العميل لترى المنتجات التي حفظها
3. حدِّد بمربعات الاختيار العناصر التي تريد إدراجها
4. اضغط «إنشاء مسودة طلب (N)»، وN هو عدد العناصر المحددة
5. وفي النافذة يمكنك تحديد خصم (نسبة أو مبلغ) ومدة حفظ المخزون وملاحظة
6. ويُظهر «إنشاء» ملخصًا مع تفصيل الأسعار
7. و«تأكيد» يُنشئ المسودة، و«تأكيد وإرسال» يُنشئها ويرسل الفاتورة فورًا

يتلقى العميل رسالة فيها رابط للدفع. وكل الحالات — مسودة، أُرسلت، فُتحت، نُقر عليها، اكتملت — تُتابع من صفحة مسودات الطلبات.

تحتاج مسودات الطلبات إلى خطة Professional (6.99 دولار شهريًا أو 62 دولارًا سنويًا).

إذا لم يظهر أي زر فافحص بالترتيب.

• هل المزية مفعَّلة في الإعدادات > صفحات المنتج أو صفحات المجموعات
• هل app embed الخاص بهذا التطبيق مفعَّل في محرر القوالب، في قسم «App embeds»
• هل خيار «تسجيل الدخول مطلوب» مفعَّل في الإعدادات؟ فإن كان كذلك لا تُحمَّل القائمة للزوار غير المسجَّلين
• امسح ذاكرة المتصفح وأعد تحميل الصفحة
• هل يدعم قالبك app blocks (قالب Online Store 2.0)
• تحقق في نافذة تصفُّح متخفٍّ
• وإن لم ينفع شيء من ذلك فتواصل مع الدعم

يرسم صفحة الحساب app embed. فإذا بقيت رسالة التحميل فذلك يعني أن app embed موقوف.

1. اضغط «تفعيل في القالب» أعلى صفحة التطبيق
2. تأكد أن المفتاح في وضع التشغيل ثم اضغط حفظ في محرر القوالب

وإذا أجاب العنوان بـ «غير موجود» فصفحة الحساب نفسها موقوفة — أعد تفعيلها من صفحة الحساب > صفحة الحساب.

إذا لم تصل الرسائل فافحص الأسباب المعتادة.

• هل مفتاح API للمزوِّد في الإشعارات > الإعدادات صحيح
• هل عنوان المُرسِل موثَّق عند المزوِّد
• هل وافق العميل على تلقي الإشعارات
• هل يُظهر سجل الإرسال في التحليلات > الإشعارات أخطاء
• أرسل رسالة تجريبية للتحقق من الضبط
• راجع الرسائل المرتجعة ومشكلات التسليم في لوحة مزوِّدك

يسعدنا أن نساعد.

• للمسائل التقنية: [email protected]
• أرسل رسالة مباشرة من زر الدعم في التطبيق
• والأسئلة الشائعة مجموعة في هذه الأسئلة والأجوبة

أرسل مفتاح API كرمز Bearer في ترويسة Authorization، أي Authorization: Bearer your_api_key. وتُنشأ المفاتيح من صفحة التكامل مع API.

كلتاهما تعمل: المعرِّف الرقمي (مثل 1234567890) وGID الكامل من Shopify (مثل gid://shopify/Customer/1234567890). وكل نقاط النهاية تقبل الصيغتين.

يستخدم API رموز حالة HTTP المعتادة.

• 200 – نجاح: تمت معالجة الطلب
• 400 – طلب غير صالح: معاملات خاطئة أو ناقصة
• 401 – غير موثَّق: مفتاح API مفقود أو غير صالح
• 404 – غير موجود: المورد لا وجود له
• 429 – طلبات أكثر من اللازم: تم تجاوز الحد
• 500 – خطأ في الخادم: المشكلة من جهتنا

تقبل نقاط النهاية التي تُرجع قوائم المعاملين page وlimit. وفي الاستجابة كائن pagination يبيِّن الصفحة الحالية وعدد الصفحات الكلي وعدد السجلات الكلي، فيمكنك المرور على نتائج كثيرة صفحة بعد صفحة.

نعم. اضبط عنوان webhook في صفحة التكامل مع API، فيرسل التطبيق إليه طلب POST عند كل حدث في قائمة الرغبات. ولا حاجة إلى الاستقصاء المتكرر.