هل تريد أن تتعلم كيفية لصق مقتطفات من الويب في ووردبريس؟ في حين أن نسخ ولصق الكود في ملفات قالب ووردبريس قد يبدو سهلاً للمستخدمين ذوي الخبرة، إلا أنه قد يكون مخيفًا للمبتدئين.
في دكتورميجا، ننشر الكثير من دروس ووردبريس التي تطلب من المستخدمين إضافة مقتطفات من الكود إلى ووردبريس. لذلك، نتلقى الكثير من الأسئلة من المبتدئين الذين يشعرون بالقلق بشكل مفهوم بشأن إفساد الأمور.
لهذا السبب قمنا بتجميع هذا الدليل. في هذه المقالة، سنوضح لك كيفية نسخ ولصق مقتطفات من الكود من الويب في ووردبريس دون إتلاف موقعك.
جدول المحتوى
لماذا يجب عليك إضافة مقتطفات من الكود إلى موقع ووردبريس الخاص بك؟
يعد ووردبريس أفضل منشئ مواقع ويب في العالم نظرًا للمرونة التي يوفرها. من السهل جدًا إضافة ميزات ووظائف جديدة إلى موقعك ويمكن أن يساعد في بناء أي نوع من المواقع الكترونية تقريبًا.
نشارك جميع أنواع النصائح والحيل التي يمكنك استخدامها لتحسين الموقع الكتروني الخاص بك. ستطلب منك بعض هذه النصائح إضافة كود إلى ووردبريس.
في حين أن إضافة مقتطفات كود مخصصة إلى موقع الويب الخاص بك أمر اختياري، ويمكنك غالبًا العثور على اضافات للقيام بنفس المهمة، إلا أن المقتطف البسيط يكون أكثر كفاءة في بعض الأحيان.
غالبًا ما تكون إضافة مقتطفات الكود طريقة سهلة لإصلاح العديد من أخطاء ووردبريس الشائعة وتحسين أمان ووردبريس وإضافة ميزات جديدة إلى الموقع الكتروني الخاص بك.
مع ذلك، دعنا نلقي نظرة على كيفية إضافة مقتطفات الكود إلى موقع ووردبريس الخاص بك بأمان.
ما هي أفضل الطرق لإضافة مقتطفات الكود في ووردبريس؟
من المهم أن نذكر أنه قبل أن تبدأ في إضافة مقتطفات الكود (التعليمات البرمجية) إلى موقع ووردبريس الخاص بك، يجب عليك تثبيت واستخدام اضافة نسخ احتياطي ووردبريس.
يحافظ هذا على أمان موقع ووردبريس الخاص بك، ويمكنك دائمًا استعادته من نسخة احتياطية في حالة حدوث أي خطأ.
عند إضافة مقتطفات إلى ووردبريس، قد تجد تعليمات لإضافتها إلى ملفات تمبلت قالب ووردبريس، مثل index.php وsingle.php والمزيد.
هذه المقتطفات مفيدة فقط لملفات القالب المحددة، لذلك سيتعين عليك إضافتها مباشرة أو إنشاء قالب ووردبريس فرعي.
ومع ذلك، سيتم إضافة معظم مقتطفات الكود إلى ملف functions.php الخاص بقالب ووردبريس الخاصة بك. قد توصي بعض البرامج التعليمية بإضافتها مباشرة إلى الملف، ولكن هناك بدائل أفضل بكثير تسمح لك بحماية تغييراتك في المستقبل.
بهذه الطريقة، إذا قمت بتغيير قالب ما، فلن تتم إزالة وظائفك المخصصة.
هناك طرق مختلفة لتحرير ملفات ووردبريس اعتمادًا على الطريقة التي تختارها لإضافة مقتطفات الكود المخصصة إلى مدونة ووردبريس أو الموقع الكتروني الخاص بك.
وبناءً على ذلك، دعنا نلقي نظرة على بعض الطرق الأكثر ملاءمة للمبتدئين لإضافة مقتطفات كود خاص في ووردبريس.
الطريقة 1: إضافة كود مخصص باستخدام اضافة WPCode (سهل)
يعد استخدام اضافة لمقتطفات الكود هي الطريقة الأكثر أمانًا والأكثر ملاءمة للمبتدئين لإضافة الكود إلى ووردبريس.

