طريقة إضافة اكواد برمجية إلى WordPress

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

ما هي أفضل الطرق لإضافة اكواد برمجية في ووردبريس؟

أول شيء يجب عليك فعله في كل موقع من مواقع WordPress هو تثبيت مكون إضافي للنسخ الاحتياطي في WordPress . يحفظ هذا موقع WordPress الخاص بك آمنًا ، ويمكنك دائمًا استعادته من النسخة الاحتياطية في حالة حدوث أي خطأ.
في بعض الأحيان ، قد تجد تعليمات لإضافة اكواد برمجية في ملفات قالب  WordPress مثل index.php و single.php و header.php والمزيد. تعتبر مقتطفات الشفرة هذه مفيدة فقط في تلك القوالب المعينة ، لذلك سيكون عليك إضافتها مباشرة إلى ملفات السمات الخاصة بك أو إنشاء سمة فرعية .
ومع ذلك، يتم إضافة معظم الاكواد  المخصصة في  ملف functions.php . على الرغم من أن البرنامج التعليمي قد يوصيك بإضافته في ملف theme.php الخاص بالقالب ، إلا أن هناك بديلًا أفضل بكثير يعمل بالطريقة نفسها التي يعمل بها ملف الوظائف.
دعنا نلقي نظرة على بعض الطرق التي يمكنك بها إضافة مقتطفات من الكود المخصص في WordPress.
1. استخدام المكون الاضافي Code Snippets 
هذه هي الطريقة الأكثر أمانًا والموصى بها للمبتدئين. Code Snippets هو أحد مكونات WordPress الإضافية التي تتيح لك بسهولة إضافة وإدارة الاكواد البرمجية المخصصة على موقع الويب الخاص بك.
يأتي مزودًا بمفتاح آمن للفشل يؤدي إلى إلغاء تنشيط مقتطف الشفرة فورًا إذا تسبب في حدوث خطأ. هذا يحميك من فقدان الوصول إلى موقع الويب الخاص بك عند إضافة مقتطف شفرة مخصص.
للحصول على إرشادات مفصلة ، راجع دليلنا حول كيفية إضافة الاكواد  البرمجية المخصصة بسهولة في WordPress .
ملاحظة: طريقة مقتطفات الكود مفيدة للقصاصات التي يجب إضافتها في ملف الوظائف. إذا طُلب منك إضافة مقتطف الشفرة في ملفات السمات الأخرى ، فلن تنجح هذه الطريقة.
2. إنشاء قالب تابع لحفظ الرمز مخصص
النهج الثاني هو إنشاء موضوع تابع. سيؤدي استخدام القالب التابع إلى الحفاظ على تغييراتك كما هي عند تحديث القالب الخاص بك. سيسمح لك أيضًا بإضافة رمز إلى ملفات القالب الأخرى إذا لزم الأمر دون الحاجة إلى القلق بشأن التحديثات التي تلغي تغييراتك.
لمزيد من التفاصيل ، راجع موضوع حول كيفية إنشاء قالب فرعي في WordPress .
ملاحظة: ستعمل هذه الطريقة أيضًا مع مقتطفات الكود اللازمة لإضافتها في القوالب  الأخرى.
3. استخدام مكون اضافي خاص  بموقع لكود مخصص
خيار آخر مرن هو استخدام المكون الاضافي الخاص بموقع ووردبريس. هذا  مكون إضافي مخصص يمكنك إنشاؤه لموقع الويب الخاص بك واستخدامه لحفظ جميع التعليمات البرمجية المخصصة الخاصة بك.
ميزة هذه الطريقة هي أن الكود الخاص بك لا يعتمد على المظهر الخاص بك ، وسيظل نشطًا حتى عند تغيير القالب. كما أنه لا يتأثر بأي تحديثات ووردبريس على موقع الويب الخاص بك.
راجع الموضوع حول كيفية إنشاء مكون إضافي مخصص للموقع لموقعك للحصول على إرشادات مفصلة.
ملاحظة: تنطبق هذه الطريقة فقط على  الشفرات التي يجب إضافتها في ملف الوظائف.
4. أضف الرمز مباشرة إلى ملف الوظائف
لا بأس أن تضيف مقتطفات برمجية في ملف وظائف. ومع ذلك ، هناك بعض الجوانب السلبية لذلك.
  • سيتم محو تغييراتك عند تحديث قالب ال WordPress الخاصة بك
  • لن يعمل الرمز الخاص بك إلا إذا كنت تستخدم هذا القالب الخاص
