كيفية إرسال الإضافات إلى مستودع 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؟ هل تفكر في استخدام نموذج عمل فريميوم؟ الصوت خارج في التعليقات أدناه!