كيفية إرسال الإضافات إلى مستودع WordPress.org
نشرت: 2021-06-02تعد استضافة مكون إضافي على مستودع WordPress.org واحدة من أكثر الطرق شيوعًا (وفعالية) لبدء عمل تجاري ناجح مجاني. إذا كانت هذه هي المرة الأولى التي ترسل فيها مكوّنًا إضافيًا إلى المستودع ، فقد تكون بعض الخطوات غير واضحة أو مربكة ، وهذا هو السبب في أنني أوجزت العملية لإرشادك. أوصي أيضًا بوضع إشارة مرجعية على هذه الصفحة إذا كنت بحاجة إلى الرجوع إليها في المستقبل.
التحضير للتقديم
أولاً ، تحتاج إلى الحصول على موافقة من فريق مراجعة البرنامج المساعد لاستضافة منتجك في المستودع. لذلك ، يجب أن يكون لديك حساب على WordPress.org. ليس لديك واحد؟ لا تقلق - يمكنك التسجيل هنا.
إنشاء ملف Readme.txt الخاص بالملحق
بعد ذلك ، تحتاج إلى إنشاء ملف readme.txt بتنسيق markdown والذي سيتم استخدامه لصفحة قائمة المكون الإضافي الخاص بك على WordPress.org. يجب أن تحتوي على المعلومات التالية:
- اسم البرنامج المساعد
- المساهمون (معرف مستخدم WordPress.org الخاص بك)
- علامات البرنامج المساعد
- يتطلب على الأقل (إصدار WordPress)
- تم اختباره حتى (إصدار WordPress)
- علامة مستقرة (إصدار البرنامج المساعد)
- الترخيص (GPLv2 أو أحدث)
- عنوان URI للترخيص: www.gnu.org/licenses/gpl-2.0.html
- الوصف (وصف كامل للمكوِّن الإضافي الخاص بك)
- أسئلة وأجوبة
- لقطات
- التغيير
كمرجع ، يوجد هنا قالب ملف readme.txt قياسي.
للتأكد من أنك قمت بتنسيق وهيكلة ملف readme.txt الخاص بالمكون الإضافي بشكل صحيح ، استخدم مدقق التمهيدي لـ WordPress.
اختر اسم البرنامج المساعد الخاص بك بعناية
من المهم أن تأخذ الوقت الكافي لاختيار اسم المكون الإضافي "الصحيح" قبل الإرسال الأولي لأنه سيؤثر على عنوان URL لقائمة المكون الإضافي الخاص بك ، مما يؤثر على مُحسّنات محرّكات البحث لقائمة WordPress.org وفي النهاية تعرض البرنامج الإضافي ونموه.
فيما يلي القسم ذي الصلة الذي يغطي تأثير الاسم من صفحة إرسال المكون الإضافي:
سيتم ملء عنوان URL الخاص بالمكوِّن الإضافي بناءً على قيمة Plugin Name
في ملف المكون الإضافي الرئيسي (الملف الذي يحتوي على رؤوس المكون الإضافي). إذا قمت بتعيين اسمك على أنه Plugin Name: Boaty McBoatface
فسيكون عنوان URL الخاص بك هو https://wordpress.org/plugins/boaty-mcboatface
وستكون slug الخاص بك هو boaty-mcboatface
على سبيل المثال. إذا كان هناك مكون إضافي موجود باسمك ، فستكون boaty-mcboatface-2
، وهكذا. يتصرف تمامًا مثل أسماء منشورات WordPress.
لذلك عندما تختار الاسم الأولي ، فكر في تحسينه من أجل تحسين محركات البحث بدلاً من العلامة التجارية. اسأل نفسك ما هي الكلمات الرئيسية التي ترغب في استهدافها واستنباط الاسم منها. يمكنك العثور على بعض نصائح التسمية هنا.
تذكر أنه يمكنك دائمًا تغيير اسم المكون الإضافي بعد الإرسال الأولي - لذلك حتى إذا اخترت اسمًا لا يعجبك ، يمكنك تغييره لاحقًا (وعدد المرات التي تريدها). ما لا يمكنك تغييره هو الرابط الثابت للمكون الإضافي ، لذلك فإن التسمية الأولية مهمة.
لاحظ أيضًا أن slug تم إنشاؤه من اسم المكون الإضافي في ملف البرنامج المساعد الرئيسي ، والذي يمكن أن يكون مختلفًا عن قيمة اسم المكون الإضافي في ملف readme.txt.
إرسال البرنامج المساعد الخاص بك
بمجرد أن تستقر على اسم جيد لتحسين محركات البحث - ويكون المكون الإضافي وملف readme.txt جاهزين - توجه إلى صفحة إضافة المكون الإضافي الخاص بك وأرسله للمراجعة.
عملية المراجعة يدوية ، ويمكن أن تستغرق من يوم إلى 10 أيام ، اعتمادًا على قائمة انتظار المراجعة ومدى تعقيد المكون الإضافي الخاص بك. إذا تم العثور على أي مشاكل ، فستتلقى رسالة بريد إلكتروني توضح بالتفصيل المشكلات المذكورة وكيف يمكنك إصلاحها.
بمجرد حل المشكلات (إن وجدت) ، ستتلقى الموافقة عبر البريد الإلكتروني. المكون الإضافي الخاص بك ليس عامًا في هذه المرحلة ، ولكن لا يزال بإمكانك تحميل الملفات وتحريرها وحذفها عبر سطر الأوامر أو عميل SVN.
نصيحة: للتأكد من عدم تفويتك لرسائل البريد الإلكتروني المهمة ، أوصي بوضع [البريد الإلكتروني المحمي] في القائمة البيضاء ، وهو عنوان البريد الإلكتروني الذي يستخدمه فريق مراجعة مكونات WordPress.org للتواصل مع مطوري المكونات الإضافية.
تحميل البرنامج المساعد
الآن بعد أن تم منحك حق الوصول إلى مستودع SVN ، فإن الخطوة التالية هي تحميل المكون الإضافي الخاص بك إلى مستودع WordPress.org. قبل القيام بذلك ، نوصيك بالتعرف على أساسيات استخدام Subversion مع WordPress.
سأقوم باستخدام واجهة سطر الأوامر لهذا البرنامج التعليمي. إذا لم تكن من محبيها وتفضل العمل مع عميل مرئي ، ففكر في TortoiseSVN لنظام التشغيل Windows و Cornerstone لنظام التشغيل Mac.
قبل أن تتمكن من تحميل ملفات البرنامج المساعد إلى مستودع SVN ، تحتاج إلى إنشاء مجلد محلي حيث سيتم تخزين الملفات والأصول. سيقوم هذا الأمر بإنشاء دليل محلي:
$ mkdir my-awesome-plugin
من أجل التناسق ، من الجيد تسمية المجلد وملف PHP الرئيسي للمكون الإضافي وفقًا للارتباط الثابت الذي تم تعيينه لك بعد الإرسال الأولي. في هذا المثال ، أفترض أن اسم المكون الإضافي الخاص بك هو My Awesome Plugin
وأن الحزمة التي تمت الموافقة عليها هي my-awesome-plugin
.
الآن ، لمشاهدة وتنزيل المستودع الذي تم إنشاؤه مسبقًا:
$ svn checkout https://plugins.svn.wordpress.org/my-awesome-plugin local/path/to/my-awesome-plugin
سيعطي هذا العائد التالي:
A my-awesome-plugin/branches A my-awesome-plugin/tags A my-awesome-plugin/trunk Checked out revision #####
هنا ، تعني A
أنه تمت إضافة الدلائل إلى المجلد المحلي من المستودع المركزي. بعد ذلك ، تحتاج إلى نسخ ملفات ومجلدات المكون الإضافي الخاص بك إلى مجلد trunk
:
$ rsync -r local/path/to/wordpress/wp-includes/plugins/my-awesome-plugin/* local/path/to/my-awesome-plugin/trunk
وإضافتهم إلى المستودع.
$ svn add trunk/*
في المقابل ، سيُطلب منك المصادقة على نفسك. بمجرد تسجيل الدخول ، ستحصل على رد يبدو كالتالي:
A trunk/my-awesome-plugin.php A trunk/readme.txt
هام: يتعامل WordPress.org مع مجلد trunk
على أنه مجلد المستوى الأعلى للمكون الإضافي الخاص بك. لذلك ، لا تقم بنسخ مجلد البرنامج المساعد بأكمله كما هو ، يجب أن يتضمن trunk
محتويات المكون الإضافي فقط.
تجنب هذا: trunk/my-awesome-plugin/my-awesome-plugin.php
بعد إضافة جميع الملفات ، قم بتنفيذ التغييرات مرة أخرى إلى المستودع المركزي:
$ svn commit -m 'My first plugin version'
سيعيد هذا الرد التالي:
Adding trunk/my-awesome-plugin.php Adding trunk/readme.txt Transmitting file data. Committed revision 9999999.
لتحميل رمز البرنامج المساعد والشعار ولقطات الشاشة ، يمكنك إنشاء مجلد أصول جديد داخل مستودع SVN المحلي الخاص بك:
$ mkdir local/path/to/my-awesome-plugin/assets
يمكنك معرفة كيفية عمل أصول البرنامج المساعد هنا.
بمجرد أن تصبح أصولك جاهزة ، أضف أصول البرنامج المساعد إلى مستودع SVN:
$ svn add assets/*
قم بإجراء التغييرات مرة أخرى:
$ svn commit -m 'Assets upload'
هذا هو! المكون الإضافي الخاص بك متاح الآن للتنزيل ويمكنك البدء في الترويج له.
نشر إصدار جديد
بالنسبة لإصدار التحديث التالي للمكون الإضافي الخاص بك ، تختلف الخطوات قليلاً. قبل نشر الإصدار الجديد ، قم بتحديث حقل Stable Tag
في trunk/readme.txt file
ورقم الإصدار في تعليق رأس المكون الإضافي. بمجرد أن تكون ملفات البرنامج المساعد جاهزة ، انسخها إلى مجلد فرعي من العلامات / واضبط اسم المجلد الفرعي على الإصدار الجديد ، مثل 1.0.1 .
$ svn copy trunk tags/1.0.1 A tags/1.0.1
التزم بالتغييرات.
$ svn commit -m 'Version 1.0.1 release' Adding tags/1.0.1 Adding tags/1.0.1/my-awesome-plugin.php Adding tags/1.0.1/readme.txt Committed revision 999999.
ومثل هذا ، فإن الإصدار الجديد من المكون الإضافي الخاص بك جاهز!
نصائح إدارة الإصدار
- قد تلاحظ بعض التأخير من لحظة إصدار الإصدار الجديد وعندما يصبح متاحًا للتنزيل على صفحة قائمة المكونات الإضافية WordPress.org. امنحها بضع ساعات ، وإذا كنت لا تزال لا ترى ذلك ، فيمكنك إرسال بريد إلكتروني إلى [email protected] لأن النظام يعاني من مشكلات من وقت لآخر.
- كقاعدة عامة ، لتقليل مشكلات المزامنة ، يوصى بأن يكون إصدار المكون الإضافي في مجلد
trunk
مطابقًا لإصدار المكون الإضافي في أحدث إصدار في مجلدtags
.
ماذا بعد؟
بطبيعتها ، فإن مطوري المكونات الإضافية المجانية مدفوعون ومتحمسون للمساهمة بأشياء مفيدة للعالم. قبل كل شيء ، نريد أن تحل منتجاتنا مشاكل معينة قد يواجهها الناس. ولكن بغض النظر عن مدى روعة المكون الإضافي الخاص بك ، فلن يكون مفيدًا إذا لم يتمكن الأشخاص من العثور عليه.
تتمثل الخطوة التالية الجيدة لتحسين رؤية المكون الإضافي المجاني في تحسين ملف readme.txt من أجل تحسين محركات البحث ، وهو شيء نستكشفه هنا.
إذا كنت تفكر في جني الأموال من المكون الإضافي الخاص بك ، فلا يكفي أن يكون لديك منتجك عبر الإنترنت مجانًا - فأنت تريد أن يكتشفه الناس ، ويستخدمونه ، ويحبونه ، و (نأمل) الترقية إلى نسختك المدفوعة! في الوقت الحاضر ، يرتدي مطور WordPress العديد من القبعات ، من صانع المنتج إلى صاحب العمل إلى المسوق ، ولجعل المكون الإضافي الخاص بك يرى من قبل الأشخاص المناسبين الذين تحتاجهم لتطوير مهاراتك التسويقية وتحسينها.
وهو موضوع نستكشفه بعمق من خلال دليل التسويق الخاص بنا لصانعي منتجات WordPress. أوصي بشدة أيضًا بمراجعة ورقة الغش أدناه لبيع المكونات الإضافية والسمات الخاصة بـ WordPress - إنها خارطة طريق موجزة وقابلة للتنفيذ لإنشاء أعمال WordPress ناجحة ، من الفكرة إلى الإطلاق إلى النمو.
احصل على نسخة مجانية من موقعنا
ورقة الغش لبيع الموضوعات والمكونات الإضافية
خارطة طريق للنمو مع نصائح موجزة وقابلة للتنفيذ لكل معلم من مراحل تطوير منتج WordPress.
شارك مع صديق
أدخل عنوان البريد الإلكتروني لصديقك. سنرسل لهم هذا الكتاب بالبريد الإلكتروني فقط ، شرف الكشافة.
شكرا لك للمشاركة
رائع - تم إرسال نسخة من "ورقة الغش لبيع السمات والمكونات الإضافية" إلى . هل تريد مساعدتنا في نشر الكلمة أكثر؟ استمر وشارك الكتاب مع أصدقائك وزملائك.
شكرا على الإشتراك!
- لقد أرسلنا للتو نسختك من "ورقة الغش لبيع السمات والمكونات الإضافية" إلى .
هل لديك خطأ مطبعي في بريدك الإلكتروني؟ انقر هنا لتعديل عنوان البريد الإلكتروني وإرساله مرة أخرى.
هل تخطط لإرسال مكون إضافي إلى مستودع WordPress.org؟ هل تفكر في استخدام نموذج عمل فريميوم؟ الصوت خارج في التعليقات أدناه!