ومع ذلك ، دعونا نلقي نظرة على كيفية نسخ ولصق  الشفرة بشكل صحيح وتجنب تعطيل موقع الويب الخاص بك.

كيفية تحرير ملفات WordPress؟

هناك طرق مختلفة لتحرير ملفات WordPress وفقًا للطريقة التي تختارها لإضافة مقتطفات من التعليمات البرمجية المخصصة على موقع الويب الخاص بك.
1. إضافة رمز مخصص في رمز قصاصات البرنامج المساعد
إذا كنت تستخدم المكون الإضافي Code Snippets ، فيمكنك بسهولة إضافة مقتطفات التعليمات البرمجية من منطقة مسؤول WordPress. ما عليك سوى الانتقال إلى Snippets » Add New page  لإضافة الشفرة المخصصة.
2. إضافة رمز مخصص في موقع محدد عن طريق المكون الضافي
إذا كنت تضيف رمزًا مخصصًا في مكون إضافي مخصص للموقع ، فيمكنك استخدام محرر المكون الإضافي WordPress لإضافة رمز مخصص.
أولاً ، حدد المكوّن الإضافي الخاص بالموقع من القائمة المنسدلة المسمى "Select plugin to edit ". سيقوم المحرر بتحميل ملف المكوّن الإضافي الخاص بك ، وستتمكن من إضافة مقتطفات برمجية فيه.
بمجرد الانتهاء ، انقر فوق الزر "Update File" لحفظ التغييرات.
إذا كان هناك شيء مفقود في الشفرة الخاصة بك أو اذا تعطل موقع الويب الخاص بك ، فسيقوم محرر البرنامج المساعد تلقائيًا بالتراجع عن تغييراتك.
هناك طريقة أخرى لإضافة رمز مخصص في مكون إضافي خاص بالموقع وهي استخدام FTP.
ببساطة انتقل إلى مجلد المكوّن الإضافي باستخدام عميل FTP الخاص بك. انقر بزر الماوس الأيمن على ملف المكوّن الإضافي ثم حدد  View/Edit .
طريقة إضافة اكواد  برمجية  إلى WordPress
3. إضافة رمز مخصص إلى ملف jobs.php أو قوالب  أخرى
إذا كنت تقوم بإضافة التعليمات البرمجية المتكررة إلى ملف functions.php الموضوع الخاص بك أو أي قالب آخر، ثم يمكنك إضافة رمز مباشرة من خلال زيارة Appearance » Editor . يمكنك تحديد الملف الذي تحتاج إلى إضافة الرمز من العمود الأيمن.
طريقة إضافة اكواد  برمجية  إلى WordPress
ستخبرك الإرشادات التي تتبعها بمكان لصق الشفرة ، ولكن إذا لم تفعل ذلك ، فأنت بحاجة إلى إضافة الكود في أسفل الملف.
هناك طريقة بديلة أفضل تتمثل في استخدام FTP لإضافة تعليمات برمجية مخصصة في ملفات القالب. ما عليك سوى توصيل عميل FTP بموقع الويب الخاص بك وانتقل إلى / wp-content / theme / your-theme-folder / وانقر بزر الماوس الأيمن على الملف الذي يحتاج إلى تحرير.
طريقة إضافة اكواد  برمجية  إلى WordPress
حدد خيار View/Edit ملف لفتح الملف في محرر النصوص.

استكشاف أخطاء ال PHP عند إضافة كود مخصص

