انتقل إلى المحتوى الرئيسي

اشترك في المحتوى

✅ هدف السيناريو:

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

✅ ما تحتاجه:

  • عنوان مشروع (PROJECT_URL) ورمز تطبيق (APP_TOKEN) صالحين للمصادقة مع واجهة برمجة تطبيقات OneEntry.

📌 مهم:

  • نحن لا نتعامل مع الأخطاء في هذه الأمثلة.
  • يمكنك التعامل مع الأخطاء في trycatch أو في بناء مثل "await Promise.catch((error) => error)"

السيناريو

1. استيراد oneEntry وتحديد عنوان URL ورمز التطبيق

مثال:

import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

2. إنشاء عميل API باستخدام دالة defineOneEntry()

مثال:

const { Users, Orders, Pages, Payments, AuthProvider, Forms } = defineOneEntry(PROJECT_URL, {
token: APP_TOKEN,
});

3. إعداد البيانات لمصادقة المستخدم

مثال:

[
{
"marker": "email_reg",
"value": "your-user@email.com"
},
{
"marker": "password_reg",
"value": "123456"
}
]

4. المصادقة والحصول على بيانات المستخدم AuthProvider.auth()

مثال:

const authResponse = await AuthProvider.auth('email', {
authData,
});
النتيجة:
{
"userIdentifier": "your-user@email.com",
"authProviderIdentifier": "email",
"accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ"
"refreshToken": "1745494429101-...-2834edf8"
}

5. نحصل على قائمة طلبات المستخدم باستخدام Orders.getAllOrdersByMarker()

مثال:

const orders = await Orders.getAllOrdersByMarker('subscriptions');
النتيجة:
{
"items": [
{
"id": 91,
"storageId": 2,
"createdDate": "2025-04-30T21:48:40.628Z",
"statusIdentifier": "active",
"formIdentifier": "subscription",
"formData": [
{
"type": "date",
"marker": "expired_date",
"value": {
"fullDate": "2025-05-07T00:00:00.000Z",
"formattedValue": "07-05-2025 00:00",
"formatString": "DD-MM-YYYY HH:mm"
}
},
{
"type": "list",
"marker": "subscription_time",
"value": [
{
"title": "1 month",
"value": "1",
"extended": {
"type": "real",
"value": "100"
}
}
]
}
],
"attributeSetIdentifier": "subscriptions",
"totalSum": "100.00",
"currency": "",
"paymentAccountIdentifier": "cash",
"paymentAccountLocalizeInfos": {
"title": "Cash"
},
"products": [
{
"id": 3,
"title": "1 month",
"sku": "",
"previewImage": null,
"price": 100,
"quantity": 1
}
],
"isCompleted": false
}
],
"total": 1
}

6. التحقق من وجود اشتراك نشط

مثال:

const now = new Date();
const hasActiveSubscription = orders.items?.some(
(order: any) =>
new Date(
order.formData.find(
(d: { marker: string }) => d.marker === 'expired_date',
).value.fullDate,
) > now,
);
النتيجة:
true

7. إذا كان الاشتراك نشطًا، نقدم الوصول، وإلا نقوم بإنشاء طلب وتوليد الدفع

مثال:

let content = null;
if (hasActiveSubscription) {
// ✅ الاشتراك نشط → عرض المحتوى
content = await Pages.getPageByUrl('premium_page');
console.log('🎉 الوصول مفتوح:', content);
} else {
// ❌ لا يوجد اشتراك → إنشاء طلب وتوليد الدفع
const body = {
formIdentifier: 'subscription',
paymentAccountIdentifier: 'cash',
formData: [
{
type: 'date',
marker: 'expired_date',
value: {
fullDate: '2025-05-07T00:00:00.000Z',
formattedValue: '07-05-2025 00:00',
formatString: 'DD-MM-YYYY HH:mm',
},
},
{
type: 'list',
marker: 'subscription_time',
value: [
{
title: '1 month',
value: '1',
extended: {
type: 'real',
value: '100',
},
},
],
},
],
products: [
{
productId: 3,
quantity: 1,
},
],
};
const order = await Orders.createOrder('subscriptions', body);
const payment = await Payments.createSession(order.id, 'session', false);
// console.log('💸 تابع الدفع للاشتراك الخاص بك:', payment)
}
النتيجة:
{
"id": 7,
"parentId": null,
"pageUrl": "premium_page",
"depth": 0,
"localizeInfos": {
"title": "الصفحة المميزة",
"menuTitle": "الصفحة المميزة",
"htmlContent": "",
"plainContent": ""
},
"isVisible": true,
"forms": [],
"blocks": [],
"type": "common_page",
"templateIdentifier": null,
"attributeSetIdentifier": null,
"attributeValues": {},
"isSync": false
}

المثال النهائي

// 1. استيراد oneEntry وتحديد PROJECT_URL و APP_TOKEN
import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

// 2. إنشاء عميل API
const { Users, Orders, Pages, Payments, AuthProvider, Forms } =
defineOneEntry(PROJECT_URL, {
token: APP_TOKEN,
});

// 3. إعداد البيانات لمصادقة المستخدم
// const form = await Forms.getFormByMarker('subscription');
// expired_date - تاريخ
// subscription_time - قائمة

const authData = [
{
marker: 'email_reg',
value: 'your-user@email.com',
},
{
marker: 'password_reg',
value: '123456',
},
];

// 4. المصادقة والحصول على بيانات المستخدم
const authResponse = await AuthProvider.auth('email', {
authData,
});
const user = await Users.getUser();

// 5. نحصل على قائمة طلبات المستخدم
const orders = await Orders.getAllOrdersByMarker('subscriptions');

// 6. التحقق من وجود اشتراك نشط
const now = new Date();
const hasActiveSubscription = orders.items?.some(
(order: any) =>
new Date(
order.formData.find(
(d: { marker: string }) => d.marker === 'expired_date',
).value.fullDate,
) > now,
);

// 7. إذا كان الاشتراك نشطًا، نقدم الوصول، وإلا نقوم بإنشاء طلب وتوليد الدفع
let content = null;
if (hasActiveSubscription) {
// ✅ الاشتراك نشط → عرض المحتوى
content = await Pages.getPageByUrl('premium_page');
console.log('🎉 الوصول مفتوح:', content);
} else {
// ❌ لا يوجد اشتراك → إنشاء طلب وتوليد الدفع
const body = {
formIdentifier: 'subscription',
paymentAccountIdentifier: 'cash',
formData: [
{
type: 'date',
marker: 'expired_date',
value: {
fullDate: '2025-05-07T00:00:00.000Z',
formattedValue: '07-05-2025 00:00',
formatString: 'DD-MM-YYYY HH:mm',
},
},
{
type: 'list',
marker: 'subscription_time',
value: [
{
title: '1 month',
value: '1',
extended: {
type: 'real',
value: '100',
},
},
],
},
],
products: [
{
productId: 3,
quantity: 1,
},
],
};
const order = await Orders.createOrder('subscriptions', body);
const payment = await Payments.createSession(order.id, 'session', false);
console.log('💸 تابع الدفع للاشتراك الخاص بك:', payment);
}