ابنِ تطبيقات وقوالب لهيكانا: نقطة بداية المطوّرين

لهيكانا موقع للمطوّرين على hekana.dev. بيشرح الشيئين اللي يقدر مطوّر من برّه يبنيهم لمتجر على هيكانا: القوالب اللي بتغيّر شكل المتجر، والتطبيقات اللي بتغيّر اللي المتجر بيعمله. المقال ده خريطة: أنهي واحد محتاجه، وأول الخطوات لكل واحد، وإيه اللي مش متاح لسه، علشان ما تضيّعش يوم على حاجة مش مبنية.

الاتنين في مرحلة الوصول المبكر. وثائق المطوّرين بتحدد بالظبط إيه اللي شغال وإيه اللي لا، والمقال بيكرر ده زي ما هو.

قالب ولا تطبيق؟

المتجر ممكن يستخدم قالبًا ويثبّت تطبيقات، ومفيش واحد منهم محتاج التاني.

| | القالب | التطبيق | | --- | --- | --- | | بيغيّر | شكل المتجر وتخطيطه | اللي المتجر بيعمله: سلوك وبيانات وتكاملات | | بتكتب | سنفرو: HTML بوسوم hk-* وملف theme.json وCSS | كود على خادمك أنت بيستدعي Apps API | | بيوصل للمتجر إزاي | التاجر بيثبّت قالبًا منشورًا | صاحب المتجر بيوافق على شاشة الموافقة الخاصة بتطبيقك | | ينفع يشغّل كود | لا، القالب مينفعش يشغّل JavaScript | أيوه، على خادمك | | ابدأ من | ابنِ أول قالب | أنشئ أول تطبيق |

ابنِ قالبًا

سنفرو هي لغة وSDK قوالب متاجر هيكانا. القالب مجلد فيه قوالب .snf شبيهة بـ HTML بوسوم hk-* وملف theme.json وملفات لغة وCSS. أداة سطر الأوامر بتفحصه وتعاينه ببيانات تجريبية وتجمّعه في ملف JSON واحد بتعرضه هيكانا.

محتاج Node.js إصدار 20 أو أحدث. بعدها:

npx sneferu init my-theme
cd my-theme
npx sneferu dev

الأمر init بينسخ قالب بداية. وتقدر تبدأ من قالب جاهز بدله: starter متجر كامل محايد، وفيه تصميمات للألعاب والمنتجات الرقمية زي arcade وconsole وesports وcreator وlicense وbento. والأمر dev بيفتح معاينة محلية ببيانات تجريبية.

ثلاث قواعد بتحكم كل اللي بتكتبه. القالب بيستخدم وسوم hk-* الموثقة بس، ومينفعش يشغّل JavaScript، ومفيهوش حقول إدخال خام إلا من خلال وسوم البحث والسلة الموثقة.

علشان تنشر، سجّل الدخول بـ npx sneferu login أو بمفتاح مطوّر من hekana.dev/account. بتاخد متجر تجريبي مجاني فيه منتجات تجريبية تختبر عليه. المتجر ده مبياخدش طلبات ومبيقبلش مدفوعات، ومحركات البحث بتتقال ما تفهرسوش. والقوالب من مطوّرين خارجيين بتتراجعها هيكانا قبل ما التجار يقدروا يستخدموها.

اقرأ دليل القوالب من أوله. ولو عايز بس متجر بشكل جاهز، مش محتاج أي حاجة من دي: شوف إزاي تبني متجرك مع هيكانا ومعرض القوالب.

ابنِ تطبيقًا

تطبيق هيكانا برنامج بيشتغل خارج هيكانا وبيتعامل مع متجر واحد من خلال Apps API، بعد ما صاحب المتجر يوافق عليه. يقدر يقرا الطلبات والمنتجات والعملاء، وينشئ طلبات، وينشئ أكواد خصم، ويراسل العملاء، ويحتفظ بمخزن بيانات صغير خاص بيه، ويعرض خانة اختيار عند الدفع، ويسمع أحداث المتجر.

المسار:

1. سجّل التطبيق وحدد الصلاحيات (scopes) اللي محتاجها. بيبدأ كمسودة.
2. قدّمه للمراجعة. مراجع من هيكانا بيوافق عليه، أو بيرجّعه بسبب، أو بيوقفه.
3. بعد الموافقة، صاحب المتجر بيفتح رابط الموافقة بتاعك، ويشوف الصلاحيات، ويوافق.
4. خادمك بيبدّل الكود برموز الوصول، ويستدعي Apps API، ويستقبل الـ webhooks.
5. صاحب المتجر يقدر يلغي تثبيت التطبيق في أي وقت.

كل رمز وصول مرتبط بتثبيت واحد، فكل طلب بيخص متجرًا واحدًا بالظبط. والتطبيق مينفعش يذكر متجرًا تانيًا.

ابدأ من نظرة عامة على التطبيقات ثم صفحة البدء.

إيه اللي مش متاح لسه

الوثائق بتسرد دول، ومهم تعرفهم قبل ما تخطط:

• حزم الـ SDK مش منشورة على npm. @hekana/apps-sdk وhekana-sdk وcreate-hekana-app مينفعش تتثبّت دلوقتي. بتستدعي Apps API بالـ HTTP. أما أداة سنفرو (sneferu) فموجودة على npm.
• مفيش وضع اختبار للتطبيقات. مسار الموافقة بيشتغل للتطبيقات المعتمدة بس.
• التطبيقات الخارجية مش بتقدر تستخدم خطط الاشتراك ولا الفترات التجريبية ولا المشتريات لمرة واحدة. دي موجودة لتطبيقات هيكانا نفسها.
• مفيش كتل قوالب مخصصة للتطبيقات الخارجية. قائمة الكتل مغلقة.
• التطبيق مينفعش يضيف رسوم عند الدفع ولا يغيّر الأسعار. إضافة الدفع بتعرض بس منتجًا من منتجات المتجر نفسه.

ماذا يرى التجار

التجار بيثبّتوا تطبيقات هيكانا نفسها من صفحة التطبيقات في لوحة التحكم. شوف إزاي تثبّت تطبيقات هيكانا وتشغّلها وتديرها لهذا الجانب.

أسئلة شائعة

لازم أكون تاجر على هيكانا علشان أطوّر؟ محتاج حساب هيكانا علشان تسجّل الدخول على hekana.dev. وبيتعمل لك متجر تجريبي مجاني لاختبار القوالب.

أقدر أبيع قالبي أو تطبيقي؟ وثائق المطوّرين مش بتوصف بيع القوالب. أما التطبيقات فالخطط والمشتريات الخارجية مش متاحة لسه.

هل Apps API مستقرة؟ موجودة ومختبرة وفيها إصدار عن طريق ترويسة Hekana-Api-Version، لكنها في الوصول المبكر. راجع ملاحظة الحالة في نظرة التطبيقات قبل ما تلتزم.

أطلب فين حاجة ناقصة؟ تواصل معنا.

جديد على هيكانا؟ شوف الباقات وابدأ مجانًا.