هناك بعض الأخطاء الشائعة التي يرتكبها المبتدئين عند إضافة الاكواد المخصصة إلى مواقعهم على الويب. دعونا نلقي نظرة على بعض منهم وكيفية تجنبها
1. الاستخدام غير الصحيح لبداية ال PHP  ونهاية العلامات
تتم كتابة WordPress بشكل رئيسي بلغة برمجة PHP التي تحتوي على  جملة محدد تخبر الخادم الخاص بك أن التعليمة البرمجية التالية تحتاج إلى معالجة بواسطة PHP. إليك كيفية ظهور مقتطف شفرة PHP النموذجي:
1
2
3
4
5
6
7
// PHP بداية كود ال
<?php
// باقي الكود هنا
// PHP نهاية كود ال
?>
تحتاج جميع أكواد الPHP لان تكون داخل <?phpو ?>العلامات.
تصبح علامة نهاية PHP أكثر أهمية في الملفات التي تتحول ذهابا و ايابا في HTML. يتضمن هذا معظم ملفات قالب WordPress التي تستخدم علامات PHP بجانب HTML.
تحتاج إلى التأكد من أنك إذا قمت بلصق الشفرة الخاصة بك في موقع لا يتم فيه إغلاق علامة بدا PHP ، فأنت بحاجة إلى إضافة الرمز الخاص بك دون بدء علامة PHP.
1
2
3
4
5
6
<?php
// Some pre-existing code
// your custom code
?>
إذا كنت تلصق الشفرة المخصصة الخاصة بك خارج أو بعد علامة نهاية PHP ، فأنت بحاجة إلى إضافة علامة البدء PHP أيضًا.
1
2
3
4
5
6
7
8
<?php
// Some pre-existing code
?>
// Your custom code snippet
<?php
?>
ما يقرب من 90 ٪ من جميع الأخطاء ناتجة عن وضع علامات PHP أو علامات البداية بشكل غير صحيح. تسمح لك دراسة الكود بفهم ما إذا كنت بحاجة إلى إضافة علامات البدء أو الإنهاء في PHP في مقتطف الشفرة المخصص الخاص بك.
قد لا تحتوي العديد من ملفات سمات WordPress ، خاصةً ووظائف ملف .php ، على علامة انتهاء PHP على الإطلاق. هذا يعني أنه يمكنك إضافة الشفرة في أسفل الملف دون علامات البدء أو النهاية.
1
2
3
4
5
6
7
8
9
10
11
<?php
// Lots of code in your theme's functions file
//
//
// Your custom code
function custom_loginlogo() {
echo '<style type="text/css">
h1 a {background-image: url('.get_bloginfo('template_directory').'/images/login_logo.png) !important; }
</style>';
}
add_action('login_head', 'custom_loginlogo');
تذكر أن كتّاب البرنامج التعليمي قد يفترضون في وقت ما أنك تعلم بالفعل كيفية استخدام علامات البدء والانتهاء لـ PHP. قد يعرضون لك ببساطة مقتطف شفرة بدون هذه العلامات.
1
2
3
4
5
6
function custom_loginlogo() {
echo '<style type="text/css">
h1 a {background-image: url('.get_bloginfo('template_directory').'/images/login_logo.png) !important; }
</style>';
}
add_action('login_head', 'custom_loginlogo');
نظرًا لأن مؤلف البرنامج التعليمي لا يعرف من أين ستضيف هذا الرمز ، فقد تخطى نهاية PHP وبدء العلامات. الآن عندما تقوم بإضافة مقتطف الشفرة في ملفات السمات الخاصة بك ، فأنت بحاجة إلى التأكد من وجوده داخل علامات PHP.
2. أخطاء تداخل غير صحيحة
يحتوي PHP على بناء جملة معين للوظائف والمنطق الشرطي والحلقات. يعتمد بناء الجملة هذا على الأقواس المعقوفة التي تشير إلى متى تبدأ الوظيفة وتنتهي.
على سبيل المثال ، إليك وظيفة PHP بسيطة:
1
2
3
4
5
<?php
function pendsoft_tutorial() {
echo "Hello World!";
}
?>
الآن إذا كنت ترغب في إضافة مقتطف شفرة مخصص لا علاقة له بهذه الوظيفة ، فستحتاج إلى وضعها خارج هذه الوظيفة كما يلي:
1
2
3
4
5
6
7
8
9
10
11
12
// Pre-existing code in your theme file
<?php
function wpbeginner_tutorial() {
echo "Hello World!";
}
// Your custom code
function custom_loginlogo() {
echo '<style type="text/css">
h1 a {background-image: url('.get_bloginfo('template_directory').'/images/login_logo.png) !important; }
</style>';
}
?>
إذا فاتك بدء أو إنهاء الأقواس المعقوفة ، فسيؤدي ذلك إلى كسر الرمز ، وسوف ينتهي بك الأمر إلى ظهور صفحة خطأ.

فهم أخطاء ال PHP في WordPress

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

ماذا تفعل عندما يتعذر الوصول إلى موقع ووردبريس الخاص بك؟

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

ليست هناك تعليقات:

نموذج الاتصال

الاسم

بريد إلكتروني *

رسالة *

Abstract photo created by freepik - www.freepik.com