لقد نجحت! إضافة ووردبريس الخاصة بك جاهزة للاستخدام. ربما تتساءل الأن عن كيفية إضافتها إلى مستودع الإضافة ليتمكن آلاف مستخدمي ووردبريس من اكتشافها واستخدامها.

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

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

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

لماذا تقوم بإضافة الإضافة الخاص بك إلى دليل اضافة ووردبريس؟

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

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

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

سيساعدك الدليل أيضًا على دعم الإضافة. يمكن للمستخدمين تقييم إضافتك، وترك تعليقاتهم، والإبلاغ عن الأخطاء، والاستفادة من منتدى الدعم.

بالطبع، هناك أيضًا بعض المتطلبات والقيود. أولها أن يكون لديك ترخيص متوافق مع ووردبريس. ينصح باستخدام GPLv2 أو إصدار أحدث.

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

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

بعد ذلك، دعونا نلقي نظرة على كيفية إضافة إضافتك إلى دليل اضافة ووردبريس. إليك الخطوات التي سنتناولها:

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

الخطوة 1: إنشاء ملف readme.txt لاضافة الخاص بك

أول ما عليك فعله هو إنشاء ملف ”Read Me’ لإضافتك. سيظهر هذا الملف في صفحة الإضافة ضمن مجلد الإضافة، ويجب استخدام التنسيق الصحيح.

إليك ملف نموذجي يمكنك استخدامه كنقطة بداية. ستحتاج إلى لصقه في محرر النص وحفظه بصيغة readme.txt في مجلد الإضافة:

=== Your Plugin Name ===
 
Contributors: Your WordPress.org Username
Tags: wpbeginner, plugin tutorial
Requires at least: 6.0
Tested up to: 6.2
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
 
A WordPress plugin to teach beginners how to write a WordPress plugin. 
 
== Description ==
 
This simple plugin is part of our beginner's guide to writing a WordPress plugin. 
 
== Installation ==
 
1. Upload the plugin folder to your /wp-content/plugins/ folder.
1. Go to the **Plugins** page and activate the plugin.
 
== Frequently Asked Questions ==
 
= How do I use this plugin? =
 
Answer to the question
 
= How to uninstall the plugin? =
 
Simply deactivate and delete the plugin. 
 
== Screenshots ==
1. Description of the first screenshot.
1. Description of the second screenshot. 
 
== Changelog ==
= 1.0 =
* Plugin released.

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

سوف تحتاج إلى تخصيص الملف لإضافتك الخاصة، لذلك سنشرح لك كيفية عمل صيغة ملف readme للإضافة ووردبريس.

السطر الأول هو ‘اسم الاضافة’ وسيظهر في دليل اضافة ووردبريس كعنوان لإضافتك.

السطر التالي هو ‘المساهمون’. هذه هي معرفات مستخدمي WordPress.org المسؤولين عن إدارة إضافتك. إذا لم يكن لديك معرف مستخدم، فستحتاج إلى إنشاء حساب مستخدم مجاني على WordPress.org.

يشير حقلا ‘يتطلب على الأقل’ و’تم اختباره حتى’ إلى إصدارات ووردبريس التي تعمل معها إضافتك. أما ‘العلامة الثابتة’ فهي إصدار إضافتك.

يمكنك ترك حقول الترخيص كما هي. بعد ذلك، يجب عليك تعديل قسم ‘الوصف’ لشرح وظيفة الإضافة الخاصة بك.

بعد تعديل ملف readme لإضافتك، لا تنس حفظ التغييرات. من الجيد أيضًا تشغيل الملف من خلال Readme Validator الرسمية ومعالجة أي مشاكل يتم تحديدها. أخيرًا، انقر بزر الماوس الأيمن على مجلد الإضافة وأنشئ ملف مضغوط. على مستخدمي ماك اختيار ‘Compress [plugin name]’، ويمكن لمستخدمي ويندوز اختيار ‘Send to » Compressed (zipped) folder’.

الخطوة 2: إرسال الاضافة الخاص بك إلى الدليل للمراجعة

الأن، أصبحت إضافتك جاهزة للمراجعة من قبل فريق الإضافات في WordPress.org.

لإرسالها، قم بزيارة صفحة إضافة إضافتك. إذا لم تكن قد سجلت دخولك بعد، فانقر على زر ‘Log in’ في أعلى يمين الشاشة.

بمجرد تسجيل الدخول، ستتمكن من رفع إضافتك وإرسالها للمراجعة.

انقر ببساطة على زر ‘Select File’ لاختيار ملف zip الخاص بإضافتك. ثم حدد جميع الخيارات المناسبة وانقر على زر ‘Upload’.

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

سيحتوي هذا البريد الإلكتروني على رابط إلى مستودع Subversion (SVN) حيث سيتم استضافة إضافتك على WordPress.org. ستحتاج إلى استخدام هذا الرابط عند رفع إضافتك.

الخطوة 3: رفع الاضافة الخاصة بك باستخدام Subversion (SVN)

بمجرد الموافقة على الإضافة، ستحتاج إلى استخدام Subversion (SVN) لرفع الإضافة.

Subversion هو نظام تحكم في الإصدارات مفتوح المصدر. يسمح للمستخدمين بإجراء تغييرات على الملفات والمجلدات مع الاحتفاظ بسجل للتغييرات، وإدارة إصدارات مختلفة، والتعاون مع مستخدمين أخرين.

ستحتاج إلى تثبيت عميل SVN على جهاز الكمبيوتر الخاص بك لرفع الإضافة. يمكن لمستخدمي ويندوز استخدام SilkSVN أو TortoiseSVN (مجاني). يمكن لمستخدمي ماك تثبيت SmartSVN أو تطبيق Versions على أجهزة الكمبيوتر الخاصة بهم.

