موقع WordPress (بدون متجر)

إضافة Joryio لـ WordPress، Joryio، تعمل على أي موقع WordPress - لا تحتاج إلى WooCommerce. على موقع بدون متجر تتتبّع مشاهدات الصفحات، وترسل إلى Joryio إرسالات نماذج Contact Form 7 وElementor Pro كجهات اتصال، وتعرض رسائل in-app (النوافذ المنبثقة) وإشعارات Web Push الخاصة بك. إنها الإضافة نفسها التي يستخدمها متجر WooCommerce؛ ميزات المتجر تعمل فقط عندما يكون WooCommerce مفعّلًا (راجع تكامل WooCommerce).

تثبيت الإضافة

1. في Joryio، انتقل إلى الإعدادات → التكاملات وافتح WooCommerce & WordPress
2. انقر تنزيل الإضافة. التنزيل هو دائمًا أحدث إصدار من الإضافة
3. في إدارة WordPress، انتقل إلى Plugins → Add New → Upload Plugin، وارفع ملف zip وانقر Install Now
4. انقر Activate

للتحديث لاحقًا، نزّل الإضافة مرة أخرى من الصفحة نفسها وارفعها بالطريقة نفسها؛ يعرض WordPress استبدال الإصدار المثبّت ويحتفظ بإعداداتك واتصالك.

الاتصال