تتيح لك اضافة WPCode إضافة وإدارة مقتطفات الكود الخاص على الموقع الكتروني الخاص بك بسهولة، دون الحاجة إلى تعديل ملفات القالب الخاص بك.
يأتي مع التحقق الذكي من مقتطفات الكود لمساعدتك على منع أخطاء الكود الشائعة. وهذا يحميك من إتلاف الموقع الكتروني الخاص بك عند إضافة مقتطفات الكود.
يحتوي WPCode أيضًا على مكتبة كود مدمجة تجعل من السهل العثور على جميع مقتطفات الكود الأكثر شيوعًا في ووردبريس. يمكنك إضافة مقتطفات الكود المكتوبة بواسطة خبراء ببضع نقرات فقط.
أفضل جزء هو أنه يتيح لك إدارة جميع مقتطفات الكود من شاشة مركزية واحدة، ويمكنك حتى تنظيمها باستخدام التاجات.
يأتي الإصدار المجاني من WPCode مزود بكل ما تحتاجه لإضافة كود مخصص في ووردبريس. يوفر WPCode Pro ميزات متقدمة مثل مكتبة مقتطفات سحابية خاصة، وبيكسلات التحويل، ومقتطفات مجدولة، والمزيد.
ملاحظة: طريقة WPCode مفيدة للأجزاء التي تحتاج إلى إضافتها إلى ملف functions.php. إذا طلب منك إضافة جزء من الكود في ملفات قالب أخر، فلن تعمل هذه الطريقة.
كيفية تعديل وإضافة كود إلى ووردبريس باستخدام WPCode
إذا كنت ستستخدم اضافة WPCode لإضافة كود إلى ووردبريس، فستضيف الكود مباشرة في لوحة تحكم مسؤول ووردبريس.
أولاً، تحتاج إلى تثبيت وتفعيل اضافة WPCode المجانية. لمزيد من التفاصيل، راجع دليل المبتدئين حول كيفية تثبيت اضافة ووردبريس.
بعد التنشيط، ما عليك سوى الانتقال إلى Code Snippets » + Add Snippet في لوحة تحكم مسؤول ووردبريس. ثم انقر فوق الزر “Add New”.

سينقلك هذا إلى شاشة حيث يمكنك اختيار مقتطف من المكتبة المعدة مسبقًا أو إضافة الكود المخصص الخاص بك.
لإضافة كود مخصص، انقر فوق الزر “Use snippet” أسفل خيار “Add Your Custom Code (New Snippet)”.

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

بعد ذلك، انتقل لأسفل إلى قسم “Insertion”. هنا، يمكنك اختيار استخدام مقتطف الكود كـ كود مختصر يمكنك نسخه ولصقه يدويًا في أي مكان على موقعك.

أو يمكنك تحديد طريقة “Auto Insert” لاختيار موقع (دالة ووردبريس) حيث سيتم إدراج مقتطف الكود تلقائيًا.
يمكنك الاختيار من بين مواقع مثل “Run Everywhere”، و”Frontend Only”، و”Admin Only”، و”Site Wide Header”، و”After Post”، و”Between Posts”، و”Before Paragraph”، والمزيد.

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

بمجرد الانتهاء من إضافة الكود، قم بتبديل المفتاح من “Inactive” إلى “Active” في الزاوية اليسرى العليا.
ثم انقر فوق الزر “Save Snippet”.

بمجرد تفعيل المقتطف، سيتم إضافته تلقائيًا أو عرضه كـ كود مختصر، وفقًا لطريقة الإدراج التي اخترتها.
للحصول على تعليمات مفصلة، راجع دليلنا حول كيفية إضافة مقتطفات كود مخصصة بسهولة في ووردبريس.
كيفية إضافة الكود إلى هيدر وفوتر صفحة ووردبريس
في بعض الأحيان قد تحتاج فقط إلى إضافة كود إلى ملفات header.php أو footer.php الخاصة بقالبك. يمكن أن تساعدك اضافة WPCode أيضًا في القيام بذلك بسهولة.
يكون هذا مفيدًا عندما تحتاج إلى إضافة كود تتبع لـ جوجل أناليتكس وجوجل ادسنس وفيسبوك بيكسل وتيك توك بيكسل والمزيد إلى الموقع الكتروني الخاص بك.
بالإضافة إلى ذلك، يتيح لك إدارة جميع أكواد هيدر وفوتر في مكان واحد، ويمنع أي أخطاء يدوية، ويسمح لك بـ تغيير قالبك أو الترقية دون قلق.
ملاحظة: تعمل هذه الطريقة بشكل أفضل لتتبع الاسكربتات وCSS المخصص وكود جافا سكريبت.
انتقل إلى Code Snippets » Header & Footer ثم أدخل مقتطف الكود الخاص بك في قسم الهيدر أو النص أو الفوتر في الموقع الكتروني الخاص بك.