في هذه المقالة، سنستخدم تطبيق Versions لنظام ماك. مع ذلك، فإن العملية متشابهة جدًا في جميع تطبيقات SVN المذكورة أعلاه.

بعد التثبيت، ستحتاج إلى فتح تطبيق Versions والاطلاع على نسخة من مستودع إضافة ووردبريس الخاصة بك. للقيام بذلك، انقر ببساطة على زر ‘New Repository Bookmark’.

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

يمكنك ترك حقلي اسم المستخدم وكلمة المرور فارغين.

الأن، انقر على زر ‘Create’. سيتصل الإصدار بمستودعك ويحمل نسخة من مستودع الإضافة إلى جهاز الكمبيوتر.

بعد ذلك، ستحتاج إلى النقر بزر الماوس الأيمن على اسم المستودع في عرض المتصفح، ثم تحديد ‘Checkout’.

سيتم مطالبتك بتوفير اسم للمجلد وتحديد الموقع الذي تريد تخزينه فيه على جهاز الكمبيوتر الخاص بك. يمكنك استخدام نفس اسم المجلد كدليل الاضافة الخاصة بك والنقر فوق الزر ‘Checkout’ للمتابعة.

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

الأن، عليك نسخ ملفات الإضافة ولصقها داخل ‘trunk folder’ في مستودعك المحلي.

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

بما أن هذه الملفات لم تكن موجودة من قبل، عليك إضافتها. حدد الملفات الجديدة وانقر على زر ‘Add’ لإضافتها إلى مجلدك المحلي.

الأن بعد إضافة ملفات الإضافات إلى Subversion، أنت جاهز لرفعها. يمكنك القيام بذلك بمزامنة التغييرات في مجلدك المحلي مع دليل Subversion.

يجب عليك النقر فوق المستودع المحلي الخاص بك لتحديده، ثم النقر فوق أيقونة ‘Commit’.

ستظهر نافذة منبثقة جديدة، وسترى قائمة التغييرات ومربع لإضافة رسالة commit.

بمجرد النقر على زر ‘Commit’، سيقوم تطبيق Versions بمزامنة تغييراتك وتأكيدها في مستودع الإضافة.

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

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

سم هذا المجلد باسم version. تأكد من أنه يطابق الإصدار الذي أدخلته في عنوان الإضافة. في المثال أعلاه، استخدمنا الإصدار 1.0 للإضافة.

بعد إضافة المجلد 1.0، الصق ملفات الإضافات بداخله. بما أن هذا مجلد جديد، ستحتاج أيضًا إلى النقر على زر ‘Add’ لإضافة المجلد وجميع ملفاته إلى المستودع.

بعد ذلك، انقر على أيقونة ‘Commit’ لمزامنة تغييراتك كما فعلت سابقًا. يمكنك الأن زيارة مجلد إضافات ووردبريس ومعاينة إضافتك.

عند الحاجة إلى تعديل ملفات الإضافات، عدل النسخة المحلية. بعد الانتهاء من التغييرات، انقر على أيقونة ‘Commit’ لمزامنتها مع مجلد إضافة ووردبريس.

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

الخطوة 4: إضافة العمل الفني إلى دليل اضافة ووردبريس

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

لافتة رأس الاضافة

لافتة الرأس أو بانر الهيدر هي الصورة الكبيرة التي تظهر أعلى صفحة الإضافة. يجب أن يكون حجمها 772×250 أو 1544×500 بكسل، ويجب استخدام صيغة JPEG أو PNG.

بناء على حجم الصورة ونوع الملف، ستحتاج إلى تسمية لافتة الرأس بأحد الأسماء التالية:

• banner-772×250.jpg
• banner-772×250.png
• banner-1544×500.jpg
• banner-1544×500.png

أيقونة الاضافة

الأيقونة عبارة عن صورة مربعة صغيرة، وستظهر في نتائج البحث وقوائم الإضافة. يجب أن يكون حجمها 128×128 أو 256×256 بكسل، ويجب استخدام صيغة JPEG أو PNG.

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

• icon-128×128.jpg
• icon-128×128.png
• icon-256×256.jpg
• icon-256×256.png

لقطات الشاشة

يمكنك إضافة أي عدد من لقطات الشاشة. يجب إدراج لقطات الشاشة هذه في وصف لقطات الشاشة بملف readme.txt.

يجب تسمية ملفات لقطات الشاشة كما يلي:

• screenshot-1.png
• screenshot-2.png

بعد تجهيز جميع الأعمال الفنية، يمكنك وضعها في مجلد assets في النسخة المحلية من الإضافة.

بعد ذلك، ستلاحظ إيقونة علامة استفهام بجوار مجلد assets. ستحتاج إلى النقر على زر ‘Add’ لإضافة ملفات assets جديدة إلى مستودعك.

أخيرًا، انقر على أيقونة ‘Commit’ لتحميل ملفاتك إلى مجلد اضافة ووردبريس.

بعد فترة من الوقت، سوف تكون قادر على رؤية العمل الفني يظهر على صفحة الاضافة الخاصة بك.

مكافأة: موارد لمطوري اضافة ووردبريس

إذا كنت تتطلع إلى تعزيز رحلة تطوير ووردبريس الخاصة بك، فإليك بعض الموارد القيمة:

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

نأمل أن يكون هذا البرنامج التعليمي قد ساعدك على تعلم كيفية إضافة الإضافة إلى دليل اضافة ووردبريس. قد ترغب أيضًا بالاطلاع على اختيارنا لـ أفضل وكالات تطوير ووردبريس ودليلنا الشامل حول كيفية استخدام تطبيق ووردبريس على أجهزة iPhone وiPad وAndroid.