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

لماذا تحتاج إلى مستودع مقتطفات التعليمات البرمجية

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

يساعدك مستودع مقتطفات التعليمات البرمجية:

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

إعداد مستودع مقتطفات التعليمات البرمجية الخاص بك

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

1: استخدام تطبيق الملاحظات المستند إلى السحابة

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

يستخدم العديد من المطورين أدوات مثل المفهوم, إيفرنوتأو Google Keep لإدارة مكتبات مقتطفات التعليمات البرمجية الخاصة بهم. لكل أداة إيجابياتها وسلبياتها:

• المفهوم: يحتوي على مجموعة ميزات غنية وممتازة لتنظيم المحتوى، ولكنه قد يكون أكثر تعقيدًا من اللازم للمكتبات الصغيرة.
• إيفرنوت: سهل الاستخدام مع ميزات جيدة لإدارة الملاحظات، ولكن لديه تنسيق متقدم محدود.
• Google Keep: خفيفة الوزن وسهلة الاستخدام ولكنها تفتقر إلى خيارات التصنيف والتنظيم القوية. يعتمد اختيار الأداة المناسبة على احتياجاتك: أداة Notion رائعة لمن يحتاجون إلى التنظيم، وأداة Evernote جيدة للملاحظات السريعة، وأداة Google Keep مناسبة لتخزين المقتطفات الأساسية جدًا. لكل أداة إيجابياتها وسلبياتها:
• المفهوم: يحتوي على مجموعة ميزات غنية وممتازة لتنظيم المحتوى، ولكنه قد يكون أكثر تعقيدًا من اللازم للمكتبات الصغيرة.
• إيفرنوت: سهل الاستخدام مع ميزات جيدة لإدارة الملاحظات، ولكن لديه تنسيق متقدم محدود.
• Google Keep: خفيفة الوزن وسهلة الاستخدام ولكنها تفتقر إلى خيارات تصنيف وتنظيم قوية. تسمح لك هذه الأدوات بتصنيف مقتطفاتك حسب العلامات (على سبيل المثال، "function.php"، "نوع المنشور المخصص"، "الرموز القصيرة")، مما يسهل البحث عنها. إليك مثالاً على ذلك:
• العنوان: إعادة توجيه تسجيل الدخول المخصص
• الفئة: إدارة المستخدمين

مقتطف الرمز:

الدالة Custom_login_redirect($redirect_to, $request, $request, $user) {
    // إعادة توجيه المستخدمين إلى الصفحة الرئيسية بعد تسجيل الدخول
    إرجاع home_url();
}
add_filter('login_redirect', 'custom_login_redirect', 10, 3);

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

2. التحكم في الإصدار باستخدام GitHub أو GitLab

للحصول على نهج أكثر تقدمًا، فكِّر في تخزين مقتطفاتك في جيثب أو GitLab. إذا كنت جديدًا على التحكم في الإصدار، ابدأ بإنشاء حساب GitHub، وتثبيت Git على حاسوبك، وتعلم أوامر Git الأساسية مثل بدء تشغيل git (لتهيئة مستودع), إضافة git (لإضافة ملفات إلى التدريج), التزام git (لحفظ التغييرات)، و دفع git (لتحميل تغييراتك إلى GitHub). بالإضافة إلى ذلك، تعرف على التفرع الذي يسمح لك بتجربة التغييرات بأمان. لا يمنحك هذا الإعداد نسخة احتياطية آمنة فحسب، بل يتيح لك أيضًا تتبع التغييرات بمرور الوقت - وهو أمر مفيد عندما تقوم بتكرار شفرتك البرمجية. إذا كنت جديدًا على التحكم في الإصدار، ابدأ بإنشاء حساب GitHub، وتثبيت Git على حاسوبك، وتعلم أوامر Git الأساسية مثل بدء تشغيل git (لتهيئة مستودع), إضافة git (لإضافة ملفات إلى التدريج), التزام git (لحفظ التغييرات)، و دفع git (لتحميل تغييراتك إلى GitHub). لا يمنحك هذا الإعداد نسخة احتياطية آمنة فحسب، بل يتيح لك أيضًا تتبع التغييرات بمرور الوقت - وهو أمر مفيد عند تكرار الشيفرة الخاصة بك. لا يمنحك هذا الإعداد نسخة احتياطية آمنة فحسب، بل يتيح لك أيضًا تتبع التغييرات مع مرور الوقت - وهو أمر مفيد عندما تقوم بتكرار شيفرتك.

