توثيق مطوري OXIRANKER

توثيق OxiRanker

مركز توثيق واضح لربط موقعك بخدمات OxiRanker. ابدأ بتكامل WordPress أو تكامل API، ثم اتبع الدليل خطوة بخطوة.

توثيق رسميالإصدار الكامل V1لمالكي المواقع والمطورين وفرق التكامل
قائمة التوثيق
اختر دليلاً من القائمة. هذه الصفحة هي مركز التوثيق الرئيسي لـ OxiRanker.
خدمة WordPress

خدمة WordPress

اربط موقعك بإضافة OxiRanker الخاصة بـ WordPress، واستقبل المقالات المُنشأة وانشرها كمنشورات WordPress.

النطاق
تم التحقق
المحتوى
جاهز
WordPress
إضافة
تنبيه مهم حول التخزين

OxiRanker ليس استضافة دائمة للموقع الوجهة

لا يقدّم OxiRanker ضمان استضافة دائمة لمحتوى الموقع الوجهة أو صوره أو ملفاته المصدّرة. OxiRanker ليس خدمة استضافة لمحتوى المستخدمين، وقد لا تبقى المحتويات المُنشأة أو صور الغلاف أو صور Open Graph أو ملفات الإخراج على بنية OxiRanker لأكثر من 90 يوماً.

لذلك، بعد استلام الإخراج، يجب على الموقع الوجهة تخزين المقال النهائي والصور وبيانات السيو وبيانات Open Graph وبيانات Schema داخل قاعدة بياناته أو خادمه أو التخزين أو CDN الخاص به، ويجب ألا يعتمد على روابط OxiRanker للعرض العام.

فيديو تدريبي

فيديو تدريب الاتصال

استخدم هذا الفيديو كشرح بصري قبل ربط WordPress أو تنفيذ تكامل API.

تحميل إضافة OxiRanker الخاصة بـ WordPress

حمّل ملف إضافة WordPress وثبّته من قسم رفع الإضافات داخل لوحة WordPress.

ملف الإضافة
oxiranker.zip
تحميل الإضافة

حمّل الإضافة، ارفعها في WordPress، فعّلها، ثم اربطها باستخدام Domain ID و Connect Token.

الخطوة 01

التسجيل وإنشاء نطاق في OxiRanker

أولاً، سجّل في OxiRanker، ثم ادخل إلى حسابك واضغط Add Domain من قسم Domains.

صيغة النطاق الصحيحة

في حقل Domain name، أدخل النطاق الجذر فقط. يجب ألا يحتوي العنوان على http أو https أو www.

example.com

صيغ خاطئة

لا تُدخل هذه الصيغ في حقل النطاق.

https://example.com
http://example.com
www.example.com
بعد إنشاء النطاق
إذا كانت صيغة النطاق صحيحة، ينشئ OxiRanker النطاق وينقلك إلى خطوة تأكيد ملكية النطاق.
الخطوة 02

تأكيد ملكية النطاق

في هذه الخطوة، يجب أن تثبت أن النطاق يخصك أو أن لديك صلاحية إدارته.

DNS TXT

موصى به

أضف TXT record إلى DNS الخاص بالنطاق. في Cloudflare، تكون هذه غالباً أسهل طريقة.

DNS Name:
_yourdomain-verification.example.com

TXT Value:
acb1****29803

HTTP File

ضع ملفاً نصياً داخل مسار .well-known في موقعك حتى يتمكن OxiRanker من التحقق منه.

File URL:
https://example.com/.well-known/yourdomain-verification.txt

File Content:
220daaa37****42730f27

Meta Tag

ضع meta tag داخل قسم head في الصفحة الرئيسية لموقعك.

<meta name="yourdomain-verification" content="190208d****d275b65" />
ملاحظة مهمة حول DNS
بعد إضافة DNS record، خصوصاً في Cloudflare، قد تحتاج إلى الانتظار من دقيقتين إلى 3 دقائق. ثم اضغط Confirm في نفس صفحة OxiRanker.
مدة صلاحية رمز التحقق
قيم تأكيد ملكية النطاق لها حد زمني. حالياً، تكون قيم التحقق صالحة عادة لمدة 1440 دقيقة.
الخطوة 03

استلام توكنات مجانية بعد تأكيد أول نطاق

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

فقط للنطاق الأول
تُضاف هذه الهدية فقط لأول نطاق يتم التحقق منه، ولا تُضاف مرة أخرى للنطاقات اللاحقة.
الخطوة 04

إعداد اللغات ورابط المدونة

في قسم Blog URLs، حدّد ما إذا كان موقعك بلغة واحدة أو متعدد اللغات، وما اللغات التي يجب استخدامها للمقالات المُنشأة.

اختيار اللغات

يدعم OxiRanker 24 لغة. يمكنك اختيار لغة واحدة أو عدة لغات بناءً على بنية موقعك.

إدخال رابط المدونة

لكل لغة، أدخل رابط المدونة الخاص بتلك اللغة. إذا كان موقعك متعدد اللغات، فأدخل مسار كل لغة بشكل منفصل.

