في ووردبريس الاتساق وسهولة الصيانة في جميع أنحاء قاعدة البيانات الضخمة للمنصة. تُقدّم هذه الإرشادات المُصممة بدقة نصائح مُختصرة لتطوير ووردبريس ، مما يُعزز الوضوح والكفاءة.
باتباع صيانة ووردبريس ، يساهم المطورون حول العالم بتناغم، ويفهمون عمل بعضهم البعض بسلاسة. حثّ تطوير ووردبريس على اتباع معايير برمجة ووردبريس بدقة لضمان حلول عالية الجودة وقابلة للتطوير والصيانة على المدى الطويل.
لماذا نلتزم بمعايير برمجة ووردبريس؟
تهدف معايير البرمجة في ووردبريس إلى ضمان اتساق الكود بين المشاريع والمساهمين. فهي تُحسّن من سهولة قراءة الكود وصيانته في التطوير التعاوني، وتُسهّل مراجعات الكود والالتزام بأفضل الممارسات في جميع أنحاء بيئة ووردبريس.
ما هي معايير البرمجة في ووردبريس؟
تُوفّر معايير برمجة ووردبريس أساسًا للتعاون والاتساق في جميع أنحاء مشروع ووردبريس ومجتمعه، بدءًا من الكود الأساسي وصولًا إلى القوالب والإضافات. تُعتبر هذه المعايير، التي طوّرها مجتمع ووردبريس بالتشاور مع منتديات دعم ووردبريس بمثابة أفضل الممارسات التي مطوري ووردبريس والمساهمين اتباعها.
تعرّف على المزيد : كيف تقلل من تأثير التعليمات البرمجية الخارجية؟
أهمية معايير الترميز
تساعد معايير البرمجة على منع الأخطاء الشائعة، وتحسين قابلية قراءة الكود، وتبسيط التعديلات. وبالالتزام بها، يبدو الكود كما لو أنه مكتوب من قبل شخص واحد، مما يسهل على أي شخص فهمه وتعديله.
المساهمة في تطوير نواة ووردبريس
إذا كنت تساهم في تطوير نواة ووردبريس، فإن التعرف على هذه المعايير أمر بالغ الأهمية، حيث يجب أن يتوافق الكود المقدم معها.
هل تواجه صعوبة في الحفاظ على معايير البرمجة لموقعك الفريد على ووردبريس؟
دع مطوري ووردبريس الخبراء لدينا يتولون الأمر!
مكونات معايير ترميز ووردبريس
تغطي المعايير إرشادات خاصة بلغات CSS و HTML و JavaScript و PHP، بالإضافة إلى إرشادات إمكانية الوصول المتوافقة مع WCAG AA.
اقرأ أيضاً: كيف يتم تحويل HTML إلى قالب ووردبريس؟
استثناء للمكتبات الخارجية
ومع ذلك، فإن مكتبات الطرف الثالث المدمجة في ووردبريس مستثناة من هذه المعايير.
أمثلة على معايير البرمجة في ووردبريس
دعونا نستكشف معايير برمجة ووردبريس من خلال أمثلة متنوعة لفهم تطبيقها في سيناريوهات واقعية. توضح هذه الأمثلة أفضل الممارسات الموصى بها لكتابة كود واضح وسهل الصيانة في ووردبريس.
لغة PHP في ووردبريس
يستخدم ووردبريس تحديثات PHP كلغة برمجة أساسية. يُعدّ الالتزام بمعايير برمجة PHP أمرًا بالغ الأهمية لضمان سهولة صيانة الكود واتساقه في ووردبريس. إليك سبب أهمية معايير برمجة PHP:
فواصل الأسطر
لا يُحدد ووردبريس الكثير بشأن فواصل الأسطر، ولكن من الشائع إضافتها بعد معظم العبارات. كما يُنصح بوضع تعريفات المتغيرات، وعبارات if، وعناصر المصفوفة على أسطر منفصلة.
المسافة البادئة
لتسهيل قراءة الكود، استخدم المسافة البادئة لإظهار بنيته المنطقية. استخدم علامات الجدولة في بداية الأسطر، بينما استخدم المسافات للمسافة البادئة في منتصف السطر.
استخدام المساحة
اجعل قراءة الكود أسهل بإزالة أي مسافات زائدة في نهاية الأسطر. كذلك، احذف الأسطر الفارغة التي تحتوي على علامات جدولة أو مسافات غير قابلة للكسر. استخدم المسافات داخل الأقواس لتوضيح الكود. أضف فاصل أسطر بعد القوس المفتوح وقبل القوس المغلق، باستثناء عمليات تحويل الأنواع.
يقتبس
في ووردبريس، القاعدة الأساسية هي استخدام علامات اقتباس مفردة للنصوص إلا إذا كنت تُقيّم شيئًا ما بداخلها. إذا كنت بحاجة إلى علامات اقتباس داخل نص، فاستخدم علامات الاقتباس المفردة والمزدوجة بالتناوب. يُسمح باستخدام علامات الهروب قبل علامات الاقتباس، ولكن نادرًا ما يكون ذلك ضروريًا.
تقويم الأسنان
أبسط طريقة هي استخدام الأقواس المعقوفة دائمًا. مع أن المعايير تسمح بتجاوز الأقواس المعقوفة في عبارات "if" أحادية السطر التي لا تحتوي على كتل متعددة الأسطر في نفس البنية، إلا أن هذا غير مسموح به في الحلقات أحادية السطر. أنا شخصيًا أفضل استخدام الأقواس المعقوفة دائمًا لزيادة الوضوح. إضافةً إلى ذلك، تنص المعايير على وضع القوس المفتوح في نفس سطر العبارة الأولى، وليس أسفلها كما هو الحال في توثيق PHP.
تنسيق استعلامات SQL
عند كتابة استعلامات SQL، تذكر كتابة الكلمات الرئيسية بأحرف كبيرة. يجب تقسيم الاستعلامات المعقدة إلى عدة أسطر. من المهم فهم الاستعلامات جيدًا، وخاصة جوانبها الأمنية، والتي سنتناولها لاحقًا. تحدث هجمات حقن SQL نتيجةً لأخطاء أمنية في ووردبريس ، مما يسمح للمخترقين بالوصول المباشر إلى قاعدة البيانات الخاصة بموقع ووردبريس والتلاعب بها.
اصطلاحات التسمية
في كود ووردبريس، تجنب استخدام نمط CamelCase في الأسماء. يجب أن تستخدم الدوال أحرفًا صغيرة، مع استخدام الشرطات السفلية عند الحاجة. يجب أن تبدأ أسماء الفئات بحرف كبير، مفصولة بشرطات سفلية.
يجب أن تكون أسماء الملفات بأحرف صغيرة فقط، مع وجود شرطات بين أجزائها. إذا كان الملف يحتوي على فئة واحدة، فيُسمى باسم الفئة مسبوقًا بـ "class-".
استخدم قيمًا نصية لوسائط الدوال بدلًا من القيم المنطقية لزيادة الوضوح. القاعدة الأهم هي اختيار أسماء وصفية. في بيئة عمل تعاونية، احرص على أن يفهم الجميع الكود الذي تكتبه.
بيانات المقارنة
من الممارسات الجيدة، ليس فقط في ووردبريس، وضع المتغير دائمًا على الجانب الأيمن من عملية المقارنة. بهذه الطريقة، إذا نسيت علامة المساواة، فسيحدث خطأ بدلًا من أن تكون النتيجة صحيحة. يُسمح باستخدام عوامل التشغيل الثلاثية، ولكن يُنصح بالتحقق من صحة المتغير لجعل الأمور أكثر وضوحًا. ويُستثنى من ذلك التحقق من المتغيرات غير الفارغة باستخدام !empty().
تنسيق HTML
بحسب دليل ووردبريس، من المهم التحقق من صحة جميع أكواد HTML باستخدام أداة التحقق من صحة W3C. مع ذلك، لا يعني الكود الصحيح بالضرورة أنه كود جيد، على الرغم من وجود علاقة واضحة بينهما.
نوع المستند
يتبع ووردبريس مواصفات XHTML 1.0 التي أوصت بها منظمة W3C في عام 2000. ومع ذلك، يستخدم قالب Twenty Eleven، وهو القالب الافتراضي في ووردبريس، لغة HTML5. لا يوجد تعارض حقيقي لأن HTML5 يتضمن تسلسل XML، مما يسمح باستخدام "XHTML5"
استخدام علامات الاقتباس
في لغة HTML، تُستخدم علامات الاقتباس بشكل أساسي للسمات وقيمها. يمكنك اختيار علامات اقتباس مفردة أو مزدوجة، ولكن يُنصح بالالتزام بنوع واحد باستمرار. شخصيًا، أستخدم علامات الاقتباس المفردة كلما أمكن، كما أفعل في لغة PHP، حفاظًا على التناسق. هذا يُسهّل عليّ تحديد أي حالات خاصة في السطر بمجرد النظر إلى علامات الاقتباس.
الكلمات الختامية
تُلزم مواصفات XHTML بإغلاق جميع الوسوم. يجب إغلاق العناصر الفارغة بشرطة مائلة قبل القوس الزاوي الأخير مباشرةً. تأكد من وجود مسافة واحدة قبل الشرطة المائلة، كما هو مُحدد.
المسافة البادئة
قم بتنسيق كود HTML الخاص بك وفقًا لقواعد التنسيق المتبعة في PHP. احرص على أن يكون التنسيق منطقيًا. عند دمج PHP وHTML، قم بتنسيق كتل PHP وفقًا لتسلسل التنسيق المعتاد.
تنسيق CSS
تتضمن عملية تنسيق CSS تنظيم وتصميم عرض محتوى الويب، مما يضمن التناسق وسهولة القراءة عبر مختلف الأجهزة والمتصفحات. يُحسّن تنسيق CSS الصحيح بنية مواقع الويب وجاذبيتها البصرية، مما يُسهم في تحسين تجربة المستخدم.
اقرأ المزيد: كيف تحذف أكواد CSS غير المستخدمة في ووردبريس؟
المسافة البادئة والبنية
يجب أن يتبع تنسيق CSS الخاص بك هذا المخطط التقريبي: اكتب كل مُحدِّد على سطر منفصل، حتى لو كنت تُدرج مُحدِّدات متعددة لمجموعة قواعد. كذلك، يجب أن يكون كل زوج من الخاصية والقيمة على سطر منفصل. ضع القوس المفتوح على سطر المُحدِّد، وضع القوس المغلق على سطر منفصل بنفس مسافة بادئة المُحدِّد المفتوح.
اصطلاحات التسمية
استخدم الأحرف الصغيرة فقط. افصل الكلمات داخل المحدد باستخدام واصلة. أعطِ المحددات أسماءً يسهل على الإنسان قراءتها.
الخصائص والقيم
توجد عدة قواعد لكتابة الخصائص وقيمها. استخدم الاختصارات كلما أمكن، إلا عند استبدال خاصية مُعرَّفة مسبقًا. استخدم رموز HEX صغيرة للألوان كلما أمكن. استخدم النسخة المختصرة عند الحاجة. ضع مسافة بعد النقطتين الرأسيتين بعد الخاصية. استخدم الأحرف الصغيرة دائمًا، إلا عند الحاجة إلى حرف كبير، كما هو الحال مع أسماء الخطوط وخصائص الموردين. رتِّب خصائص CSS أبجديًا، باستثناء خصائص الموردين التي يجب أن تسبق دائمًا نظيرتها العامة، وخصائص الأبعاد التي يجب تجميعها معًا. إذا تم تحديد العرض والارتفاع، فاكتب العرض أولًا.
التعليق
يدعم CSS نوعًا واحدًا فقط من التعليقات، وهو نمط الكتلة؛ ولا توجد صيغة منفصلة للتعليقات المضمنة. اكتب التعليقات القصيرة في سطر واحد، دون فاصل أسطر أسفلها. أما التعليقات التي تمتد على عدة أسطر، فأضف فاصل أسطر بعد بداية التعليق مباشرةً وقبل نهايته. إذا كنت تستخدم التعليقات لفصل أجزاء من الكود، فاستخدم الصيغة التالية:
استخدام معالجات CSS المسبقة
يُسهّل استخدام مُعالجات CSS المُسبقة، مثل SASS وLess، عملنا كمطورين بشكل كبير، لكنها لا تخلو من العيوب. عادةً ما يكون الكود الناتج عن هذه الأدوات صحيحًا، لكن لا يُمكن وصفه بأنه نظيف تمامًا. ستكون ورقة الأنماط المُنشأة يدويًا (وبعناية) أكثر قابلية للقراءة من تلك المُنشأة تلقائيًا بواسطة Less. يعتمد الأمر على طبيعة عملك. إذا كان منتجك تجاريًا، فإن الهدف النهائي هو توفير تجربة مستخدم جيدة، مع كود صحيح ومُحسّن. في هذه الحالة، استخدم مُخرجات المُعالج المُسبق كملف CSS رئيسي، ولكن أدرج الملف الأصلي للمطورين. على الرغم من أن ملف CSS الخاص بك لن يتوافق مع معايير WordPress، إلا أن إدراج الملف الأصلي يُقلل الفجوة إلى حد ما حتى تتخذ WordPress موقفًا رسميًا. يُعد التضحية بمعايير كتابة كود CSS من أجل تبسيط عملية التطوير (بهدف تحسين تجربة المستخدم) أمرًا مقبولًا. أما التضحية بصحة الكود فليست كذلك.
كيف يمكنك المساهمة في معايير برمجة ووردبريس؟
البرمجة تشبه الكتابة - لكل شخص أسلوبه الخاص. قد يختلف شكل كود HTML الخاص بك عن كودي، وقد يكون كود JavaScript الخاص بي مُرهقًا للعين، بينما قد يكون كود CSS الخاص بك في غاية الروعة. ولكن عندما يتعلق الأمر بالتعاون في مشروع مثل ووردبريس، فإن وجود معايير برمجة متسقة أمر بالغ الأهمية.
تهدف معايير البرمجة في ووردبريس إلى ضمان سهولة قراءة وفهم وبناء أي شخص يساهم في قاعدة البيانات البرمجية، مما يُمكّنه من الاستفادة من عمل الآخرين. بالالتزام بهذه المعايير، فإنك تتحدث لغة مشتركة مع المساهمين الآخرين. يشبه الأمر الاتفاق على استخدام قواعد نحوية وتنسيقية متسقة، مما يسمح للجميع بالتعاون بسلاسة في كتابة نفس الكتاب.
إذا كنت ترغب في المساهمة في ووردبريس، فإن الإلمام بمعايير البرمجة واتباعها أمر أساسي. فهذا يسمح لأسلوبك البرمجي الفردي بالانسجام التام مع قاعدة بيانات ووردبريس الأوسع.
الاستنتاجات
يُعدّ الالتزام بمعايير برمجة ووردبريس أمرًا أساسيًا للحفاظ على قاعدة بيانات متماسكة وقابلة للتطوير التعاوني. تُشكّل هذه الإرشادات، التي وضعها مجتمع ووردبريس، لغةً مشتركةً للمساهمين حول العالم. باتباع معايير PHP وHTML وCSS وJavaScript وإمكانية الوصول، يضمن المطورون أن يكون كودهم متسقًا وسهل القراءة والصيانة.
مع استمرار تطور ووردبريس، ستلعب معايير البرمجة هذه دورًا حاسمًا في تعزيز بيئة تطوير متناغمة وفعالة للمجتمع بأكمله.
