As a WordPress developer, you’ve likely solved the same problems repeatedly—adding custom post types, tweaking theme functions, or adjusting plugin behaviour. Imagine this scenario: you’re working on a client project and must add a specific function that customizes the login page. You remember doing something similar before but can’t recall where you saved that snippet. You spend valuable time searching through old projects or browsing online resources, only to rewrite them from scratch. This kind of repetitive work is frustrating and inefficient. The solution? Build your code snippet repository. Creating a personal library of reusable code snippets can save you valuable time, reduce redundancy, and make your development process more efficient and organized. A well-maintained repository can be a lifesaver, making frequently used code easily accessible and reducing development time.
لماذا تحتاج إلى مستودع مقتطفات التعليمات البرمجية
تخيل أنك تعمل على عدة مواقع ووردبريس. لكل مشروع، تحتاج إلى إضافة وظيفة معينة تعدل صفحة تسجيل الدخول. بدلاً من البحث في 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. If you’re new to version control, start by creating a GitHub account, installing Git on your computer, and learning basic Git commands like بدء تشغيل git
(لتهيئة مستودع), إضافة git
(لإضافة ملفات إلى التدريج), التزام git
(لحفظ التغييرات)، و دفع git
(to upload your changes to GitHub). Additionally, familiarize yourself with branching, which allows you to safely experiment with changes. This setup not only gives you a safe backup but also lets you track changes over time—useful when you’re iterating on your code. If you’re new to version control, start by creating a GitHub account, installing Git on your computer, and learning basic Git commands like بدء تشغيل git
(لتهيئة مستودع), إضافة git
(لإضافة ملفات إلى التدريج), التزام git
(لحفظ التغييرات)، و دفع git
(لتحميل تغييراتك إلى GitHub). لا يمنحك هذا الإعداد نسخة احتياطية آمنة فحسب، بل يتيح لك أيضًا تتبع التغييرات بمرور الوقت - وهو أمر مفيد عند تكرار الشيفرة الخاصة بك. لا يمنحك هذا الإعداد نسخة احتياطية آمنة فحسب، بل يتيح لك أيضًا تتبع التغييرات مع مرور الوقت - وهو أمر مفيد عندما تقوم بتكرار شيفرتك.
على سبيل المثال، يمكنك إنشاء مستودع يسمى مقتطفات ووردبريس-سنيبتس
وتنظيمها في مجلدات مختلفة:
- وظائف الموضوع/وظائف/: المقتطفات المتعلقة بالمواضيع
- الرموز القصيرة/: رموز قصيرة مخصصة لمختلف الوظائف
- التخصيص الإداري/التخصيص الإداري/: رمز لتخصيص منطقة إدارة ووردبريس
قد يبدو مجلد نموذجي مثل هذا:
وورد-مقتطفات ووردبريس/
|-وظائف-موضوع-وظائف/
|--- enqueue-scripts.php
|--- تذييل مخصص.php
|-- الرموز القصيرة/
|-- youtube-embed.php
|-- تخصيص المسؤول/
|---لوحة معلومات مخصصة-قطعة-معلومات.php
With Git, you can collaborate with other developers and create a shared snippet library, making standardizing your team’s development approach easier. Remember to secure your repository by setting appropriate access controls and regularly backing it up to avoid any data loss. Using features like branch protection can prevent unauthorized changes and help maintain the quality of your code repository.
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
لا توفر أي معلومات حول الغرض منها، مما يجعل من الصعب إعادة استخدامها. بدلاً من ذلك، اتبع أفضل الممارسات التالية لضمان سهولة العثور على مقتطفاتك وفهمها:
Once you’ve set up your repository, following some best practices will help keep it organized and useful:
1.استخدام العناوين الوصفية: Titles like “Custom Post Type for Portfolio” or “Redirect After Login” make it easy to understand what each snippet does quickly.
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');
By saving this snippet in your repository under a folder named custom-post-types/, you have it ready whenever needed. So, you’ll be prepared the next time a client wants a portfolio section on their website.
الخاتمة
Building your code snippet repository may take some initial effort, but it’s an investment that will pay off in the long run. For beginners, tools like cloud-based note apps or WordPress plugins are great starting points due to their simplicity and ease of access. As you gain experience, consider transitioning to GitHub or GitLab for more control, collaboration features, and version history tracking. Each method has its advantages—cloud tools are simple and accessible, plugins integrate directly into WordPress, and version control tools provide safety, version tracking, and collaboration options. A plugin or cloud notes may be sufficient for small projects or beginners, but for larger teams or more complex needs, Git repositories are ideal. Choose a method that fits your workflow and start compiling your snippets today. For beginners, tools like cloud-based note apps or WordPress plugins are great starting points due to their simplicity. As you gain experience, consider transitioning to GitHub or GitLab for more control and collaboration features. Each method has advantages—cloud tools are simple and accessible, plugins integrate directly into WordPress, and version control tools provide safety and collaboration options. Choose a method that fits your workflow and start compiling your snippets today. With a well-organized library, you’ll write less code, reduce bugs, and complete projects faster. Whether you prefer cloud notes, Git repositories, or WordPress plugins, choose a method that fits your workflow and start compiling your snippets today.