https://example.com/fa/blog
https://example.com/en/blog
بنية الرابط
إذا كان موقعك يستخدم بنية مختلفة، فأدخل رابط المدونة الحقيقي في موقعك. النقطة المهمة أن يكون الرابط النهائي هو المسار الذي يجب نشر المقالات فيه.
الخطوة 05

إضافة الكلمات المفتاحية لكل لغة

في تبويب Keywords، أضف 3 كلمات مفتاحية على الأقل وحتى 50 كلمة لكل لغة.

القاعدة الأساسية

يجب إدخال الكلمات المفتاحية لكل لغة بنفس اللغة. إذا كانت لغة المقال الإنجليزية، فيجب أن تكون الكلمات المفتاحية أيضاً بالإنجليزية.

كيفية إضافة الكلمات المفتاحية

بعد كتابة كل كلمة مفتاحية، اضغط Enter لإضافتها. بعد إكمال جميع الكلمات، اضغط Save.

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

إكمال ملف Article Profile للنطاق

يوضح Article Profile لـ OxiRanker ما هي علامتك التجارية، ولمن يكتب، وما الأسلوب الذي يجب استخدامه، وما الموضوعات التي يجب تجنبها.

المجال

يحدد السوق أو فئة العمل. مثال: استشارات عقارية وشراء وبيع العقارات في دبي.

وصف النشاط التجاري

يوضح ما الذي يبيعه النشاط التجاري، ومن يخدم، وكيف يعمل، وما الذي يميزه.

الجمهور

يحدد من يجب أن يخاطبه المحتوى. يمكن حفظ كل جمهور بشكل منفصل.

النبرة

تتحكم في أسلوب وصوت المحتوى المُنشأ، مثل الرسمي أو التعليمي أو البسيط أو التقني أو الموجه للبيع.

هدف المحتوى

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

الموضوعات المحظورة

أي شيء لا يجب أن تتحدث عنه العلامة التجارية أو لا يجب أن ترتبط به يتم إدخاله هنا.

CTA اختياري

CTA يعني الإجراء الذي تريد من القارئ اتخاذه بعد قراءة المقال. إذا لم تكن متأكداً من النص المناسب، فمن الأفضل ترك هذا الحقل فارغاً.

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

الربط الداخلي والخارجي

يمكن لـ OxiRanker تطبيق الروابط الداخلية والخارجية داخل المقالات بذكاء.

الروابط الداخلية

هذا الخيار مفعّل افتراضياً ومن الأفضل إبقاؤه مفعّلاً. يساعد الربط الداخلي محركات البحث على فهم بنية محتوى موقعك بشكل أفضل.

في المقال الأول، لا تُنشأ الروابط الداخلية عادة لأنه لا يوجد مقال سابق بعد. من المقال الثاني فصاعداً، يستطيع النظام تنفيذ الربط الداخلي.

الروابط الخارجية

تُضاف الروابط الخارجية إلى مصادر رسمية وموثوقة، ويتم وضعها كـ nofollow حتى لا تنتقل قوة السيو بشكل غير مقصود.

الخطوة 08

فحص جودة الملف باستخدام AI

بعد إكمال Article Profile، يراجع OxiRanker جودة الملف.

85+
الحد الأدنى المطلوب للحفظ
95
درجة ممتازة يتم الوصول إليها غالباً بعد التحسينات
AI
اقتراحات احترافية لكل حقل
إذا كانت الدرجة أقل من 85
لا يسمح النظام بالحفظ النهائي ويعرض توضيحات واقتراحات تحسين لكل حقل فيه مشكلة. يمكنك تطبيق الاقتراحات ثم الحفظ مرة أخرى.
الخطوة 09

ربط Telegram لملخصات المقالات

بعد حفظ الملف بنجاح، يمكنك تفعيل إرسال ملخصات المقالات إلى قناة Telegram.

1

إضافة البوت

أضف @Oxiranker_Bot إلى قناة Telegram الخاصة بك واجعله Admin.

2

إدخال اسم مستخدم القناة

أدخل اسم القناة مع @. مثال: @my_channel

3

تفعيل إرسال الملخص

بعد تسجيل قناة صالحة، فعّل إرسال ملخص المقالات.

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

إعداد محرك المقالات التلقائي

في تبويب Automatic article generation، يمكنك إدارة محرك إنشاء المقالات التلقائي.

اختيار ذكي للموضوع

يستخدم النظام الكلمات المفتاحية و Article Profile لاختيار موضوعات مناسبة وفريدة وقابلة للنشر.

إنشاء واعٍ بالعلامة التجارية

تتم مراعاة النبرة والجمهور وهدف المحتوى وقيود العلامة التجارية أثناء إنشاء المقال.

النشر المجدول

يتم توزيع السعة الشهرية على مدار الشهر حتى يبدو نشر المحتوى طبيعياً ومتناسقاً.

السعة الشهرية

7 articles / month
10 articles / month
15 articles / month
30 articles / month

30 مقالاً تعني تقريباً مقالاً واحداً يومياً. 15 مقالاً تعني تقريباً يوماً بعد يوم. 10 مقالات تعني تقريباً كل يومين إلى ثلاثة أيام. 7 مقالات تعني تقريباً كل ثلاثة إلى أربعة أيام.