تأكد من النقر فوق الزر “Save Changes”، وستظهر مقتطفات الكود الخاصة بك على الموقع الكتروني الخاص بك.
لمزيد من التفاصيل، راجع دليلنا حول كيفية إضافة كود هيدر وفوتر في ووردبريس.
الطريقة 2: إضافة كود مخصص في اضافة ووردبريس الخاصة بالموقع

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

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

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

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

سيخبرك البرنامج التعليمي الذي تتبعه بالمكان الذي يمكنك فيه إضافة مقتطف الكود، ولكن إذا لم يكن الأمر كذلك، فأنت بحاجة إلى إضافة الكود في أسفل الملف أسفل كل كود موجود.
هناك بديل آخر وهو استخدام FTP لمدير ملفات استضافة ووردبريس لإضافة كود مخصص إلى ملفات القالب الخاص بك.
ما عليك سوى الاتصال بعميل FTP الخاص بك بموقع الويب الخاص بك ثم الانتقال إلى wp-content » themes » your-theme-folder والنقر بزر الماوس الأيمن على الملف الذي يحتاج إلى تحرير.

بعد ذلك، انقر فوق خيار “View/Edit” لفتح الملف في محرر النصوص وإضافة مقتطف الكود الخاص بك.
استكشاف أخطاء PHP وإصلاحها عند إضافة كود مخصص
هناك بعض الأخطاء الشائعة التي يرتكبها المبتدئون عند إضافة مقتطفات أكواد مخصصة إلى مواقع ووردبريس الخاصة بهم. لحسن الحظ، يمكن تجنب معظم هذه الأخطاء وإصلاحها بسهولة.
دعنا نلقي نظرة على هذه الأخطاء وأفضل الطرق التي يمكنك من خلالها إصلاحها.
1. الاستخدام غير الصحيح لتاجات البداية والنهاية في PHP
تمت كتابة ووردبريس بشكل أساسي بلغة البرمجة PHP التي تحتوي على صيغة بناء جملة محددة تخبر السيرفر الخاص بك بأن الكود التالي يحتاج إلى معالجة بواسطة PHP. فيما يلي الشكل النموذجي لمقتطف كود PHP:
// PHP بداية التاج
<?php
// Rest of the code goes here
// PHP نهاية التاج
?>
يجب أن يكون كل كود PHP الخاص بك داخل <?php و ?>
تاجات أو علامات.
تعتبر علامة نهاية PHP مهمة جدًا في الملفات التي يتم التبديل بينها وبين PHP وHTML. ويشمل هذا معظم ملفات قالب ووردبريس الذي تستخدم علامات PHP إلى جانب HTML.
يجب أن تتأكد من أنه إذا كنت تلصق الكود الخاص بك في مكان لا تكون فيه علامة بداية PHP مغلقة، فيجب عليك إضافة الكود الخاص بك بدون علامة بداية PHP.
<?php
// Some pre-existing code
// your custom code
?>
إذا كنت تقوم بلصق الكود المخصص خارج أو بعد علامة نهاية PHP، فأنت بحاجة إلى إضافة علامة بداية PHP أيضًا.
<?php
// Some pre-existing code
?>
// Your custom code snippet
<?php
?>
تنتج ما يقرب من 90% من الأخطاء عن وضع غير صحيح لعلامات البداية أو النهاية في PHP. سيساعدك إلقاء نظرة على الكود الخاص بك على فهم ما إذا كنت بحاجة إلى إضافة علامات البداية أو النهاية في PHP في مقتطف الكود المخصص الخاص بك أم لا.
ومع ذلك، قد لا تحتوي العديد من ملفات قالب ووردبريس مثل functions.php
على علامة نهاية PHP على الإطلاق. وهذا يعني أنه يمكنك إضافة الكود الخاص بك في أسفل الملف بدون علامات البداية أو النهاية.
فيما يلي مثال على ما يبدو عليه ذلك.
<?php
// Lots of code in your theme's functions.php 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. لذا، قد تعرض عليك مقتطف من الكود دون وضع هذه العلامات في مكانها.
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 بسيطة:
<?php
function doctormega_tutorial() {
echo "Hello World!";
}
?>
الآن، إذا كنت تريد إضافة مقتطف كود مخصص لا علاقة له بهذه الدالة، فستحتاج إلى وضعه خارج هذه الدالة مثل هذا:
// Pre-existing code in your theme file
<?php
function doctormega_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 في ووردبريس
غالبًا ما تؤدي الأخطاء الناتجة عن إضافة كود مخصص إلى ووردبريس إلى ظهور رسالة خطأ مفصلة. معظمها أخطاء في بناء الجملة أو أخطاء تحليل أو أخطاء قاتلة بسبب الأحرف غير المتوقعة.
والخبر السار هو أن هذه الأخطاء ستخبرك بالسطر في الكود الذي تسبب في الخطأ.

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

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