لماذا وكيف يتم نشر البرنامج المساعد في دليل البرنامج المساعد وورد بريس

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

جرب نسخة تجريبية مجانية

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

لماذا دليل البرنامج المساعد وورد بريس؟

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

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

دليل البرنامج المساعد وورد بريس

دليل البرنامج المساعد وورد بريس

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

ما يجب أن تهتم به

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

الترميز

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

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

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

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

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

سمات

حتى إذا لم تحصل على أموال مقابل عملك ، يجب أن تعتبر المكونات الإضافية الخاصة بك مثل المنتجات التي تبيعها. لست مطالبًا بأن تكون متخصصًا في التسويق: عليك فقط أن تعرف أن المكون الإضافي الخاص بك يجب أن يكون فريدًا إلى حد ما و / أو يمكن تمييزه عن المكونات الإضافية المماثلة. امنح المكون الإضافي الخاص بك اسمًا ذا مغزى لا يُنسى ، وميزات فريدة تجعل الناس يقولون “أنا بحاجة إليه!” وإذا كان المكون الإضافي الخاص بك يوفر ميزات تمت تغطيتها بالفعل بواسطة مكونات إضافية أخرى ، فركز على إمكانية الوصول وسهولة الاستخدام لمنح المستخدمين قيمة مضافة تُحدث فرقًا واضحًا بين منتجك ومنافسيه.

الدعم

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

التحديثات

قم بتحديث المكون الإضافي بانتظام ، ودفع التغييرات الصغيرة عند الحاجة ، ولكن لا تتجاوز. الكثير من التحديثات يمكن أن يخيب آمال المستخدمين.

الترخيص

تم إصدار وورد بريس بموجب ترخيص GNU العام V2 ويتم إصدار معظم الملحقات بموجب ترخيص GPL نفسه. في الواقع ، ليس مطلوبًا بشكل صارم إصدار المكون الإضافي بموجب نفس الترخيص ، حيث يتم قبول أي ترخيص متوافق. على أي حال ، يوصى باستخدام GPLv2 (اقرأ المزيد عن ترخيص GPL ).

من أجل تقديم مثال عملي لهذا المنشور ، تم نشر المكون الإضافي الذي قمنا بتشريحه في 4 Handy وورد بريس Media Library Hacks إلى الدليل. قم بتنزيل ExIF Viewer وافتح ملفاته في محرر النصوص الخاص بك ، ثم ارجع إلى هذا المنشور واغوص في بنية المكون الإضافي.

هيكل البرنامج المساعد

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

توفر مستودعات SVN أربعة مجلدات افتراضية:

/assets/
/branches/
/tags/
/trunk/

يتم إدخال لقطات الشاشة والعناوين والأيقونات في الأصول

trunk هو الدليل الذي ستضع فيه ملفات البرنامج المساعد

تنتقل فروع الكود المتباينة إلى الفروع

سيتم تخزين إصدارات البرنامج المساعد في العلامات

يجب توفير كل مكون إضافي من ملفين على الأقل: ملف readme.txt ونص PHP الرئيسي. اختياريًا ، يمكنك إضافة عدد من الصور (الأصول) ليتم عرضها على صفحة البرنامج المساعد.

أصول البرنامج المساعد

الأصول هي رؤوس المكونات الإضافية والأيقونات ولقطات الشاشة. رؤوس المكونات الإضافية هي صور JPG أو PNG التي يمكنك رؤيتها في الجزء العلوي من صفحة البرنامج المساعد. تعتمد أسماء الملفات على عرض الصورة وارتفاعها. حاليًا ، يُسمح بالاسم / الأبعاد التالية:

عادي: بانر 772 × 250 (jpg | png)

شبكية العين: banner-1544 × 500. (jpg | png)

الأيقونات عبارة عن صور مربعة بالأسماء / الأبعاد التالية:.

icon-128 × 128. (jpg | png)

icon-256 × 256. (jpg | png)

icon.svg

يجب ألا تحدد أبعاد SVG في اسم الملف ، حيث يمكن تغيير حجم هذه الصور بأي حجم. إذا كنت تستخدم SVGs ، فيجب عليك توفير رمز PNG كعنصر احتياطي.

لقطات الشاشة هي الصور المعروضة في محتوى صفحة البرنامج المساعد. يُسمح بتنسيقات PNG و JPEG ، ويجب أن يكون اسم الملف بأحرف صغيرة وأن يحترم البنية التالية:

لقطة شاشة 1. (jpg | png)

قطة 2. (jpg | png)

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

صفحة Akismet

تجعل الأصول الجذابة والمتسقة صفحة مكون إضافية رائعة

ملف Readme.txt

يجب عليك تزويد الإضافة بملف readme.txt والعناوين المناسبة في النص الرئيسي.

أولاً ، أنت بحاجة إلى ملف readme.txt بالمعلومات التالية:

اسم البرنامج المساعد

المساهمون : (قائمة وورد بريس.org userid’s)

رابط التبرع : http://example.com/

العلامات : (علامات البرنامج المساعد)

يتطلب على الأقل : (إصدار وورد بريس)

تم اختباره حتى : (إصدار وورد بريس)

علامة مستقرة : (إصدار البرنامج المساعد)

الترخيص : GPLv2 أو أحدث (أو متوافق)

URI للترخيص : https://www.gnu.org/licenses/gpl-2.0.html

وصف

التركيب

لقطات

التغيير

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

المدقق التمهيدي

يُخرج Readme Validator الملاحظات والتحذيرات على الملفات التمهيدية

تعليق رأس البرنامج المساعد

يخبر تعليق الرأس وورد بريس أن الملف عبارة عن مكون إضافي.

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

اسم المكون الإضافي : (مطلوب) يجب أن يكون اسم المكون الإضافي فريدًا. قبل النشر ، ابحث في دليل المكونات الإضافية عن المكونات الإضافية التي تحمل الاسم نفسه

عنوان URI للمكون الإضافي : الصفحة الرئيسية للمكوِّن الإضافي

الوصف : وصف مكون إضافي مكون من سطر واحد (أقل من 140 حرفًا)

الإصدار : إصدار البرنامج المساعد الحالي (يجب أن يكون أعلى من الإصدار السابق)

المؤلف : اسم مؤلف واحد أو أكثر ، مفصولة بفواصل

عنوان URI للمؤلف : الصفحة الرئيسية للمؤلف

الترخيص : سبيكة ترخيص البرنامج المساعد (مثل GPL2)

URI للترخيص : الرابط إلى النص الكامل للترخيص (مثل https://www.gnu.org/licenses/gpl-2.0.html)

مجال النص: المجال النصي للمكوِّن الإضافي

مسار المجال: أين تجد ملفات الترجمة (انظر كيفية تدويل البرنامج المساعد الخاص بك )

فيما يلي تعليق رأس أحد أكثر ملحقات وورد بريس شيوعًا :

<?php
/**
 * @package Akismet
 */
/*
Plugin Name: Akismet Anti-Spam
Plugin URI: https://akismet.com/
Description: Used by millions, Akismet is quite possibly the best way in the world to <strong>protect your blog from spam</strong>. It keeps your site protected even while you sleep. To get started: activate the Akismet plugin and then go to your Akismet Settings page to set up your API key.
Version: 3.3.2
Author: Automattic
Author URI: https://automattic.com/wordpress-plugins/
License: GPLv2 or later
Text Domain: akismet
*/

النشر في دليل البرنامج المساعد وورد بريس

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

تريد أن تعرف كيف زدنا من حركة المرور لدينا أكثر من 1000 ٪؟

انضم إلى أكثر من 20000 آخرين ممن يتلقون رسائلنا الإخبارية الأسبوعية مع نصائح من الداخل حول وورد بريس!

إشترك الآن

أضف البرنامج المساعد الخاص بك

يجب تحميل إصدار المكون الإضافي الأول للمراجعة اليدوية

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

في انتظار الموافقة

قد تستغرق عملية المراجعة ما يصل إلى عشرة أيام

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

البريد الإلكتروني للموافقة

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

في الوقت الحالي ، لا يتوفر المكون الإضافي للتنزيل ، ولكن يمكنك تحميل الملفات وتحريرها وحذفها عبر سطر الأوامر (أو أي عميل SVN). توضح الصورة أدناه صفحة البرنامج المساعد الحالية.

صفحة البرنامج المساعد المعتمدة

صفحة المكوّن الإضافي نشطة ، لكن المكوّن الإضافي غير متاح للتنزيل

تحميل البرنامج المساعد

مهمتنا الأولى هي تحميل ملفات البرنامج المساعد إلى مستودع SVN ، لكننا نحتاج أولاً إلى مجلد محلي حيث سنخزن ملفات البرنامج المساعد:

$ mkdir localdir

الآن يمكننا التحقق من مستودع ما قبل الإنشاء:

$ svn co https://plugins.svn.wordpress.org/plugin-name path/to/localdir

سنحصل على الرد التالي:

> A    plugin-name/branches
> A    plugin-name/tags
> A    plugin-name/trunk
> Checked out revision 99999999.

و الوسائل التي المجلدات التي تمت إضافتها من المستودع المركزي إلى مجلد محلي.

الخطوة التالية هي إضافة الملفات إلى المجلد المحلي / trunk وتحميلها إلى المستودع:

localdir/$ svn add trunk/*

سيُطلب منك المصادقة على نفسك. بمجرد تسجيل الدخول ، ستحصل على الرد التالي:

هل تعاني من مشاكل التوقف و وورد بريس؟ Kinsta هو حل الاستضافة المصمم لتوفير الوقت! تحقق من ميزاتنا

> A    trunk/my-plugin.php
> A    trunk/readme.txt

ملاحظة: لا تضع ملف البرنامج المساعد الرئيسي في مجلد فرعي من trunk ، لأن هذا سيؤدي إلى تعطيل التنزيلات.

تحقق الآن من التغييرات مرة أخرى إلى المستودع:

localdir/$ svn ci -m 'First plugin version'

وهنا الرد النهائي:

> Adding trunk/my-plugin.php
> Adding trunk/readme.txt
> Transmitting file data .
> Committed revision 9999999.

هيكل عارض ExIF

بنية ملف النسخة المحلية من عارض ExIF

بعد ذلك ، يتعين علينا إضافة أصول البرنامج المساعد:

localdir/$ svn add assets/*

ثم تحقق من التغييرات مرة أخرى:

localdir/$ svn ci -m 'Assets upload'

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

صفحة البرنامج المساعد ExIF Viewer

الصفحة الأخيرة من البرنامج المساعد ExIF Viewer

انشر إصدارًا جديدًا

قبل نشر الإصدار التالي ، يجب أن تتذكر تحديث حقل العلامة الثابتة في ملف trunk / readme.txt ورقم الإصدار في تعليق رأس الملحق. عندما يكون الإصدار الجديد جاهزًا للنشر ، انسخ ملفاتك إلى مجلد فرعي للعلامات / واضبط اسم المجلد الفرعي على رقم الإصدار (أي 1.0.1):

localdir/$ svn cp trunk tags/1.0.1
> A tags/1.0.1

ثم قم بإيداع التغييرات:

localdir/$ svn ci -m "tagging version 1.0.1"
> Adding         tags/1.0.1
> Adding         tags/1.0.1/my-plugin.php
> Adding         tags/1.0.1/readme.txt
> Committed revision 999999.

وهذا كل شيء! الإصدار الجديد على الإنترنت.

تحرير ملف

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

localdir/$ svn up
> At revision 999999.

ثم قم بتحرير الملفات وتحقق من التغييرات:

localdir$ svn stat
> M       trunk/readme.txt

M يعني أنه تم تعديل هذه الملفات.

فيما يلي يمكنك رؤية ما تغير بين النسختين:

localdir$ svn diff

أخيرًا ، ckeck في التغييرات على المستودع المركزي:

localdir$ svn ci -m "minor changes"
> Sending trunk/readme.txt
> Transmitting file data .
> Committed revision 999999.

ملخص

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

إذا كنت تشعر أن مهاراتك في المبيعات والتسويق ليست قوية بما يكفي ، فتأكد من مراجعة Bridget Willard’s ” How To Market Your Plugin ” لمعرفة المزيد حول كيفية تحسين بيع المكونات الإضافية.

إذن ، هل فكرت يومًا في هذه الفرصة؟ شارك تجربتك معنا أدناه.

وفر الوقت والتكاليف وحقق أقصى قدر من أداء الموقع من خلال:

مساعدة فورية من خبراء استضافة وورد بريس ، 24/7.

تكامل Cloudflare Enterprise.

يصل الجمهور العالمي إلى 28 مركز بيانات حول العالم.

التحسين من خلال مراقبة أداء التطبيقات المضمنة لدينا.

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