طول المقال والصورة

يمكن أن يكون طول المقال Short أو Standard أو Long. خيار Standard مناسب ومتوازن لمعظم المواقع.

يمكن تفعيل صور المقال أو تعطيلها، ويمكن اختيار ثيم الصورة Light أو Dark.

الخطوة 11

إنشاء أول مقال من Generate

بعد تجهيز النطاق، افتح قائمة Generate، واختر النطاق، ثم اضغط New Content أو New Article.

1

اللغة

يتم اختيار لغة واحدة فقط لكل طلب محتوى.

2

الموضوع

اكتب موضوعاً واضحاً. Source URL اختياري.

3

الصورة

فعّل الصورة أو عطّلها واختر ثيم Light أو Dark.

4

الدفع والإنشاء

يتم خصم التكلفة من المحفظة ويبدأ إنشاء المقال.

وقت الإنشاء
عادةً يستغرق إنشاء المقال والصورة حوالي 2 إلى 3 دقائق. بعد الاكتمال، يظهر المقال داخل OxiRanker.
Source URL
إذا تم إدخال Source URL، يستخدمه OxiRanker لفهم الموضوع بشكل أفضل، لكنه لا ينشئ محتوى منسوخاً. النظام مصمم لإنشاء محتوى فريد.
الخطوة 12

مراجعة Preview و SEO Report و JSON Output

بعد إنشاء المقال، تتوفر عدة مخرجات مهمة لمراجعة الجودة والتحضير للنشر.

Preview

يعرض نص المقال والصورة المُنشأة. هذا القسم مفيد لمراجعة الجودة النهائية قبل النشر.

SEO Report

يعرض تقرير سيو واضحاً يشمل SEO Score والعنوان و meta description و canonical والكلمات المفتاحية و schema والعناوين والروابط والصور و OpenGraph.

JSON Output

يعرض الإخراج الكامل للمقال للمستخدمين التقنيين، بما في ذلك slug و html_body و schema وروابط الصور والوسوم والتصنيف ووقت القراءة وتواريخ الإنشاء/التحديث.

معنى المخرجات
توضح هذه المخرجات أن المقال ليس مجرد نص عادي. إنه محتوى منظم وجاهز للسيو ومعدّ لـ WordPress و CMS و API وأنظمة النشر.
الخطوة 13

ربط WordPress ونشر المقالات

في تبويب WordPress Output، يمكنك ربط موقع WordPress الخاص بك بـ OxiRanker.

الخطوة 1: تثبيت الإضافة

حمّل إضافة OxiRanker وثبّتها وفعّلها.

https://oxiranker.com/oxiranker.zip

مسار التثبيت في WordPress:

Plugins -> Add New -> Upload Plugin -> oxiranker.zip -> Activate

الخطوة 2: الاتصال باستخدام Token

انسخ Domain ID و Connect Token من Setup Wizard وأدخلهما في إعدادات الإضافة.

DOMAIN ID:
1

CONNECT TOKEN:
wlXQy15WMB****MC1Lb08=

Connect Token له حد زمني ويكون عادةً نشطاً لمدة 30 دقيقة.

الخطوة 3: طريقة النشر

بعد الاتصال، اختر طريقة النشر.

Publish
تُنشر المقالات مباشرة.
Draft
تُنشأ المقالات كمسودات.
Manual
يرسل المستخدم المقال باستخدام زر النشر.
توصية للاختبار الأولي
للاختبار الأولي، من الأفضل ضبط حالة المنشور الافتراضية في الإضافة على Draft حتى يمكن مراجعة المقال في WordPress قبل النشر.
النشر التلقائي
إذا كان النشر التلقائي مفعّلاً، يمكن إرسال المقالات التي تم إنشاؤها يدوياً أو عبر المحرك التلقائي إلى WordPress بعد أن تصبح جاهزة.
الخطوة 14

التوافق مع Yoast SEO

إذا كان موقعك يستخدم إضافة Yoast SEO، فإن OxiRanker متوافق معها.

إذا كان Yoast مثبتاً
يرسل OxiRanker بيانات السيو بطريقة يستطيع Yoast استخدامها وعرضها عند وجود Yoast.
إذا لم يكن Yoast مثبتاً
إذا لم يكن Yoast مثبتاً، يمكن لإضافة OxiRanker إدارة وعرض بيانات السيو المطلوبة بنفسها.
الخطوة 15

ملخص مسار WordPress الكامل

بعد إكمال هذه الخطوات، سيكون موقع WordPress الخاص بك جاهزاً لاستقبال المقالات التي ينشئها OxiRanker.

التسجيل في OxiRanker
إضافة نطاق
تأكيد ملكية النطاق
اختيار اللغات وإضافة Blog URL
إضافة الكلمات المفتاحية لكل لغة
إكمال Article Profile
إعداد Telegram عند الحاجة
إعداد محرك المقالات التلقائي
إنشاء أول مقال من Generate
مراجعة Preview و SEO Report
تثبيت إضافة WordPress
إدخال Domain ID و Connect Token
اختيار طريقة النشر
نشر المقالات في WordPress