1. في صفحة Joryio نفسها، انسخ رابط الخادم وانقر إنشاء مفتاح API للحصول على مفتاح API (يبدأ بـ jry_wc_ - النوع نفسه من المفاتيح الذي يستخدمه المتجر)
2. في إدارة WordPress، انتقل إلى Settings → Joryio (على موقع بدون WooCommerce تجد الإضافة ضمن Settings، لا ضمن WooCommerce)
3. ألصق مفتاح API، وتأكد أن Server URL هو عنوان API لمنطقتك (مثلًا https://api-eu1.joryio.com)، وانقر Connect

تعرض صفحة الإعدادات عندها Connected to Joryio مع اسم الموقع ورابطه وWorkspace ID. في Joryio، تعرض الإعدادات → التكاملات الاتصال على أنه موقع WordPress، مع ما يرسله إلى Joryio - بدون إحصاءات متجر أو أزرار مزامنة، لأنه لا يوجد متجر للمزامنة.

بدءًا من الإصدار 1.6.32 من الإضافة، تحتوي صفحة الإعدادات على أربعة تبويبات: Connection وTracking & identity وIn-app & web push وForms (إلى أن يتصل الموقع، Connection وحده). يحفظ كل تبويب إعداداته فقط، وتعرض الصفحة Settings saved. بعد الحفظ.

في بقية Joryio الموقع هو موقع WordPress وليس متجرًا: تعرض Settings → Apps ومنتقيات التطبيق في رسائل In-App و Push تطبيقه باسم WordPress، ولا يُحتسب ضمن متاجرك المتصلة، ولا يُعرض كمتجر لبرامج القسائم، وتتخطاه فحوصات المتجر (المزامنة والمطابقة المجدولة وتنبيهاتهما).

ما يعمل بدون متجر

الميزة	ما تفعله	أين تضبطها
تتبّع الصفحات	يسجّل سكربت التتبع كل زيارة صفحة كـ Page Viewed، ويربط الزائر بجهة اتصال عندما يعطي بريدًا إلكترونيًا (نموذج، تسجيل دخول، تسجيل حساب)	Settings → Joryio → Tracking & identity → Inject Tracking Script (مفعّل افتراضيًا)
نماذج الموقع	إرسالات Contact Form 7 وElementor Pro تنشئ جهة الاتصال أو تحدّثها وتسجّل Form Submitted (راجع نماذج الموقع)	Settings → Joryio → Forms، أو Actions After Submit للنموذج في Elementor
رسائل in-app	تعرض رسائل in-app (النوافذ المنبثقة) من Joryio، بما فيها رسائل HTML	Settings → Joryio → In-app & web push (مفعّل افتراضيًا)
Web Push	يتيح للزوار الاشتراك في إشعارات المتصفح، عبر رسالة in-app لطلب الموافقة على الإشعارات	Settings → Joryio → In-app & web push → Web push (معطّل افتراضيًا)

تعمل رسائل in-app وإشعارات Web Push كما في المتجر - الإعدادات وملف service worker وشرط أن يكون الموقع في جذر النطاق لإشعارات Web Push موصوفة في رسائل in-app وإشعارات Web Push.

نماذج الموقع

لا يغادر موقعك إلا الحقول التي تربطها. يُرسَل الإرسال عندما يحتوي على بريد إلكتروني أو هاتف صالح؛ الإرسال الذي لا يحتوي على أي منهما لا يُرسَل.

Contact Form 7

1. انتقل إلى Settings → Joryio. يعرض تبويب Forms كل نماذج Contact Form 7
2. حدّد Send this form to Joryio
3. اختر List (اختياري - بدون قائمة يحفظ النموذج جهة الاتصال والحدث فقط)
4. اختر وضع List subscription، ولوضع الموافقة اختر حقل acceptance في النموذج
5. اربط كل حقل بـ Email أو Phone أو First name أو Last name أو Custom attribute (اكتب مفتاح السمة: أحرف لاتينية صغيرة وأرقام وشرطات سفلية) أو Do not send. اربط على الأقل حقل بريد إلكتروني أو هاتف
6. انقر Save form settings. لا يستطيع تغيير إعدادات النماذج إلا مدير الموقع

Elementor Pro

1. حرّر النموذج في Elementor وأضف Joryio ضمن Actions After Submit
2. في قسم Joryio، اختر List ووضع List subscription. لوضع الموافقة، أدخل Consent field ID - معرّف حقل Acceptance في النموذج، من تبويب Advanced للحقل
3. أدخل معرّفات الحقول لـ Email وPhone وFirst name وLast name، وأي سمات مخصصة سطرًا لكل منها بالشكل attribute_key = field_id
4. انقر Update

الموافقة

كل إرسال ينشئ جهة الاتصال أو يحدّثها ويسجّل الحدث Form Submitted. الاشتراك في القائمة وحده يعتمد على وضع النموذج:

الوضع	الاشتراك في القائمة
This is a signup form - always subscribe	في كل إرسال
Only when a consent field is ticked (الافتراضي)	فقط عندما يكون حقل الموافقة في النموذج - حقل acceptance في Contact Form 7 أو حقل Acceptance في Elementor - محدّدًا

تبيّن الخاصية consentGiven في الحدث هل أُعطيت الموافقة. المربع غير المحدّد لا يلغي اشتراك أي أحد أبدًا. عندما تتطلب القائمة تأكيدًا مزدوجًا (double opt-in)، يرسل Joryio رسالة التأكيد أولًا ويشترك جهة الاتصال عندما تؤكد؛ وحتى ذلك الحين يذكر الحدث القائمة في listsPending.

ما يسجّله Joryio

• جهة الاتصال: يملأ نموذج الزائر البريد الإلكتروني والهاتف فقط عندما لا يكونان لدى جهة الاتصال، ولا يغيّر أبدًا بريد أو هاتف جهة اتصال موجودة. يمكن للعميل المسجَّل دخوله تحديث هاتفه (الإضافة 1.6.34): عندما يرسل عميل مسجَّل دخوله إلى موقعك نموذجًا ويكون بريد النموذج تابعًا لجهة الاتصال الخاصة به، يحلّ الهاتف المكتوب في النموذج محل هاتف جهة الاتصال. تثبت الإضافة هوية المستخدم المسجَّل دخوله بإثبات موقَّع يُنشأ على خادمك، فقط لنموذج أُرسل على موقعك؛ ولا يتغير البريد الإلكتروني بهذه الطريقة أبدًا. نموذج Contact Form 7 الذي يُرسَل عبر WordPress REST API دون REST nonce يصل إلى ووردبريس كمستخدم غير مسجَّل الدخول، فتنطبق عليه قاعدة الزائر. تُكتب الأسماء والسمات المخصصة التي ربطتها إلى جهة الاتصال. جهة الاتصال التي أنشأها نموذج تظهر مع أُنشئت عبر: نموذج الموقع
• الحدث: Form Submitted، مع source (cf7 أو elementor) وformId وformName وpageUrl وconsentGiven وconsentText (صياغة مربع الموافقة المحدَّد، بدءًا من الإضافة 1.6.31) وlistsSubscribed وlistsPending، وemail وphone الخاصين بالنموذج (بالتنسيق الذي تخزّنهما به جهة الاتصال، حتى لا يضيع هاتف مختلف كتبه زائر) وphoneUpdated عندما يختلف هاتف النموذج عن هاتف جهة الاتصال - true عندما تحمله جهة الاتصال الآن، وfalse عندما احتفظت جهة الاتصال بهاتفها. أعضاء الفريق غير المسموح لهم برؤية البيانات الشخصية لا يرون قيم البريد والهاتف، وتُمحى هذه القيم مع الشخص. استخدمه لبدء رحلة أو تشغيل حملة أو بناء شريحة. باقي القيم المُرسَلة ليست على الحدث
• سجل الموافقة - عندما يشترك النموذج بجهة الاتصال في قائمة، يحتفظ سجل الاشتراكات بإثبات الموافقة: الصياغة الدقيقة لمربع الموافقة الذي حدّده الشخص، والصفحة التي أُرسل منها النموذج (pageUrl)، والوقت، وعنوان IP للزائر (يظهر فقط لأعضاء الفريق المسموح لهم برؤية البيانات الشخصية). راجع إثبات الموافقة

إثبات الموافقة

بدءًا من الإضافة 1.6.31، عندما يحدّد الشخص حقل الموافقة في النموذج، ترسل الإضافة أيضًا ما وافق عليه:

• الصياغة - النص الظاهر لحقل الموافقة: نص وسم acceptance في Contact Form 7 ([acceptance your-consent] I agree to receive news by email [/acceptance])، أو Acceptance Text لحقل Acceptance في Elementor (وإلا فتسميته). تُزال الروابط والتنسيق؛ بحد أقصى 500 حرف. النص الذي تكتبه خارج وسم acceptance في قالب Contact Form 7 لا يُرسَل - ضع الصياغة داخل الوسم. في Elementor، الحقل هو المحدد في Consent field ID (أي معرّف مخصص) ويجب أن يكون حقل Acceptance
• الصفحة والوقت وعنوان IP لإرسال الزائر

المربع غير المحدّد لا يرسل صياغته أبدًا، ونموذج الاشتراك (بلا مربع) لا يرسل أي صياغة. يُكتب الإثبات في سجل موافقة فقط عندما يشترك النموذج بجهة الاتصال في قائمة: مع No list لا يُشترك أحد، فتبقى الصياغة في حدث Form Submitted فقط (consentText؛ ولا يوضع عنوان IP في الحدث أبدًا). في قائمة بتأكيد مزدوج يُحفظ الإثبات مع التأكيد ويُسجَّل عندما يؤكد الشخص.

لا تبطئ الإرسالات الزائر أبدًا: يضعها WordPress في طابور ويرسلها في الخلفية عبر WP-Cron، ويعيد المحاولة عندما لا يكون Joryio متاحًا. لا تُحتسب إعادة المحاولة مرتين أبدًا. يعمل WP-Cron مع زيارات الموقع، لذا على موقع بزيارات قليلة جدًا، أو مع تعطيل WP-Cron، شغّله من cron على الخادم.

الدليل الكامل للنماذج هو نفسه في المتجر: النماذج: Elementor وContact Form 7.

التعرّف على الزائر. البريد المكتوب في نموذج على الموقع يعرّف أيضًا متصفح الزائر عندما يكون التعرّف على الزوار من البريد الإلكتروني الذي يكتبونه مفعّلًا (الافتراضي). يذهب الإرسال نفسه دائمًا إلى جهة الاتصال صاحبة هذا البريد.

ما يتطلب WooCommerce

تتطلب هذه الميزات وجود WooCommerce على الموقع:

• مزامنة المنتجات والطلبات والعملاء، وأرقام المتجر في لوحة التحكم
• تتبّع المنتجات والفئات والإضافة إلى السلة وصفحة الدفع
• تتبّع السلات المتروكة وروابط استرداد السلة
• روابط تطبيق القسائم
• مربع موافقة التسويق في صفحة الدفع ونموذج التسجيل

إضافة WooCommerce لاحقًا

إذا ثبّتّ WooCommerce على موقع متصل بالفعل، يعرض WordPress تنبيهًا يطلب منك إعادة الاتصال. انتقل إلى WooCommerce → Joryio، وانقر Disconnect، ثم ألصق مفتاح API مرة أخرى وانقر Connect: عند الاتصال تنشئ الإضافة مفتاح REST الخاص بـ WooCommerce الذي يحتاجه Joryio، ويبدأ Joryio بمزامنة متجرك. تُحفظ إعدادات النماذج. من الآن فصاعدًا يصبح الموقع متجرًا - راجع تكامل WooCommerce.

يلاحظ Joryio ذلك بنفسه أيضًا: أول طلب أو سلة أو منتج أو عميل ترسله الإضافة بعد تفعيل WooCommerce يحوّل الموقع إلى متجر في Joryio (يظهر تطبيقه مجددًا باسم WooCommerce ويُحتسب متجرًا)، حتى قبل إعادة الاتصال. وحتى تعيد الاتصال تصل التحديثات المباشرة، لكن المزامنة الكاملة للمتجر تنتظر مفتاح REST - لذا أعد الاتصال كما هو موضح أعلاه. إزالة WooCommerce لاحقًا لا تعيد المتجر إلى موقع تلقائيًا.