على سبيل المثال، يمكنك إنشاء مستودع يسمى مقتطفات ووردبريس-سنيبتس وتنظيمها في مجلدات مختلفة:

• وظائف الموضوع/وظائف/: المقتطفات المتعلقة بالمواضيع
• الرموز القصيرة/: رموز قصيرة مخصصة لمختلف الوظائف
• التخصيص الإداري/التخصيص الإداري/: رمز لتخصيص منطقة إدارة ووردبريس

قد يبدو مجلد نموذجي مثل هذا:

وورد-مقتطفات ووردبريس/
  |-وظائف-موضوع-وظائف/
       |--- enqueue-scripts.php
       |--- تذييل مخصص.php
  |-- الرموز القصيرة/
       |-- youtube-embed.php
  |-- تخصيص المسؤول/
       |---لوحة معلومات مخصصة-قطعة-معلومات.php

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

3. ملحقات إدارة المقتطفات في ووردبريس

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

على سبيل المثال، إذا كنتَ تضيف بشكل متكرر طول مقتطف مخصص إلى مقالاتك، فيمكنك إضافته إلى إضافة مقتطفات التعليمات البرمجية:

الدالة Custom_excerpt_length($length) {
    الإرجاع 20؛ // تعيين طول المقتطف إلى 20 كلمة
}
add_filter('excer_length', 'custom_excerpt_length');

الدالة Custom_excerpt_length($length) {
    الإرجاع 20؛ // تعيين طول المقتطف إلى 20 كلمة
}
إضافة_فلتر('excer_length', 'custom_excerpt_length');

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

أفضل الممارسات لمستودع مقتطفات التعليمات البرمجية الخاص بك

من المزالق الشائعة وجود مستودع غير منظم. تخيل وجود مقتطفات متعددة باسم مقتطف1.php أو رمز الاختبار. php.-لا توفر هذه الأسماء أي سياق، مما يجعل من الصعب معرفة ما يفعله كل مقتطف دون فتح الشيفرة وقراءتها. على سبيل المثال، يمكن استبدال اسم مقتطف رديء مثل function-test.php باسم وصفي مثل تسجيل الدخول المخصص-إعادة التوجيه.php، مما يوفر السياق على الفور. على سبيل المثال، المقتطفات المسماة مثل مقتطف1.php أو test-code.php لا توفر أي معلومات حول الغرض منها، مما يجعل من الصعب إعادة استخدامها. بدلاً من ذلك، اتبع أفضل الممارسات التالية لضمان سهولة العثور على مقتطفاتك وفهمها:

بمجرد إعداد المستودع الخاص بك، سيساعدك اتباع بعض أفضل الممارسات في الحفاظ على تنظيمه وفائدته:

1.استخدام العناوين الوصفية: العناوين مثل "نوع المقالة المخصص للحافظة" أو "إعادة التوجيه بعد تسجيل الدخول" تجعل من السهل فهم ما يفعله كل مقتطف بسرعة.

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

// إعادة توجيه المستخدمين إلى الصفحة الرئيسية بعد تسجيل الدخول
الدالة Custom_login_redirect($redirect_to, $request, $request, $user) {
    إرجاع home_url();
}

3.التنظيم حسب الفئة: صنف المقتطفات في مجلدات أو علامات بناءً على الغرض منها (على سبيل المثال، المشرف، الواجهة الأمامية، الحقول المخصصة).

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

مثال على ذلك: إنشاء مقتطف نوع منشور مخصص

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

دالة إنشاء_حافظة_حافظة_نوع_البوست() { {
    $args = مصفوفة(
        'عام' => صحيح,
        "التسمية" => "المحفظة",
        'يدعم' => مصفوفة ('عنوان'، 'محرر'، 'صورة مصغرة')
    );
    register_post_type('portfolio', $args);
}
add_action('init'، 'create_portfolio_portfolio_post_type');

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

الخاتمة

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