استخدام Subversion مع دليل البرنامج المساعد WordPress
نشرت: 2012-07-24اتبع هذه التعليمات خطوة بخطوة لإضافة وتحديث المكونات الإضافية في دليل WordPress Plugin العام.
هذه الخطوات الأساسية من الفيديو تتبع أدناه:
- الشروع في العمل مع البرنامج المساعد الخاص بك
- سجل للحصول على حساب WordPress.org
- اطلب وضع البرنامج المساعد الجديد في دليل البرنامج المساعد WordPress
- قم بتثبيت عميل SVN لجهازك
- اختر دليلاً محليًا لمشاريعك
- البريد الإلكتروني الخاص بالموافقة على طلب المكون الإضافي
- شروط الدليل لهذه المادة
- سحب دليل الخادم الجديد إلى جهازك المحلي
- الانتهاء من تطوير البرنامج المساعد الخاص بك
- اجعل نسختك الأولى متاحة للجمهور
- تحديث جذع دليل المشروع
- وضع علامات على نسخة جديدة على الخادم
- تحديث دليل مشروعك المحلي بالإصدار الجديد ذي العلامات
- تحديث العلامة الثابتة readme.txt
- التطورات الجديدة لبرنامجك الإضافي
الشروع في العمل مع البرنامج المساعد الخاص بك
سواء كانت لديك فكرة أو أوشكت على الانتهاء من الإصدار 0.1 ، فأنت بحاجة إلى اسم ووصف للمكوِّن الإضافي الخاص بك. اجعل الاسم قصيرًا ووصفيًا ، مع إعطاء فكرة عما يفعله المكون الإضافي. "Wax on Wax off Plugin" ليس اسمًا جيدًا. "Drop Shadow Maker" أفضل بكثير. لست بحاجة إلى إضافة "البرنامج المساعد" إلى العنوان الفعلي.
لتتماشى مع العنوان الخاص بك ، يجب أن تكتب وصفًا موجزًا يخبر الأشخاص بالفوائد التي يوفرها المكون الإضافي الخاص بك. أوصي بأن يكون هذا الوصف أقل من 150 حرفًا.
سجل للحصول على حساب WordPress.org
إذا لم يكن لديك بالفعل حساب WordPress.org - يُستخدم للتفاعل في منتديات الدعم وما شابه - فأنت بحاجة إلى الحصول على حساب. ما عليك سوى الانتقال إلى: https://login.wordpress.org/register
اطلب وضع البرنامج المساعد الجديد في دليل البرنامج المساعد WordPress
يمكن أن تحصل المكونات الإضافية المعقولة التي يتم تسليمها بترخيص متوافق على مساحة في دليل مكونات WordPress.
- انتقل إلى: http://wordpress.org/extend/plugins/add/
- املأ العنوان والوصف
(قلت لك أنك ستحتاج ذلك!) - تخطي تحميل المكون الإضافي الخاص بك من هذا النموذج - حتى إذا كان المكون الإضافي الخاص بك جاهزًا للعمل.
تتم معالجة طلب دليل المكون الإضافي الخاص بك بواسطة أشخاص حقيقيين ، لذلك قد يستغرق الأمر بعض الوقت.
قم بتثبيت عميل SVN لجهازك
للعمل مع دليل البرامج الإضافية ، تحتاج إلى عميل Subversion على جهازك.
- لنظام التشغيل Windows ، أوصي بـ TortoiseSVN.
- بالنسبة لنظام التشغيل Mac ، يبدو أن SCPlugin عبارة عن حزمة جيدة.
ما عليك سوى اختيار واحد وتثبيته. ليس هناك الكثير ليقال عن ذلك.
اختر دليلاً محليًا لمشاريعك
ستحتفظ Subversion بنسخة محلية من ملفات البرنامج المساعد محدثة باستخدام دليل WordPress Plugin. أوصي بإنشاء دليل واحد على جهازك المحلي حيث ستحتفظ بجميع مشاريعك التي يتم تتبع التخريب فيها. تحذير: إذا كانت لديك بيئة تطوير ويب على جهازك المحلي ، فلا تميل إلى استخدام دليل إضافات WordPress لخادم الويب المحلي كدليل لمشروعك.
على سبيل المثال ، إذا كان لديك تثبيت WordPress محلي على جهازك حيث يكون مجلد الإضافات:
documents/public_html/devdomain.com/wp-content/plugins/
... لا تعتقد أنه يمكنك استخدام هذا الدليل لمزامنة مشاريع دليل البرنامج المساعد في WordPress. هذا سوف يسبب لك الألم.
بدلاً من ذلك ، قم بإنشاء دليل مثل هذا المثال:
documents/projects/wp-plugins-public/
سيتم وضع كل مجلد من مجلدات مشروع المكون الإضافي ضمن "wp-plugins-public". في هذا البرنامج التعليمي ، سأستخدم مجلد مكون إضافي باسم "جدولة المحتوى". لذلك ، سأكون قد قمت بعمل دليل على هذا النحو:
documents/projects/wp-plugins-public/content-scheduler
البريد الإلكتروني الخاص بالموافقة على طلب المكون الإضافي
بمجرد الموافقة على طلب المكون الإضافي الخاص بك ، ستتلقى رسالة بريد إلكتروني تحتوي على رابط إلى مستودع SVN الخاص بك. هذا مخصص لهذا المكون الإضافي ، وهو ضروري لمتابعة مزامنة Subversion.
شروط الدليل لهذه المادة
مع وجود العديد من الدلائل والمشاريع والمجلدات المختلفة المذكورة في هذه المقالة ، قد يكون من السهل الخلط. دعنا نتفق على ثلاثة مواقع مختلفة عند العمل مع سير عمل التخريب هذا.
- عمل اخراجي
هذه هي النسخة الحالية من الكود الذي تقوم بتغييره واختباره. يجب أن يكون في المجلد "/ wp-content / plugins /" على خادم الويب الخاص بالتطوير. على جهازي ، يحدث أن يكون:
documents/public_html/devdomain.com/wp-content/plugins/content-scheduler/ - دليل المشروع
هذا هو الدليل الذي سيظل عميل Subversion الخاص بك متزامنًا مع دليل WordPress Plugin Directory. على جهازي ، هذا هو:
documents/projects/wp-plugins-public/content-scheduler/ - دليل الخادم
يشير هذا إلى مشروعك كما هو مخزّن في دليل WordPress Plugin. هذا هو المكان الذي سيتمكن فيه الجمهور من الحصول على المكون الإضافي الخاص بك. يُطلق على موقع الجذر اسم "مستودع SVN" الخاص بك ، وسيتم تخصيصه لك في البريد الإلكتروني الخاص بالموافقة على طلب المكون الإضافي. على سبيل المثال ، هذا هو:
http://plugins.svn.wordpress.org/content-scheduler
سحب دليل الخادم الجديد إلى جهازك المحلي
على الرغم من أنك لم تضع أي ملفات في موقع المكون الإضافي الجديد الخاص بك في دليل المكونات الإضافية ، فإنك تحتاج إلى سحب تلك النسخة من الدليل إلى جهازك. يؤدي القيام بذلك إلى تعيين بعض العلامات وراء الكواليس لمساعدة عميل Subversion الخاص بك على معرفة ما يتم تحديثه وما هو غير ذلك.
- انقر بزر الماوس الأيمن فوق مجلد البرنامج المساعد لدليل المشروع.
- اختر "SVN Checkout".
- أدخل عنوان URL الخاص بمستودع WordPress SVN (من البريد الإلكتروني الخاص بالموافقة) في الحقل الأول.
- يجب أن يكون مجلد البرنامج المساعد لدليل المشروع في الحقل الثاني.
منذ أن بدأت هذه العملية بالنقر بزر الماوس الأيمن على هذا المجلد ، يجب أن يكون هذا الحقل ممتلئًا بالفعل. - انقر فوق موافق"
الانتهاء من تطوير البرنامج المساعد الخاص بك
تطوير واختبار البرنامج المساعد الخاص بك. يتضمن ذلك إنشاء ملف "readme.txt" مناسب لتتماشى معه. إن ملف "readme.txt" ليس مجرد بعض الملاحظات العشوائية حول البرنامج المساعد الخاص بك. يستخدم دليل البرنامج المساعد WordPress محتويات ملف "readme.txt" لفهم إصدار المكون الإضافي الخاص بك الذي يعتبر حاليًا ، وكذلك لإنشاء محتويات صفحة المكون الإضافي في الدليل.
- لمزيد من المعلومات حول إنشاء ملف "readme.txt" مناسب ، راجع هذا المثال الخاص بـ WordPress readme.txt.
جزء أساسي من ملف “readme.txt” الخاص بك هو علامة “Stable”. أثناء تطوير المكوِّن الإضافي الخاص بك ، اترك هذه العلامة مكتوب عليها "trunk". بمجرد إصدار إصدار للاستهلاك العام ، سنقوم بتحديثه برقم الإصدار الصحيح.
اجعل نسختك الأولى متاحة للجمهور
تحديث جذع دليل المشروع
- انسخ محتويات دليل العمل إلى مجلد "trunk" في دليل مشروعك.
في حالتي ، أقوم بنسخ محتويات المكون الإضافي بالكامل من دليل العمل:
/documents/public_html/devdomain.com/wp-content/plugins/content-scheduler/
إلى دليل مشروعي:
/documents/projects/wp-plugins-public/content-scheduler/ - انقر بزر الماوس الأيمن على مجلد البرنامج المساعد "content-Scheduler" في دليل المشروع الخاص بك واختر "SVN Commit."
- أدخل تعليقًا للالتزام إذا كنت تريد.
- راجع قائمة الملفات التي تعتبر جديدة وسيتم نسخها إلى الخادم. إذا كانت هذه القائمة تبدو دقيقة ، فانقر فوق "موافق" وسيتم نسخ الملفات إلى دليل الخادم الخاص بك على wordpress.org.
وضع علامات على نسخة جديدة على الخادم
لقد قمت بتحديث الملفات في "trunk" ، لكن هذا ليس ما يجب على الجمهور تنزيله. تحتاج إلى استخدام "العلامات" لإنشاء نسخة من "trunk". لن يتم تغيير هذه النسخة بعد ذلك ، وسيتم عرضها للاستخدام العام. في هذا المثال ، لنقم بإنشاء إصدار 1.0.
- انقر بزر الماوس الأيمن على مجلد "trunk" في دليل المشروع واختر "Branch / Tag".
بالنسبة لي ، هذا هو:
/documents/projects/wp-plugins-public/content-scheduler/trunk/ - سينتهي حقل الموقع "إلى URL" بـ "/ trunk". تحتاج إلى تغيير هذا إلى "/tags/1.0" لإنشاء نسختك 1.0.
- يمكنك إضافة ملاحظة حول عملية وضع العلامات هذه إذا كنت تريد ذلك.
- انقر فوق "موافق" ، وتجاهل أي رسالة حول "من المهم التغيير إلى هذا الفرع ..."
تحديث دليل مشروعك المحلي بالإصدار الجديد ذي العلامات
لقد أخبرت الخادم للتو أن يقوم بعمل نسخة جديدة من ملفات مشروعك في الدليل "/tags/1.0". الآن ، نحتاج إلى تحديث دليل مشروعك المحلي بهذه العلامة الجديدة.
قد تبدو هذه العملية غريبة. قد تتساءل لماذا لا يمكنك فقط إنشاء نسختك الخاصة في دليل "/tags/1.0" المحلي. إذا قمت بذلك ، يمكن أن يصبح دليل الخادم ودليل المشروع في حالة من الفوضى والارتباك بشأن ما تم تحديثه وما لم يتم تحديثه.
- انقر بزر الماوس الأيمن فوق دليل المشروع مرة أخرى واختر "SVN Update".
يؤدي هذا إلى سحب التغييرات من دليل الخادم إلى دليل المشروع المحلي. في هذه الحالة ، يكون التغيير إضافة لنسخة "/tags/1.0" من ملفاتك.
تحديث العلامة الثابتة readme.txt
جميع الملفات الصحيحة في مكانها للجمهور لاستخدام المكون الإضافي الخاص بك. ومع ذلك ، يتعين علينا إخبار دليل البرنامج المساعد بالنسخة ذات العلامات التي يجب على الجمهور استخدامها.
- قم بتحرير ملف "readme.txt" في مجلد "trunk" بدليل المشروع المحلي.
بالنسبة لي ، هذا ما يلي:
/documents/projects/wp-plugins-public/content/scheduler/trunk/readme.txt - غيّر "العلامة الثابتة" إلى نسخة إصدارك ، "1.0"
- حفظ الملف
- انقر بزر الماوس الأيمن فوق ملف "readme.txt" الذي قمت بتحديثه للتو واختر "SVN Commit".
هذا هو! في غضون 15 دقيقة أو نحو ذلك:
- سيقوم دليل WordPress Plugin بتحديث قائمة مشروعك
- سيُنظر إلى "1.0" على أنه علامة ثابتة
- سيتم استخدام المعلومات الموجودة في "/tags/1.0/readme.txt" لملء صفحة مشروعك.
التطورات الجديدة لبرنامجك الإضافي
على الأرجح ، ستجري تحسينات على المكون الإضافي الخاص بك وستحتاج إلى نشرها. إليك كيف يعمل هذا.
- قم بإجراء تغييرات على المكون الإضافي في دليل العمل الخاص بك.
يجب أن تتضمن هذه التغييرات التغييرات على ملف readme.txt حسب الحاجة ، مثل إدخالات سجل التغيير. - انسخ التغييرات من دليل العمل إلى دليل المشروع المحلي.
- تأكد من احتواء ملف readme.txt على علامة "ثابتة" صحيحة للإصدار العام الحالي.
- انقر بزر الماوس الأيمن فوق دليل المشروع واختر "SVN Commit" للحصول على تغييرات جذع جديدة في دليل الخادم.
- انقر بزر الماوس الأيمن فوق دليل "trunk" في دليل المشروع الخاص بك واختر "Branch / Tag" لإنشاء علامة إصدار جديدة للإصدار. (تأكد من تعيين "إنشاء نسخة داخل المستودع من:" على "نسخة العمل".)
- انقر بزر الماوس الأيمن فوق دليل المشروع واختر "SVN Update" لسحب تغييرات العلامة من دليل الخادم.
- قم بتحديث العلامة الثابتة في ملف "/trunk/readme.txt" الخاص بدليل المشروع لمطابقة علامة الإصدار الجديد التي قمت بإنشائها.
- انقر بزر الماوس الأيمن فوق دليل المشروع (نعم ، مرة أخرى) واختر "SVN Commit" لإحضار ملف readme.txt المحدث إلى الخادم.
تفو. هذا كل شئ!
العلامات: