تُشير الروابط الدائمة إلى كل منشور ضمن مدونتك، إضافةً إلى التصنيفات ومكونات أخرى من منشورات المدونة، ويستخدم مُدوّن آخر الرابط الدائم لمقالك ليربط مقاله بمقالك، وهو ما تستخدمه لإرسال رابط عن قصتك في بريد إلكتروني. يجب أن يكون رابط كل منشور دائمًا ولا يتغير، ولذلك سُميت هذه الروابط بالروابط الدائمة.

أنواع الروابط الدائمة

توجد ثلاثة أنواع أساسية في ووردبريس للروابط الدائمة.

1- الافتراضي

يظهر الرابط الافتراضي بهذا الشكل:

http://example.com/?p=N

حيث أن N هي مُعرف المنشور، ويعمل هذا النوع ضمن أي بيئة خادم لكن مظهره ليس بالجيد موازنةً مع الخيارات الأخرى.

2- الروابط الجميلة mod_rewrite

تستطيع تشكيل روابط أجمل باستخدام mod_rewrite أو lighttpd (انظر إلى الروابط الجميلة)، حيث توجد عدة هيئات لكن الأكثر استخدامًا تبدو مثل الآتي:

http://example.com/2012/post-name/

أو مثل:

http://example.com/2012/12/30/post-name

يُمكنك استخدام الروابط الجميلة في:

• خوادم Apache التي تستخدم وحدة mod_rewrite.
• خوادم NGINX التي تستخدم try-files وفقًا للدليل التعليمي.
• خوادم Hiawatha عند تفعيل UrlToolkit.
• Lighttpd الذي يستخدم وحدة mod_rewrite أو 404 handler.
• Caddy الذي يستخدم rewrite وفقًا للدليل التعليمي.

3- معلومات المسار (روابط شبه جميلة)

تبدو هذه الروابط تقريبًا مثل روابط mod_rewrite لكن مع اختلاف واحد هو وجود /index.php قبلها.

http://example.com/index.php/yyyy/mm/dd/post-name/

لا يوجد أي فرق بين الروابط الجميلة والشبه جميلة ما عدا الفرق السابق حتى من الناحية الوظيفية.

اختيار تركيبة الروابط الدائمة

تستطيع اختيار واحدة من التراكيب الأكثر استخدامًا للروابط الدائمة أو إدخال تركيبة مخصصة ضمن حقل تركيبة مخصصة.

اقتباس

ملاحظة: لا تستخدم رابط الموقع ضمن حقول الروابط الدائمة، بل استخدم وسوم التركيبة الموجودة أو مزيج منها فقط.

ابدأ التركيبة بـ /index.php لتفعيل الروابط شبه الجميلة.

1- وسوم تركيبة الروابط الدائمة

تستطيع استخدام هذه الوسوم لتخصيص الروابط الجميلة وشبه الجميلة، وإليك بعض التلميحات:

• لا تستخدم رابط موقعك ضمن حقول الروابط الدائمة، إذ تستطيع استخدام واحد من وسوم التراكيب أو مزيج منها.
• يجب أن تنتهي بنيتك إما بـ %post_id% أو %postname% مثل البنية:

 /%year%/%monthnum%/%day%/%postname%/

وذلك لتُشير الروابط الدائمة إلى كل منشور فردي.

2- تركيبة التصنيف وتركيبة الوسم

إن تركيبة التصنيف وتركيبة الوسم هي عبارة عن بوادئ تُستخدم في رابط التنصيف والوسم والذي يبدو هكذا:

example.net/wp/category_base/category_name
 example.net/wp/tag_base/tag_name

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

3- استخدام %category% مع عدة تصنيفات ضمن المنشور

عند تعيينك عدة تصنيفات للمنشور؛ يُمكن أن يظهر تصنيف واحد فقط ضمن الروابط الدائمة، حيث تُرتب التصنيفات حسب الأحرف الأبجدية، كما ينطبق الأمر نفسه ضمن التصنيفات الفرعية. (انظر لإدارة التصنيفات). يُمكن الوصول للمنشور من أي تصنيف،كما هو الحال عندما ينتمي لتصنيف واحد، كما تستطيع تجريب إضافة WP Category Permalink إذا كنت تريد اختيار التصنيف الذي يظهر ضمن الرابط الدائم.

استخدام الروابط الدائمة الجميلة

1 المتطلبات:

• خادم Apache مُثبت عليه وحدة mod_rewrite.
• ضمن المسار الرئيسي لووردبريس.
• يجب تفعيل خيار FollowSymLnks.
• السماح بالتوجيه FileInfo مثل AllowOverride FileInfo or AllowOverride All.
• ملف htaccess، حيث سيحاول ووردبريس إنشاء واحد إذا كان الملف مفقودًا عند تفعيل الروابط الدائمة الجميلة.
• إن كنت تريد أن يُحدث ووردبريس ملف htaccess تلقائيًا سوف يحتاج صلاحية الكتابة على الملف.
• عليك إضافة ما يلي عند استخدام خادم NGINX.

location / {
           try_files $uri $uri/ /index.php?$args;
}

• بالنسبة لخادم Hiawatha وهو خادم يُعنى بالأمان كثيرًا، فيجب استخدام قاعدة UrlToolkit التالية:

UrlToolkit }
   ToolkitID = wordpress
   RequestURI exists Return
   Match .*\?(.*) Rewrite /index.php?$1
   Match .* Rewrite /index.php
{

• يجب على مستخدمي ماك الذين يشغلون ووردبريس على حواسيبهم تعديل ملف httpd.conf لتغيير سطر AllowOverride لقراءة AllowOverride All ضمن المسار التالي:

 /Library/WebServer/Documents

بالنسبة لنظام Mac OS X 10.2.x وما بعد، فإن الملف موجود في المسار الآتي:

 ‎/private/etc/apache2/users/[your-username].conf

وإلا سوف تجده في ‎/etc/httpd/httpd.conf.

سوف يولد ووردبريس قواعد rewrite عند إنشاء أو تحديث تركيبة الروابط الدائمة الجميلة بهدف إدخالهم ضمن ملف ‎.htaccess وفي حال لم يتمكن من ذلك، فسوف يطلب منك تحديث ملف htaccess ويُظهر لك كل القواعد المطلوبة لتنسخها وتلصقها ضمن الملف (ضع هذه القواعد في نهاية الملف).

سوف تحتاج لتنفيذ هذا مرةً واحدةً لأن ووردبريس يُنفذ عملية الكتابة داخليًا. وفي حال نقلت يومًا ما المسار الرئيسي لووردبريس، فسوف تحتاج لتكرار الخطوة السابقة.

يتعامل ووردبريس جيدًا مع ملف ‎htaccess الموجود مُسبقًا، حيث لن يحذف أي قواعد أو توجيهات موجودة فيه مسبقًا، وإذا كنت تملك قواعد mod_rewrite أخرى، فضعها قبل القواعد التابعة لووردبريس.

أين ملف htaccess الخاص بي

يجب أن تواجد ملفي index.php و‎htaccess معًا ضمن نفس المسار الذي يُشير إليه رابط عنوان الموقع في صفحة عام من إعدادات ووردبريس. يُحتمل ألا يكون الملف مرئيًا للعلن عند الاتصال عبر FTP لأن اسمه يبدأ بنقطة، إلا في حال غيرت إعدادات برنامج FTP الذي تستخدمه لتظهر جميع الملفات بما فيها المخفية، ويُمكن ألا تُظهر لك بعض الاستضافات أو تسمح لك بتعديل ملف ‎htaccess إن ثُبت ووربدريس عبر تطبيقات الاستضافة.

إنشاء وتحرير ملف htaccess

يجب عليك إنشاء ملف htaccess إذا كنت لا تملك واحدًا، وهذا ممكن عبر اتصال shell أو ssh للوصول للخادم، حيث يكفي كتابة الأمر touch .htaccess لإنشاء الملف. وإذا كنت تستخدم اتصال FTP لنقل الملفات، فأنشئ ملفًا على حاسوبك المحلي واسمه htaccess_old، ثم ارفعه للمسار الرئيسي لتثبيت ووردبريس، بعدها أعد تسميته لـ htaccess.

تستطيع تحرير ملف ‎htaccess باستخدام FTP أو shell أو ربما لوحة تحكم الاستضافة، كما يجب أن تكون قواعد إعادة كتابة الروابط الدائمة التالية موجودةً ضمن ملف ‎.htaccess

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

سوف يتوقف موقعك إذا تضمن ملف htaccess أي أخطاء لتظهر لك رسالة Internal Server Error 500، وعندها سوف تُضطر لاستخدام اتصال FTP أو لوحة تحكم الاستضافة لحذف ملف htaccess التالف.

تحديث ملف htaccess تلقائيا

سوف يطلب منك ووردبريس تحديث ملف ‎htaccess إذا لم يتمكن من تحديثه تلقائيًا، حيث سوف تجد رسالةً في أسفل صفحة الروابط الدائمة في قسم الإعدادات.

إذا كنت تريد أن يتولى ووردبريس تنفيذ هذه العملية، فعليك إعطاؤه صلاحيات الكتابة على ملف ‎htaccess. تختلف الصلاحيات المطلوبة حسب إعدادات الخادم، لذلك حاول إضافة صلاحيات الكتابة للمالك ثم للمجموعة ثم للكل، واختبر بعد كل تغيير وحافظ على النتيجة التي تسمح لووردبريس بتحرير الملف بنجاح.

وبعد تطبيق الروابط الدائمة، عليك تغيير الصلاحيات لصلاحيات أشد أمنيًا مثل 660 أو 644 لمنع الآخرين ضمن الخادم من الوصول لهذا الملف.

إصلاح مشاكل الروابط الدائمة

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

1- إصلاح مشكلة توليد ملف htaccess

توجد عدة أسباب يُمكن أن تمنع ووردبريس من إنشاء ملف htaccess أو التعديل عليه إن وجد. تابع الخطوات التالية خطوةً بخطوة دون الانتقال للخطوة التالية إلا في حال فشلت السابقة على حل المشكلة:

• تغيير صلاحيات الملف: يجب عليك تغيير الصلاحيات باستخدام chmod إلى 666، وذلك لتتمكن من تعديل الملف باستخدام محرر قالب ووردبريس، لكن لا يُنصح بهذا لأن هذه الخطوة تسمح لأي مستخدم ضمن مدونتك (يستطيع تعديل القوالب) بتعديل هذا الملف، كما تستطيع تغيير الصلاحيات إلى 660 لجعل الملف قابلًا للكتابة من قبل الخادم، لكن هذا يعود بنا لمحدودية الصلاحيات والتي ربما هي سبب المشكلة.
• حجب من قبل الخادم: يُحتمل أن تكون استضافتك قد حَجبت المتغير SERVER_SOFTWARE، وهذا يُسبب فشل ووردبريس في توليد ملف htaccess. إذا كنت واثقًا من أن خادمك يعمل على Apache، فتستطيع إجبار ووردبريس على الاعتقاد أن خادمك يعمل على Apache بتعديل ملف wp-includes/vars.php. اتّبع الخطوات التالية لتنفيذ التعديل:
  • افتح ملف wp-includes/vars.php باستخدام محرر الملفات الموجودة ضمن لوحة تحكم ووردبريس، وللوصول لهذا المحرر عليك تسجيل الدخول لووردبريس، ثم الضغط على "إدارة"، ثم "ملفات". بعدها توجه لأسفل الصفحة واكتب wp-includes/vars.php من مربع النص أسفل عبارة "ملفات أخرى" وابحث عن:

$is_apache = strstr($_SERVER[‘SERVER_SOFTWARE’], ‘Apache’) ? 1 : 0;

واستبدله بـ:

// $is_apache = strstr($_SERVER[‘SERVER_SOFTWARE’], ‘Apache’) ? 1 : 0;

أضف سطرًا جديدًا تحت

/ $is_apache = strstr($_SERVER[‘SERVER_SOFTWARE’], ‘Apache’) ? 1 : 0;

واكتب

$is_apache = 1;

• مستخدمو XAMPP (ويندوز): لن يكون mod_rewrite في بعض إصدارات XAMPP مُفعلًا افتراضيًا، ولتفعيله لتمكين ووردبريس من الكتابة على ملف ‎htaccess وإنشاء الروابط الدائمة الجميلة المطلوبة، عليك فتح الملف ‎/apache/conf/httpd.conf وإزالة التعليق عن السطر الآتي:

 LoadModule rewrite_module modules/mod_rewrite.so

وهنا يجب عليك حذف إشارة # الموجودة في بداية السطر.

• مستخدمو WAMP (ويندوز): لن يكون mod_rewrite أو السماح باتباع SymLink مُفعلًا افتراضيًا في بعض إصدارات WAMP، ولتفعيل الميزات المطلوبة، عليك التوجه إلى apache/conf/httpd.conf وفتحه بمحرر نصوص، ثم إزالة التعليق عن السطر الآتي:

 LoadModule rewrite_module modules/mod_rewrite.so

ويجب عليك هنا حذف إشارة # الموجودة في بداية السطر. يوجد في أسفل الملف قسم يبدأ بالسطر Options FollowSymlinks أيضًا، عليك بتغيير السطر الثاني ضمن هذا القسم من AllowOverride none إلى AllowOverride all، ثم احفظ الملف وأعد تشغيل WAMP. يجب أن تعمل الروابط الدائمة الآن.

نصائح

تجنب التفسير مثل رابط أرشيف

من المُحتمل ألا تنشر أكثر من منشور في اليوم، ولهذا فإن استخدام الوسوم الآتية:

%year%%monthnum%%day%

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

%year%%monthnum%%day%%hour%.

تحقق من تركيبة الروابط الدائمة

طريقة للتحقق إذا كانت المدونة تمتلك تركيبة روابط دائمة هي:

<?php if ( get_option('permalink_structure') ) { echo 'permalinks enabled'; } ?>

ترجمة -وبتصرف- للمقال Using Permalinks من موقع ووردبريس.

اقرأ أيضًا

• أساسيّات عمل mod_rewrite لإعادة كتابة الروابط على خادوم Apache
• كيفية تثبيت ووردبريس
• الأخطاء العشرة الأكثر شيوعًا لدى مطوري ووردبريس

تبدأ عملية تنقيح الأخطاء باستخدام الثابت WP_DEBUG وتُصبح أكثر عمقًا كلما كانت عملية التنقيح أكثر تعقيدًا، وسوف نتكلم عن النقاط التالية في هذا المقال:

1. كيفية كتابة رسائل الخطأ في سجل وتحديد مسار هذا السجل.
2. تعلُّم كيفية استخدام ملفات جافاسكربت و CSS للنظام بهدف تنقيح الأخطاء.
3. كيفية تسجيل جميع استعلامات SQL التي تعمل في الصفحة.
4. التعرف على بعض الإضافات الممكن أن تُساعد في عملية تنقيح الأخطاء.

كتابة رسائل الأخطاء في ملف التسجيل

تبدأ عملية تنقيح الأخطاء بالتوجُّه إلى ملف wp-config.php في مسار تثبيت ووردبريس وتفعيل نمط تنقيح الأخطاء.

define( 'WP_DEBUG', true );

عند تغيير هذا الثابت 'WP_DEBUG' من false إلى true، فسوف تظهر جميع أخطاء وملاحظات وتحذيرات PHP على الشاشة، ويُنصح بتفعيل هذه الخاصية في مرحلة التطوير كونها تُظهر أخطاء الشيفرة البرمجية في هذه المرحلة، مما يُساعد على إصلاحها مباشرةً؛ ولكن إذا كان المطلوب التحقق من وجود أخطاء في موقعٍ نشطٍ وله مستخدمون، فإن إظهار هذه الأخطاء لهم هو آخر ما تريد عمله وذلك لسببين، أولهما أنها تُسرب معلومات عن الموقع، والثاني أنها تُصّعب عملية تصفُّح الموقع على المستخدم. وبالتالي للاطلاع على الأخطاء في موقعٍ انتهى من مرحلة التطوير وأصبح في حالة عمل، فلا بد من وجود وسيلةٍ لتحقيق ذلك دون مشاركتها مع زوار الموقع وهنا يأتي دور الثوابت الأخرى الممكن استخدامها في ملف wp-config.php.

ثوابت إظهار الأخطاء والتحذيرات

يتضمن توثيق ووردبريس حلًا لهذه المشكلة تحت عنوان How to debug WordPress، حيث يمكن كتابة الأخطاء الناتجة في ملف التسجيل بعد تفعيل الثابت WP_DEBUG ثم الثابت WP_DEBUG_LOG، إذ يُنشئ ووردبريس تلقائيًا هذا الملف حالما يظهر خطأ أو تحذير أو ملاحظة في PHP؛ أما بالنسبة لموقع الملف فسوف يكون ضمن مجلد wp-content.

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

// Disable display of errors and warnings
define('WP_DEBUG_DISPLAY', false);

أصبحت مجموعة التعليمات التي علينا استخدامها لإرسال الأخطاء للسجل ومنعها من الظهور على الشاشة على النحو التالي:

// Enable WP_DEBUG mode
define('WP_DEBUG', true);

// Enable Debug logging to the /wp-content/debug.log file
define('WP_DEBUG_LOG', true);

// Disable display of errors and warnings 
define('WP_DEBUG_DISPLAY', false);

سوف نحتاج في بعض الأحيان إلى إضافة التعليمة التالية لمنع الأخطاء من الظهور على الشاشة، وذلك إذا كان ملف php.ini ضمن الخادم يحتوي على الثابت display_errors وقيمته 1.

@ini_set('display_errors',0);

عدم الاستفادة من استخدام تعليمة تحديد الخطأ أو كتابة رسائلك الخاصة في ملف التسجيل

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

يكمن الحل في تفعيل wp-debug وwp_debug_log ضمن ملف wp-config.php وإسناد قيمة true لكليهما، فهذا يُنشئ سجلًا ضمن مجلد wp-content يتضمن أخطاء وملاحظات وتحذيرات PHP.

تسجيل المتغيرات في سجل الأخطاء نيابة عن استخدام تعليمة تحديد الخطأ

الآن وبدلًا من تسجيل المتغيرات على الشاشة باستخدام التعليمة echo، سوف نُسجلها ضمن سجل الأخطاء باستخدام التعليمة error_log، لذلك بدلًا من كتابة:

echo "I'm on line 38";

عليك كتابة:

error_log("I'm on line 38");

كيفية تسجيل المتغيرات في سجل الأخطاء نيابة عن التحقق من قيمها

من أجل التحقق من قيم متغيراتٍ محددة كما تفعل الدالة var_dump وحفظ القيمة الناتجة ضمن سجل الأخطاء، وبفرض عدم وجود سلسلة خاطئة أو حتى أية سلسلةٍ على الإطلاق، فلا بد من استخدام التعليمات التالية:

$x = "My string";
// Dump x, or any other variable for that matter
ob_start();
var_dump($x);
$contents = ob_get_contents();
ob_end_clean();
error_log($contents);

تحويل تعليمات تنقيح الأخطاء السابقة إلى دالة

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

مدخلات إضافية لتعليمة تسجيل الأخطاء

تقبل تعليمة error_log ثلاث مُدخلات إضافية اختيارية، ويُمكن استخدام المُدخلة الثانية message_type$ مع الثالثة destination$ وفي بعض الأحيان مع الرابعة extra_headers$ لتعريف موقعٍ إضافي لتسجيل الأخطاء ضمن سجل.

المزيد من إمكانيات تنقيح الأخطاء

توجد المزيد من التعليمات الممكن استخدامها ضمن ملف wp-config.php للمساعدة في عملية تتبع وتنقيحالأخطاء في ووردبريس.

إمكانية تنقيح الخطأ في السكربت

من المحتمل مواجهة بعض المشاكل مع ملفات جافا سكريبت وCSS التي تنتمي إلى ملفات تثبيت ووردبريس، ويجب البحث عن الأخطاء ضمن هذه الملفات أو إدخال بعض تعليمات console.log أو اتباع طرقٍ أخرى لتتبع الأخطاء.

يُحمِّل ووردبريس ملفاته بفعالية فهو يستخدم نسخًا مُصغرة من ملفات جافا سكريبت وCSS وهذا ما يزيد من صعوبة تنقيح الأخطاء المرتبطة بهذه الملفات، ولكن لحسن الحظ فإن ووردبريس مُجّهز بصورةٍ جيدة لمثل هذه الحالات، حيث تتضمن ملفاته نُسخًا غير مصغرة من ملفات جافا سكريبت وCSS، ومن أجل إجبار ووردبريس على استخدامها؛ يجب إعطاء قيمة true للثابت SCRIPT_DEBUG ضمن ملف wp-config.php.

define('SCRIPT_DEBUG', true);

حفظ الاستعلامات

سوف نحتاج أيضًا لتنقيح أخطاء قاعدة البيانات عند استغراق أحد الاستعلامات وقتًا أكثر من اللازم أو عندما يُعيد الاستعلام نتائجًا خاطئةً أو لأسبابٍ أخرى. أولى خطوات حل المشاكل السابقة هي إلقاء نظرةٍ على الاستعلامات التي تعمل عند تحميل صفحةٍ ما، لذلك من المُفيد تفعيل الثابت SAVEQUERIES ضمن ملف wp-config.php في مثل هذه الحالات لتُحفظ جميع الاستعلامات، إضافةً إلى معلوماتٍ عن مدة تنفيذها والدالة التي استدعتها، وتُحفظ جميع هذه المعلومات في متغيرٍ شاملٍ هو wpdb->queries$.

define('SAVEQUERIES', true);

تنقيح الأخطاء باستخدام الإضافات

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

Query Monitor

الإضافة Query Monitor هي مجموعة أدوات تطوير ووردبريس تسمح تنقيح أخطاء استعلامات قاعدة البيانات وأخطاء PHP والخطّافات والإجراءات وكتل محرر الكتل والنصوص البرمجية، إلى جانب نداءات HTTP API ونداءات AJAX ونداءات REST API وغير ذلك، حيث تعرض معلوماتها بعد تجميعها ضمن مجموعاتٍ خاصة بكل إضافة أو قالب، أو حسب الدوال المسؤولة عنها، وتُضيف قائمة شريط أدواتٍ للمدير تعرض ضمنه ملخصًا عن الصفحة الحالية مع معلومات تنقيح الأخطاء الكاملة الموضحة في اللوحات.

أضف إلى ذلك أن هذه الإضافة تمتلك أكثر من 100000 تثبيتٍ نشطٍ لها كما أنها مدعومة بصورةٍ جيدة وتمتلك تقييمًا بخمس نجوم، وقد طُوّرت من قِبل جون بلاكبورن وهو مساهِم قديم في تطوير ووردبريس.

Debug Bar

تضيف الإضافة Debug Bar قائمةً لتنقيح الأخطاء ضمن شريط المدير الذي يعرض الاستعلامات، والذاكرة المخبئية cache، ومعلومات مفيدة أخرى. تتبِّع هذه الإضافة عند تفعيل WP_DEBUG تحذيرات وملاحظات PHP لتسهيل الوصول إلى الأخطاء، كما أنها تتبِّع وتعرض الاستعلامات عند تفعيل SAVEQUERIES.

تمتلك هذه الإضافة أكثر من 3000 تثبيتٍ نشطٍ وتقييمًا بأربع نجوم اعتمادًا على 59 مراجعة، كما أنها طُورت من قِبل أكثر من 10 مساهمين ومطورين.

Debug This

توفر الإضافة Debug This معلوماتٍ عن تثبيت ووردبريس من خلال شريط المدير من خلال الكائن الحالي WP_Query ومعلومات المدونة وخياراتها والملفات التي عولجت ضمن HTML (الصور وCSS وملفات جافا سكربت) وأحجام الصور والمتغيرات الشاملة والثوابت والقوائم وإحصاءات الذاكرة المخبئية cache للكائن، إلى جانب الإضافات والإضافات التي يجب استخدامها والاستعلامات ومعلومات الخادم وPHP ومرفقات المنشور وأنواع المنشورات والسكربتات والأنماط المُدرجة ضمن قائمة الانتظار، وكذا الأشرطة الجانبية والأدوات وغيرها.

يُمكن تفعيل إضافاتٍ لها باستخدام شيفرةٍ برمجية يمكن الاطلاع عليها في صفحة الإضافة ضمن مستودع ووردبريس.

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

الخلاصة

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

ترجمة -وبتصرّف- للمقال How to Debug WordPress Beyond the Basics لصاحبه Lea Cohen.

اقرأ أيضًا

• أخطاء سببها الاعتماد الزائد على النفس يجب تجنبها في ووردبريس
• ما الذي تحتاج معرفته قبل الشروع في التطوير على ووردبريس
• كيف تنشأ صفحة خطأ 404 مخصصة في ووردبريس
• تعديل ملف wp-config.php لضبط إعدادات ووردبريس

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

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

الحاجة إلى مقتطف بطول ثابت من المحارف

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

يمتلك ووردبريس دالةً مفيدةً هي the_excerpt()‎ تعرض مُقتطفًا للمنشور، حيث تعمل هذه الدالة بذكاء، فهي تتأكد أولًا مما إذا كان المنشور يتضمن مقتطفًا لعرضه، وفي حال عدم تضمنه فستستخرجُ أول بضع كلماتٍ من محتوى المنشور لتحل محل المُقتطف، والطول الافتراضي للمُقتطف هو 55 كلمة، ويُمكن تغيير هذا الطول باستخدام مُرشح excerpt_length.

يمكن من الناحية النظرية استخدام الدالة the_excerpt()‎ لتحديد طول المٌقتطف، ولكن تبين بعد التجربة أنها غير كافية لأنّ الكلمات وحدة قياسٍ غير دقيقة، فهي تتفاوت بالطول ولا بد من دقةٍ أكبر في تحديد الطول، ولذلك يجب استخدام المحارف كما تُدعى في لغة البرمجة أو الحروف في لغتنا العربية لتعيين طول المقتطف.

يشرح هذا المقال دالةً تستخدم محتوى المنشور (وليس المُقتطف) من أجل استخراج العدد المرغوب من المحارف، حيث سيتناول جميع أجزاء هذه الدالة بما فيها من مكونات، مع الانتباه إلى أنّ عملية استخراج المحارف ليست عملية تعدادٍ للمحارف فقط، إذ يُمكن أن يتضمن محتوى المنشور عناصر أخرى ضمنه مثل وسوم HTML أو صورًا أو أكوادًا قصيرة، ويجب الأخذ بالحسبان عند عدّ المحارف تلك المحارف المكتوبة بشيفرة مغايرة لشيفرة ASCII مثل ترميز UTF-8.

إزالة الوسوم والأكواد القصيرة الأسطر والفراغات

يجب إزالة جميع وسوم HTML بالخطوة الأولى، وهذا سوف يؤدي إلى إزالة وسم img ووسم التعليق، لذلك سوف تكون التعليمة الأولى في الدالة هي:

$content = strip_tags($content);

أصبح المحتوى الآن خاليًا من وسوم HTML، ولكن ما تزال هناك الكثير من العناصر التي لا نحتاجها ضمن المُقتطف، مثل الأكواد القصيرة لأن وظيفة المٌقتطف هي عرض نص فقط ولا حاجة للأكواد القصيرة ضمنه حتى لو كان مضمونها نصًا، حيث لن يكون لها معنًى إلا عند تحليلها والأفضل التخلص منها. لن نحتاج إلى كتابة دالةٍ جديدة لفعل ذلك لأن ووردبريس يمتلك دالة strip_shortcodes()‎ وظيفتها إزالة الأكواد القصيرة.

أيضًا أصبح لدينا الآن محتوىً بدون وسومٍ أو أكوادٍ قصيرة، لكن يُحتمل ظهور فراغاتٍ وأسطر لا حاجة لها، حيث نريد أن يظهر المُقتطف على أنه مقطعٌ واحدٌ مستمر، ولذلك سنستخدم تعبيرًا نمطيًا للبحث عن الفراغات والأسطر وغيرها واستبدالها بفراغٍ واحد.

عد المحارف والحفاظ على كلمة كاملة

لقد حصلنا الآن على نصٍ بدون أي عناصر أخرى، وبقي علينا أمران هما استخراج عدد المحارف المطلوب والانتباه إلى أنّ الكلمة الأخيرة من المقتطف غير مقسومة. يمكن عدّ المحارف باستخدام إحدى الدالتين strpos()‎ أوsubstr()‎، لكن عند تجربتهما على موقعٍ لا يستخدم ترميز ASCII، فقد حصل شيئان، وأولهما عدم الحصول على نفس عدد المحارف الممرر للدالة، والثاني ظهور أحرفٍ غريبةٍ بعض المرات في نهاية المُقتطف. وبعد البحث اكتشفنا وجود دالةٍ متعددة البايت مكافئةٍ لكل دالة str في PHP وتُستخدم لمعالجة جميع محارف UTF-8، حيث أن طول محارف UTF-8 أكبر من 1 بايت، لذلك كانت دالة strpos()‎ تَعُد المحارف بالاعتماد على الطول وهو 1 بايت، ونتج عن ذلك أخطاء عند عَدّ محارف بترميز UTF-8 ليظهر عددٌ أقل من المطلوب، وكان هذا أيضًا السبب وراء ظهور محارفٍ غير معروفة في نهاية المقتطف.

تعتمد substr()‎ على طول المحارف لعدّها، والطول المعتمد لديها هو 1 بايت أيضًا، وعند وصولها بالعد لمنتصف محرفٍ معين (طول المحرف 2 بايت في ترميز UTF-8)، فسوف تعرض محرفًا غير معروف، ولذلك يجب استخدام mb_strpos()‎ بدلًا من strpos()‎، وmb_substr()‎ بدلًا من substr()‎.

تتمثل الخطوة الآن في ترتيب المقتطف بصورةٍ أنيقة بحيث لا تُقتطع أية كلمة من المنتصف، حيث لن يكون عدد المحارف الذي يُمرر مثل معاملٍ في أغلب الأحيان دقيقًا، لكننا نريد أن نبقى قريبين منه قدر الإمكان، لذا سنتحقق أي الحالتين أقرب، وهما القطع قبل أو بعد الكلمة الأخيرة التي نحن في منتصفها. سنستخدم mb_strrpos لإيجاد الفراغ الأخير قبل نهاية المحرف وmb_strpos لإيجاد الفراغ التالي بعد نهاية المحرف، ثم نقيس المسافة بين هذين الفراغين من نهاية المحرف ونعيد المقتطف إلى أقرب فراغ.

الدالة الكاملة

تسمح الشيفرة البرمجية التالية بالحفاظ على آخر كلمة من المقتطف دون اقتطاعها مهما كان عدد المحارف المطلوب استخراجه من المحتوى.

/**
* Get a limited part of the content - sans html tags and shortcodes - 
* according to the amount written in $limit. Make sure words aren't cut in the middle
* @param int $limit - number of characters
* @return string - the shortened content
*/
function wpshout_the_short_content($limit) {
   $content = get_the_content();
  /* sometimes there are <p> tags that separate the words, and when the tags are removed, 
   * words from adjoining paragraphs stick together.
   * so replace the end <p> tags with space, to ensure unstickinees of words */
   $content = strip_tags($content);
   $content = strip_shortcodes($content);
   $content = trim(preg_replace('/\s+/', ' ', $content));
   $ret = $content; /* if the limit is more than the length, this will be returned */
   if (mb_strlen($content) >= $limit) {
      $ret = mb_substr($content, 0, $limit);
     // make sure not to cut the words in the middle:
     // 1. first check if the substring already ends with a space
      if (mb_substr($ret, -1) !== ' ') {
        // 2. If it doesn't, find the last space before the end of the string
         $space_pos_in_substr = mb_strrpos($ret, ' ');
        // 3. then find the next space after the end of the string(using the original string)
         $space_pos_in_content = mb_strpos($content, ' ', $limit);
        // 4. now compare the distance of each space position from the limit
         if ($space_pos_in_content != false && $space_pos_in_content - $limit <= $limit - $space_pos_in_substr) {
           /* if the closest space is in the original string, take the substring from there*/
            $ret = mb_substr($content, 0, $space_pos_in_content);
         } else {
           // else take the substring from the original string, but with the earlier (space) position
            $ret = mb_substr($content, 0, $space_pos_in_substr);
         }
      }
   }
   return $ret . '...';
}

تحديث المنشور بالمقتطف المولد

يمكن تحديث مُقتطف المنشور ضمن قاعدة البيانات إذا كنا لا تريد للشيفرة البرمجية أن تُولّد المُقتطف في كل مرةٍ يُعرض فيها المنشور، وبالتالي فعندما تعمل الدالة has_excerpt()‎ على منشورٍ معين، فسوف تُعيد نتيجةً إيجابيةً وتأخذ المُقتطف مباشرةً من قاعدة البيانات دون المرور بكل ما سبق. ويجب هنا أن يحدث استدعاء للدالّة wp_update_post()‎ في نهاية الدالة wpshout_the_short_content()‎، وذلك من أجل تحديث المنشور والتي تحتاج لمُعرّف المنشور ID والمُقتطف.

function wpshout_update_post_excerpt($new_excerpt){
    $post = array( 
        'ID' => get_the_ID(),
        'post_excerpt' => $new_excerpt,
    );
    wp_update_post($post);
}

أفضل طريقةٍ لاستدعاء هذه الدالة هي من خلال ربطها مع مُرشح wp_trim_excerpt يولِّد مُقتطفًا من محتوى منشور ووردبريس عن طريق اختصاره إلى 55 كلمة وإضافة "[…]"، وقبل الإنتهاء نستدعي مرشح wp_trim_excerpt للسماح بترشيح النتائج وتوليد سلوك مقتطفٍ خاصٍ بنا.

function wpshout_excerpt( $text ) {
    if( is_admin() ) {
        return $text;
    }
    if (! has_excerpt() ) {
        $text = wpshout_the_short_content(200);
    }
    wpshout_update_post_excerpt($text);
    return $text;
}

add_filter( 'wp_trim_excerpt', 'wpshout_excerpt' );

الخلاصة

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

ترجمة -وبتصرّف- للمقال How to Create an Excerpt From a Post Without an Excerpt and Limit It by Character Count لصاحبه Lea Cohen.

اقرأ أيضًا

• فهم الحلقة وطريقة ووردبريس في عرض المنشورات
• إنشاء أنواع منشورات مخصصة Custom Post Types في ووردبريس
• تعديل ملف wp-config.php لضبط إعدادات ووردبريس
• إدارة الإضافات في ووردبريس

يشرح هذا المقال أحد أهم المواضيع المرتبطة بتطوير ووردبريس وهو حلقة ووردبريس WordPress loop وتُدعى أيضًا "The loop"، لذلك يُعَد المحتوى مهمًا جدًا، كما أنه يُمثل دليلًا عمليًا لفهم ووردبريس، حيث تُعَد الحلقة ركنًا أساسيًا في تطوير قوالب ووردبريس، ولهذا يجب التعرف عليها، ولحسن الحظ فهي ليست معقدةً. يهدف المقال هنا إلى توضيح مبدأ عمل الحلقات في ووردبريس ثم الانتقال إلى الشيفرة البرمجية وآلية عملها.

تعريف الحلقة ببساطة

في هذا القسم لن يُستعان بالبرمجة لشرح عمل الحلقة، بل سيُشرح مبدأ عملها والفكرة منها.

حلقة ووردبريس موجودة في ملفات القالب

تتكون قوالب ووردبريس من ملفات قوالب PHP، وتُحدد هيكلية قوالب ووردبريس ملفات القالب المرتبطة مع كل صفحة، حيث يرتبط ملف page.php مثلًا مع طلبٍ لصفحة "من نحن About"، وhome.php مع طلب الصفحة الرئيسية للموقع، بينما يُستخدم ملف index.php احتياطيًا في حال لم يُفعّل الجزء الأعلى من هذه الهرمية.

يجب الغوص في محتوى ملف القالب بعد تحديد أي ملفٍ نريد العمل عليه لإيجاد الحلقة.

الحلقة هي المسؤولة عن معالجة المنشورات في ووردبريس

حلقة ووردبريس هي الآلية التي يتعامل فيها ووردبريس مع أي منشورٍ أو مجموعة منشورات، حيث تستطيع ضمن الحلقة تحديد كيفية عرض كل منشور لتُطبّق الحلقة البنية المطلوبة على كل منشور ضمن المجموعة، فعلى سبيل المثال تتضمن صفحة المدونة حلقة ووردبريس التي تعالج العديد من المقالات، ثم تُعيد استخدام بنية المنشور التي حددتها على جميع هذه المقالات، ولكن إذا وُجد مقال واحد فقط أو طلب المستخدم الوصول لصفحة "من نحن About"؛ فعندها سوف يستخدم ووردبريس مبدأ الحلقة ذاته ولكن لعرض منشورٍ واحدٍ فقط سواءً كان مقالًا أو صفحة.

حلقة ووردبريس هي أساس التخصيص في ملفات القالب في ووردبريس

تُعَد الحلقة المحرك النابض لأي ملف قالب، فهي قابلة للتخصيص وتتغير حسب الملف، ويُعَد تغيير محتوى الحلقة هو الطريقة الرئيسية لتغيير وظيفة ملفات القالب، فقد تريد لصفحة المدونة لديك مثلًأ (والتي يُتحكم بها من قِبل ملف home.php للقالب المُستخدم) عرض مقتطفاتٍ من فقرةٍ واحدةٍ من مقالات المدونة بدلًا من عرض كامل المحتوى، ولتحقيق ذلك سوف تُستخدم الدالة the_excerpt()‎ داخل حلقة الملف home.php، وبنفس الوقت ربما نريد لصفحات مقالات المدونة والتي يُتحكم بها من قِبل ملف single.php عرض محتوى المقال كاملًا وليس فقط المقتطف، لذا علينا استخدام الدالة the_content()‎ داخل حلقة الملف single.php بدلًا من الدالة the_excerpt()‎.

يتمحور تطوير قوالب ووردبريس حول معرفة هذه التفاصيل والفرق بينها.

مثال على استخدام حلقة ووردبريس

تجد في الصورة المُبينة في الأسفل محتوى ملف single.php للقالب الشهير Twenty Fifteen، حيث تشغُل الحلقة مجال السطور (15 وحتى 43)، ولكن أُخفي محتواها كي لا نشغل ذهننا به الآن (أي السطور من 18 إلى 39 مخفية)، مع ملاحظة كيف أن ملف single.php مكونٌ تقريبًا ْمن الحلقة فقط، وبالتالي فهي التي تسمح لملف القالب بعرض محتواه.

بعد رؤية توظيف الحلقة ضمن ملفٍ حقيقي، لنبدأ عملية التشريح الوظيفي لها في أي قالب.

النسخة البسيطة من الحلقة

سنلقي نظرةً هنا على الشيفرة البرمجية PHP للحلقة وبنيتها الأساسية، حيث يُمكن كتابة شيفرة الحلقة بطريقتين وكلتاهما تؤديان الوظيفة ذاتها.

<?php
/* Environment: We're inside a theme template file in the WordPress template hierarchy */

if ( have_posts() ) { // (1)
    while ( have_posts() ) { // (2)
        the_post();  // (3)

       // (Loop contents will go here)  (4)

    } // end while  (5)
} // end if  (6)

أو

<?php
/* Environment: We're inside a theme template file in the WordPress template hierarchy */

if ( have_posts() ) : // (1)
    while ( have_posts() ) :  // (2)
        the_post();   // (3)

       // (Loop contents will go here)  (4)

    endwhile; // (5)
endif;  // (6)

لا داعي للارتباك بفكرة وجود طريقتين لكتابة الحلقة، فما هي إلا خياراتٌ مختلفةٌ توفرها لغة البرمجة PHP ولها المعنى ذاته. وستُسخدم الطريقة الثانية في الأقسام الآتية من المقال.

كيفية عمل الحلقة في ووردبريس

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

تعمل الحلقة وفقًا للخطوات التالية المُرقمة ضمن الشيفرة:

1. تسأل الحلقة بيئة ووردبريس الرئيسية عما إذا كانت هناك أي منشوراتٍ لمعالجتها من خلال دالةٍ تُدعى have_posts()‎، حيث تُعيد هذه الدالة إما true في حال وُجد منشورات جاهزةٍ للمعالجة أو false في حال عدم وجود منشورات؛ وإذا كانت النتيجة المُعادة من قِبل الدالة have_posts()‎ ضمن عبارة if هي true، فسوف تعمل أجزاء الحلقة؛ أما إذا كانت false، فسوف يتجاوز معالج PHP الحلقة لأنها لا تحتوي على شيء.

2. سوف تُنفّذ تعليمة (()while ( have_posts عند تحقق شرط عبارة if، والذي يعني وجود منشورات يجب معالجتها ضمن الحلقة، وفعليًا هذا هو السطر الذي تبدأ عنده الحلقة، وهو عبارةٌ عن حلقة while في لغة PHP تُعيد تنفيذ التعليمات داخلها طالما أن شرطها مُحقق، أي وبمعنىً آخر "طالما توجد منشورات لمعالجتها ادخل الحلقة"، وبالتالي ستُنفذ الحلقة الشيفرة البرمجية الموجودة داخلها مرةً لكل منشور وتستمر هذه العملية حتى تنتهي المنشورات وتنتقل الصفحة لتنفيذ تعليمات PHP التي تلي الحلقة في نفس ملف القالب.

3. نحن الآن داخل حلقة while المُشار إليها بالفقرة السابقة وتدل تعليمة the_post()‎ على أنه "طالما لدينا منشورٌ للعمل عليه، فيجب أن نُضيف المنشور الحالي للرتل"، حيث تعمل هذه الدالة على إضافة المنشور للرتل أي أنها تُجهّز المنشور التالي لتُطبّق عليه عمليات ووردبريس المتوفرة ضمن الحلقة، ويجب أن تكون هذه الدالة موجودةً ضمن الحلقة.

4. كتابة محتوى الحلقة، حيث يُعَد هذا القسم الجزء الرئيسي للحلقة وهنا نستطيع الإبداع وكتابة الشيفرة البرمجية التي سوف تُطبق على كل منشور، وهو فارغٌ الآن لأنه القسم الذي علينا كتابته بأنفسنا، وسنتوسع في شرح هذا القسم في الفقرات القادمة من هذا المقال.

5. نهاية الحلقة من خلال كتابة تعليمة endwhile;‎ وهذه هي طريقة PHP للقول "انتهينا من حلقة while" وكل التعليمات المتواجدة بين while() :‎ وendwhile;‎ هي تعليماتٌ تابعةٌ للحلقة while، وأي شيءٍ بعدها هو خارج هذه الحلقة وسوف يُنفذ لمرةٍ واحدة بعد الانتهاء من تنفيذ حلقة while.

6. نهاية الشرط من خلال تعليمة endif;‎، وهذه هي طريقة PHP للقول "انتهينا من عبارة if التي كنا داخلها"، حيث تُنفذ جميع التعليمات المتواجدة بين if():‎ وendif;‎لمرةٍ واحدة (طالما أنها ليست داخل حلقة) عند تحقق شرط عبارة if، ولن تتأثر أي تعليماتٍ بعدها بالشرط الخاص بها، وسوف تُنفذ مهما كانت نتيجة الشرط.

مثال على عمل حلقة

سنطلّع الآن على مثالٍ لحلقةٍ تُنفّذ وظيفةً ما، حيث أصبح من الأسهل فهم ما يجري بعد الاطلاع على أجزاء الحلقة وعملها.

<?php 
/* Environment: We're inside a theme template file in the WordPress template hierarchy */

if ( have_posts() ) :
    while ( have_posts() ) :
        the_post(); ?>

        <article class="full-article">
            <h2><?php the_title(); ?></h2>
            <?php the_excerpt(); ?>
        </article>

    <?php endwhile;
endif;

خرج هذه الحلقة في قوالب ووردبريس

تُنشئ هذه الحلقة من أجل كل منشورٍ ضمن المجموعة وسمًا <article>، حيث تعرض داخله العنوان أولًا ثم مُقتطفًا قصيرًا (افتراضيًا أول 55 كلمة يتبعها الرمز [...]) للمنشور الحالي.

سوف تعرض الحلقة السابقة المُخرج التالي بعد استخدام عدة منشوراتٍ من ضمن الموقع الذي نجربها عليه.

<article class="full-article">
    <h2>What Your Minimum Viable Product Should Be Measuring</h2>
    <p>In our last article we introduced you to the idea of the Minimum Viable Product (MVP), and covered some of the internal challenges that often arise when you prepare to share a beta version of your idea. An MVP isn't just a quick, cheap version of your product that you're releasing because it's easy. On […]</p>
</article>


<article class="full-article">
    <h2>Starting Small: Creating a Minimum Viable Product</h2>
    <p>A common mistake entrepreneurs make is to start with a very specific idea and grind as hard as possible to make it work. This might work out great—but as many entrepreneurs learn, it's far too easy to rush through, or entirely overlook, the process of refining our initial ideas into something people truly want. Not […]</p>
</article>


<article class="full-article">
    <h2>How to Plan a Successful Web Project</h2>
    <p>It's too easy to plan out a web project in terms of technologies rather than solutions. Too many web projects don't meet their goals. The project could be the wrong solution for the right goal, the right solution for the wrong goal—or, perhaps worst of all, a shiny solution for no goal. The problem is […]</p>
</article>

// (And so on for many more articles)

أنماط علينا ملاحظتها في الحلقة

يجب الانتباه لأمرين اثنين في المثال السابق: كيفية الانتقال بين وسوم HTML والصيغ المُستخدمة في PHP، ولا بد من الإنتباه إلى أن أي شيءٍ ليس ضمن <‎?php ?‎> فهو وسم HTML فقط، وفي مثالنا السابق هذه الوسوم كانت <h2> و<article>، حيث تُطبع هذه الوسوم مبُاشرةً في المتصفح في كل مرةٍ تمر فيها الحلقة على منشورٍ جديد. الجزء الحقيقي والعميق المُتعلقان بووردبريس، وهما وسما PHP المُستخدمان: الوسم الأول هو the_title()‎ والذي يطبع عنوان المقال الحالي في كل مرةٍ يُستخدم فيها ضمن الحلقة؛ أما الوسم الثاني فهو the_excerpt()‎ ويطبع مُقتطفًا من نفس المقال.

نستطيع إنشاء قالبٍ واستخدام ملفٍ واحدٍ ضمنه وهو index.php، وكذا استخدام الحلقة السابقة ضمنه لتعرض الصفحة الرئيسية للموقع عناوين ومقتطفات أحدث المنشورات ضمنه (سواءٌ كان مقالًا أو صفحةً).

الخلاصة

يساعد هذا المقال في توضيح مفهومٍ رئيسيٍ في ووردبريس وهو الحلقة، والتي تكون أكثر تعقيدًا في معظم القوالب المُستخدمة في ووردبريس ولكن يمكن البدء بالأمثلة الموجودة هنا.

ترجمة -وبتصرّف- للمقال Understanding The Loop: WordPress’s Way of Showing Posts لصاحبه David Hayes.

اقرأ أيضًا

• إنشاء أنواع منشورات مخصصة Custom Post Types في ووردبريس
• إنشاء أنواع التصنيفات Taxonomies والحقول Fields في ووردبريس
• خمس طرق لإنشاء استعلامات مخصصة في ووردبريس
• تطوير ووردبريس للمبتدئين
• تعلم PHP
• تعلم البرمجة

يُعَد ملف wp-config.php أحد أهم ملفات إعدادات ووردبريس، وهو متواجد في مسار الجذر الرئيسي لملفات ووردبريس، كما يتضمن المعلومات الأساسية لتشغيل موقعك مثل معلومات الاتصال بقاعدة البيانات.

لن تجد ملف wp-config.php عند تنزيل ملف ووردبريس المضغوط لأول مرة، ولكنه سيُنشأ فور تثبيت ووردبريس بالاعتماد على المعلومات التي تُقدمها في خطوات التثبيت (اسم قاعدة البيانات واسم مستخدم قاعدة البيانات وكلمة المرور الخاصة به).

تستطيع إنشاء ملف wp-config.php يدويًا باستخدام الملف wp-config-sample.php، والذي تجده ضمن ملفات تثبيت ووردبريس عند فك ضغطه (ضمن المسار الرئيسي لملفات ووردبريس)، وبعد الانتهاء من تعديل محتوى الملف، عليك حفظه باسم wp-config.php.

اقتباس

ملاحظة: يجب عليك الانتباه إلى أهمية ترتيب محتويات ملف wp-config-sample.php، وقد ينتج عن إعادة ترتيب هذه المحتويات في ملف wp-config.php أخطاءٌ ضمن الموقع.

تحتاج إلى المعلومات التالية لتعديل ملف wp-config.php أثناء التثبيت:

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

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

ضبط إعدادات قاعدة البيانات

اقتباس

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

حدد موقع ملف wp-config-sample.php ضمن مسار تثبيت ووردبريس الرئيسي وافتحه ضمن محرر نصوص.

ملف wp-config-sample.php الافتراضي

فيما يلي مثال عن ملف wp-config-sample.php الافتراضي، حيث أن القيم المستخدمة هي مجرد أمثلة لتعريفك ما يجب فعله.

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'database_name_here' );
/** MySQL database username */
define( 'DB_USER', 'username_here' );
/** MySQL database password */
define( 'DB_PASSWORD', 'password_here' );
/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

اقتباس

ملاحظة: يُعَد النص داخل /**/ تعليقات لتقديم معلومات لا غير.

ضبط اسم قاعدة البيانات

استبدل عبارة database_name_here باسم قاعدة البيانات الخاصة بك، مثل MyDatabaseName.

define( 'DB_NAME', 'MyDatabaseName' ); // Example MySQL database name

ضبط مستخدم قاعدة البيانات

استبدل عبارة username_here باسم مستخدم قاعدة البيانات الخاصة بك، على سبيل المثال MyUserName.

define( 'DB_USER', 'MyUserName' ); // Example MySQL username

ضبط كلمة مرور قاعدة البيانات

استبدل عبارة "password_here" بكلمة مرور قاعدة البيانات لديك، مثال MyPassword.

define( 'DB_PASSWORD', 'MyPassWord' ); // Example MySQL password

ضبط مضيف قاعدة البيانات

استبدل localhost باسم مضيف قاعدة البيانات، مثال MyDatabaseHost إضافةً إلى رقم منفذ الاتصال والذي من الممكن أن تحتاج معه إلى مسار ملف مقبس يونكس Unix socket.

define( 'DB_HOST', 'MyDatabaseHost' ); // Example MySQL Database host

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

المنفذ البديل لقاعدة بيانات MYSQL

ستضطر لتغيير قيمة DB_HOST ضمن ملف wp-config.php في حال استخدم المضيف رقم منفذ بديل لقاعدة بياناتك.

من أجل المُضيف المحلي localhost:

define( 'DB_HOST', '127.0.0.1:3307' );

أو في بعض الحالات:

define( 'DB_HOST', 'localhost:3307' );

أما لخادم محدد:

define( 'DB_HOST', 'mysql.example.com:3307' );

طبعًا رقم المنفذ المُستخدم 3307 ليس إلزاميًا فهو يختلف تبعًا لما يمنحه لك مضيفك.

مقابس MYSQL أو Pipe

يجب عليك الانتباه أنه في حال استخدام مضيفك لمقابس يونكس أو Pipe، عليك تعديل قيمة DB_HOST ضمن ملف wp-config.php حسب المُستخدم.

define( 'DB_HOST', '127.0.0.1:/var/run/mysqld/mysqld.sock' );
// or define( 'DB_HOST', 'localhost:/var/run/mysqld/mysqld.sock' );
// or define( 'DB_HOST', 'example.tld:/var/run/mysqld/mysqld.sock' );

استبدل/var/run/mysqld/mysqld.sock بمعلومات المقبس أو Pipe المُقدّمة من قبل مضيفك.

الاحتمالات الممكنة لقيمة DB_HOST

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

مجموعة محارف قاعدة البيانات Database character set

تسمح DB_CHARSET بتعيين مجموعة محارف قاعدة البيانات حتى تُستخدم عند تعريف جداول قاعدة البيانات. حيث تكون القيمة الافتراضية لها هي utf8 (مجموعة محارف Unicode UTF-8)، وهي الخيار الأفضل في أغلب الأحيان، حيث تدعم UTF-8 جميع اللغات وبالتالي من المُستحسن الإبقاء على قيمة utf8 لـ DB_CHARSET واستخدام ترتيب قاعدة البيانات DB_COLLATE للغة المُراد دعمها بدلًا من ضبط قيمة DB_CHARSET.

يُظهر المثال التالي استخدام utf8 وهي قيمة ووردبريس الافتراضية:

define( 'DB_CHARSET', 'utf8' );

لا توجد حاجة غالبًا لتغيير قيمة DB_HOST الافتراضية ولكن إن احتاجت مدونتك لمجموعة محارف مختلفة، فعليك قراءة مجموعات المحارف والترتيبات التي تدعمهاMySQL للحرص على استخدام قيم صحيحة لقيمة DB_HOST.

اقتباس

تحذير: تتطلب بعض القيم عمل ترقية لقاعدة البيانات.

لا تضف تعريفًا لمجموعة قاعدة البيانات DB_CHARSET  أو ترتيبها DB_COLLATE في حال عدم وجودها في ملف wp-config.php، إلا إن كنت قد قرأت عن وفهمت جيدًا آلية تحويل مجموعة محارف قاعدة البيانات، وذلك لأن إضافة DB_CHARSET  أو DB_COLLATE لمدونةٍ قيد التشغيل غالبًا سوف يُسبب مشاكل خطيرة.

ترتيب مجموعة محارف قاعدة البيانات Database Collation

يسمح DB_COLLATE بتعيين ترتيب مجموعة محارف قاعدة البيانات (مثال على ذلك كيفية ترتيب مجموعة المحارف)، ويجب الإبقاء على قيمة هذا المتغير في معظم الحالات فراغًا لتعيين ترتيب قاعدة البيانات افتراضيًا من قبل MySQL بالاعتماد على مجموعة محارف قاعدة البيانات المُحددة بقيمة DB_CHARSET. يُمكنك استخدام DB_COLLATE وإعطائها أحد قيم UTF-8 المُعرّفة في مجموعات محارف UTF-8 للغات أوروبا الغربية عند استخدامك لغة مختلفة تظهر محارفها مختلفة عما هو مُدخل. (ألقِ نظرةً على مجموعات محارف Unicode ضمن كتيب إرشادات SQL).

القيمة الافتراضية لـ DB_COLLATE في ووردبريس:

define( 'DB_COLLATE', '' );

ترتيب UTF-8 Unicode العام:

define( 'DB_COLLATE', 'utf8_general_ci' );

ترتيب UTF-8 Unicode التركي:

define( 'DB_COLLATE', 'utf8_turkish_ci' );

للأسف لا يوجد ترتيب خاص باللغة العربية، ولكن يُستخدم عادةً utf8mb4_unicode_ci مع مواقع ووردبريس العربية دون أي مشاكل في إظهار الحروف العربية.

لا يوجد عادًة أي داعي لتغيير قيمة DB_COLLATE الافتراضية، حيث يضمن إبقاء القيمة فارغة التعيين التلقائي لها من قِبل MySQL عند إنشاء جداول قاعدة البيانات.

المفاتيح الأمنية Security Keys

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

مثال (لا تستخدم البيانات التالية):

define( 'AUTH_KEY',         't`DK%X:>xy|e-Z(BXb/f(Ur`8#~UzUQG-^_Cs_GHs5U-&Wb?pgn^p8(2@}IcnCa|' );
define( 'SECURE_AUTH_KEY',  'D&ovlU#|CvJ##uNq}bel+^MFtT&.b9{UvR]g%ixsXhGlRJ7q!h}XWdEC[BOKXssj' );
define( 'LOGGED_IN_KEY',    'MGKi8Br(&{H*~&0s;{k0<S(O:+f#WM+q|npJ-+P;RDKT:~jrmgj#/-,[hOBk!ry^' );
define( 'NONCE_KEY',        'FIsAsXJKL5ZlQo)iD-pt??eUbdc{_Cn<4!d~yqz))&B D?AwK%)+)F2aNwI|siOe' );
define( 'AUTH_SALT',        '7T-!^i!0,w)L#JK@pc2{8XE[DenYI^BVf{L:jvF,hf}zBf883td6D;Vcy8,S)-&G' );
define( 'SECURE_AUTH_SALT', 'I6`V|mDZq21-J|ihb u^q0F }F_NUcy`l,=obGtq*p#Ybe4a31R,r=|n#=]@]c #' );
define( 'LOGGED_IN_SALT',   'w<$4c$Hmd%/*]`Oom>(hdXW|0M=X={we6;Mpvtg+V.o<$|#_}qG(GaVDEsn,~*4i' );
define( 'NONCE_SALT',       'a|#h{c5|P &xWs4IZ20c2&%4!c(/uG}W:mAvy<I44`jAbup]t=]V<`}.py(wTP%%' );

يحمي المفتاح الأمني موقعك تجاه الهجمات من خلال إضافة عناصر عشوائية لكلمة المرور، وبعبارة أبسط فإن المفتاح الأمني عبارة عن كلمة مرور مكونة من عناصر تجعل من الصعب توليد مفاتيح محتملة كافية لكسر أمن موقعك. من الناحية الأخرى فإن استخدام كلمات مرور، مثل: "password"، أو "test"، يُسهل جدًا اختراق موقعك لأنها كلمات سهلة التوليد ومُتوقعة؛ بينما استخدام كلمة مرور طويلة وعشوائية وخالية من كلمات ذات معنى مثل "88a7da62429ba6ad3cb3c76a09641fc"، يتطلب ملايين الساعات لكسرها باستخدام هجوم القوة الغاشمة Brute Force. تُضاف مفاتيح salt وهي بيانات عشوائية تُستخدم مثل إضافي للدوال أحادية الاتجاه لحماية كلمات المرور المخزنة في الذاكرة) لزيادة أمان كلمة المرور المُولدة أيضًا.

تزيد المفاتيح الأربعة من أمان موقعك ولكنك غير مُلزم بإضافتها، حيث يُولد ووردبريس مفاتيح salt لك في حال عدم توفرها. وتستطيع إيجادها ضمن ملف wp-config.php بالحالة العادية بعد التثبيت.

ألق نظرةً على المراجع التالية للحصول على فكرة تقنية أوسع ومزيد من المعلومات التفصيلية عن المفاتيح الأمنية وكلمات المرور الآمنة:

• كيف تستعمل SSL وHTTPS مع ووردبريس
• كيفية ضبط تشفير SSL/TLS للاتصالات إلى قواعد بيانات MySQL على خادم أوبنتو 16.04
• كيفية تثبيت شهادة SSL من سلطة شهادات تجارية: الحصول على الشهادة وتثبيتها
• حفظ و تأمين كلمات المرور عبر تطبيق KeePass

خيارات متقدمة

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

بادئة جداول قاعدة البيانات table_prefix

يحتوي المُتغير ‎$table_prefixعلى قيمة البادئة التي تُحشر ببداية اسم كل جدول ضمن قاعدة البيانات المُستخدمة مع ووردبريس والقيمة الافتراضية لها هي ‎wp_"‎"، وتتغير قيمة هذا المتغير طالما باستطاعتك تغيير البادئة. تُستخدم بادئات مختلفة عند تثبيت عدة مدونات ووردبريس باستخدام نفس قاعدة البيانات، كما هو الحال عند إنشاء مواقع متعددة multisite ضمن ووردبريس.

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

$table_prefix = 'r235_'; // من فضلك يجب أن تتضمن أرقام أو محارف أو إشارة _ فقط!

رابط عنوان ووردبريس WP_SITEURL

يسمح لك WP_SITEURL بتعريف رابط عنوان ووردبريس، ويجب أن تدل القيمة المُعرفة ضمنه على موقع ملفات ووردبريس الأساسية؛ كما يجب أن يتضمن الرابط الجزئية "‎"‎ http://‎ التي تدل على البروتوكول المستخدم لتصفح مواقع الويب، لكن عليك عدم إضافة "/" لنهاية الرابط.

يسمح لك ضبط هذه القيمة ضمن ملف wp-config.php بتجاهل القيمة الموجودة ضمن جدول wp_options لرابط الموقع siteurl، كما يُقلل إضافة هذه القيمة من خلال الملف السابق من عدد مرات الاتصال بقاعدة البيانات عند تحميل الموقع.

اقتباس

ملاحظة: لايُغيّر هذا من القيمة المحفوظة ضمن قاعدة البيانات.

ستُستخدم القيمة المحفوظة في قاعدة البيانات عند حذف السطر الذي يغير هذه القيمة من ملف wp-config.php، أما لتغيير قيمة siteurl ضمن قاعدة البيانات عليك، فاستخدم الثابت RELOCATE.

لنقترض أن ووردبريس مُثبت ضمن مسار يُدعى "wordpress" للنطاق example.com، عندها عليك تعريف WP_SITEURL كالتالي:

define( 'WP_SITEURL', 'http://example.com/wordpress' );

يُمكن ضبط قيمة WP_SITEURL ديناميكيًا بالاعتماد على المتغير ‎$_SERVER['HTTP_HOST']‎:

define( 'WP_SITEURL', 'http://' . $_SERVER['HTTP_HOST'] . '/path/to/wordpress' );

اقتباس

ملاحظة: يُنشَأ HTTP_HOST ديناميكيًا من خلال بي اتش بي بالاعتماد على قيمة ترويسة HTTP_HOST ضمن الطلب، وهذا قد يسمح بثغرات تضمين الملف File Inclusion Vulnerabilities. ومن الممكن أيضًا إنشاء SERVER_NAME ديناميكيًا ولكن عند إعداد خادم Apache ليستخدم UseCanonicalName، وتُضبط قيمة SERVER_NAME من خلال إعدادات الخادم وهذه الحالة أكثر أمانًا للمستخدِم من HTTP_HOST.

تُضبط قيمة WP_SITEURL اعتمادًا على ‎‎$_SERVER['SERVER_NAME']‎:

define( 'WP_SITEURL', 'http://' . $_SERVER['SERVER_NAME'] . '/path/to/wordpress' );

عنوان رابط المدونة URL

يسمح استخدام هذا المتغير WP_HOME بتجاهل قيمة home ضمن جدول ‎_wp_options دون تغييره ضمن قاعدة البيانات، وهذه القيمة هي العنوان الذي تريد لزوارك كتابته ضمن متصفحاتهم للوصول لمدونتك على ووردبريس. يجب أن يتضمن الرابط بروتوكول http://"‎" دون الانتهاء بـ "/" في نهاية الرابط. انتبه أن استخدام هذا المتغير يُقلل من عدد الطلبات لقاعدة البيانات عند تحميل الموقع.

define( 'WP_HOME', 'http://example.com' ); 

يجب عليك اتباع المثال التالي في حال كنت تستخدم التقنية المشروحة ضمن تعيين المسار الخاص بووردبريس، ولا تنسى إضافة index.php ضمن المسار الخاص بموقعك إن كنت تستخدم هذه الإعدادات. اضبط WP_HOME ديناميكيًا بالاعتماد على قيمة ‎‎$_SERVER['HTTP_HOST']‎‎:

define( 'WP_HOME', 'http://' . $_SERVER['HTTP_HOST'] . '/path/to/wordpress' );

نقل مجلد wp-content

تستطيع نقل مسار المجلد wp-content المُتضمن القوالب والإضافات والملفات المرفوعة للموقع إلى مسار خارج مسار ووردبريس.

اضبط قيمة WP_CONTENT_DIR للمسار المحلي الكامل الذي تريد النقل له بدون إضافة "/" لنهاية المسار.

define( 'WP_CONTENT_DIR', dirname(__FILE__) . '/blog/wp-content' );

اضبط قيمة WP_CONTENT_URL بالرابط الكامل للمسار السابق دون إضافة "/" لنهاية الرابط.

define( 'WP_CONTENT_URL', 'http://example/blog/wp-content' );

نقل المجلد الخاص بالإضافات

اضبط قيمة WP_PLUGIN_DIR للمسار المحلي الكامل الذي تريد النقل له دون إضافة "/" لنهاية المسار.

define( 'WP_PLUGIN_DIR', dirname(__FILE__) . '/blog/wp-content/plugins' );

اضبط قيمة WP_PLUGIN_URL بالرابط الكامل للمسار السابق دون إضافة "/" لنهاية الرابط.

define( 'WP_PLUGIN_URL', 'http://example/blog/wp-content/plugins' );

قد تواجهك مشاكل بالتوافق مع بعض الإضافات، حاول معالجة ذلك بضبط قيمة PLUGINDIR للمسار المحلي الكامل السابق دون إضافة "/" لنهاية المسار، على سبيل المثال.

define( 'PLUGINDIR', dirname(__FILE__) . '/blog/wp-content/plugins' );

نقل مجلد القوالب

من غير الممكن نقل مجلد القوالب، لأن مساره منسوب ضمن الكود البرمجي إلى مجلد wp-content:

$theme_root = WP_CONTENT_DIR . '/themes';

بينما تستطيع تسجيل مسارات إضافية للقالب من خلال تسجيل مسار القالب.

ألقِ نظرةً على كيفية نقل مجلد wp-content. ولمزيدٍ من التفاصيل حول موقع مجلد القوالب وكيفية تصميمه، ألقِ نظرةً على ملف wp-includes/theme.php.

نقل مجلد المرفوعات

اضبط قيمة UPLOADS إلى:

define( 'UPLOADS', 'blog/wp-content/uploads' );

لا يمكن أبدًا لهذا المسار أن يكون ثابتًا مطلقًا، بل يكون منسوبًا إلى ABSPATH؛ لذلك لا يتطلب استخدام "/" في البداية.

تعديل فواصل الحفظ التلقائي الزمنية

يَستخدم ووردبريس Ajax لتنفيذ عملية الحفظ التلقائي للمقال خلال تعديلك له وحفظ نسخ عنه. ومن المُحتمل أن ترغب في زيادة هذه القيمة لتصبح الفواصل الزمنية بين عمليات الحفظ أطول، أو ربما العكس لضمان عدم خسارة أي تعديلات. بحيث القيمة الافتراضية هي 60 ثانية.

define( 'AUTOSAVE_INTERVAL', 160 ); // Seconds

تنقيحات المنشور

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

تعطيل تنقيحات المنشور

يضبط ووردبريس قيمة WP_POST_REVISIONS إلى القيمة true افتراضيًا، وهذا يُفعّل تنقيحات المنشور أي حفظ نسخ عنه. لتعطيل هذه الميزة الرائعة استخدم الكود التالي:

define( 'WP_POST_REVISIONS', false );

اقتباس

ملاحظة: لا يستطيع بعض المستخدمين تفعيل هذه الميزة إلا عند نقل الأمر السابق لأول سطر يلي تعليق الكتلة الأوّلي ضمن ملف wp-config.php.

تحديد عدد نسخ تنقيحات المنشور

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

define( 'WP_POST_REVISIONS', 3 );

اقتباس

ملاحظة: لا يستطيع بعض المستخدمين تفعيل هذه الميزة إلا عند نقل الأمر السابق لأول سطر يلي تعليق الكتلة الأوّلي ضمن ملف wp-config.php.

ضبط نطاق ملفات الارتباط

يمكن تحديد النطاق ضمن ملفات ارتباط ووردبريس لمن يمتلك إعدادات نطاق غير عادية. فمثلًا إذا كانت النطاقات الفرعية مُستخدمة لتخديم محتوى ثابت، تستطيع ضبط نطاق ملف الارتباط فقط لنطاقك الذي يقدم محتوى ديناميكي لمنع إرسال ملفات ارتباط ووردبريس مع كل طلب للمحتوى الثابت ضمن النطاق الفرعي.

define( 'COOKIE_DOMAIN', 'www.example.com' );

تفعيل ميزة المواقع المتعددة/ الشبكة Multisite/ Network

يسمح ضبط قيمة WP_ALLOW_MULTISITE بتفعيل أو تعطيل ميزة المواقع المتعددة، وفي حال عدم وجود هذا الخيار ضمن ملف wp-config.php، فإن الحالة الافتراضية هي عدم تفعيل الميزة والقيمة الافتراضية للمتغير هي false.

define( 'WP_ALLOW_MULTISITE', true );

إعادة التوجيه للمدونات غير الموجودة

يُمكن استخدام NOBLOGREDIRECT لإعادة توجيه الزوار الذين يحاولون الوصول لِنطاق فرعي أو مجلد فرعي غير موجود.

define( 'NOBLOGREDIRECT', 'http://example.com' ); 

إظهار رسالة خطأ WP_DISABLE_FATAL_ERROR_HANDLER

قدّم إصدار 5.2 من ووردبريس نمط الاستعادة Recovery Mode الذي يُظهر رسالة خطأ بدلًا من شاشة بيضاء عندما تتسبب الإضافات بخطأ برمجي، إذ تُعرض رسالة تشبه الرسالة التالية:

اقتباس

The site is experiencing technical difficulties. Please check your site admin email inbox for instructions.

والتي تعني: يعاني الموقع من صعوبات تقنية. يرجى التحقق من البريد الوارد البريد الإلكتروني المسؤول الموقع للحصول على تعليمات

لن تظهر شاشة بيضاء أو رسالة خطأ ضمن كود البي اتش بي للمستخدِمين بعد الآن. ولكن ضمن بيئة التطوير فقط، فإن كنت ترغب بتفعيل WP_DEBUG_DISPLAY، فيجب عليك تعطيل نمط الاستعادة من خلال ضبط قيمة WP_DISABLE_FATAL_ERROR_HANDLER للقيمة true.

define( 'WP_DISABLE_FATAL_ERROR_HANDLER', true );   // 5.2 and later define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', true );

تنقيح الأخطاء WP_DEBUG

يتحكم خيار WP_DEBUG بعرض بعض الأخطاء والتحذيرات، وتفعيله يسمح باستخدام إعدادات WP_DEBUG_DISPLAY وWP_DEBUG_LOG. الحالة الافتراضية لهذه المتغيرات هي false.

define( 'WP_DISABLE_FATAL_ERROR_HANDLER', true );   // 5.2 and later
define( 'WP_DEBUG', true );

تظهر أخطاء قاعدة البيانات ضمن المتصفح فقط عند ضبط قيمة WP_DEBUG إلى القيمة true، ويتعامل الصنف wpdb مع أخطاء قاعدة البيانات التي لا تتأثر بإعدادات أخطاء بي اتش بي، كما ويرفع ضبط قيمة WP_DEBUG إلى true من مستوى التبليغ عن الخطأ إلى E_ALL، ويُفعل التحذيرات عند استخدام ملفات أو دوال قديمة لا يجب استخدامها؛ أما في الحالة الافتراضية، يكون مستوى التبليغ عن الخطأ مضبوطًا إلىM

 E_ALL ^ E_NOTICE ^ E_USER_NOTICE

نمط البيئة WP_ENVIRONMENT_TYPE

يتحكم خيار WP_ENVIRONMENT_TYPE بنمط البيئة لموقعك الالكتروني، سواءً محلية local، أو تطوير development، أو مرحلية staging، أو إنتاج production. وتُعالج قيم أنماط البيئة بالترتيب التالي، بحيث تُلغي كل طريقة تسلسلية القيم السابقة: متغير بيئة بي اتش بي WP_ENVIRONMENT وثابت WP_ENVIRONMENT.

ستُعاد القيمة الافتراضية production في حال كانت قيمة نمط البيئة المُوفرة من قِبل أي من الطريقتين السابقتين غير موجودة ضمن أنماط البيئة المُسموح بها.

وأبسط طريقة لضبط القيمة هي من خلال تعريف الثابت:

define( 'WP_ENVIRONMENT_TYPE', 'staging' );

اقتباس

ملاحظة: عند إعادة development من قبل الدالة wp_get_environment_type()‎، فستُضبَط قيمة WP_DEBUG إلى true في حال كانت غير معرّفة ضمن ملف wp-config.php للموقع.

تنقيح السكربت SCRIPT_DEBUG

يجبر الثابت SCRIPT_DEBUG ووردبريس على استخدام إصدارات "dev" للسكربت، وأوراق الأنماط stylesheet من ملفات الجافاسكربت، وCSS الموجودة ضمن: wp-includes/js، وwp-include/css، وwp-admin/js، وwp-admin/css لتُحمَّل بدلًا من النسخ min.js وmin.css.

لذلك يجب عليك إضافة الكود التالي إن كنت تريد التعديل على كود جافاسكربت أو CSS موجود ضمن ملفات ووردبريس:

define( 'SCRIPT_DEBUG', true );

تعطيل ضم ملفات الجافاسكربت

تُضم ملفات الجافاسكربت برابط واحد لتحقيق تحميلٍ أسرع للوحة تحكم المدير. في حال وجود أخطاء أو فشل في عمل ملفات الجافاسكربت ضمن لوحة تحكم المدير، يمكنك تعطيل هذه الميزة إن كانت تحل المشكلة:

define( 'CONCATENATE_SCRIPTS', false );

إعداد تسجيل الخطأ

قد يكون إعداد تسجيل الخطأ صعبًا قليلًا، وذلك بسبب ضبط إعدادات سجل وعرض خطأ بي اتش بي ضمن ملف php.ini، والذي قد تمتلك أو لا تمتلك إمكانية الوصول له، لهذا يجب ضبط هذه الإعدادات حسب المطلوب في حال كان لديك وصول للملف السابق، ومن المُحبّذ ألا تُعرَض رسائل خطأ للعلن بل توجيهها إلى سجلٍ للأخطاء، كما يجب أيضًا ألا يكون سجل الخطأ موجودًا ضمن مسار يمكن لأي زائر لخادمك الوصول إليه.

عينة عن الإعدادات التي يُوصى بها لملف php.ini:

error_reporting = 4339
display_errors = Off
display_startup_errors = Off
log_errors = On
error_log = /home/example.com/logs/php_error.log
log_errors_max_len = 1024
ignore_repeated_errors = On
ignore_repeated_source = Off
html_errors = Off

إن error_reporting 4339 هي قيمة مخصصة تسمح بتسجيل المشاكل التي تؤثر على عمل موقعك الإلكتروني وتتجاهل أشياء أخرى مثل الملاحظات التي قد لا تكون أخطاء. ألقِ نظرةً على ثوابت أخطاء بي اتش بي لتفهم معنى موقع كل بت من "1000011110011" وهو العدد الثنائي الموافق للعدد العشري 4339. حيث يعني البت الأول من جهة اليسار والذي أخذ قيمة 1، وجوب عرض تقرير عن أي E_RECOVERABLE_ERROR؛ أما البت التالي وهو بقيمة 0، فيعني عدم الإبلاغ عن E_STRICT (يُرفع هذا الخطأ عندما يُستخدم ترميز غير متقن ولكنه فعّال). تستطيع استخدام الرقم الذي تريد بدلًا من 4339.

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

@ini_set( 'log_errors', 'Off' );
@ini_set( 'display_errors', 'On' );
define( 'WP_DISABLE_FATAL_ERROR_HANDLER', true );   // 5.2 and later
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', false );
define( 'WP_DEBUG_DISPLAY', true );

ملف wp-config.php هو مكان مثالي لتعيين إعدادات ملف php.ini المتحكّمة بتثبيت بي اتش بي الخاص بك، نظرًا لتحميل هذا الملف في كل مرة تزور الصفحة فيها ولا يُحمَّل أبدًا من ذاكرة التخزين المؤقتة cache. هذا الإعداد مفيد جدًا إن كنت لا تمتلك صلاحية الوصول لملف php.ini أو في حال أردت تغيير بعض الإعدادات سريعًا.

يوجد استثناء وحيد مرتبط بإعداد error_reporting، حيث يأخذ القيمة E_ALL من قِبل ووردبريس في حال عُيّنت قيمة WP_DEBUG إلى true بغض النظر عن الإعدادات التي تحاول تغييرها ضمن ملف wp-config.php. عند اضطرارك لضبط قيمة error_reporting لشيء آخر، يجب ضبط ذلك بعد تحميل ملف wp-settings.php، مثلًا في ملف إضافة.

تذكر حذف سجل الأخطاء في حال كان مفعلًا بعد الانتهاء من معاينته، لأنه غالبًا ما يكون ضمن مسار علني يمكن لأي أحد الوصول له.

يُفعّل المثال التالي سجل أخطاء بي اتش بي ويُسجلهم ضمن ملف محدد وفي حال كان قيمة WP_DEBUG هي true سيحفظ الأخطاء ضمن هذا الملف. عليك تضمين هذا الكود قبل أوامر require_once أو includes.

@ini_set( 'log_errors', 'On' );
@ini_set( 'display_errors', 'Off' );
@ini_set( 'error_log', '/home/example.com/logs/php_error.log' );
/* That's all, stop editing! Happy blogging. */

نعرض مثالًا آخر لتسجيل الأخطاء، مقترح من قبل مايك ليتل Mike Little ضمن قائمة البريد الالكتروني لـِ wp-hackers:

/**
* This will log all errors notices and warnings to a file called debug.log in
* wp-content (if Apache does not have write permission, you may need to create
* the file first and set the appropriate permissions (i.e. use 666) )
*/
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

توجد نسخة أخرى مُحسنة من مايكل ليتل ضمن مجموعة مانشستر لمستخدم ووردبريس:

/**
* This will log all errors notices and warnings to a file called debug.log in
* wp-content only when WP_DEBUG is true. if Apache does not have write permission,
* you may need to create the file first and set the appropriate permissions (i.e. use 666).
*/
define( 'WP_DEBUG', true ); // Or false
if ( WP_DEBUG ) {
    define( 'WP_DEBUG_LOG', true );
    define( 'WP_DEBUG_DISPLAY', false );
    @ini_set( 'display_errors', 0 );
}

يمتلك ووردبريس ثلاثة ثوابت يبدو أن لها نفس الوظيفة ظاهريًا وهذا يُسبب إشكالية. تذكر أولًا أن WP_DEBUG لا يفعل أي شيء مع ثابتي التنقيح الآخرين عند احتوائه على قيمة false. طبعًا أيًا كانت إعدادات بي اتش بي، فستكون هي السائدة إلا error_reporting حيث يعطيها ووردبريس القيمة 4983 في حال كان WP_DEBUG مُعرف بقيمة false. ثانيًا، حتى عند امتلاك WP_DEBUG على قيمة true، لا يعمل الثابتين الآخرين أي شيء إلا عند إسناد قيمة true لهما؛ أما في حال ضُبطا على قيمة false، فلن تتغير إعدادات بي اتش بي.

على سبيل المثال، إذا احتوى ملف php.ini على التوجيه 'display_errors'='On' ولكن لديك ضمن ملف wp-config.php التعريف التالي:

define( ‘WP_DEBUG_DISPLAY’, false )

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

تستطيع استخدام الكود البرمجي التالي لمنصة ووردبريس لديك في مرحلة التثبيت ضمن ملف wp-config.php بالرغم أن جزء منه يبدو زائدًا عن الحاجة:

@ini_set( 'log_errors', 'On' );
@ini_set( 'display_errors', 'Off' );
define( 'WP_DISABLE_FATAL_ERROR_HANDLER', false );   // 5.2 and later
define( 'WP_DEBUG', false );
define( 'WP_DEBUG_LOG', false );
define( 'WP_DEBUG_DISPLAY', false );

الملف الافتراضي لسجل التنقيحات هو ‎/wp-content/debug.log"‎". إن وضع سجلات الأخطاء في مسار يُمكن الوصول له، هو خطأٌ أمني، لذلك من الأفضل أن تُوضع سجلاتك في مسار أعلى من جذر الموقع، ولكن إن كنت لا تستطيع فعل ذلك، غيّر صلاحيات ملف السجل إلى 600 مع إضافة ما يلي إلى ملف "htaccess." الموجود في مسار تثبيت ووردبريس الرئيسي:

<Files debug.log>
    Order allow,deny
    Deny from all
</Files>

يمنع هذا أي شخص من دخول الملف من خلال بروتوكول HTTP، أما بالنسبة لك فتستطيع الاطلاع على ملف السجل من خلال تنزيله باستخدام اتصال FTP مع خادمك.

زيادة الذاكرة المخصصة من أجل بي اتش بي

يسمح لك WP_MEMORY_LIMIT بتحديد قيمة الذاكرة التي يستطيع بي اتش بي استهلاكها، وهي ضرورية جدًا في حال كنت تتلقى رسالة مثل "Allowed memory size of xxxxxx bytes exhausted".

يستطيع هذا الثابت رفع ذاكرة بي اتش بي من أجل ووردبريس فقط، ويحاول ووردبريس افتراضيًا رفع الذاكرة المحجوزة من أجل بي اتش بي إلى 40 ميجا بايت (انظر الكود في بداية ملف ‎/wp-includes/default-constants.php"‎") للموقع الواحد، و64 ميجا بايت للمواقع المتعددة. لذلك يجب استخدام قيمة أعلى من 40 أو 64 ميجا بايت عند استخدام هذا الثابت ضمن ملف wp-config.php.

يتحقق ووردبريس تلقائيًا فيما إذا كانت ذاكرة بي اتش بي المحجوزة أقل من القيمة المُدخلة قبل استخدام هذه الدالة. ففي حال حَجز ذاكرةً بقيمة 64 ميجا بايت من أجل بي اتش بي مثلًا، فلا حاجة لوضع قيمة 64 ضمن الثابت لأن ووردبريس سيستخدم هذه القيمة تلقائيًا.

اقتباس

ملاحظة: لا تسمح بعض الاستضافات برفع حدود ذاكرة بي اتش بي تلقائيًا، وفي هذه الحالة يجب عليك التواصل مع فريق دعم الاستضافة لزيادة حدود ذاكرة بي اتش بي، حيث تُحددها العديد من الاستضافات بقيمة 8 ميجا بايت.

لرفع ذاكرة بي اتش بي إلى 64 ميجا بايت:

define( 'WP_MEMORY_LIMIT', '64M' );

لرفع ذاكرة بي اتش بي إلى 96 ميجا بايت:

define( 'WP_MEMORY_LIMIT', '96M' );

وتتطلب المهام الإدارية كمية ذاكرة أكبر من المهام العادية. يمكن زيادة الذاكرة أو إنقاصها عند استخدام لوحة تحكم المدير باستخدام WP_MEMORY_LIMIT عبر تعريف WP_MAX_MEMORY_LIMIT.

define( 'WP_MAX_MEMORY_LIMIT', '256M' );

اقتباس

ملاحظة: يجب وضع العبارة السابقة قبل تضمين ملف wp-settings.php.

ملفات التخزين المؤقت Cache

يُستخدم سكربت wp-content/advanced-cache.php عند إعطاء قيمة true لِـ WP_CACHE عند تنفيذ الملف wp-settings.php.

define( 'WP_CACHE', true );

جدولي المستخدم العادي والمستخدم المخصص

تُشير CUSTOM_USER_TABLE وCUSTOM_USER_META_TABLE إلى عدم استخدام جداول المستخدم المخصص وجداول usermeta العادية من قِبل ووردبريس، إنّما تُستخدم هذه القيم أو الجداول لتخزين معلومات المستخدم.

define( 'CUSTOM_USER_TABLE', $table_prefix.'my_users' );
define( 'CUSTOM_USER_META_TABLE', $table_prefix.'my_usermeta' );

اقتباس

ملاحظة: يُنشَأ جدول usermata لكل قاعدة بيانات مع الصلاحيات المرتبطة بكلٍ منها حتى عند ضبط CUSTOM_USER_META_TABLE يدويًا. حيث يُضيف مُثبِّت ووردبريس افتراضيًا الصلاحيات لأول مستخدم (ID #1)، وعليك إدارة الصلاحيات لكل واحد ضمن الموقع من خلال إضافة plugin أو دالة مخصصة، وفي حال عدم إعداد هذا، فستواجه أخطاءً في الصلاحيات ومشاكل في تسجيل الدخول.

من السهل اعتماد CUSTOM_USER_TABLE عند إعداد أول نسخة من موقع ووردبريس، حيث تشير العبارات المُعرفة في ملف wp-config.php للنسخة الأولى إلى مكان تخزين بيانات wp-users افتراضيًا، وبعد الانتهاء من إعداد أول نسخة ووردبريس ستحتاج لنسخ ملف wp-config.php للنسخة الثانية مع تعديل في المتغير ‎$table_prefix"‎"، وانتبه لعدم استخدام عنوان بريدٍ إلكتروني موجود سلفًا في النسخة الأولى. حالما تنتهي من عملية التثبيت تستطيع تسجيل الدخول باستخدام حساب المدير المُولّد تلقائيًا وكلمة المرور، وعليك ترقية حسابك العادي بعد ذلك إلى مدير، ثم تسجيل خروج من حساب المدير وإعادة تسجيل الدخول بحسابك وحذف حساب المدير، وعندئذٍ تستطيع ترقية بقية الحسابات كما تريد.

اللغة ومسار اللغة

تسمح نسخة ووردبريس 4.0 بتغيير اللغة ضمن لوحة تحكم ووردبريس، من خلال التوجّه إلى الإعدادات ثم عام، واختر لغة الموقع.

نسخة ووردبريس 3.9.6 وما قبل

يُعرِّف WPLANG اسم لغة ملف الترجمة ‎.mo"‎"، بينما يُعرف WP_LANG_DIR مسار تواجد ملف ‎.mo"‎". يبحث ووردبريس أولًا في المسار wp-content/languages في حال لم يكن WP_LANG_DIR مُعرفًا، ثم يبحث في includes/languages عن ملف ‎.mo"‎" المُعرف من قِبل ملف WPLANG.

define( 'WPLANG', 'de_DE' );
define( 'WP_LANG_DIR', dirname(__FILE__) . 'wordpress/languages' );

لمعرفة كود اللغة WPLANG، انظر إلى الكود الموجود ضمن عمود WP local فهو ما تحتاجه.

حفظ الاستعلامات لتحليلها

يُمكّنك SAVEQUERIES من حفظ استعلامات قاعدة البيانات ضمن مصفوفة يمكن عرضها لمساعدتك في تحليل هذه الاستعلامات. حيث يُحفظ كل استعلام والوقت الذي احتاجه للتنفيذ والدالة التي استدعاها.

اقتباس

ملاحظة: سيؤثر هذا على أداء موقعك لذا لابد من تعطيل هذه الميزة بعد الانتهاء من البحث عن المشاكل.

أولًا، عليك إضافة السطر التالي لِملف wp-config.php:

define( 'SAVEQUERIES', true );

ثم أضف التالي للتذييل ضمن القالب الخاص بموقعك:

<?php
if ( current_user_can( 'administrator' ) ) {
    global $wpdb;
    echo "<pre>";
    print_r( $wpdb->queries );
    echo "</pre>";
}
?>

تجاوز صلاحيات الملف الافتراضية

يسمح FS_CHMOD_DIR وFS_CHNOD_FILE بتجاوز صلاحيات الملف الافتراضية، حيث طُوّر هذين المتغيرين استجابةً لمشكلة فشل وظيفة تحديث ووردبريس مع استضافات تعمل ضمن suexec. ويمكن لهذين المتغيرين حل مشكلة الصلاحيات المقيّدة (مثال 400) في حال استخدامها من قِبل مضيف أو عند عدم السماح لمضيف بالوصول للملفات التي تمتلك صلاحيات مجموعة أو صلاحيات عامة.

define( 'FS_CHMOD_DIR', ( 0755 & ~ umask() ) );
define( 'FS_CHMOD_FILE', ( 0644 & ~ umask() ) );

مثال لتأمين setgid:

define( 'FS_CHMOD_DIR', ( 02755 & ~umask() ) );

اقتباس

ملاحظة: القيم ‘0755’ و’02755’ هي قيم بترميز ثماني، فيجب أن تبدأ بصفر ولا تُحاط بإشارة اقتباس مفردة. ألقِ نظرةً على تغيير صلاحيات الملف.

ثوابت ترقية ووردبريس

اقتباس

ملاحظة: استخدم أقل عدد ممكن من الثوابت التالية لإصلاح مشاكل التحديث.

إن أكثر المشاكل التي تتطلب منك تعريف بعض من هذه الثوابت هي:

• تشغيل المضيف مع إعداد تثبيت خاص يتضمن ارتباطات رمزية symlinks، عندها ستضطر لتعريف ثوابت مرتبطة بالمسارات FTP_BASE وFTP_CONTENT_DIR وFTP_PLUGIN_DIR، ويكفي عادةً تعريف FTP_BASE.

• تتضمن بعض عمليات تثبيت بي اتش بي وجود إضافة PHP FTP غير المتوافقة مع بعض خوادم FTP وفي ظل هذه الظروف النادرة قد تُضطر لتعريف FS_METHOD وإسناد قيمة ftpsockets له.

  الثوابت التالية هي ثوابت فعلية لتحديثات ووردبريس:

• تفرض FS_METHOD طريقة ملفات النظام، حيث يجب أن تكون إما direct، أو ssh2، أو ftpext، أو ftpsockets. ويجب عليك تغيير قيمة هذا الثابت فقط عند مواجهتك لمشاكل أثناء التحديث، وفي حال استمرار المشكلة، فعليك إعادته لقيمته السابقة أو إزالته، وستُحل المشكلة غالبًا عند استخدام ftpsockets في حال فشلت الطريقة المختارة تلقائيًا.

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

• * الخيار الثاني ssh2 لإجبار النظام على استخدام إضافة SSH PHP إن كانت مُثبتة.

• * الخيار الثالث ftpext لإجبار النظام على استخدام إضافة FTP PHP للدخول باستخدام بروتوكول FTP.

• * الخيار الرابع ftpsockets والذي يَستخدم صف مقابس بي اتش بي للدخول باستخدام بروتوكول FTP.

• FTP_BASE: وهو المسار الكامل لمجلد تثبيت ووردبريس الرئيسي.

• FTP_CONTENT_DIR: وهو المسار الكامل للمجلد wp-content لتثبيت ووردبريس.

• FTP_PLUGIN_DIR: وهو المسار الكامل لمجلد الإضافات plugins لتثبيت ووردبريس.

• FTP_PUBKEY: وهو المسار الكامل للمفتاح العام SSH الخاص بك.

• FTP_PRIKEY: وهو المسار الكامل للمفتاح الخاص SSH الخاص بك.

• FTP_USER: إما اسم مستخدم FTP أو اسم مستخدم SSH ولا فرق في استخدام أيٍ منهما غالبًا، لذا استخدم الأنسب لنوع التحديث الذي ترغب بالقيام به.

• FTP_PASS: كلمة المرور لاسم المستخدم الموجود في FTP_USER. إن كنت تستخدم مفتاح SSH عام يُمكن حذف هذا الثابت.

• FTP_HOST: وهو دمج اسم المُتضيف مع رقم المنفذ hostname:port لِخادم SSH/FTP. حيث أن المنفذ الافتراضي من أجل FTP هو 21، أما الافتراضي من أجل SSH هو 22.

• FTP_SSL: يكون true للاتصالات ذات شهادة SSL في حال كانت مدعومة (غير متوفرة في كل الخوادم). وهو من أجل Secure FTP وليس SSH SFTP.

define( 'FS_METHOD', 'ftpext' );
define( 'FTP_BASE', '/path/to/wordpress/' );
define( 'FTP_CONTENT_DIR', '/path/to/wordpress/wp-content/' );
define( 'FTP_PLUGIN_DIR ', '/path/to/wordpress/wp-content/plugins/' );
define( 'FTP_PUBKEY', '/home/username/.ssh/id_rsa.pub' );
define( 'FTP_PRIKEY', '/home/username/.ssh/id_rsa' );
define( 'FTP_USER', 'username' );
define( 'FTP_PASS', 'password' );
define( 'FTP_HOST', 'ftp.example.org' );
define( 'FTP_SSL', false );

يجب ضبط FTP_HOST في بعض التشكيلات بقيمة localhost لتجنب أخطاء 503 عند محاولة تحديث الإضافات أو ووردبريس نفسه.

تفعيل الدخول والترقية من خلال SSH

توجد طريقتان للترقية باستخدام SSH2، هما:

• الطريقة الأولى: باستخدام إضافة دعم لمُحدِّث SSH SFTP.
• الطريقة الثانية: من خلال استخدام مطوّر SSH2 مبني داخليًا والذي يتطلب تثبيت إضافة pecl SSh2.

ستحتاج لاستخدام أمر مشابه للأمر التالي لتثبيت إضافة pecl SSH2، أو يمكنك تثبيتها من خلال التواصل مع فريق دعم الاستضافة ليهتموا بذلك بدلًا عنك:

pecl install ssh2

ستحتاج لتعديل إعدادات بي اتش بي الخاصة بعد تثبيت pecl ssh2 لتحميل هذه الإضافة تلقائيًا.

تُوفَّر pecl ضمن حزمة pear في معظم توزيعات لينكس، ومن أجل تثبيت pecl ضمن ريدهات Redhat/فيدورا Fedora/ سينتوس CentOS:

yum -y install php-pear

لتثبيت pecl ضمن نظام ديبيان Debian/ اوبنتو Ubuntu:

apt-get install php-pear

يُفضّل استخدام مفتاح خاص غير محمي بكلمة مرور، فهناك عدة تقارير تشير بأن المفاتيح الخاصة المحمية بكلمة مرور لا تعمل جيدًا، ولكن إن قررت اعتماد مفتاح خاص محمي بكلمة مرور، فسيتوجب عليك إدخال كلمة المرور للمفتاح الخاص مثل FTP_PASS، أو إدخالها ضمن حقل كلمة المرور في الحقل الظاهر عند تثبيت التحديثات.

استخدام Cron بديل

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

تتضمن هذه الطريقة بعض المخاطر لأنها تعتمد على خدمة غير أساسية ضمن ووردبريس.

define( 'ALTERNATE_WP_CRON', true );

تعطيل Cron وزمن انتهائه

تستطيع تعطيل عمليات Cron نهائيًا من خلال إسناد قيمة true للثابت DISABLE_WP<_CRON.

define( 'DISABLE_WP_CRON', true );

للتأكد من عدم تشغيل عمليات cron إلا مرةً كل WP_CRON_LOCK_TIMEOUT ثانية.

define( 'WP_CRON_LOCK_TIMEOUT', 60 );

ثوابت إضافية معرفة

إليك مجموعة من الثوابت الإضافية التي لا يمكنك استخدامها إلا بعد اتباع منهجيات أخرى أولًا. يمكن أن تكون تعريفات ملف الارتباط مفيدة إن كان لديك إعدادات نطاق غير اعتيادية.

define( 'COOKIEPATH', preg_replace( '|https?://[^/]+|i', '', get_option( 'home' ) . '/' ) );
define( 'SITECOOKIEPATH', preg_replace( '|https?://[^/]+|i', '', get_option( 'siteurl' ) . '/' ) );
define( 'ADMIN_COOKIE_PATH', SITECOOKIEPATH . 'wp-admin' );
define( 'PLUGINS_COOKIE_PATH', preg_replace( '|https?://[^/]+|i', '', WP_PLUGIN_URL ) );
define( 'TEMPLATEPATH', get_template_directory() );
define( 'STYLESHEETPATH', get_stylesheet_directory() );

تفريغ سلة المهملات

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

define( 'EMPTY_TRASH_DAYS', 30 ); // 30 days

يجب ضبط عدد الأيام إلى الصفر من أجل تعطيل سلة المهملات.

define( 'EMPTY_TRASH_DAYS', 0 ); // Zero days

اقتباس

ملاحظة: لا يسأل ووردبريس عن تأكيد عملية الحذف النهائي عند استخدام هذه الإعدادات.

التحسين التلقائي لقاعدة البيانات

هناك دعم لعملية إصلاح تلقائي لقاعدة البيانات، والتي تستطيع تفعيلها من خلال إضافة التعريف التالي ضمن ملف Wp-config.php.

اقتباس

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

define( 'WP_ALLOW_REPAIR', true );

يمكنك ايجاد السكربت ضمن

{$your_site}/wp-admin/maint/repair.php

عدم ترقية الجداول العامة DO_NOT_UPGRADE_GLOBAL_TABLES

يمنع تعريف DO_NOT_UPGRADES_GLOBAL_TABLES دوال الترقية و"‎"dbDelta()‎ من إجراء استعلامات ضخمة للجداول المعّرفة على أنها عامة global.

يمكن للمواقع التي تمتلك جداول عامة (بالأخص جداول users وusermeta)، والمواقع التي تشارك جداول المستخدم مع bbpress، ومواقع ووردبريس أخرى، عدم السماح بتغيير هذه الجداول أثناء الترقية من خلال إسناد قيمة true للثابت DO_NOT_UPGRADES_GLOBAL_TABLES. وتستغرق تعليمات ALTER، وDELETE، وUPDATE وقتًا طويلًا، لذلك تتفادى المواقع الضخمة هذه التعليمات مثل جزء من عملية الترقية وتُعالج لوحدها.

أيضًا، إذا تشاركت عمليات التثبيت جداول المستخدم بين عدّة تثبيتات ووردبريس وbbPress، فربما ترغب أن يكون موقع واحد هو المُتحكم بعملية الترقية.

  define( 'DO_NOT_UPGRADE_GLOBAL_TABLES', true );

عرض كل الثوابت المعرفة

تمتلك لغة بي اتش بي دالةَ تُعيد مصفوفةً لكل الثوابت المُعرّفة حاليا مع قيمها.

print_r( @get_defined_constants() );

تعطيل محرر القالب والإضافة

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

define( 'DISALLOW_FILE_EDIT', true );

اقتباس

ملاحظة: من الممكن أن تتأثر وظيفة بعض الإضافات باستخدام"‎"current_user_can('edit_plugins')‎ ضمن أكوادها. يجب على مطوّر الإضافة تجنُّب التحقق من هذه الصلاحية أو على الأقل التحقق من كون هذا الثابت مضبوطًا وعرض رسالة خطأ مناسبة.

انتبه في حال لم تعمل الإضافة فقد يكون هذا هو السبب.

تعطيل تحديث وتثبيت الإضافات والقوالب

يمنع هذا التعطيل المستخدِم من الاستفادة من وظائف تحديث وتثبيت الإضافة والقالب ضمن لوحة تحكم ووردبريس، كما أن ضبط هذا الثابت يُعطل محرر الإضافة ومحرر القالب (ليس عليك تفعيل DISALLOW_FILE_MODES وDISALLOW_FILE_EDIT، حيث تُقدم DISALLOW_FILE_MODES نفس التأثير).

define( 'DISALLOW_FILE_MODS', true );

طلب SSL للوحة تحكم المدير وتسجيل الدخول

اقتباس

ملاحظة: توقف ووردبريس 4.0 عن استخدام FORCE_SSL_LOGIN لذلك من فضلك استخدم FORCE_SSL_ADMIN.

يُستخدم FORCE_SSL_ADMIN لتأمين صفحة تسجيل الدخول ولوحة التحكم، بحيث تُرسل كلمات المرور وملفات الارتباط بصورة آمنة. ألقِ نظرةً على الإدارة من خلال SSL لمزيدٍ من التفاصيل.

define( 'FORCE_SSL_ADMIN', true );

حجب طلبات URL خارجية

تستطيع حجب طلبات URL خارجية من خلال إسناد قيمة true إلى WP_HTTP_BLOCK_EXTERNAL، وعندها يُسمح فقط لمدونتك وlocalhost بإجراء طلبات؛ في حين يسمح الثابت WP_ACCESSABLE_HOSTS لمضيفين آخرين بإجراء طلبات.

تُعتمد قائمة بأسماء الاستضافات المسموح لها، بحيث يكون مفصولًا بينها بفاصلة تمامًا مثل صيغة مُستخدمة مع الثابت WP_ACCESSABLE_HOSTS.

يمكن استخدام wildcard للنطاقات مثل ‎*.wordpress.org"‎" حيث يسمح هذا لجميع النطاقات الفرعية بإجراء طلبات.

define( 'WP_HTTP_BLOCK_EXTERNAL', true );
define( 'WP_ACCESSIBLE_HOSTS', 'api.wordpress.org,*.github.com' );

تعطيل تحديثات ووردبريس التلقائية

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

define( 'AUTOMATIC_UPDATER_DISABLED', true );

تعطيل تحديثات ووردبريس

أسهل طريقة للتلاعب بتحديثات ووردبريس هي باستخدام الثابت WP_AUTO_UPDATE_CORE:

# Disable all core updates:
define( 'WP_AUTO_UPDATE_CORE', false );

# Enable all core updates, including minor and major:
define( 'WP_AUTO_UPDATE_CORE', true );

# Enable core updates for minor releases (default):
define( 'WP_AUTO_UPDATE_CORE', 'minor' );

المرجع: تعطيل التحديثات التلقائية في ووردبريس 3.7

التخلص من تعديلات الصورة

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

define( 'IMAGE_EDIT_OVERWRITE', true );

تحقق بدقة قبل حفظ أي تغيير

تحقق دائمًا من وجود فراغات تسبق أو تلي القيم السابقة التي تُدخلها ولا تحذف إشارة الاقتباس المُفردة.

اقرأ الملف الذي عدلت عليه مرتين قبل حفظه، وتحقق من عدم حذف إشارة تعليق مُفردة محيطة بقيمة المتغير عن طريق الخطأ.

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

تستطيع حفظ الملف من خلال اختيار ملف ثم حفظ باسم، ثم كتابة الاسم wp-config.php واختيار المسار الرئيسي لتثبيت ووردبريس موقعًا لحفظ الملف، بعدها ارفع الملف لخادمك لتصبح جاهزًا لتثبيت ووردبريس.

ترجمة -وبتصرف- للمقال Editing wp-config.php من موقع wordpress.org.

اقرأ أيضًا

• تعلم ووردبريس
• كيفية تثبيت ووردبريسإدارة الإضافات في ووردبريس
• تعارض إضافات ووردبريس: كيف تكتشفها وماذا تفعل حيالها
• كيف تحوّل قالب HTML ساكن إلى قالب ووردبريس متجاوب: ملفات حول الموقع والاتصال والبحث والتعليقات
• كيف تنشأ صفحة خطأ 404 مخصصة في ووردبريس

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

استضافة ووردبريس: أمور يجب معرفتها قبل تثبيت ووردبريس

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

النظام الذي ينصح به

يُنصح باستخدام منصة مكونة من نظام تشغيل لينكس وخادم ويب Apache أو NGINX، لكن أي خادم يدعم PHP و MySQL يفي بالغرض، كما يجب أن يدعم خادمك وضع mod_rewrite أو أي بديل عنه من أجل الروابط الدائمة، كما أن استضافتك تكون أكثر أمانًا عندما تعمل تطبيقات PHP مثل ووردبريس باستخدام حساب مستخدم منفصل عن الحساب الافتراضي المشترك للخادم. يجب أن تسمح استضافتك بالاتصالات البعيدة لتعمل معظم ميزات ووردبريس، فعندما تحجب الاستضافة اتصالات HTTP الخارجة سوف تتوقف كثير من مكونات ووردبريس عن العمل.

متطلبات يجب تحقيقها من جهة الخادم

• نسخة PHP 7.4 أو أعلى.
• نسخة MySQL 5.6 أو MariaDB 10.1 أو أعلى.

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

مزودو خدمة الاستضافة

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

• الاستضافات التي ينصح بها ووردبريس: تدعم هذه الاستضافات ووردبريس في كثير من الجوانب.
• ابحث ضمن وسم استضافة في أكاديمية حسوب عن أي مقالات تتحدث عن الاستضافات للتعرف عليها أكثر.
• تباحث مع أعضاء أكاديمية حسوب أو مجتمع مطوري حسوب IO واسألهم عن رأيهم.

المتطلبات في حال استخدام الخادم المحلي

• حساب دخول (اسم المستخدم وكلمة المرور) للخادم من خلال بروتوكول FTP أو Shell.
• محرر نصي.
• FTP.
• متصفح الويب المفضل لديك.

يجب عليك تعلُّم استخدام محرر النصوص لتعديل ملف الإعداد الرئيسي، وفي حال كنت مستخدمًا لويندوز فسيفي المحرر Notepad بالغرض؛ أما في حال كنت مستخدمًا لنظام OS X، فيُمكنك الاعتماد على TextEdit. ربما تحتاج لاحقًا لتعديل ملفات القالب (ألقِ نظرة على القوالب كمرجعية). تستطيع تعديل هذه الملفات طبعًا من خلال لوحة تحكم ووردبريس ولكن استخدام محرر نُصوص أفضل وهذا ما يُنصح به.

يجب أن تكون مُتمكنًا من استخدام برنامج FTP لرفع الملفات وضبط صلاحيات الملف (اختياري)، ومن ضمن الخيارات برنامج FileZilla.

والآن، أنت جاهز للانطلاق بعملية التثبيت.

تعليمات أساسية

فيما يلي النسخة المُختصرة والسريعة من الإرشادات للأشخاص المتمكنين من إجراء هكذا تثبيت ويليها تعليمات أكثر تفصيلًا.

1. نزّل وفك ضغط ملف الووردبريس إن لم يكن لديك.
2. أنشئ قاعدة بيانات ووردبريس على خادمك إضافة إلى مُستخدم MySQL (أو MariaDB) يمتلك كل الصلاحيات للدخول لها والتعديل عليها.
3. ابحث عن الملف wp-config-sample.php وأعد تسميته إلى wp-config.php ثم عدّل محتويات الملف (ألق نظرةً على تعديل ملف wp-config.php) وأضِف معلومات قاعدة البيانات الخاصة بك. ملاحظة: الخطوة 3 اختيارية وفي حال كنت غير مرتاح لإعادة تسمية الملفات، فيمكنك تجاوزها وينشئ برنامج التثبيت ملف wp-config.php خاص بك.
4. ارفع ملفات ووردبريس للمكان المطلوب ضمن خادمك:

• يجب عليك رفع ملفات ووردبريس إلى المسار الرئيسي للخادم إن أردت استخدام ووردبريس على النطاق الرئيسي (مثال: https://example.com).
• إن أردت تثبيت ووردبريس ضمن مسار فرعي (مثال: http://example.com/blog)، فعليك إنشاء مجلد باسم blog ضمن المسار الرئيسي للنطاق على الخادم ورفع ملفات ووردبريس إليه عبر بروتوكول FTP.
• ملاحظة: إذا كان لبرنامج FTP client لديك خيار تحويل أسماء الملفات إلى أحرف لاتينية صغيرة، فعليك تعطيل هذا الخيار (مثال: تحويل الاسم Name إلى name).

5. ابدأ بتثبيت ووردبريس من خلال زيارة رابط الموقع عبر المتصفح، حيث يكون الرابط هو النطاق الرئيسي في حال رفعك الملفات للمسار الرئيسي للخادم (http://example.com) أو المسار الفرعي كما ذكرنا سابقًا في حال استخدمت مسار فرعي (http://example.com/blog).

هذا كل شيء! وهكذا تكون انتهيت من تثبيت ووردبريس. وفيما يلي نُفصّل أكثر بالتعليمات:

تعليمات مفصلة عن عملية تثبيت ووردبريس

لنبدأ تثبيت ووردبريس باتباع الخطوات الآتية.

الخطوة الأولى: تنزيل وفك ضغط ملف ووردبريس

ابدأ بتنزيل وفك ضغط ملف ووردبريس 

• إن كنت سترفع ملفات ووردبريس إلى خادم بعيد، فعليك تنزيل الملف المضغوط لحزمة ووردبريس على حاسوبك من خلال المتصفح ثم فك ضغطه.
• إن كنت تريد استخدام FTP، تستطيع تجاوز الخطوة التالية – إذ سنتكلم عن رفع الملفات لاحقًا.
• إن كنت تملك آلية اتصال shell بالخادم وليس لديك مشكلة في استخدام أدوات لوحة الأوامر، تستطيع تنزيل ملف ووردبريس مباشرةً على الخادم باستخدام الأمر wget (أو lynx أو متصفح ويب مُعتمد على لوحة الأوامر) إذا كنت تريد تجنب استخدام FTPing:
• wget.
• ثم فُك ضغط الملف.

سيُفك ضغط الملف ضمن مجلد باسم wordpress في نفس المسار الذي حملت ملف حزمة ووردبريس المضغوط إليه.

الخطوة الثانية: إنشاء قاعدة بيانات ومستخدم

إن كنت تستخدم مزود استضافة، فغالبًا قد تم إعداد قاعدة بيانات ووردبريس لك مسبقًا أو ربما يوجد آلية تثبيت ووردبريس تلقائية لعمل ذلك.

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

إن قررت إنشاء قاعدة البيانات يدويًا، فعليك اتباع التعليمات التالية لاستخدام phpMyAdmin وإنشاء قاعدة بيانات واسم مستخدم. أنشئ قاعدة بيانات لووردبريس للوحات تحكم، مثل: Plesk، و cPanel، والتي تستخدم MySQL Client.

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

استخدام phpMyAdmin

اتبع التعليمات التالية إن كنت تستعمل خادم مثبت عليه phpMyAdmin لإنشاء قاعدة بيانات ووردبريس ومُستخدم تابع لها. إن كنت تعمل على حاسوبك فإن معظم توزيعات لينكس تستطيع تثبيت phpMyAdmin تلقائيًا.

اقتباس

ملاحظة: التعليمات التالية مكتوبة لنسخة phpMyAdmin 4.4 لذلك قد تجد اختلافًا في واجهة المُستخدم بين نُسخ البرنامج المختلفة.

عليك إنشاء قاعدة بيانات ووردبريس إن لم تكن موجودةً سلفًا في القائمة المُنسدلة في يسار الواجهة، بعدها عليك باتباع ما يأتي:

1. اختر اسمًا من أجل لقاعدة بيانات ووردبريس: إن أسماء wordpress وblog خيارات جيدة، ولكن معظم مزودي الاستضافات (بالأخص المشتركة منها) تُجبرك على استخدام اسم لقاعدة البيانات يبدأ باسم المستخدم مع إشارة . لذلك حتى وإن كنت تعمل على حاسوبك، ننصحك بالتحقق من متطلبات استضافتك كي تتبعها على حاسوبك لتتمكن من نقل قاعدة بياناتك إليها مستقبلًا دون مشاكل. أدخل اسم قاعدة البيانات المُختار ضمن حقل Create database، واختر الترتيب Collation الأفضل للغتك ونوع الترميز. يُفضل اختيار سلسلة utf8‎ في معظم الحالات وإن لم تجد لغتك فاختر utf8mb4generalci.

2. اضغط على شعار phpMyAdmin في الزاوية العلوية اليُسرى للعودة للصفحة الرئيسية، ثم اضغط على نافذة المستخدمين Users. والآن أنشئ مستخدم لقاعدة البيانات إن لم يكن هناك مُستخدم موجود سلفًا:

3. اضغط على Add user.
4. اختر اسم المستخدم لقاعدة البيانات (wordpress خيار جيد) وأدخله ضمن حقل User Name، ثم تأكد من اختيار Use text filed من القائمة المُنسدلة.
5. اختر كلمة مرور آمنة وقوية، بحيث يجب أن تحتوي مزيجًا من الأحرف بالحالة الكبيرة والصغيرة وأرقام وإشارات خاصة، وأدخلها ضمن حقل Password مع التتأكد من اختيار Use text filed من القائمة المُنسدلة، ثم أعد إدخال كلمة المرور في حقل تكرار كلمة المرور.
6. احفظ اسم المستخدم وكلمة المرور الخاصة به في مكان آمن لأنك سوف تحتاجها في خطوات لاحقة.
7.  أبق على جميع الخيارات بحالتها الافتراضية في قسم Global privileges.
8.   اضغط Go.
9. عُد إلى صفحة المستخدمين واضغط على أيقونة Edit privileges للمستخدم الذي أنشأته لِووردبريس.
10. اختر قاعدة البيانات التي أنشأتها من أجل ووردبريس ضمن قسم Database-specific privileges من خلال القائمة المنسدلة Add privileges to the following database ثم اضغط على Go.
11. ستُحدَّث الصفحة مع صلاحيات قاعدة البيانات. اضغط على Check All لاختيار جميع الصلاحيات ثم اضغط Go.
12. انتبه لاسم المُستضيف بجانب كلمة Server في الصفحة الناتجة، فعادةً ما يكون localhost.

الخطوة الثالثة: إعدادات ملف wp-config.php

تستطيع إنشاء وتعديل ملف wp-config.php بنفسك، أو يمكنك تخطي هذه المرحلة والاعتماد على ووردبريس في إنشائه عند بدء عملية التثبيت (الخطوة الخامسة). ويجب عليك إخبار ووردبريس بمعلومات قاعدة البيانات من اسمها واسم المستخدم وكلمة المرور.

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

أدخل معلومات قاعدة البيانات تحت القسم ذي العنوان التالي:

// ** MySQL settings - You can get this info from your web host ** //

حيث أن:

• DB_NAME اسم قاعدة البيانات التي أنشأتها في الخطوة الثانية.
• DB_USER اسم المستخدم الذي أنشأته من أجل ووردبريس في الخطوة الثانية.
• DB_PASSWORD كلمة المرور التي اخترتها لاسم المستخدم في الخطوة الثانية.
• DB_HOST اسم المُستضيف الذي حددته في الخطوة الثانية (عادةً يكون localhost ولكن ليست قاعدة ثابتة، ألق نظرة على بعض القيم المُحتملة للاسم DBHOST). عليك إضافة (:) بعد اسم المُستضيف في حال وجود منفذ أو مقبس أو Pipe ثم أضف المعلومات اللازمة لِاسم المُستضيف.
• DB_CHARSET مجموعة محارف قاعدة البيانات ولا يتم تغييرها عادةً (ألق نظرةً على تعديل ملف wp-config.php).
• DB_COLLATE الترتيب الخاص بقاعدة البيانات وتكون فارغة عادةً (ألق نظرة على تعديل ملف wp-config.php).

أدخل قيم المفتاح الأمني أسفل القسم ذي العنوان التالي:

* Authentication Unique Keys and Salts.

الآن احفظ ملف wp-config.php.

الخطوة الرابعة: رفع الملفات

والآن يجب أن تقرر أين تريد لموقع ووردبريس أن يظهر على نطاقِك وذلك حسب مكان رفع ملفات ووردبريس:

• ضمن مسار الجذر الرئيسي للموقع (مثل: http://example.com)
• ضمن مسار فرعي للموقع (مثل: http://example.com/blog/)

اقتباس

ملاحظة: يتغير مكان المسار الرئيسي للموقع ضمن الخادم تبعًا لمزود الاستضافة ونظام التشغيل للخادم. إن لم تكن على دراية بهذه الأمور عليك التحقق منها مع مزود الاستضافة أو مدير النظام.

ضمن مسار الجذر الرئيسي

• عليك استخدام برنامج FTP client إن أردت رفع محتويات مجلد wordpress لخادمك (انتبه عليك رفع محتويات المجلد وليس المجلد نفسه) ضمن المسار الرئيسي لموقعك.
• إن كانت ملفاتك موجوة على الخادم وأنت تستخدم shell لتثبيت ووردبريس، عندها عليك نقل محتويات مجلد wordpress (انتبه عليك رفع محتويات المجلد وليس المجلد نفسه) إلى المسار الرئيسي لموقعك.

ضمن مسار فرعي

• إن كنت تريد رفع الملفات للخادم الخاص بك، فيجب عليك تغيير اسم المجلد من wordpress إلى الاسم المناسب لك، ثم استخدام برنامج FTP client لرفع المجلد إلى مسار نطاق موقعك الرئيسي.
• في حال كنت تستخدم shell وملفاتك موجودة سلفًا على الخادم، فعندها عليك نقل المجلد wordpress إلى المسار المطلوب ضمن مسار الجذر الرئيسي للنطاق ثم تغيير اسم المجلد للاسم الذي ترغب به.

الخطوة الخامسة: البدء بتثبيت ووردبريس

تتم هذه الخطوة باستخدام متصفح ويب.

• عليك زيارة install.php في حال وضعت ملفات ووردبريس ضمن مسار الجذر الرئيسي للنطاق على الخادم  مع استبدال اسم النطاق باسم النطاق الخاص بك.
• أما في حال وضعت ملفات ووردبريس ضمن مسار فرعي يُدعى على سبيل المثال blog، فعليك زيارة الرابط التالي http://example.con/blog/wp-admin/install.php مع تغيير اسم النطاق لاسم النطاق الخاص بك.

إعداد ملف التهيئة

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

إكمال عملية التثبيت

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

ويُمكنك تغيير كل هذه المعلومات لاحقًا ضمن لوحة تحكم المدير.

وستظهر لك صفحة تسجيل الدخول ضمن ووردبريس عند إنهاء عملية التثبيت بنجاح.

حل مشاكل سكربت التثبيت

في حال ظهر لك خطأ يتعلق بقاعدة المعطيات عند تشغيل سكربت التثبيت فعليك باتباع ما يأتي:

• ارجع للخطوة الثانية والثالثة وتأكد بأن معلومات قاعدة البيانات التي أدخلتها ضمن ملف wp-config.php صحيحة.
• تأكد من إعطاء الصلاحيات الصحيحة لمستخدم ووردبريس للوصول لقاعدة البيانات في الخطوة الثالثة.
• تأكد أن خادم قاعدة المعطيات يعمل.

تثبيت ووردبريس محليًا على حاسوبك

استخدم التعليمات في الاسفل لتثبيت بيئة الخادم على حاسوبك بغرض التجريب والتطوير.

يُثبت ووردبريس عادةً محليًا بغرض التطوير، لذلك يجب أن يتبع المهتمون بتطوير ووردبريس التعليمات التالية وتنزيل ووردبريس محليًا.

• AMPPS: يتضمن مجموعة WAMP/MAMP/LAMP المجانية مع مُثبت Softaculous مبني ضمنها. تستطيع بضغطة زر واحد تثبيت وترقية ووردبريس وغيرها.
• DesktopServer Limited: خادم مجاني على ويندوز/ماكنتوش يستطيع إنشاء عدة خوادم افتراضية مع نطاقات افتراضية (مثل www.example.dev) للعمل على عدة مشاريع ووردبريس بآن واحد.
• تطبيق من متجر ماكنتوش لتثبيت ووردبريس بضغطة زر واحدة: تثبيت شامل بضغطة زر واحدة لووردبريس وكل ما يحتاجه للعمل هو MySQL/MariaDB وApache وPHP.
• تثبيت ووردبريس محليًا على جهاز ماك باستخدام MAMP: سنشرحه في الأسفل.
• User:Beltranrubo/BitNami لتثبيت مجاني لووردبريس على نظام OS X وويندوز ولينكس. يتوفر أيضًا مثبتات لووردبريس متعدد المواقع User:Beltranrubo/BitNami Mulltistie يستخدم نطاقات مختلفة أو نطاقات فرعية.
• Instant Wordpress بيئة مجانية محمولة لووردبريس يُمكن استخدامها ضمن أنظمة ويندوز التي تعمل من مفتاح USB.

تطبيقات برمجية جاهزة للاستخدام

يُحتمل أن تجد استخدام تطبيقات برمجية طريقةً جيدةً للبدء بتشغيل ووردبريس خصوصًا عند العمل مع برمجية آلة افتراضية مثل VMWare و VirtualBox و Xen HVM و KVM.

يُمكنك استخدام برنامج آخر مثل Parallels لكنه غير مجاني على عكس البرامج السابقة. يسمح لك بتشغيل ماك وويندوز على حاسوبك.

تُساعد هذه البرمجيات المستخدم على تخطي عملية تثبيت ووردبريس اليدوية وما يتبعها من خطوات حيث تستبدله بنظام جاهز يتطلب خطوات قليلةً جدًا للحصول على ووردبريس بزمن لا يتجاوز الدقيقتين.

ننصح ببرمجية TurnKey لووردبريس وهي برمجية مجانية تعمل على Debian تتضمن مجموعةً من إضافات ووردبريس المعروفة، وتدعم تحديثات أمنية وشهادة SSL وواجهة ويب للإدارة. تتوفر كنسخة ISO وصور مختلفة للآلات الافتراضية أو يُمكنك تشغيلها على سحابة.

التثبيت التلقائي لووردبريس على خادم Ubuntu

تستطيع اتباع هذا المقال من خلال نسخ ولصق الأوامر ضمن واجهة الأوامر لضبط ووردبريس على خادم أوبنتو Ubuntu.

لست بحاجة لإدخال أي تفاصيل أو معلومات سرية مثل الطرق السابقة حيث كل شيء مؤتمت وتستطيع تخطي مرحلة التثبيت.

التثبيت على ويندوز عبر حزمة WAMP

إن كنت لا تملك IIS على حاسوبك أو لا تريد استخدامه تستطيع استخدام WAMP:

• خادم WAMP
• AMPPS WAMPStack يتضمن مُثبت Softaculous
• EasyPHP يتضمن إضافة تثبيت ووردبريس
• BitNami WAMPStack يتضمن حزمة ووردبريس
• XAMPP WAMPStack

يُمكن تنزيل الحزم السابقة مجانًا وتثبيتها لتعمل على حاسوبك. تستطيع توجيه حاسوبك إلى localhost عند الانتهاء من تثبيت WAMP واستخدام الرابط للوصول إلى phpMyAdmin وإنشاء قاعدة بيانات.

يجب عليك تنزيل ملف ووردبريس المضغوط zip واستخراج محتواه لتثبيت ووردبريس ضمن مسار الويب الخاص بتثبيت WAMP (يُثبت عادة ضمن المسار C:\wamp\www). توجه باستخدام متصفحك للعنوان التالي http://localhost//wordpress لتبدأ خطوات تثبيت ووردبريس. (افترضت أنك استخرجت محتوى ملف ووردبريس المضغوط إلى المسار c:\wamp\www\wordpress).

نصيحة: إن كنت بحاجة لاستخدام أي نوع من بنى الروابط الدائمة عدا الافتراضي عليك تفعيل وحدة mod_rewrite ضمن WAMP ولعمل ذلك عليك بالضغط على أيقونة WAMP ضمن شريط المهام ثم تحريك مؤشر الفأرة فوق Apache ضمن القائمة ثم Apache module ثم تفعيل rewrite_module.

تثبيت ووردبريس محليًا على جهاز ماك باستخدام MAMP

يرمز اختصار MAMP إلى (Macintosh - Apache - MySQL - PHP) وهو تطبيق يمكنك تثبيته على جهازك الماك يسمح لك بالوصول إلى خادم PHP محلي وخادم MySQL. يمنحك MAMP بشكلٍ أساسي جميع الأدوات التي تحتاجها لتشغيل ووردبريس على جهازك لأغراض التطوير والإختبار. ويمكنك الحصول على ذلك بطرق مختلفة لكنها ليست بسيطة مثل تطبيق MAMP (انظر MacOS_X_Local_Mirror لتثبيت PHP و MySQL يدويًا على جهازك الماك الخاص).

الخطوة 1: تثبيت MAMP

قبل تثبيت MAMP تحتاج إلى تنزيله من موقع MAMP وهو يتطلب أن يعمل جهازك بنظام التشغيل Mac OS X 10.6.6 أو الأحدث منه.

بمجرد اكتمال تنزيل MAMP انقر نقرًا مزدوجًا فوق صورة MAMP وستظهر لك نافذة MAMP منبثقة، اسحب مجلد MAMP (لا نتكلم عن نسخة MAMP PRO وسنشرحها في وقت لاحق) إلى مجلد التطبيقات.

الخطوة 2: ضبط إعدادات MAMP الأساسية

الآن بعد تثبيت MAMP على نظامك افتح MAMP.app (الموجود في ‎/Applications/MAMP/MAMP.app)، وقد يطالبك MAMP أثناء تحرير الإعدادات بكلمة مرور المسؤول وهذا مطلوب لأنه يحتاج إلى تشغيل عمليتين: mysqld (في MySQL) و httpd (في Apache)، واعتمادًا على الإعدادات التي قمت بتعيينها لهذه العمليات قد تحتاج أو لا تحتاج إلى إدخال كلمة مرورك.

بمجرد فتح MAMP انقر فوق التفضيلات Preferences وبعد ذلك انقر فوق "المنافذ" ports، منافذ MAMP الافتراضية هي 8888 لخادم Apache و 8889 لقواعد بيانات MySQL، وإذا كنت تستخدم هذا الإعداد فلن يتم مطالبتك بكلمة مرورك ولكنك ستحتاج إلى تضمين رقم المنفذ في عنوان URL (المضيف المحلي: 8888) وإذا أردت عدم تضمين رقم المنفذ في عنوان URL غير منفذ Apache إلى 80 ولكن بسبب استخدام المنفذ 80 كمنفذ MAMP Apache ستتم مطالبتك دائمًا بكلمة المرور الخاصة بك.

وأخيرًا في تبويب خادم الويب web server ستحتاج إلى تعيين جذر المستند وهذا هو المكان الذي ستكون فيه جميع ملفاتك لخادم الويب المحلي ومثال على جذر المستند هو /Users/USERNAME/Sites/wordpress/.

وبمجرد الانتهاء من ضبط جميع الإعدادات اضغط على موافق لحفظها.

الخطوة 3: بدء تشغيل خوادم MAMP وإنشاء قاعدة البيانات

لبدء تشغيل خوادم MAMP Apache وMySQL انقر فوق "بدء الخوادم start servers" من شاشة MAMP الرئيسية. وبمجرد أن تبدأ خوادم MAMP ستفتح صفحة بدء MAMP في متصفح الويب الافتراضي وإذا لم يحدث ذلك انقر على "فتح صفحة البداية Open start page" في نافذة MAMP وبمجرد فتح الصفحة حدد phpMyAdmin من صفحة الويب.

ضمن "إنشاء قاعدة بيانات جديدة" create new database أدخل اسم قاعدة بيانات وعلى سبيل المثال "ووردبريس" واضغط على إنشاء"create" ولن تحتاج لاختيار الترتيب "collation": سيتم تعيينه تلقائيًا بواسطة MySQL عند إنشاء جداول قاعدة البيانات أثناء تثبيت ووردبريس.

الخطوة 4: تنزيل وتثبيت ووردبريس

حان الوقت الآن لتنزيل ووردبريس وبمجرد تنزيله وفك ضغطه افتح مجلد "ووردبريس" انقر واسحب جميع الملفات منه إلى جذر مستند MAMP (استخدم /Users/USERNAME/Sites/wordpress/).

بالنسبة أولئك الذين لديهم تثبيت MAMP الافتراضي يجب إعادة تسمية المجلد وسحبه إلى مجلد htdocs الموجود ضمن ‎/Applications/MAMP ومن ثم في المتصفح انتقل إلى localhost:port/folder_renamed لتشغيل التثبيت وعلى سبيل المثال إذا تمت إعادة تسمية المجلد wordpresstest فانتقل إلى العنوان localhost:8888/wordpresstest.

أخيرًا علينا تشغيل تثبيت ووردبريس، قم بزيارة موقعك المحلي (localhost:port أو localhost:port/wordpress) وأدخل المعلومات التالية في نموذج إعداد قاعدة البيانات:

• Database Name اسم قاعدة البيانات: wordpresstest
• User Name اسم المستخدم (database): root
• Password كلمة المرور (database): root
• Database Host/server خادم/مضيف قاعدة البيانات: localhost
• Table Prefix سابقة الجداول: wp_‎

لاحظ اسم قاعدة البيانات الافتراضي هو "Wordpress" وأنك ستحتاج إلى تغيير اسم قاعدة البيانات إلى الاسم الذي أدخلته في PHP Admin، (في حالتنا "wordpresstest") وإذا كان لديك العديد من مواقع ووردبريس على جهازك المحلي كل منها يستخدم قاعدة البيانات الخاصة به فستحتاج إلى جعل اسم قاعدة البيانات في ووردبريس متسقًا مع اسم قاعدة بياناتك الثانية أو الثالثة أو الرابعة.

بمجرد اكتمال ذلك أدخل اسم المدونة وعنوان البريد الإلكتروني وستكون جاهزًا لاستخدام ووردبريس على جهازك الماك.

تثبيت ووردبريس بلغتك وبالعربية

على الرغم أن ووردبريس يُعرض باللغة الإنجليزية الأمريكية افتراضيًا إلا أنه يمتلك إمكانية استخدامه بأي لغة لأن مجتمع ووردبريس ترجم فعلًا ووردبريس للعديد من اللغات وهناك قوالب وملفات ترجمة ودعم متوفر للعديد من اللغات.

تثبيت ملفات اللغة من لوحة تحكم ووردبريس

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

تثبيت ملفات اللغة يدويًا

نزل ملف اللغة ‎.mo للغتك (انظر قسم ترجمة ووردبريس للعربية) حيث تعتمد سياسة ملفات ‎.mo على ترميز اللغة ISO-639 (مثلًا ar للغة العربية) متبوعة بترميز الدولة ISO-3166 (مثلًأ SA للسعودية)، وبالتالي سوف يكون ملف اللغة العربية السعودية ar_SA.mo وملف اللغة العربية غير المُعين ar.mo. تجد القائمة الكاملة للتراميز في تراميز الدول وتراميز اللغة.

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

ضبط لغة موقعك

تستطيع تغيير اللغة في إصدار ووردبريس 4.0 وما بعده من خلال لغة الموقع في تبويب عام ضمن قسم الإعدادات داخل لوحة تحكم ووردبريس.

أما في إصدار ووردبريس 3.9.2 وما سبقه، فافعل ذلك عبر فتح ملف wp-config.php ضمن محرر نصي والبحث عن:

define ('WPLANG', '');

وهنا عدل هذا السطر بالاعتماد على ملف ‎.mo الذي نزلته فمثلًا للغة العربية المحكية في السعودية عليك إضافة:

define ('WPLANG', 'ar_SA');

احفظ الملف بعد إضافة ترميز اللغة.

انتبه إلى أنه في حال عدم وجود ملفات ‎.mo و ‎.po لترميز اللغة الذي استدعي في ملف wp-config.php عنها، فلن تظهر لك رسالة خطأ لكن سوف يستمر استخدام الترميز في دالة language_attributes()‎.

ضبط اللغة في شبكة مواقع متعددة

إن كنت تُدير شبكة مواقع ووردبريس فإن ضبط اللغة يكون على مستوى كل مدونة من خلال خيار لغة الموقع في تبويب عام قسم الإعدادات. تستطيع ضبط اللغة الافتراضية للشبكة ككل ضمن مدير الشبكة في نافذة الإعدادات واختيار اللغة الافتراضية.

إضافة ترجمة لعبارات مخصصة

إن أردت إضافة ترجمات للعبارات التي ما زالت تُعرض باللغة الإنجليزية بعد التثبيت عليك زيارة translate.wordpress.org واختيار لغتك. اطلع على هذه اللغة لتبدأ في دليل المترجم.

المشاكل الشائعة أثناء التثبيت

المشاكل التالية هي جزء من المشاكل الأكثر شيوعًا والتي يتعرض لها المستخدم أثناء تثبيت ووردبريس ولمزيد من المعلومات وكيفية حل مشاكل تثبيت ووردبريس.

رؤية قائمة بالمسارات ضمن الخادم بدلا من صفحة ويب

الحل: تُعاد تهيئة خادم الويب ليرى ملف index.php افتراضيًا، وفي خادم أباتشي Apache عليك استخدام التوجيه DirectoryIndex index.php ضمن ملف اسمه ‎.htaccess، ضمن المسار الذي تريد تثبيت ووردبريس فيه (عليك إنشاء الملف في حال لم يكن موجودًا).

رؤية الكثير من أخطاء Headers already sent، وكيفية اصلاحها

الحل: تنتج هذه المُشكلة غالبًا بسبب خطأ في صيغة التعليمات ضمن ملف wp-config.php.

1. حمّل ملف wp-config.php إن كنت لا تملك وصول للخادم عبر shell.

2. افتح الملف باستخدام محرر نصي.

3. تحقق من أن السطر لا يحتوي سوى ‎<?php ولا يوجد نص قبلها (يجب ألا تجد حتى مسافة فارغة قبلها).

4. تحقق من أن السطر الأخير يتضمن فقط ‎?>‎ ولا يوجد نص بعده (يجب ألا تجد مسافة فارغة بعده).

5. تأكد أن المحرر النصي لا يُضيف علامة ترتيب البايت Byte Order Mark أو اختصارًا BOM في حال كان يحفظ الملفات بصيغة Unicode. لا تُعلِم معظم المحررات النصية بإضافة BOM للملفات، لذلك قد تحتاج لاستخدام محرر نصي آخر.

6. احفظ الملف وارفعه مجددًا وأعد تحميل الصفحة ضمن متصفحك.

ظهور كلام غير مفهوم ضمن الصفحة وعند النظر إلى مصدر الصفحة نجد العديد من وسوم

الحل: إرسال وسوم ‎‎ إلى المتصفح يُشير إلى عدم عمل بي اتش بي بطريقة صحيحة. يجب أن تُنفّذ كل اكواد بي اتش بي قبل إرسال الخادم وسوم HTML الناتجة للمتصفح. (لذلك يدعونها بالمعالج المُسبق). وتحقق أن خادمك يحقق الشروط الدنيا لعمل ووردبريس وأن بي اتش بي مُثبت ومُعَد بطريقة صحيحة أو اتصل بمزود الاستضافة أو مدير النظام لديك لطلب المساعدة.

أتلقى باستمرار رسالة الخطأ Error connecting to database رغم التأكد من صحة الإعدادات

الحل: جرب تهيئة كلمة مرور MySQL يدويًا وإن كنت تملك اتصال Shell بـ MySQL جرب التالي:

SET PASSWORD FOR 'wordpressusername'@'hostname' = OLD_PASSWORD('password');

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

تلقي رسالة فقدان تمديد MySQL باستمرار رغم سلامة الإعدادات

الحل: تحقق من إعدادات الخادم وعملها إضافةً إلى التحقق من MySQL وعمله وتحميله من قبل الخادم بطريقة صحيحة.

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

مشكلة عدم عمل ملفات MP3 أو الصور التي رفعتها

الحل: إن كنت تستخدم محررًا نصيًا مليئَا بالأدوات ضمن مدونة موجودة على مسار فرعي، وبعض الصور التي تسحبها وتُفلتها ضمن حقل المحرر تختفي بعد بضع ثواني، فغالبًا المشكلة متعلقة بـ TinyMCE، حيث لا يتلقى معلومات كافية أثناء عملية سحب الملف لبناء مسار للصورة أو أي ملف أخر بصورة صحيحة. ويكون الحل بعدم سحب الصور المرفوعة إلى المحرر، وبدلًا عن ذلك اضغط باستمرار على الصورة واضغط على Send to Editor.

ترجمة -وبتصرف- للمقالات:

• Hosting WordPress

• Before You Install

• How to install WordPress

• Installing WordPress on your own Computer 

• Installing WordPress Locally on Your Mac With MAMP

• Installing WordPress in your language

من موقع wordpress.org

اقرأ أيضًا

• تعلم ووردبريس
• إنشاء صفحة البحث في الووردبريس
• تطوير ووردبريس للمبتدئين: بناء القوالب Themes
• نظرة شاملة على قاعدة بيانات ووردبريس

ما هي الإضافات؟

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

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

كيف تساهم هذه الإضافات في بنية ووردبريس؟

إن نظام إدارة محتوى ووردبريس أو بنية ووردبريس يهدف بشكل رئيسي لنشر المحتوى وإدارة المستخدمين، وكل إضافة هي جزء إضافي برمجي سهل التثبيت يُساهم في تعزير الخدمات الأساسية لووردبريس أو إضافة وظيفة وميزة جديدة له.

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

بعض الأمثلة على الإضافات

تندرج بعض من أكثر الإضافات شعبية -المتواجدة ضمن مستودع ووردبريس- ضمن التصنيفات التالية:

• التحكم بالتعليقات المزعجة
• تحسين محركات البحث SEO
• تصدير واستيراد البيانات
• التجارة الإلكترونية E-commerce
• الأمن
• التخزين المؤقت Caching

ما سبق هو عينة صغيرة فهناك الآلاف من الإضافات المتوفرة ضمن المستودع وهذا يزيد من فرصة إيجادك لما تريده من خواص أو ميزات.

إيجاد وتثبيت الإضافات

إيجاد إضافات

تستطيع تصفح الإضافات والبحث عما تريده ضمن مستودع ووردبريس حيث جميع الإضافات مجانية ومتوفرة للتنزيل كملف مضغوط zip ليبقى عليك رفعها وتثبيتها على موقع ووردبريس.

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

تحديث الإضافات

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

1. اضغط على "إضافات" ضمن القائمة الجانبية في الجهة اليمنى من لوحة التحكم.
2. ابحث ضمن القائمة التي تعرض الإضافات المثبتة على موقعك وابحث إن كان أي منها يحتوي على السطر "هناك نسخة جديدة متاحة من…".
3. اضغط على رابط "عرض تفاصيل النسخة…" لعرض تفاصيل أوسع عن النسخة الأحدث من الإضافة.
4. اضغط على "التحديث الآن" لتحديث الإضافة.

توافق الإضافة

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

توافقية الإضافات الجديدة

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

توافقية الإضافات المثبتة

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

تثبيت الإضافات

يوجد ثلاث طرق لتثبيت إضافة ووردبريس.

• التثبيت التلقائي للإضافة، حيث يمكن تثبيت أي إضافة موجودة ضمن مستودع ووردبريس بشكل تلقائي من خلال المثبت المبني ضمن ووردبريس.
• رفع الإضافة من خلال لوحة تحكم المدير، حيث تستطيع بسهولة تثبيت الإضافة من خلال رفع الملف المضغوط zip الخاص بها من على حاسوبك.
• التثبيت اليدوي للإضافة، ففي بعض الحالات قد تضطر لرفع الملف المضغوط للإضافة من خلال بروتوكول SFTP.

التثبيت التلقائي للإضافة

هذه الطريقة هي الأسهل لتثبيت الإضافة، وتتضمن الخطوات التالية:

1. توجه إلى "إضافات" ثم تبويب "أضف جديد".
2. استخدم مربع البحث الموجود في الزاوية العلوية اليسرى للبحث عن إضافة باستخدام كلمة مفتاحية أو اسم المؤلف أو وسم.
3. سوف تظهر لك صفحة نتائج البحث التي تتضمن مجموعة من الإضافات، اختر الإضافة التي تريد واضغط على عنوانها لتقرأ المزيد عن مواصفاتها. قد تتضمن هذه الصفحة ملاحظات للتثبيت أو توثيق الإضافة أو معلومات أخرى مفيدة.
4. اضغط على "التنصيب الآن" لتثبيت الإضافة.
5. اضغط على "تفعيل" لتفعيل الإضافة.

رفع الإضافة بشكل يدوي من لوحة تحكم المدير في ووردبريس

إن كنت تمتلك نسخة مضغوطة من ملف الإضافة، تستطيع رفعها بشكل يدوي لتثبيتها من خلال لوحة تحكم المدير لووردبريس.

1. توجه إلى "إضافات" ثم تبويب "أضف جديد"
2. اضغط على خيار "رفع إضافة" الموجود في الزاوية العلوية اليمنى.
3. اختر الملف المضغوط zip من حاسوبك.
4. اضغط على "التنصيب الآن"
5. عند اكتمال التثبيت سوف تظهر عبارة "تم تنصيب الإضافة بنجاح". اضغط على "تفعيل الإضافة" في أسفل الصفحة.

التثبيت اليدوي للإضافة

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

تتطلب منك هذه الطريقة الإلمام بكيفية نقل الملفات باستخدام بروتوكول SFTP.

1. عليك فك ضغط ملف الإضافة في حال كانت بصيغة zip. يجب أن تجد بعد فك الضغط مجلدًا وحيدًا بنفس اسم الإضافة.
2. ابحث ضمن مجلد الإضافة عن ملف readme.txt واقرأ محتوياته للتأكد من أن هذه هي الإضافة الصحيحة والاطلاع على التعليمات الخاصة بالتثبيت إن وجدت.
3. الآن اتصل بالمخدم الخاص بك والذي يحتوي على موقعك من خلال بروتوكول SFTP.
4. انسخ مجلد الإضافة إلى المسار wp-content/plugins/ ضمن مسار ووردبريس. بهذا تكون قد ثبتت الإضافة ضمن موقعك.
5. توجه إلى صفحة الإضافات المنصبة في موقعك وحدد مكان وجود الإضافة الجديدة التي قمت برفعها.
6. اضغط على خيار "تفعيل".
7. في حال وجود خيار "تفاصيل أكثر"، اضغط عليه لمعرفة المزيد من المعلومات عن الإضافة.

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

الإضافات المفضلة

تستطيع إضافة أي إضافة إلى قائمة المفضلة لديك وتستطيع بسهولة عرض وتثبيت الإضافات المفضلة لمستخدم ووردبريس آخر.

تفضيل إضافة

1. عليك تسجيل الدخول ضمن موقع ووردبريس ثم التوجه إلى مستودع إضافات ووردبريس.
2. عند مراجعة صفحة أي إضافة يمكنك الضغط على أيقونة القلب الموجودة إلى جانب خيار التنزيل.
3. سوف يظهر ضمن ملفك العلني على ووردبريس قائمة بالإضافات التي تُفضلها حالما يصبح لديك إضافات مُفضلة كما أن تقييمك للإضافة سوف يظهر في نفس المكان في حال نشرت مراجعة للإضافة.

مشاهدة الإضافات المفضلة لمستخدم

لمشاهدة الإضافات المفضلة لدى مستخدم ووردبريس، بما في ذلك الإضافات التي تفضلها أنت:

1. توجه لصفحة "أضف جديد" للإضافات ضمن موقعك.
2. اضغط على لسان المفضلة
3. اكتب اسم المستخدم ضمن الحقل المخصص.
4. اضغط على "احصل على المفضلة".

تتضمن كل الإضافات الظاهرة هنا خيار "التنصيب الآن" لتتمكن من إضافتها لموقعك بسهولة.

حذف إضافة

تمتلك الإضافات آلية إلغاء تثبيت آمنة وسهلة الاستخدام وفي حال لم يكن هذا متوفر لديك لسبب ما، تستطيع حذف الإضافة بشكل يدوي.

الحذف التلقائي للإضافة

الطريقة الآمنة والسهلة لحذف إضافة هي عبر لوحة تحكم مدير ووردبريس.

1. توجه إلى صفحة "إضافات"، ثم حدد الإضافة التي تريد إلغاء تثبيتها.
2. اضغط على خيار "تعطيل".
3. اضغط الآن على خيار "حذف".

الحذف اليدوي لإضافة

قد تضطر في حالات نادرة حذف الإضافة يدويًا بدون استخدام لوحة تحكم مدير ووردبريس ويُنصح باستخدام هذه الطريقة فقط عند الضرورة.

1. توجه إلى صفحة "إضافات"، وحدد الإضافة التي تريد حذفها.
2. اضغط على خيار "تعطيل".
3. في حال عدّلتً على ملفات القالب لكي تتمكن من تثبيت الإضافة عليك إزالة هذه التعديلات قبل حذفها.
4. اتصل بالمخدم الخاص بموقعك باستخدام بروتوكول SFTP.
5. توجه إلى مسار ووردبريس، ثم wp-content/plugins/ وحدد المجلد الخاص بالإضافة التي تريد حذفها.
6. الآن احذف المجلد ومحتوياته.
7. توجه من جديد لصفحة "إضافات" ضمن لوحة تحكم مدير ووردبريس، وتأكد من أن عملية حذف الإضافة المطلوبة تمت بنجاح.

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

تحذير: تتضمن العملية التالية حذف ملفات يدويًا من المخدم الذي يتواجد عليه موقعك لذلك قد يكون هذا خطيرًا ويُنصح بأخذ نسخة احتياطية عن الموقع قبل البدء بهذه العملية.

حل المشاكل

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

المصادر

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

حلول ممكنة

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

حل مشاكل متقدم

قد تكون المعلومات الموجودة في هذا القسم غير مألوفة أو مخيفة لأي مُستخدم جديد لووردبريس ولكن إن كنت تمتلك خبرة جيدة بمنصة ووردبريس ولا تخاف من الغوص عميقًا فإن هذا القسم مفيد لك.

تساعدك هذه الخطوات على حل المشكلة تواجهك مع إضافة جديدة أو إضافة سابقة توقفت عن العمل بعد تحديث:

• في حال ثُبتت الإضافة يدويًا:
• تحقق من موقع مجلد الإضافة، يجب أن تجده ضمن المسار /wp-content/plugins
• عند رفعك نسخة جديدة من الإضافة عليك التحقق من أن النسخ القديمة تم حذفها أو إعادة تسمية المجلد الخاص بها.
• استخدم بروتوكول SFTP لحذف مجلد الإضافة ثم أعد تثبيتها من جديد.
• في حال قمت بتعديل على ملفات القالب ليتوافق مع الإضافة عليك مراجعة التعديلات. تأكد أن الشيفرة صحيحة وخالية من الأخطاء الكتابية وفي مكانها الصحيح (مثلا: ضمن حلقة ووردبريس وليس خارجها).
• في حال عدم ظهور الإضافة ضمن قائمة الإضافات، عليك إلقاء نظرة على الملف الرئيسي للإضافة باستخدام محرر الإضافات للتأكد من أن شيفرة الترويسة للإضافة موجودة ومكتوبة بشكل صحيح.
• في حال استخدامك لقالب ووردبريس مخصص عليك تفعيل القالب الافتراضي بدلًا منه وتأكد هل ما زالت المشكلة موجودة أم لا؟ في حال توقفت المشكلة عن الظهور يجب عليك التواصل مع مطور هذا القالب للمساعدتك على حل المشكلة.
• ألغ تفعيل جميع الإضافات ثم أعد تفعيل الإضافة التي تسبب المشكلة، وإن عملت الإضافة بدون مشاكل فهذا يعني وجود تعارض مع أحد الإضافات المُفعلة لديك. الآن عليك تفعيل الإضافات الأخرى واحدة تلو الأخرى ولاحظ إن عادت المشاكل لتكتشف عندها الإضافة التي تسبب هذا التعارض.

نصائح حول إضافات ووردبريس

ما يلي هي نصائح وتقنيات للمستخدمين المتقدمين والمطورين.

إدارة الإضافة

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

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

<?php
/**
* Plugin Name: Magic Plugin
* Description: Magic Plugin performs magic.
* Plugin URI: http://example.com/magic-plugin
* Version: 2.3
* Author: Mr. Magic
* Author URI: http://example.com/
* Text Domain: magic-plugin
*
* @package Magic Plugin
*/

?>

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

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

إضافات مفعلة على الشبكة

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

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

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

إخفاء الإضافات عند تعطيلها

تضيف بعض الإضافات عند تفعيلها شيفرة إلى ملفات قالب ووردبريس ويمكن أن يبقى هذا الكود الإضافي في مكانه حتى بعد تعطيل الإضافة وهذا قد يؤثر على شكل القالب أو وظائفه لينتج بعض الأخطاء. لذلك من المهم منع إضافة معطلة من أن يتم اكتشافها أو استخدامها ولفعل ذلك يجب أن تضيف شيفرة بي اتش بي إلى القالب لتنفيذ عملية تحقق بسيطة من وجود الإضافة ()function_exists. (انظر إلى المثال في الأسفل) ثم ارفع القالب المعدل إلى مجلد wp-content.

تقوم الدالة البرمجية if(function_exists())‎ بالتحقق من الإضافة لتقوم باستدعاء بقية الدوال المرتبطة بهذه الإضافة إن كانت مثبتة ونشطة أما في حال أعادت الدالة FALSE فهذا يعني أن الإضافة غير مثبتة أو غير مُفعلة ويجب تجاهل الدوال المرتبطة بالإضافة ومتابعة تحميل الصفحة.

<?php
if ( function_exists( 'FUNCTION NAME' ) ) {
 FUNCTION_NAME();
}
?>

تستخدم الإضافة في المثال دالة تدعى ()alexgetshoutbox لطباعة محتواها.

<?php
if ( function_exists( 'alex_get_shoutbox' ) ) {
 alex_get_shoutbox();
}
?>

تطوير الإضافات

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

إن كنت جديدًا في مضمار تطوير الإضافات عليك الإطلاع على هذه المصادر التي يمكن أن تكون مفيدة لك كنقطة انطلاق.

ترجمة -وبتصرف- للمقال Managing Plugins من موقع ووردبريس

اقرأ أيضًا

• تعلم ووردبريس

ما هو القالب؟

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

قالب ووردبريس عبارة عن مجموعة من الملفات تعمل معًا لإنتاج واجهة مرئية ذات طابع موحد للموقع الالكتروني تُدعى هذه الملفات بملفات القالب. يُعدل القالب الطريقة التي يُعرض بها الموقع من دون التعديل على البرمجية القائم عليها أي ووردبريس. تضمن ملفات القالب صور ‏(jpg, *.png, *.gif.*)‏ وملفات تصميم (css.*) وصفحات مخصصة إضافة إلى أي ملفات برمجية مطلوبة (php.*). ألق نظرة على ملفات القالب لمعلومات أكثر.

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

لتفهم المخطط السابق بشكل أفضل تستطيع التفاعل معه.

القوالب الافتراضية

يمتلك ووردبريس الآن ثلاث قوالب مجانية: القالب الافتراضي Twenty Nineteen theme (العرض التجريبي) والقوالب الافتراضية السابقة بالعرض التجريبي Twenty Seventeen، وTwenty Sixteen.

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

احصل على قوالب جديدة

مستودع قوالب ووردبريس هو الموقع الرسمي لقوالب ووردبريس، حيث تمت مراجعة جميع القوالب المعروضة ضمنه من قبل فريق مختص والتأكد من التزامها بمجموعة كبيرة من القواعد لضمان تجربة آمنة ومرضية لمستخدم القالب.

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

يُمكنك الإطلاع على العرض التجريبي للقالب مع معاينة الميزات ضمن صفحة معلومات القالب في حال لم تكن الصور وقائمة المميزات كافية لك لتقرر هل القالب مناسب لاحتياجاتك أم لا.

إضافة قوالب جديدة

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

إضافة قوالب جديدة باستخدام صفحة المدير

تستطيع تنزيل القوالب من مستودع قوالب ووردبريس مباشرة على موقعك باستخدام خيار "أضف جديد" ضمن تبويب "قوالب" في قائمة "المظهر".

1. تسجيل الدخول لصفحة المدير في ووردبريس.
2. اختر "المظهر" ثم "قوالب".
3. اختر "أضف جديد".
4. استخدم إما مربع البحث أو خيارات الترشيح للبحث عن القالب الذي تريد استخدامه.
5. اضغط على "معاينة" لمعاينة القالب أو اضغط "تنصيب" لرفع القالب إلى موقعك الإلكتروني.
6. أو استخدم خيار "رفع قالب" في أعلى الصفحة لرفع نسخة مضغوطة عن القالب الذي سبق لك تنزيله لحسابك.

إن كان القالب مرفوعًا مسبقًا على موقعك الالكتروني ولكن غير مُفعل عندها تستطيع استخدام خيار المعاينة لمعاينة شكل القالب على موقعك الالكتروني قبل تفعيله لتأخذ فكرة كيف سوف يبدو مع المحتوى الموجود على موقعك.

إضافة قوالب جديدة من خلال لوحة cPanel

في حال تمتلك استضافة تقدم لوحة تحكم cPanel فإنك تستطيع استخدامها لرفع ملفات القالب لموقعك الالكتروني ولاتباع هذه الطريقة يجب أن تمتلك ملفات القالب بالشكل المضغوط بامتداد zip أو gz.

1. نزل ملف zip للقالب إلى حاسوبك.
2. ضمن مدير ملفات cPanel، توجه إلى مجلد Themes. قد يختلف المسار لهذا المجلد تبعًا للاستضافة التي لديك ولكنك ستجده عمومًا ضمن مجلد public_html ثم المسار /wp-content/themes/.
3. حالما تصبح داخل مجلد themes ضمن مدير ملفات cPanel، اضغط على خيار Upload وارفع الملف المضغوط zip للقالب الذي قمت بحفظه في الخطوة الأولى.
4. حالما يتم رفع الملف المضغوط zip، اضغط عليه بالزر اليميني للفأرة واختر Extract من القائمة.
5. بعد أن يتم استخراج ملفات القالب بنجاح، اتبع التعليمات في الأسفل لتفعيل القالب الجديد.

إضافة قوالب جديدة FTP

لإضافة قالب جديد لموقع ووردبريس خاصتك عبر بروتوكول FTP سوف تحتاج إلى برنامج FTP client وملفات القالب بعد فك ضغطها.

1. حمل ملفات القالب المضغوطة zip ثم استخرج هذه الملفات. يجب أن تحصل على مجلد له نفس اسم القالب يتضمن ملفات القالب.
2. استخدم برنامج FTP Client للدخول إلى استضافتك وتوجه إلى المسار /wp-content/themes/.
3. ارفع مجلد القالب إلى المسار السابق ضمن استضافتك.
4. اتبع التعليمات في الأسفل لتفعيل القالب الجديد.

تفعيل القالب

الآن وبعد أن أصبح القالب الجديد ضمن المسار /wp-content/themes/ (سواءً استخدمت صفحة المدير، أو cPanel، أو FTP) أصبح جاهز للتفعيل. جميع القوالب الموجودة ضمن المسار /wp-content/themes/ متوفرة للتفعيل والتحديث (عندما يتم توفير التحديث من قبل مؤلف القالب) ولكن فقط قالب واحد يمكن أن يكون نشط.

عندما يتم تفعيل قالب فهذا يعني أنه سوف يتم استخدام تصميم القالب ووظائفه (الشكل والمميزات الوظيفية) على موقعك الإلكتروني. سوف يتم إعلامك بتنبيه أن عملية تفعيل القالب قد تمت بنجاح.

لتفعيل قالب على موقعك الإلكتروني:

1. يجب تسجيل الدخول لصفحة المدير في ووردبريس.
2. اختر "المظهر"، ثم "قوالب".
3. يجب أن يظهر لك هنا كل القوالب الموجود ضمن المسار /wp-content/themes/ ومن هنا تستطيع تفاصيل كل قالب من خلال الضغط على تفاصيل القالب (حرك مؤشر الفأرة فوق صورة القالب).
4. يسمح لك خيار معاينة حية بمعاينة القالب على موقعك مباشرة بما يوجد عليه من محتوى.
5. اضغط على تفعيل لتفعيل القالب.

سوف يتم تفعيل خيارك فورًا.

ملاحظة: في حال كانت المعاينة المباشرة للقالب فارغة لاتُفعِّل القالب الجديد بدون التحري عن الموضوع أكثر. فمن المحتمل ألا يُعرَض موقعك بطريقة صحيحة، وإن كنت لا ترى الصورة المُصغرة للقالب أبدًا فقد تكون ملفات قالبك الجديد عاطلة. ألق نظرةً أسفل القالب الذي ثبّتته لترى إن كانت هناك أي معلومات عن القالب المُعطل وفي هذه الحالة تواصل مع مؤلف القالب للمساعدة.

إنشاء قوالب

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

إن كنت تريد فقط تخصيص محتوى قالبك لاستخدامك الخاص فعليك التفكير في إنشاء قالب ابن.

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

ترجمة -وبتصرف- للمقال Using Themes من موقع ووردبريس.

استخدام الوجوه التعبيرية

ما هي الوجوه التعبيرية؟

الوجوه التعبيرية والمعروفة أيضا بأيقونات المشاعر هي عبارة عن حروف رسومية تُستخدم لتضمين المشاعر ضمن الكتابة وهي طريقة ممتازة لتحسين المنشورات.

تُستخدم علامتا ترقيم أو أكثر لإنشاء وجه تعبيري. بعض الأمثلة:

علامات الترقيم	الوجه التعبيري المُوافق لها
;-)
:-)
:-(
:-?

لتتعرف أكثر على أيقونات المشاعر وقصتها ألق نظرة على مقال ويكيبيديا.

الوجوه التعبيرية ليست إيموجي

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

كيف يتعامل ووردبريس مع الوجوه التعبيرية؟

يُحول ووردبريس بشكل افتراضي نص الوجوه التعبيرية إلى صور جرافيكية فعندما تكتب ;-) ضمن مقالك سوف تتحول إلى عند معاينة المقال أو نشره.

إلغاء ميزة صور الوجوه التعبيرية

أُزيل خيار تعطيل الوجوه التعبيرية بدءا من نسخة ووردبريس 4.3. يوجد إضافة إن أردت استعادة هذا الخيار.

ما النص الذي يجب عليه طباعته كي تظهر الوجوه التعبيرية

صور الوجوه التعبيرية والنصوص المُستخدمة لتوليدها:

الأيقونة	النص	النص	النص الكامل	الأيقونة	النص الكامل
	:)	:-)	:smile:		:lol:
	:D	:-D	:grin:		:oops:
	:(	:-(	:sad:		:cry:
	:o	:-o	:eek:		:evil:
	8o	8-o	:shock:		:twisted:
	:?	:-?	:???:		:roll:
	8)	8-)	:cool:		:!:
	:×	:-×	:mad:		:?:
	:P	:-p	:razz:		:idea:
	:|	:-|	:neutral:		:arrow:
	;)	;-)	:wink:		:mrgreen:

في بعض الحالات توجد عدة نصوص لعرض نفس الوجه التعبيري.

حل مشاكل الوجوه التعبيرية

لماذا لا تعمل؟

من المُحتمل أن تكون ميزة الوجوه التعبيرية مُعطلة من قبل مدير الموقع أو أن ملفات الصور التعبيرية قد حُذفت من المسار /wp-content/images/smilies.

لماذا لا تعمل الوجوه التعبيرية لدي؟

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

أين تخزن صور الوجوه التعبيرية؟

تستطيع إيجاد الصور التابعة لها أو صور أيقونات المشاعر ضمن المسار /wp-content/images/smilies.

كيف يمكنني جعل صور وجوه تعبيرية مختلفة تظهر؟

أسهل طريقة للقيام بذلك هي ترشيح الوجوه التعبيرية.

ارفع الصور التي تريدها أن تظهر بنفس الاسم إلى خادمك ضمن المسار /wp-content/images/smilies ) وأضف هذه الشيفرة ضمن ملف functions.php التابع لقالبك:

add_filter( <span class="hljs-string">'smilies_src'</span>, <span class="hljs-string">'my_custom_smilies_src'</span>, <span class="hljs-number">10</span>, <span class="hljs-number">3</span> );
<span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">my_custom_smilies_src</span><span class="hljs-params">( $img_src, $img, $siteurl )</span>
</span>{
        <span class="hljs-keyword">return</span> $siteurl.<span class="hljs-string">'/wp-content/images/smilies/'</span>.$img;
}

تعمل الشيفرة السابقة على استبدال https://example.com/wp-includes/images/smilies/icon_question.gif بالرابط التالي https://example.com/wp-content/images/smilies/icon_question.gif.

لماذا تظهر صور الوجوه التعبيرية فارغة؟

إن رفعت الصور مؤخرًا فقد يكون السبب أن الصور المرفوعة رُفعت بصيغة ASCII عبر تطبيق FTP ولحل المشكلة عليك رفع الصور من جديد مع التأكد أنها سوف تُرفع بصيغة BINARY.

تمتلك بعض برامج FTP إعدادات كشف تلقائي تقوم برفع الملفات بالصيغة الصحيحة دون تدخل المستخدم لذلك احرص على تفعيل هذا الخيار في حال وجوده.

CSS خاص بالوجوه التعبيرية

يُضاف صنف خاص بشكل تلقائي لصور الوجوه التعبيرية في ووردبريس هو wp-smiley عندما يتم عرضها في مقال. تستطيع استخدام هذا الصنف لتغيير شكل أو طريقة ظهور الوجوه التعبيرية بحيث تكون مميزة عن باقي صور المقال.

على سبيل المثال، من غير المُعتاد ضبط الصور في المقال لتظهر بالجهة اليسرى من المحتوى مع نص يلتف حولها وشيفرة CSS التالية تجعل ذلك ممكنًا:

<span class="hljs-selector-class">.post</span> <span class="hljs-selector-tag">img</span> {
        <span class="hljs-attribute">float</span>: left;
}

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

<span class="hljs-selector-tag">img</span><span class="hljs-selector-class">.wp-smiley</span> {
        <span class="hljs-attribute">float</span>: none;
}

للاطلاع على المزيد من المعلومات عن CSS في ووردبريس تستطيع البدء هنا.

لمزيد من المعلومات عن الوجوه التعبيرية، يمكن العودة إلى صفحة ويكيبيديا - أيقونات المشاعر.

اختصارات لوحة المفاتيح في ووردبريس

اختصارات المحرر

تستطيع ضمن محرر ووردبريس المرئي استخدام مجموعة من المفاتيح للقيام بأشياء تتطلب عادة استخدام الفأرة أو أجهزة دخل أخرى. توفر عليك الاختصارات التالية الوقت والجهد المُتمثل في مد يدك للوصول للفأرة والضغط على شريط الأدوات: استخدم زر (CTRL + مفتاح) في أنظمة ويندوز ولينكس وزر Command + مفتاح في نظام ماك.

CTRL+ مفتاح

يظهر في الجدول التالي المفاتيح التي يجب ضغطها مع زر CTRL والوظيفة التي يُقدمها الاختصار.

Alt + Shift + مفتاح

تستخدم الاختصارات التالية مجموعة مختلفة من الأزرار: Alt + Shift + مفتاح في نظامي ويندوز ولينكس وCTRL + Option + مفتاح في ماك. (أنظمة ماك التي تعمل على نسخ ووردبريس 4.2 ما دون تستخدم Alt + Shift + مفتاح).

يظهر في الجدول التالي المفاتيح التي يجب ضغطها مع Alt + Shift ووظيفة الاختصار

اختصارات تهيئة النص

اختصارات تهيئة النص أثناء استخدام المحرر المرئي (منذ نسخة 4.3)

اختصارات لوحة المفاتيح للتعليقات

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

تفعيل اختصارات لوحة المفاتيح

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

صُمَّمَت اختصارات لوحة المفاتيح لتستخدم كلتا يديك بشكل متزامن على لوحة مفاتيح تعمل بنمط QWERTY.

أهمية تحديد التعليق

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

استخدام لوحة المفاتيح للتنقل بين التعليقات

يتم التنقل بين التعليقات باستخدام الحرفين j و k. تكون جميع التعليقات غير محددة عند زيارتك لصفحة التعليقات لذلك الضغط أولًا على مفتاح j أو k لتختار أول تعليق وبعدها اضغط على j لتنقل التحديد للتعليق التالي.

• الضغط على j ينقل التحديد (الخلفية ذات اللون الأزرق الفاتح) للأسفل
• الضغط على k ينقل التحديد (الخلفية ذات اللون الأزرق الفاتح) للأعلى

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

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

لتكون هذه الإجراءات ذات مفعول على التعليقات يجب عليك أولًا التأكد من تحديد تعليق (انظر في الأعلى) ثم اضغط على:

• a: قبول التعليق المحدد وإظهاره.
• s: اعتبار التعليق المحدد على أنه تعليق مزعج.
• d: نقل التعليق إلى سلة المهملات (ووردبريس 2.9) أو حذف التعليق الحالي.
• u: عدم الموافقة على ظهور التعليق المحدد مما يعيده إلى حالة قيد المراجعة.
• r: بدء عملية الرد على التعليق الحالي (يمكنك الضغط على Esc لإلغاء الرد)
• q: تنشيط التحرير السريع مما يسمح لك بتعديل سريع على التعليق الحالي.
• e: النقل إلى صفحة التعديل للتعديل على التعليق الحالي.

إجراء جماعي

تستطيع أيضًا تطبيق إجراء على عدة تعليقات بنفس الوقت ولكن أولًا عليك تحديد هذه التعليقات باستخدام مفتاح x لتفعيل مربع الاختيار بجانب كل تعليق. يمكن استخدام Shift + x لعكس حالة المربع. حالما تقوم باختيار عدة تعليقات اضغط على:

• Shift + a للموافقة على التعليقات المحددة
• Shift + s لتعيين التعليقات المحددة أنها تعليقات مزعجة
• Shift + d لحذف التعليقات المحددة
• Shift + u لإلغاء الموافقة على التعليقات المحددة
• Shift + t لنقل التعليقات المحددة إلى سلة المهملات
• Shift + z لاستعادة التعليقات المحددة من سلة المهملات

ترجمة -وبتصرف- للمقالين:

• المقال Using ٍSmilies من موقع ووردبريس.
• المقال Keyboard Shortcuts من موقع ووردبريس.

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

صفحة البحث هي صفحة ووردبريس تستخدم قالب صفحة مخصص وذلك لإتاحة ميزة البحث للمستخدمين ضمن موقعك الإلكتروني.

أشياء عليك معرفتها

تمتلك قوالب ووردبريس المختلفة ملفات قالب (ملفات القالب هنا يُقصد بها ملفات تتضمن شيفرة مرتبطة بنوع صفحة معين مثل صفحة البحث أو صفحة عرض المقالات وهي تُعطي للصفحة هيكليتها ووظيفتها) مختلفة فالبعض يستخدم ملف قالب search.php وهي ليست صفحة بحث بل قالب لعرض نتائج البحث. يوجد أيضا ملف قالب يُدعى searchform.php والذي يُضمن عادة في العمود الجانبي للعديد من القوالب كي يولد مربع بحث. قد لا يمتلك القالب الذي تستخدمه مثل هذا الملف، لذلك تستطيع نسخه بسهولة من القالب الافتراضي لووردبريس.

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

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

إنشاء قالب صفحة بحث

1. افتح ملف page.php باستخدام محرر نصوص واحفظه باسم searchpage.php. تستطيع إنشاء ملف page.php في حال لم تجده بالاعتماد على قالب الملف index.php للقالب الذي تستخدمه. ملاحظة: اسم الملف search.php محجوز بشكل مًسبق كاسم خاص لقالب ملف البحث لذلك عليك تجنب استخدامه بينما الاسم المًستخدم في الخطوة الأولى searchpage.php غير محجوز ويُسهل عملية التعرف على عمل الملف عند النظر إليه ضمن مجموعة كبيرة من الملفات.
2. اتبع الخطوات التالية بعد حفظ الملف السابق:

• احذف الحلقة (عمليا كل ما هو موجود ضمن وسم div الخاص بالمحتوى) مع الإبقاء على وسوم div دون أي تعديل.
• أضف الترويسة مثل "Search Posts" أو أي بديل مماثل. تستطيع استخدام أصناف من ملفات CSS الخاصة بك أو إنشاء أصناف جديدة.
• انسخ ما يلي ضمن محتوى وسم div أو أي وسم div آخر يتضمن المحتوى الخاص بصفحتك:

<?php get_search_form(); ?> 

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

 <?php
 /**
 * Template Name: Search Page
 */
 ?>

3. احفظ الملف.
4. ارفع الملف إلى مسار القالب (في حال قمت بتغييرات على ملف style.css عليك برفعه أيضا).

يجب أن يظهر محتوى ملف search.php كالتالي في حال استعنت بملف page.php من قالب Twenty Seventeen لإنشائه:

 <?php
 /**
 * Template Name: Search Page
 */

 ?>
 <?php get_header(); ?>

 <div class="wrap">
    <div id="primary" class="content-area">
        <main id="main" class="site-main" role="main">
        <?php get_search_form(); ?>
        </main><!-- #main -->
    </div><!-- #primary -->
 </div><!-- .wrap -->

 <?php get_footer();

إنشاء صفحة بحث

تستطيع الآن إنشاء صفحة البحث بالاعتماد على قالب الصفحة.

1. توجه ضمن صفحة المدير إلى "صفحات" ثم "أضف جديدًا".
2. أدخل "بحث" ضمن حقل العنوان (هذا هو عنوان صفحة البحث الخاصة بك) لا تكتب أي شي ضمن محتوى الصفحة.
3. ابحث عن "خصائص الصفحة" على الجانب الأيسر ضمن نفس الصفحة.
4. اضغط على القائمة المنسدلة في "القالب" واختر Search Page.
5. اضغط على زر "نشر".

سوف يظهر مربع بحث بسيط مثل التالي

الربط مع صفحة البحث الخاصة بك

تستطيع الآن إنشاء رابط لصفحة البحث المخصصة لديك بعدة طرق.

باستخدام معرف الصفحة Page ID

تستطيع الربط مع صفحة البحث الجديدة من خلال استخدام رقم معرف الصفحة Page ID سواء كنت تستخدم الروابط الدائمة أو لا. أدخل السطر التالي ضمن أي منشور أو صفحة أو ملف قالب.

 <a href="index.php?page_id=17" title="Search Page">Search Page</a>

أو تستطيع استخدام السطر التالي ضمن ملف القالب

 <a href="<?php echo home_url(); ?>/?page_id=17">Search Page</a>

باستخدام الاسم اللطيف slug

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

 <a href="/wordpress/search-page/" title="Search Page">Search Page</a>

لأي منشور أو صفحة أو قالب عندما يكون الاسم اللطيف هو "search-page" أو يمكنك إضافة السطر التالي لملف القالب

 <a href="<?php echo home_url(); ?>/wordpress/search-page/" title="Search Page">Search Page</a>

باستخدام ()wp_listpages

إن كنت تستخدم وسم القالب ()wp_listpages سوف يتم توليد اسم الصفحة بشكل آلي ضمن قائمة الصفحات الخاصة بك.

تخصيص صفحة البحث الخاصة بك

الآن وبعد إنشاء صفحة البحث الخاصة بك، تستطيع تخصيص طريقة عرضها وللبدء بذلك افتح ملف searchpage.php ضمن محرر النصوص وأضف ما تريد من تعديلات. تستطيع إضافة نص يساعد الزوار على البحث ضمن موقعك وذلك ضمن ملف searchpage.php قبل الدالة get_search_form()‎.

 <p>My Site features articles about 
 <a title="WordPress Articles" href="/category/wordpress/">WordPress</a>, 
 <a title="Web Design Articles" href="/category/web-design/">web page design</a>, 
 <a title="Development Articles" href="/category/website-development/">website development</a> 
and <a title="CSS Articles" href="/category/css/">CSS</a>.</p>
 <p>To search my website, please use the form below.</p>

ربما تريد إضافة قائمة بالكلمات المفتاحية أو معلومات أخرى أو صور أو تفاصيل تجعل من صفحة البحث الخاصة بك مميزة.

حفظ نتائح صفحة البحث والتصفيح

قد تتوقف صفحة نتائج البحث والتصفيح Pagination (التصفيح هو عرض أقسام صفحة أو نتائج البحث مُقسمة على عدة صفحات) نتيجة خطأ فادح عند تطبيق تعديلات على شيفرة الصفحة. لتفادي ذلك يجب على المطور أن يُضيف الشيفرة التالية لبداية الصفحة وذلك للتأكد من حفظ الاستعلام Query الرئيسي لووردبريس.

يمكنك استخدام متغيرات إضافية للمصفوفة search_query$ للتعديل على الاستعلام. نفِّذ search_query$ من خلال كائن جديد wp_query$. يمكن إيجاد مزيد من المعلومات عن الغرض WP_Query.

 <br>
<?php <br> global $query_string;</p> <p>$query_args = explode("&", $query_string);<br> $search_query = array();</p> <p>if( strlen($query_string) > 0 ) {<br> foreach($query_args as $key => $string) {<br> $query_split = explode("=", $string);<br> $search_query[$query_split[0]] = urldecode($query_split[1]);<br> } // foreach<br> } //if</p> <p>$search = new WP_Query($search_query);<br> ?> <br>

يمكنك التعرف على المتغيرات الإضافية التي يمكنك استخدامها لتخصيص الطلب في WP_Query.

عرض النتائج الكاملة

لعرض نتائج البحث كاملة في صفحة البحث search.php يجب استعادة كامل المنشورات التي عُثر عليها باستخدام الكائن wp_query.

 <?php
 global $wp_query;
 $total_results = $wp_query->found_posts;
 ?>

يمكنك التعرف على المتغيرات الإضافية التي يمكنك استخدامها لتخصيص الطلب في WP_Query.

ترجمة -وبتصرف- للمقال Creating a Search Page من موقع ووردبريس.

تسمح صفحة إعدادات المناقشة بالتحكم بالخيارات المرتبطة بالتعليقات (تُدعى أيضا بالمناقشة). حيث يُقرر من خلالها المدير تفعيل التعليقات ضمن الموقع أم لا وإن كانت التنبيهات pingbacks والتعقيبات trackbacks مقبولة أم لا وما هي التعليقات التي تُعتبر مزعجة كما يمكنه في الصفحة ذاتها اختيار الحالات التي تُرسل فيها المدونة تنبيهات بريد إلكتروني للمدير لأحداث معينة على الموقع.

الإعدادات الافتراضية للمقال

يمكن تجاوز هذه الإعدادات فرديًا لكل مقال.

• محاولة تنبيه المدونات المشار إليها في المقالة:  يقوم ووردبريس بإرسال تنبيه ping للموقع أو المقال الذي أُشير له ضمن المقال عند تفعيل هذا الخيار. سوف تظهر هذه الإشارة ضمن قسم التعليقات لموقعهم إن كان الموقع المُشار إليه يسمح بالتنبيهات pingbacks. تتم عملية التنبيه خلال نشر المقال على شبكة الانترنت لذلك وجود العديد من الروابط التشعبية ضمن المقال سوف يُبطئ عملية النشر لأن ووردبريس يقوم بتنبيه جميع المواقع الإلكترونية قبل نشر المقال.
• السماح بإشعارات الربط من المدونات الأخرى (التنبيهات PingBacks والتعقيبات TrackBack) في المقالات الجديدة: تفعيل هذا الخيار يعني قبول ووردبريس التنبيهات Pings من مواقع أخرى التي يُحتمل أن تشير إلى مقالات ضمنه وكما ذُكر سابقًا فإن التنبيهات PingBacks والتعقيبات Trackbacks سوف تظهر في قسم التعليقات للمقال عند تفعيل هذا الخيار.
• السماح للناس بإرسال التعليقات على المقالات الجديدة (يُمكن تغيير وتجاوز هذه الإعدادات في كل مقال بطريقة منفصلة) يجب تفعيل هذا الخيار للسماح بالتعليق على المقالات ومن الممكن التحكم بالتعليقات من خلال تحويل المقال لمقال خاص يتطلب كلمة مرور صحيحة قبل السماح بالتعليق أما لمنع الزوار من التعليق يجب عدم تفعيل هذا الخيار.

إعدادات التعليقات

• يجب على المعلق كتابة الاسم والبريد الإلكتروني - يفرض هذا الخيار على أصحاب التعليقات المزعجة بذل جهد إضافي من خلال كتابة الاسم والبريد الإلكتروني قبل نشر التعليق وبالرغم من بساطة الموضوع إلا أنه يُخفض من عدد التعليقات المزعجة.
• يجب على الزوار التسجيل ليتمكنوا من التعليق - تفعيل هذا الخيار يسمح فقط للزوار المسجلين ضمن الموقع التعليق على المقالات.
• إيقاف التعليقات تلقائيًا في المقالات التي مرّ على نشرها x يوم. - يُحدد هذا الخيار عدد الأيام اللازمة بعد نشر المقال لإيقاف ميزة التعليقات ضمنه بشكل تلقائي.
• إتاحة التعليقات التشعبية بحيث يكون العمق x مستويات - يسمح هذا الخيار بكتابة تعليقات متشعبة وتحديد مستوى عمق التعليقات المتداخلة (10 هو الحد الأقصى) المسموح بها. يجب على القالب المُستخدم أن يكون مُجهز بشكل جيد لعرض التعليقات المتداخلة.
• حدّد عدد التعليقات في كل صفحة بحيث يظهر x تعليق في كل صفحة واعرض صفحة التعليقات [الأولى/الأخيرة] افتراضياً، ويجب أن تظهر التعليقات [الأحدث/الأقدم] في أعلى الصفحة - يسمح هذا الخيار بعرض التعليقات ضمن صفحات وتحديد عدد التعليقات الأعظمي لعرضه ضمنها إضافة إلى اختيار ترتيب الصفحات من الأولى للأخيرة أو العكس وعرض التعليقات ضمن هذه الصفحات من الأقدم أو من الأحدث.

أرسل لي بريد إلكتروني في حال

يتيح الخياران التاليان التحكم بالأحداث التي يتلقى فيها المؤلفون والمدير تنبيهات عن التعليقات التي تنتظر المراجعة واستخدام "لي" هنا يشير إما إلى مؤلف المقال أو المدير (الشخص الذي يُستخدم بريده الإلكتروني لأغراض إدارية).

• نشر تعليق، حيث سيتم إرسال تنبيه للمؤلف عند تفعيل هذا الخيار عند كتابة أي تعليق على الموقع ولكن في حال تلقى مقال الكثير من التعليقات سوف يمتلئ صندوق بريد المؤلف بالإشعارات.
• إضافة تعليق ينتظر المراجعة، إذ سيرسل ووردبريس عند تفعيل هذا الخيار تنبيه بأن التعليق قيد المراجعة، حيث يُرسل التنبيه إلى البريد الإلكتروني المدرج في تبويب "عام" من قسم "إعدادات" ضمن حساب المدير. هذا الخيار مفيد عندما يكون لمدونتك عدة مؤلفين وكل مؤلف مخول لرفض أو قبول التعليقات.

يمكن لمدير الموقع باستخدام هذه الطريقة مراجعة التعليقات المقبولة أو المرفوضة من قبل المؤلفين.

قبل ظهور التعليق

توفر هذه الإعدادات تحكم أوسع بما يتعلق بالتعليقات التي يتم نشرها.

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

إدارة التعليقات

يمكن تحديد هذه الخيارات ضمن قسم إدارة التعليقات للتعامل مع التعليقات المزعجة.

• لا تنشر التعليقات التي تحتوي على x رابط أو أكثر. إذ تتميز التعليقات المزعجة Spam باحتوائها على الكثير من الروابط.
• كان أصحاب التعليقات المزعجة يُضمّنون 5 أو 10 روابط ضمن تعليقاتهم المزعجة منذ زمن ليس ببعيد وهذا سهّل على المدونيين التعرف على هذه التعليقات ولكن سرعان ما تنبه أصحاب التعليقات المزعجة لهذا الأمر واعتمدوا استخدام رابط أو اثنين ضمن تعليقاتهم. يُمكن تحديد عدد ضمن المربع لإعلام ووردبريس بعدد الروابط التي يُسمح للمُعلق تضمينها قبل تحويل تعليقه للمراجعة.
• عندما يحتوي التعليق على أي كلمة من الكلمات التالية في نص التعليق، اسم المعلّق، الرابط، عنوان البريد الإلكتروني أو في عنوان IP، أو سلسلة وكيل مستخدم المتصفح، سيتم حينها نقل التعليق إلى طابور المراجعة. أضف في كل سطر كلمة واحدة أو عنوان IP، وخذ بالحسبان أنه يتم البحث داخل الكلمات فإذا أضفت الكلمة "بريس" سيتم إرسال كل تعليق يحتوي على الكلمة "ووردبريس" إلى قائمة الانتظار.
•  يُمكن إضافة الكلمات المزعجة الخاصة بمالك الموقع ضمن هذا المربع ليتم ترشيح التعليقات التي يتم نشرها بالاعتماد على محتواه.

مفاتيح التعليقات غير المسموح بها

• عندما يحتوي التعليق على أي كلمة من الكلمات التالية في نص التعليق، اسم المعلّق، الرابط، عنوان البريد الإلكتروني أو في عنوان IP، أو سلسلة وكيل مستخدم المتصفح، سيتم حينها نقل التعليق إلى سلة المهملات. أضف في كل سطر كلمة واحدة أو عنوان IP.
• خذ بالحسبان أنه يتم البحث داخل الكلمات فإذا أضفت الكلمة "بريس" سيتم إرسال كل تعليق يحتوي على الكلمة "ووردبريس" إلى سلة المهملات. يُشابه عمل هذا المربع المربع السابق ولكن بدلا من تحويل التعليقات إلى المراجعة يتم تحويل التعليقات إلى سلة المهملات بدون أي تنبيه.
• يُنصح باستخدام هذا الخيار كملاذ أخير فمن الممكن أن تُحذف تعليقات غير مزعجة.

الصور الرمزية

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

عرض الصورة الرمزية

• السماح بعرض الصور الرمزية - تظهر الصور الرمزية بجانب التعليقات عند تفعيل هذا الخيار.

نوع الصور الرمزية المسموح عرضها

يسمح هذا الخيار بتحديد مستوى الصور التي يُسمح بعرضها على المدونة.

• G — ملائمة للجميع.
• PG — ممكن أن تكون مسيئة، عادة لمن أعمارهم 13 سنة أو أكثر.
• R — موجهة للمراهقين الذين تزيد أعمارهم عن 17 سنة.
• X — للبالغين فقط.

الصورة الرمزية الافتراضية

يُمكن عرض الشعار أو توليد صورة بالاعتماد على عنوان بريدهم الإلكتروني للمستخدم الذي لا يمتلك صورة رمزية خاصة به.

• شخصية غامضة
• فارغ
• شعار موقع Gravatar
• أيقونة (عشوائي)
• وجوه (عشوائي)
• وحوش (عشوائي)
• ريترو (عشوائي)

حفظ التغييرات

لحفظ التغييرات يجب الضغط على خيار حفظ التغييرات حيث يظهر بعدها في أعلى الصفحة نص يؤكد عملية الحفظ مباشرة بعد الضغط عليه.

ترجمة -وبتصرف- للمقال Settings Discussion Screen من موقع ووردبريس.

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

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

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

• تعارض بين إضافتين
• تعارض بين القالب الخاص بك وبين إضافة جديدة أو إضافة محدثّة
• تعارض بين إضافة ونسخة إصدار ووردبريس الحالية للموقع

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

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

كيف تشخص مشكلة تعارض إضافات ووردبريس وتحلَّها

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

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

في هذا القسم ستكتشف مشكلات تعارض الإضافات المعروفة قبل أن تحدث على موقعك.

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

السيناريو الأول: الموقع يعمل لكن الإضافة لا تعمل

إذا كانت إحدى الإضافات على موقعك لا تعمل مطلقًا، أو لا تعمل بكفاءةٍ، لكنك لا تزال قادرًا على الوصول إلى ووردبريس وإلى موقعك، ابحث عن تحديثٍ للإضافة. لعل شيئًا ما متعلقًا ب CSS أو JavaScript فيها تسبب في المشكلة فجأةً. (سنفصِّل في ذلك لاحقًا)

اتّبع المسار المعتاد لتحديث الإضافات، ثم تفقّد الموقع. إذا كانت المشكلة قد حُلّت، فهذا يعني أن المطوّر انتبه للتعارض أو المشكلة العامة وحلّها.

السيناريو الثاني: بعد تحديث إضافةٍ أو تثبيت إضافةٍ جديدةٍ حدثت مشكلة ما

إذا كنت قد ثبتّ للتوّ إضافةٍ جديدةٍ لموقعك أو حدَّثت إضافةً موجودة بالفعل، فمن السهل تحديد سبب المشكلة. لا داعي للقيام بعملية استكشاف لمعرفة السبب.

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

السيناريو الثالث: بعد التحديثات التلقائية أو الدفعية حدثت الكارثة

لا تسئ فهم كلامي: أنا لا أقول أن التحديثات التلقائية للنواة أو القوالب أو الإضافات في ووردبريس أمرٌ سيءٌ. في الواقع، أعتقد أنها حركةٌ ذكيةٌ، بما أن الانسيابية والأتمتة أصبحت من أهم سبل النجاح. ومع ذلك، إذا اخترت التحديث التلقائي على ووردبريس، فكن على علمٍ بأن حلَّ مشكلات تعارض الإضافات قد يحتاج إلى المزيد من الجهد.

هناك مسارين مختلفين عليك اتباع أحدهما، وفقًا لكيفية ظهور الخطأ على الموقع:

حين يصيب القالب أو الإضافة عطلٌ ما، أو تظهر رسالة خطأ

موقعك لا يزال يعمل، (الحمد لله)، وتستطيع الدخول إلى ووردبريس. هذا جيدٌ. إليك ما عليك فعله إذا ما أصاب موقعك عطلٌ كهذا:

1- تفقد أحدث نسخة احتياطية لديك. إذا كانت قد خُزّنت قبل التحديث مباشرة، استعدها، ثم اذهب مباشرة إلى الخطوة 5.

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

3- تفقد موقعك لترى ما إذا كانت المشكلة قد حُلَّت. في تلك الحالة، اعلم أن المشكلة في الإضافة.

4- انتقل من القالب الحالي إلى قالب ووردبريس المبدئي.

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

5- إذا حُلَّت المشكلة عن طريق تبديل القالب، عليك اختبار كل إضافة على حدة.

6- ابدأ بإعادة تفعيل الإضافة الأساسية إذا كان لديك واحدة. هذا في حالة ما إذا كان موقعك متخصص في التجارة الإلكترونية أو الفندقة أو العضويات …إلخ. تأكد من أن موقعك يعمل بلا مشاكل بعد تفعيل تلك الإضافة.

7- فعّل الإضافة التي تظن أنها تُسبّ المشكلة. إذا ظهرت رسالة خطا، فهذا يؤكد أنها بالفعل سبب المشكلة. إذا لم يحدث ذلك، جرب إضافة أخرى.

8- عليك فعل ذلك مع كلِّ إضافةٍ حتى تحدّد أيّها يسبب التعارض. عليك تعطيل كلّ إضافةٍ بعد اختبارها، قبل تفعيل الإضافة التالية. سيقلّل هذا من عدد المتغيرات التي عليك أخذها في الاعتبار في أثناء البحث عن سبب التعارض.

9- حين تعثر على سبب التعارض، عطّله، وبلغ عن المشكلة للمطور في المستودعات أو لفريق الدعم إذا كانت إضافة مدفوعة.

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

حين ترى شاشة الموت البيضاء

شاشة الموت البيضاء مخيفة لكل مستخدمي ووردبريس. رغم ذلك، إذا كان سببها تحديث دُفَعِي (batch update) قمت به مؤخرًا، سيكون الحل سهلًا:

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

2. عطل كل الإضافات. يمكنك فعل ذلك عن طريق تغيير اسم مجلد الإضافات إلى اسم آخر.

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

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

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

كيف تتجنب تعارضات الإضافات في المستقبل

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

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

إذا أردت تجنب هذا العناء، إليك بعض النصائح التي ستساعدك (وتساعد عملاءك) على تجنب تعارض إضافات ووردبريس في المستقبل:

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

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

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

الختام

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

مترجم وبتصرف عن مقال WordPress Plugin Conflicts: How to Check for Them and What to Do بقلم Suzanne Scacca

إن الحصول على المواضيع من قاعدة بيانات الوورد بريس هي إحدى المواضيع المفضلة لدي، وذلك بسبب المرونة الرائعة التي يتيحها صنف WP_Query التي تسمح لنا بالحصول على مانريده، وتُعتبر هذه الطريقة هي إحدى الميزات الأساسية في أنظمة إدارة المحتوى CMS التي نراها عند العمل في الواجهات الأمامية front-end.

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

ماهو استعلام الوورد بريس؟

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

كما ننوّه إلى أن ذكرنا لكلمة استعلام query، أو استعلام وورد بريس wordpress query نقصد بها الاستعلام الذي يقوم باسترجاع بعض المواضيع posts من قاعدة البيانات الخاصة بالوورد بريس.

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

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

وبالتالي نجد أن أي صفحة افتراضية نُحمّلها تحوي في الغالب على استعلام يُجرى تلقائيًا.

الحلقة: كيفية استخدام الاستعلامات

تُعتبر الحلقة طريقة لاستعادة مجموعة من المواضيع معًا، ولكن المسألة الأساسية هنا هي كيفية عرض المواضيع المُسترجعة، حيث أن كل موضوع يستخدم عناصر الإظهار و HTML الخاصة به، مع أنها جميعها تشترك في حلقة واحدة. ببساطة تقوم الحلقة باستخدام آلية خاصة في الوورد بريس تُمكّنها من الانتقال عبر المواضيع المُسترجعة مع تمكين الموضوع من عرضه بطريقته الخاصة.

يمكن شرح هذه الآلية من خلال الأسطر البرمجية:

<?php if ( have_posts() ) : ?>
	<?php while ( have_posts() ) : the_post() ?>
	<div <?php post_class() ?>>
		<h2><?php the_title() ?></h2>
		<?php the_content() ?>
	</div>
	<?php endwhile ?>
<?php else : ?>
	<h2>Ooops, no posts here!</h2>
<?php endif ?>

إن المثال السابق هو مثال مبسط عمّا يمكن إيجاده في أي صفحة تحوي قوائم يوجد داخلها مجموعة من المواضيع، حيث نلاحظ في المثال أن الحلقة تحوي أيضًا على تعليمة if/else .

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

أما تابع ()the_post فإنه هو المسؤول عن معالجة حالة "هل يوجد مواضيع أخرى بعد الموضوع الحال أم لا".

وفي النهاية عند المرور على جميع المواضيع، تُنفّذ تعليمة else وهي إظهار نص محدد قد يشير كما في المثال السابق إلى انتهاء المواضيع.

الآن قبل المتابعة في هذه المقالة، أود توضيح بعض المصطلحات التي مرت معنا، أولا مصطلح الحلقة "the loop" والذي يستخدم لوصف حلقة تمر على قائمة مو المواضيع الموجودة في الصفحة والمنشورة على الوورد بريس، لنستعرض مثالًا توضيحيًا، في حال كان لدينا قسم في المدونة نستعرض فيه المواضيع المتعلقة بمدونتنا والتي نستعرضها في قسم "Related articles on our blog"

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

بناء استعلام مخصص

سنتعلم في هذه الفقرة طريقة بناء استعلام مخصص، لنفترض أننا نريد الحصول على قائمة بالمواضيع الخاصة بمؤلف معين ومُدرجة ضمن فئة معينة. هذا المثال يطرح طريقة برمجية للوصول إليها:

<?php 
$args = array(
	'author_name' => 'danielpataki',
	'category_name' => 'wordpress'
);
$author_posts = new WP_Query( $args );
if ( $author_posts->have_posts() ) : 
?>
	<?php while ( $author_posts->have_posts() ) : $author_posts->the_post() ?>
	<div <?php post_class() ?>>
		<h2><?php the_title() ?></h2>
		<?php the_content() ?>
	</div>
	<?php endwhile ?>
<?php else : ?>
	<h2>Ooops, no posts here!</h2>
<?php endif ?>

يتعامل القسم الأول من التعليمات مع الاستعلام في قاعدة البيانات حيث ترى أنني قمت ببناء غرض WP_Query من خلال تمرير مجموعة من المعاملات arguments، ولكن لاتقلق في حال لست من المهتمين بالبرمجة غرضية التوجه لأننا سنستخدمها بطريقة بسيطة جدًا، حيث مررنا اسم المؤلف من خلال المعامل author_name والفئة المختارة من خلال المعامل category_name.

الآن لترتيب هذه المواضيع ضمن قائمة واحدة نحتاج إلى تعديل الحلقة قليلًا وذلك من خلال استخدام التوابع الخاصة بالغرض WP_Query بدلًا من استخدام التوابع ()have_post و ()the_post وذلك يعني أن نسبق اسم التابع باسم المتغير بالشكل ()variable_name->function$.

مع العلم أنني لن أعرض الحلقة في الأمثلة التالية وذلك لأن الفكرة نفسها ستتكرر دومًا، والآن اسم متغيرنا هو $custom_post  لذلك سنستخدم التوابع ()custom_posts->have_post$ و ()custom_posts->the_post$.

معاملات WP_Query

إن بناء استعلام مخصص يعتمد بالأساس على تغيير المعاملات parameters، ومن الأمثلة على الاستعلامات المخصصة استعلام الحصول على المواضيع من تاريخ محدد، المؤلفين، نمط نشر معين، تصنيفات مخصصة، وحالات وأمور أخرى.

الآن لنلق نظرة على جميع المعاملات من خلال بعض الأمثلة الأساسية البسيطة.

معامل المؤلف Author Parameters

يوجد أربع طرق مختلفة يمكن استخدامها لتجميع المؤلفين، حيث أن المعامل author يقبل رقم تعريفي وحيد لمؤلف محدد، أو قائمة من الأرقام المعرفة للمؤلفين مفصولة عن بعضها بفاصلة، كما يمكن استخدام السالب أمام الأرقام التعريفية للمؤلفين لاستبعادها من ناتج الاستعلام:

// Posts from the author with the ID of 42
$args = array(
	'author' => 42 
);

// All posts except the ones from author 42
$args = array(
	'author' => -42
);

// Posts from author 42, 38 and 55
$args = array(
	'author' => '42,38,55'
);

// Posts from everyone except author 42 and 38
$args = array(
	'author' => '-42,-38'
);

يمكن استخدام المعامل author_name في حال كنا نريد تمرير اسم المؤلف بدلًا من رقمه التعريفي، ولكن من المهم الانتباه إلى استخدام اسم المستخدم username الصحيح.

$args = array(
	'author_name' => 'danielpataki'
);

المعاملان المتبقيان والمتعلقان بالمؤلف هما author_in و author_not_in حيث أُضيف هذين المعاملين في النسخ اللاحقة من الوورد بريس في 3.7 حيث تعرّف المؤلفين من خلال إدخال أرقام المؤلفين على شكل مصفوفة.

// Posts from author 42, 38 and 55
$args = array(
	'author__in' => array( 42, 38, 55 ) 
);

// Posts from everyone except author 42 and 38
$args = array(
	'author__not_in' => array( 42, 38 ) 
);

إن هذه الطريقة لاتبدو مختلفة كثيرا عن استخدام المعامل author ولكن هذه الطريقة أفضل من حيث الطريقة التنظيمية.

حالة استخدام: إعداد قائمة بمقالات المؤلفين الأعلى تصنيفًا

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

<?php 
$args = array(
	'meta_key'     => 'rating',
	'meta_value'   => 4,
	'meta_compare' => '>',
	'fields'       => 'id',
); 
$top_users = get_users( $args );
$args = array(
	'author__in' => $top_users;
); 
$top_author_posts = new WP_Query( $args );
 
?>

معامل الفئة Category Parameters

يمكن تقييد إضافة المواضيع على أساس الفئة باستخدام ما لا يقل عن خمس توابع منفصلة.

إن المعامل cat يشبه المعامل author الذي شرحناه بالأعلى، من حيث إسناد الأرقام الصحيحة والتي تستخدم كمفتاح تعريف للفئة، كما يمكن إضافة إشارة السالب (-) من أجل استبعاد الفئة التي تُعرّف بالرقم الصحيح الذي يلي الإشارة.

// Posts from the category with the ID of 42
$args = array(
	'cat' => 42 
);

// All posts except the ones from category 42
$args = array(
	'cat' => -42
);

// Posts from categories 42, 38 and 55
$args = array(
	'cat' => '42,38,55'
);

// Posts from all categories except 42 and 38
$args = array(
	'cat' => '-42,-38'
);

من الأفضل عدم استخدام category_name وذلك لأن اسم الفئة غالبًا يستخدم في توليد رابط URL الخاص بالمقالة، من خلال استخدام اسم الفئة وعنوان المقالة مع بعض التعديلات الخاصة مثل تحويل جميع الأحرف إلى أحرف صغيرة، وحذف جميع الكلمات الخاصة، واستبدال الفراغات بـ (-)، فمثلًا الفئة المخصصة لمراجعات الكتب والمسماة "Book Reviews" غالبًا ستجد قسم من رابط المقالة يحوي على "book-reviews".

$args = array(
	'category_name' => 'book-reviews'
);

كما يمكننا استخدام مصفوفة من الفئات تحوي ثلاثة معاملات هي category_in، و category_not_in والتي تماثل في طريقة عملها مماثلاتها في معامل author، حيث يمكن من خلالها التأكد من أن المواضيع التي تم تحديدها من خلال الفئات المدخلة فقط هي التي استُرجِعت بواسطة الاستعلام.

$args = array(
	's' => 'awesome+wordpress+plugins',
	'posts_per_page' => 8
);
$results = new WP_Query( $args );

echo "A total of " . $results->found_posts . " posts were found.<br />";
echo "We will be displaying " . $results->query_vars['posts_per_page'] . " posts per page if possible.<br />";
echo "We need a total of " . $results->max_num_pages . " pages to display the results".

حالة استخدام: الحصول على مقالات الفئات الأكثر استخدمًا

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

$args = array(
	'number' => 5,
	'orderby' => 'count',
	'order' => 'DESC',
	'fields' => 'ids'
);
$top_categories = get_terms( array( 'category' ), $args );

$args = array(
	'category__in' => $top_categories;
); 
$top_category_posts = new WP_Query( $args );

معامل الوسم Tag Parameters

يمرر لمعامل الوسم خمس متغيرات هي tag، tag_id، tag_and، tag_in، tag_not_in نلاحظ وجود ثلاث منها ذُكرت مع المعاملات السابقة، وسنشرحها من خلال المثال:

// Posts from the tag named "Awesome Colors"
$args = array(
	'tag' => 'awesome-colors'
);

// Posts from the tag named "Awesome Colors" or "Awesome People"
$args = array(
	'tag' => 'awesome-colors,awesome-people'
);

// Posts from the contain both "Awesome Colors" and "Awesome People"
$args = array(
	'tag' => 'awesome-colors+awesome-people'
);

// Posts from the tag with the ID of 23
$args = array(
	'tag_id' => 23
);

// Posts from tag 42, 38 and 55
$args = array(
	'tag__in' => array( 42, 38, 55 ) 
);

// Posts from all tags except 42 and 38
$args = array(
	'tag__not_in' => array( 42, 38 ) 
);

// Posts that are assigned both tag 42 and 38
$args = array(
	'tag__and' => array( 42, 38 ) 
);

أود أن أشير إلى أمرين، الأول أن نواة الوورد بريس ليست متناسقة تمامًا، فمثلًا معامل category يتوقع أن يمرر لها معرف ID، أما معامل tag و category_name فيتوقع قسم من الرابط، لذلك فالتحدي الذي يواجهك في البرمجة هنا هو أن تجعل المعلومات التي تدخلها دومًا متناسقة قدر الإمكان، مع أنه في بعض الأحيان تُجبر على تخطي بعض هذه القواعد لأسباب قديمة كانت موجودة سابقًا في النواة.

أما الأمر الثاني هو أنه من الأفضل استخدام المصفوفات في حال كان ذلك مسموحًا، فمثلًا على الرغم من أن معامل tag يتيح لك إدخال متغيرات متعددة ولكن من الأفضل استخدام  tag_in والمتغيرات الأخرى التي تسمح بتمرير القيم على شكل مصفوفة.

ولتسهيل الأمور أكثر في التعامل مع الوسوم يوجد أيضًا معاملين آخرين هما tag_slug_and و tag_slug_in ويكون التعامل معها بالشكل التالي:

// Posts from the tag named "Awesome Colors" or "Awesome People"
$args = array(
	'tag_slug__in' => array( 'awesome-colors', 'awesome-people' )
);

// Posts from the contain both "Awesome Colors" and "Awesome People"
$args = array(
	'tag_slug__and' => array( 'awesome-colors', 'awesome-people' )
);

حالة استخدام: الدمج بين معاملات الوسم، الفئة، المؤلف

بما أننا تعرفنا على بعض المعاملات يمكننا الدمج فيما بينها ضمن استعلام واحد، على سبيل المثال لنجمع المقالات المتميزة (التي أُضيف لها وسم "featured") لمؤلفين محددين وذلك في فئتي الكتب والأفلام.

$args = array(
	'tag' => 'featured',
	'category__in' => array( 43, 52 ),
	'author__in' => array( 255, 930 )
);
$author_featured_posts = new WP_Query( $args );

أنواع المواضيع Post Type

تحوي الوورد بريس على عدد من أنواع المواضيع المبنية داخله بالأساس وهي موضوع post، الصفحة page، مرفقات attachment، مراجعة revision، و عنصر قائمة التنقل، ولكن أصبح من الشائع إضافة أنواع أخرى عند إدارة المشاريع مثل الأعمال، المنتجات، المنتديات وهكذا بحسب مايحتاجه المشروع من أنواع.

يسمى المعامل المخصص للتعامل مع أنواع المواضيع الجديدة post_type والذي يساعدنا في تحديد النوع الذي ينتمي له الموضوع المُراد نشره.

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

// Return posts with the 'page' post type
$args = array(
	'post_type' => 'page'
);

// Return posts from two custom post types
$args = array(
	'post_type' => array( 'product', 'post' )
);

// Returns posts from all post types
$args = array(
	'post_type' => 'any'
);

مع العلم أنه هذا المعامل له قيمة افتراضية هي post، ولذلك في حال كنت ترغب في استعادة أنواع أخرى من المنشورات عليك تحديدها بشكل واضح.

في حال استخدام المعامل tax_query (سنتكلم عنه لاحقًا) ستصبح القيمة الافتراضية هي any.

حالة المنشور Post Status

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

تحوي الوورد بريس على ثماني حالات مبنية في النواة هي:

• publish الموضوع Post أو الصفحة page منشورة
• pending الموضوع قيد الانتظار للمراجعة
• draft الموضوع حُفظ كمسودة
• auto-draft الموضوع المُنشأ حديثًا ولكن بدون محتوى
• future موضوع سينشر في المستقبل
• private ليس معروضًا أمام المستخدمين غير المسجلين الدخول
• inherit مراجعة (له علاقة بـ get_children)
• trash الموضوع في سلة المهملات (هذه الحالة متاحة في النسخة رقم 2.9)

يمكننا أيضًا استخدام القيمة any لنقول بأننا نريد تضمين جميع حالات الموضوع، أما القيمة الافتراضية فهي Publish لذلك من الأفضل أن تتأكد بأنك حددت الحالة في حال كنت ترغب بحالة مختلفة.

حالة استخدام: الإعلان عن المنتجات القادمة

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

في هذه الحالة لاتحتاج إلى نشر الكتب على شكل مواضيع ثم استخدام بعض الخدع لتستثنيها من العرض حتى يُؤمّن ويستطيع المستخدم طلبها، يمكنك فقط ترتيب قائمة مباشرة بها بالشكل التالي:

$args = array(
	'post_status' => 'future',
	'post_type' => 'product',
	'category_name' => 'books'
);

معامل البحث The Search Parameter

يسمى المعامل الخاص بعملية البحث s، ويأخذ قيمة نصية string هي نفسها المُستخدمة في عملية البحث داخل الموضوع. ولكن يجب تأكد من ترميز العبارة النصية المُستخدمة في البحث، حيث يمكنك القيام بذلك من خلال استخدام التابع urlencode الموجود في PHP والذي يساعدك في تحديد عدد الفراغات والمحارف الخاصة الأخرى وتحويل العبارة إلى كلمات يمكن البحث عنها.

$args = array(
	's' => 'awesome+wordpress+plugins'
);

حالة استخدام: البحث في موضوع فرعي

يمكن البحث في المحتوى كاملًا من خلال شريط البحث الافتراضي الموجود في الوورد بريس باستخدام المعامل s، ولكن يمكن أن يبحث بطريقة أكثر مهنية من خلال الدمج بين معامل البحث والمعاملات الأخرى، سنطرح في المثال التالي طريقة للبحث في مواضيع فرعية متعددة:

// Show posts about ACF (Advanced Custom Fields) from the news category
$args = array(
	's' => 'ACF',
	'category_name' => 'news'
);

// Search an author's posts
$args = array(
	's' => 'custom post types',
	'author_name' => 'danielpataki'
);

// Search an array of custom post types
$args = array(
	's' => 'wordpress',
	'post_type' => array( 'project', 'portfolio' )
);

المواضيع المحمية بكلمة مرور

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

في جميع الحالات التي تجعلك ترغب بإضافة كلمة مرور للموضوع الخاص بك، يمكنك استخدام المعامل has_password لتحديد فيما إذا كنت ترغب بإدراج الموضوع إلى قائمة المواضيع المحمية بكلمة المرور.

يمكن أن يُمرَّر للمعامل has_password قيمة true عندها سيقوم الاستعلام بجمع المواضيع التي تم إعطاؤها كلمة مرور، أو قيمة false وبذلك يختار الاستعلام المواضيع التي لم تُزود بكلمة مرور، ولكن في حال كانت قيمة المعامل محذوفة أو تم إسناد null لها عندها ستُنشر جميع المواضيع.

كما يمكن استخدام المعامل post_password من أجل إعداد قائمة بالمواضيع المحمية بكلمة مرور محددة.

// Return only password protected posts
$args = array(
	'has_password' => true
);

// Return posts protected with the password: qweasd
$args = array(
	'post_password' => 'qweasd'
);

حالة استخدام: لعبة صيد الكنز أونلاين

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

$args = array(
	'post_type'    => 'clue',
	'post_password' => 'treasurehunt2015'
);

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

تضمين، استبعاد، واستهداف مواضيع محددة

يوجد تسعة معاملات مختلفة تُستخدم للحصول على مواضيع معينة في الاستعلام:

• المعامل p: يُستخدم في تجميع المواضيع بالاعتماد على معرف الموضوع ID.
• المعامل name: يُستخدم في تجميع تجميع المواضيع من خلال تمرير slug كقيمة نصية له.
• المعاملين page_id و page_name: الأول يشبه معامل p والثاني يشبه name ولكنها تعمل بالنسبة للصفحات، مع بعض الاختلاف بينهما.
• حيث سيعملان بشكل متشابه تمامًا في حال تم تحديد قيمة للمعامل post_type أما في حال عدم تحديد هذه القيمة فإن معامل page_id سيعمل كما هو مُتوقع منه على عكس معامل p
• المعاملين post_in و post_not_in: تعمل بنفس الطريقة التي تعمل بها شبيهاتها مع الفئات والوسوم حيث تقبل تمرير مصفوفة من مُعرِّفات المواضيع.
• المعامل post_parent: يأخد معِّرف وحيد عندها يقوم الاستعلام بإعداد قائمة بالمواضيع التي تكون أبناء تابعة للموضوع المُحدد بالمعرف المذكور.
• المعاملين post_parent_int و post_parent_not_int: كما في شبيهاتها يُمرَّر لها مصفوفة من معرِّفات المواضيع.

من المهم الأخذ بالحسبان نوع المنشور post_type عند التعامل مع هذه المعامل، ففي حال قمت بتضمين المُعرِّفات لمجموعة من أنواع المواضيع عندها ستحتاج لتمرير القيمة any للمعامل post_type، أو تدخل النوع المحدد الذي تبحث عنه.

// Grab post 532 only
$args = array(
	'p' => 532
);

// Grab the post with the given slug
$args = array(
	'name' => 'guide-to-wp-query'
);

// Retrieve page 55
$args = array(
	'page_id' => 55
);

// Retrieve the about page
$args = array(
	'pagename' => 'about'
);

// Get the specified 5 posts
$args = array(
	'post__in' => array( 31, 36, 39, 91, 119 )
);

// Get all posts except the specified 5 
$args = array(
	'post__not_in' => array( 31, 36, 39, 91, 119 )
);

// Get all child posts of post 6
$args = array(
	'post_parent' => 6
);

// Get posts which are the children of the listed posts
$args = array(
	'post_parent__in' => array( 6, 23, 55 )
);

// Get posts which do not have the listed parents
$args = array(
	'post_parent__not_in' => array( 6, 23, 55 )
);

حالة استخدام:  الوصول إلى جميع المرفقات في الموضوع

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

global $post;
$args = array(
	'post_parent' => $post->ID,
	'post_type' => 'attachment',
	'post_status' => 'any'
);

استعلامات التصنيف

بعد أن تعرفنا بشكل مفصل عن المعاملات المُستخدمة في الاستعلام وكيفية التعامل معها، يمكننا الانتقال إلى موضوع متقدم أكثر هو tax_query.

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

سنأخذ نظرة عامة في المثال المقتبس من WordPressCodex:

$args = array(
	'post_type' => 'post',
	'tax_query' => array(
		array(
			'taxonomy' => 'movie_genre',
			'field'    => 'slug',
			'terms'    => array( 'action', 'comedy' ),
		),
		array(
			'taxonomy' => 'actor',
			'field'    => 'id',
			'terms'    => array( 103, 115, 206 ),
			'operator' => 'NOT IN',
		),
		'relation' => 'AND',
	),
);

يحوي استعلام التصنيف على شرطين condition وعلاقة relation، وهذه العلاقة هي التي تحدد إما أنه يجب أن يتحقق شرط واحد على الأقل (OR) أو يجب تحقيق كلا الشرطين (AND)، أما بالنسبة للشرطين نفسهما فإنهما عبارة عن مصفوفات تحدد فيها قيود التصنيف.

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

يحوي كل شرط في استعلام التصنيف على ثلاثة معاملات خاصة به هي:

• taxonomy : يُحدَّد من خلاله المقطع slug الخاص بالتصنيف.
• field : يمكن من خلاله الاختيار فيه بين المعاملات الثلاثة وهي term_id، أو name أو slug.
• operator : يستخدم لتحديد كيفية التعامل مع المصطلحات المتواجدة في الشرط، حيث IN سيسمح لأي من المواضيع التي تنتمي لأي من الشروط المدرجة بالتواجد في القائمة النهائية، أما NOT IN سيسمح لأي من المواضيع التي لاتتضمن أيًا من الشروط المدرجة، أما AND فسيسمح للمواضيع التي تحقق جميع الشروط المدرجة.
• Include_children : يحدد فيما إذا كان بالإمكان السماح  أو عدم السماح بتضمين المواضيع التي تنتمي للتصنيف الابن في التصنيفات الهرمية

حالة استخدام: تصفية محتوى متقدمة

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

$args = array(
	'post_type' => 'book',
	'tax_query' => array(
		array(
			'taxonomy' => 'mood',
			'field'    => 'slug',
			'terms'    => array( 'negative', 'bad', 'sad' ),
			'operator' => 'NOT IN'
		),
		array(
			'taxonomy' => 'genre',
			'field'    => 'slug',
			'terms'    => array( 'comedy', 'romance' ),
			'operator' => 'NOT IN',
		),
		'relation' => 'AND',
	),
);

في هذه الحالة بالتحديد يريد المستخدم النظر إلى جميع الكتب التي تحوي أفكار إيجابية(التي لاتحوي على وسوم سلبية تم إعطاؤها إياها) ولكن لايمكن أن تكون مُصنفة ككتب كوميدية أو رومانسية.

الاستعلامات من نمط Meta Query

تشبه بنية الاستعلام من نمط Meta query استعلام التصنيف. حيث يُسمح للاستعلام عن المواضيع بالاعتماد على القيم الخاصة بها من الجداول التعريفية الأساسية الخاصة بالوورد بريس meta table. يقدم الوورد بريس أربع معاملات يمكن استخدامها هي meta_key، meta_value، meta_value_num، و meta_compare ولكن يمكن استبدالها بالمعامل meta_query وهو الأفضل. لنلق نظرة على المثال:

$args = array(
	'post_type'  => 'book',
	'meta_query' => array(
		array(
			'key'     => 'pages',
			'value'   => 500,
			'compare' => '>',
			'type' => 'NUMERIC'
		),
	),
);

في هذا المثال يقوم استعلام meta query باسترجاع الكتب التي عدد صفحاتها أكثر من 500 صفحة. يُعتبر هذه الطريقة أسهل بكثير من استخدام استعلام التصنيف.

لنتعرف أكثر على المعاملات الفرعية الموجودة في المثال السابق:

• key: مفتاح الحقل المُدخل
• value: القيمة التي نبحث عنها
• compare: نوع عملية المقارنة ويمكن أن تكون أحد قيم المساواة(=)، اللامساواة (!=) أكبر (>)، أكبر أو يساوي (>=)، أصغر (<)، أصغر أو يساوي (<=)، يشابه (LIKE)، لايشبه(NOT LIKE)، داخل(IN)، ليس ضمن (NOT IN)، بين (BETWEEN)، ليس بين (NOT BETWEEN)، موجود (EXISTS)، وليس موجود (NOT EXISTS).
• type: نوع البيانات الموجودة في الحقل. ومن الممكن نوع القيمة ‘NUMERIC‘, ‘BINARY‘، ‘CHAR‘، ‘DATE‘، ‘DATETIME‘، ‘DECIMAL‘، ‘SIGNED‘، ‘TIME‘، ‘UNSIGNED‘.

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

حالة استخدام: المواضيع المُرفقة بصور مميَّزة

يوجد الكثير من الطرق لاستخدام استعلام meta queries. من أهم الأمثلة عليه هي جمع المواضيع التي تحوي صور مميزة. كل معرف ID للصور المميزة يخزّن في أحد الجداول التعريفية الأساسية للوورد بريس باسم _thumbnail_id ويمكن من خلال استعلام meta query للبحث عن المواضيع التي تكون فيها قيمة هذا المفتاح المعرف meta key الذي لايكون فارغًا.

$args = array(
	'meta_query' => array(
		array(
			'key'     => '_thumbnail_id',
			'value'   => '',
			'compare' => '!=',
		),
	),
);

استعلامات التاريخ

تشبه طريقة عمل استعلامات التاريخ استعلامات meta queries، حيث تقدم WP_Query ثمانية معاملات لتضيق قائمة المواضيع بالاعتماد على التاريخ ويمكن تعويضها جميعًا بمعامل date_query وسنشرحه بتفصيل بسبب أهميته وكثرة استخدامه.

لنتعرف أولًا على المعاملات الخاصة بالتاريخ، والمقتبسة من WordPressCodex:

• year - وهي عبارة عن السنة مؤلفة من 4 أرقام مثل 2011.
• month - رقم الشهر من 1 إلى 12.
• week - رقم الأسبوع ضمن السنة من 0 إلى 53.
• day - رقم اليوم ضمن الشهر من 1 إلى 31.
• hour - الساعة من 0 إلى 23.
• minute - الدقيقة من 0 إلى 59.
• second - الثانية من 0 إلى 59.
• after - التاريخ الذي نريد استرجاع المواضيع بعده. حيث يمرر التاريخ من خلال ()strtotime والذي يمكن أن يأخذ التاريخ كقيمة نصية أو من خلال مصفوفة تحوي القيم السنة ‘year‘، الشهر ‘month‘، واليوم ‘day‘ على النحو التالي:
• • year – تقبل السنة بصيغة الأربع أرقام ولكن القيمة الافتراضية هي أن تكون فارغة.
  • month - الشهر من السنة ويقبل الأرقام من 1 إلى 12 والقيمة الافتراضية هي 12.
  • day - هو اليوم من السنة وتأخذ قيمة من 1 إلى 31 أما القيمة الافتراضية هي آخر يوم من الشهر.
• before - التاريخ الذي نريد استرجاع المواضيع التي قبله. حيث يمرر التاريخ من خلال ()strtotime والذي يمكن أن يأخذ التاريخ كقيمة نصية أو من خلال مصفوفة تحوي القيم السنة ‘year‘، الشهر ‘month‘، واليوم ‘day‘ على النحو التالي:
• year – تقبل السنة بصيغة الأربع أرقام ولكن القيمة الافتراضية هي أن تكون فارغة.
• month - الشهر من السنة ويقبل الأرقام من 1 إلى 12 والقيمة الافتراضية هي 1.
• day - هو اليوم من السنة وتأخذ قيمة من 1 إلى 31 أما القيمة الافتراضية هي 1.
• inclusive - تستخدم مع before/after من أجل تحديد فيما إذا كانت قيمة التاريخ متضمنة ضمن المجال أو لا.
• compare -يمكن الإطلاع على ()WP_Date_Query::get_compare.
• column - القيمة الافتراضية له post_date.
• relation - وتأخذ إحدى القيمتين OR أو AND والتي تحدد كيف ستتعامل المصفوفات الفرعية فيما بينها لإتمام عملية المقارنة، والقيمة الافتراضية له هي AND.

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

// Return all posts from 2014
$args = array(
	'date_query' => array(
		array(
			'year'  => 2014,
		),
	),
);

// Return all posts from January 2015
$args = array(
	'date_query' => array(
		array(
			'year'  => 2015,
			'month' => 1
		),
	),
);

// Return all Valentine's Day posts, regardless of year:
$args = array(
	'date_query' => array(
		array(
			'month' => 2
			'day' => 14
		),
	),
);

وللتحكم أكثر بالنطاق الزمني يمكن استخدام المعاملين before و after، ولكنك تحتاج لتحديد السنة، الشهر، واليوم كعناصر في المصفوفة الفرعية. كما يمكن استخدام المعامل inclusive لتحديد حدود النطاق الزمني بشكل دقيق أكثر.

$args = array(
	'date_query' => array(
		array(
			'after'     => 'January 1st, 2013',
			'before'    => array(
				'year'  => 2013,
				'month' => 2,
				'day'   => 28,
			),
			'inclusive' => true,
		),
	),
);

سيعيد هذا المثال المأخوذ من Codex كل المواضيع المنشورة بين الأول من كانون الثاني عام 2013 و الثامن والعشرين من شباط عام 2013. وبما أن القيمة الممررة للمعامل inclusive هي true فستكون المواضيع المنشورة في التواريخ الحدودية مُتضمَّنة في النتيجة.

إن وظيفية التاريخ هنا تعتمد على صنف WP_Date_Query، لذلك أقترح الإطلاع أكثر على الموضوع.

حالة استخدام: المنشورات الموسمية السابقة

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

المثال القصير التالي سيضيف موضوعا خاصا بخدعة الأول من نيسان:

$args = array(
	'date_query' => array(
		array(
			'month' => 4,
			'day' => 1
		),
	),
);

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

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

المعامل paged هو أحد المعاملات المستخدمة بكثرة حيث يحدد أي صفحة يمكن عرض نتائجها. ويمكن ربطها مع المعامل posts_per_page. مثلًا إذا تم عرض 10 مواضيع في الصفحة وأُسنِد للمعامل paged القيمة 4 فستعدل قيمة 4 إلى 10.

المعامل nopaging يسمح لك بتجاهل ترقيم الصفحات بشكل كلي إذا عدلت قيمته إلى true.

كما يوجد معامل offset والذي يعمل كما في MySQL حيث تزاح المواضيع المسترجعة من خلال القيمة الممرة للمعامل وبالتالي ستكسر قاعدة ترقيم الصفحات مالم تكن تعرف ماتفعله، وسنشرح عن هذا الموضوع بشكل بسيط.

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

يحدد المعامل posts_per_archive_page عدد الصفحات التي توجد في صفحات الأرشيف، والتي ستكون هي الصفحات التي تُعطى القيمة true للتوابع ()is_archive و i()s_search، مع العلم أن هذا المعامل لايُستخدم مع معامل posts_per_page.

أخيرًا، المعامل page يُظهر المواضيع التي عادةً ما تظهر فقط في الصفحة X من الصفحة الأمامية الثابتة.

$args = array( 
	'posts_per_page' => 20, 
	'offset' => 2,
	'ignore_sticky_posts' => true
);

يعيد المثال في الأعلى المواضيع العشرين الثانية (كانت قيمة الإزاحة 2) من قاعدة البيانات مع تجاهل المواضيع المثبتة.

ترتيب النتائج

إن ترتيب النتائج هو بنفس أهمية استرجاع النتائج. ويمكن التحكم في ترتيب النتائج من خلال معاملين هما order و orderby.

إن معامل orderby يحدد ترتيب المواضيع التي ستُستعاد. ويوجد لدينا العديد من الخيارات منها:

• none - لايوجد ترتيب وهو القيمة الافتراضية في MySQL
• ID - ترتيب المواضيع من خلال المفتاح المعرف
• author - ترتيب المواضيع بحسب معرف المؤلف
• title - ترتيب المواضيع بحسب العنوان
• name - ترتيب المواضيع بالاعتماد على slug
• type - ترتيب المواضيع بحسب نوع الموضوع
• date - ترتيب المواضيع بحسب التاريخ
• modified - ترتيب المواضيع بالاستناد إلى تاريخ آخرت تعديل
• parent - ترتيب المواضيع بالاستناد إلى معرف الأب
• rand - ترتيب عشوائي للمواضيع
• comment_count - ترتيب المواضيع بحسب عدد التعليقات على الموضوع
• menue_order - ترتيب المواضيع بحسب ترتيب الصفحات
• meta_value - ترتيب المواضيع بالاستناد إلى القيمة meta value
• meta_value_num ترتيب المواضيع بالاستناد إلى القيمة الرقمية ل meta value
• post_in الحفاظ على الترتيب المدخل في هذا المعامل

تقريبًا جميع هذه المعاملات تشرح نفسها بنفسها، ولكن لنتعمق أكثر في طريقة ترتيب المواضيع باستخدام meta value. للقيام بهذا العمل، علينا أول تحديد معامل meta_key كما يعرّفه الوورد بريس بأنه المفتاح الذي يحوي قيمة meta value، ولكن يجب عليك الاهتمام بتحديد النمط الصحيح عند الترتيب وإلا فإننا سنحصل على نتائج غير مُتوقعة.

مع الملاحظة أنه في في حال كنا نرتب معلومات رقمية عندها سنستخدم المعامل meta_value_num بدلًا من meta_value.

ويمكن أيضًا استخدام المعامل meta_type الذي يسمح لنا بتحديد نوع البيانات.

إن المعامل order يحدد اتجاه الترتيب ففي حال كانت القيمة المُمررة له هي ASC عندها ستكون نتيجة الترتيب تصاعديًا، فيما ستكون نتيجة الترتيب تنازلية في حال كانت قيمة المعامل DESC ، والآن لنلق نظرة على المثال التالي الذي يعطينا نظرة عملية عن طريقة الترتيب:

// Reverse order by post title
$args = array(
	'post_type' => 'post',
	'orderby' => 'title',
	'order' => 'DESC'
);

// List specific posts, preserve given order
$custom_posts = array( 56, 928, 2271, 22, 491, 883 );
$args = array(
	'post_type' => 'any',
	'post__in' => $custom_posts,
	'orderby' => 'post__in',
);

// Order by meta data (grab posts with thumbnails first)
$args = array(
	'post_type' => 'post',
	'meta_key' => '_thumbnail_id',
	'orderby' => 'meta_value',
	'order` => 'DESC'
);

ولتوخي الدقة في المعلومات فإن خيار الترتيب باستخدام عدة أعمدة كان على شكل تمرير قيم منفصلة في نسخ الوورد بريس التي سبقت الإصدار 4.0 ولكن من الإصدار 4.0 ومافوق، حُسّن الأمر من خلال استخدام مصفوفة يمكن تحديد طريقة الترتيب من خلالها بشكل منفصل:

$args = array(
	'orderby' => array( 'title' => 'DESC', 'menu_order' => 'ASC' )
);

حالة استخدام: ترتيب المنتجات حسب السعر

تتطلب نماذج مواقع التجارة الالكترونية طريقة لترتيب المنتجات بحسب السعر. سنبحث في المثال التالي عن المنتجات التي يتجاوز سعرها 20 دولارًا وترتيبها في قائمة حسب السعر من الأدنى إلى الأعلى:

$args = array(
	'meta_query' => array(
		array(
			'key'     => 'price',
			'value'   => '20',
			'compare' => '>=',
		),
	),
	'post_type' => 'product',
	'meta_key' => 'price',
	'orderby' => 'meta_value_num',
	'order` => 'ASC'
);

القيم المُسترجعة

يبدو أن المعامل fields ليس معروفًا بشكل جيد، بالرغم من أنه أحد الميزات الهامة في الاستعلامات التي تسمح بحمل القيم المُسترجعة من الاستعلامات بسهولة، وذلك من خلال تمرير قيمتين لهذا المعامل.

في حال حذف المعامل fields فستُسترجع البيانات من الاستعلام بالطريقة المُعتادة، أما في حال ممرنا القيمة ids لهذا المعامل فستكون النتيجة المُرجعة من الاستعلام على شكل مصفوفة تحوي أرقام المعرفات الخاصة بالمواضيع post IDs، وفي حال كانت قيمة المعامل هي id=>parent عندها ستكون النتيجة المُرجعة من الاستعلام هي مصفوفة ولكنها تحوي أرقام المعرفات الخاصة بالآباء المرتبطة بالعلاقة المذكورة في الاستعلام.

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

حالة استخدام: إضافة معرض صور برمجيًا

لنفترض أننا نريد إضافة معرض خاص بالصور التي مرت في الموضوع بعد الانتهاء من عرضه، سنقوم بعمل ذلك من خلال الاستعلام التالي:

// Programmatically placing a gallery shortcode
global $post;
$args = array(
	'post_parent' => $post->ID,
	'post_type' => 'attachment',
	'post_status' => 'any',
	'fields' => 'ids'
);
$images = new WP_Query( $args );
$image_id_string = implode( ',', $images );
echo do_shortcode( '[gallery ids="' . $image_id_string . '"]' );

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

الإذن Permission

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

$args = array(
	'post_status' => array( 'publish', 'private' ),
	'perm'        => 'readable',
);

التخزين المؤقت Caching

هذه أحد التحسينات المتقدمة التي تسمح بالتحكم بطريقة التخزين المؤقت التي  تستخدمها الاستعلامات. بشكل عام إن تخزين نتاج الاستعلام بشكل مؤقت يعتبر فكر جيدة لأن لديها فرصة كبيرة في استخدمها عدة مرات في نفس الصفحة.

مثلا قائمة بأفضل 10 مواضيع على الأغلب لن تتغير من استعلام إلى آخر وبالتالي يمكن الاستفادة من تخزينها.

يوجد حالتين يمكن فيها التحكم بهذا التخزين المؤقت. إذا قمت بتخزين قائمة ولاتحتاج إلى البيانات الأساسية منها metadata أو إلى تصنيفها يمكن أن تستخدم المعاملين update_post_meta_cache و update_post_term_cache وذلك لإيقاف التخزين المؤقت الخاص به. كما أنه في حال كنت تقوم باستعلام لمرة وحيدة من أجل اختبار ما سريع يمكن استخدام المعامل cache_results لإيقاف تخزين  نتايج الموضوع نفسه.

// Do not cache results
$args = array(
	'posts_per_page' => -1,
	'cache_results'  => false
);

// Don't cache taxonomy data
$args = array(
	'posts_per_page' => 10,
	'update_post_term_cache'  => false
);

قمت في هذا المثال ببناء جدول تصدير سريع لجميع المواضيع المتواجدة في قاعدة البيانات تحوي جميع معرفات المواضيع، عناوينها، الفئات، والوسوم المُسندة إليها، حيث أن تخزين هذا الاستعلام ذو الاستخدام لمرة واحدة غير منطقي، فما الفائدة من تخزين بيانات بدائية meta date عن 8000 موضوع أو أكثر.

خصائص استعلامات الوورد بريس WP_Query

حتى الآن كنا نتكلم عن المعاملات التي يمكن تمريرها لاستعلام WP_Query، ولكن الآن سنتكلم عنه كصنف Class وسنشرح الخصائص properties و التوابع methods التي يمكن أن نتعامل معها.

يحوي WP_Query Properties Documentation على شرح وافٍ لجميع الخصائص الخاصة بهذا الصنف، ولكن سنتحدث هنا عن أكثر الخصائص فائدة وكيفية الاستفادة منها.

لنبدأ أولًا بالخاصية $found_posts التي تحمل قيمة عدد المواضيع التي تم العثور عليها كإجمالي ناتج الاستعلام المدخل.

أما الخاصية $post_count فإنها تحمل عدد المواضيع التي تظهر حاليًا، وهي قيمة غير ثابتة منذ استخدم ترقيم الصفحات، فمثللًا يمكن أن يكون هناك 52 موضوع أوجده الاستعلام ولكن تعرض 10 فقط في الوقت الحالي. كما أنه يجب الانتباه إلى أن القيمة التي يحملها $post_count ليس من الضروري أن تكون نفسها الموجودة في post_per_page فعلى سبيل المثال إذا وُجد 52 موضوع وكانت كل صفحة تعرض 10 مواضيع في المرة الواحدة ستكون الصفحة الأخيرة تحوي موضوعين فقط .

أخيرًا سنتحدث عن الخاصية $max_num_pages والتي تحمل عدد الصفحات التي نحتاجها لإظهار النتائج، وهي عمليًا ناتج العملية $found_posts\$posts+per_page ويقرّب الناتج إلى أكبر قيمة صحيحة.

$args = array(
	's' => 'awesome+wordpress+plugins',
	'posts_per_page' => 8
);
$results = new WP_Query( $args );

echo "A total of " . $results->found_posts . " posts were found.<br />";
echo "We will be displaying " . $results->query_vars['posts_per_page'] . " posts per page if possible.<br />";
echo "We need a total of " . $results->max_num_pages . " pages to display the results".

توابع استعلامات الوورد بريس WP_Query Methods

بما أننا نتكلم عن الأصناف فإن الخصائص تشابه بشكل كبير المتغيرات، والتوابع methods تشبه أيضًا الدوال functions. يمتلك استعلام الوورد بريس العديد من التوابع رغم أنك لاتحتاج إلى استخدامها مباشرة بشكل عام. ولكن أهم تابعين ذكرناهما في الأعلى هما ()have_post و ()the_post.

بعض التوابع الأخرى المفيدة هي ()rewind_posts والذي يعيد ضبط الحلقة ويمكن استخدامها في حال مثلًا كان الخرج عبارة عن قائمتين متماثلتين تمامًا في مكانين مختلفين.

بالنسبة للتوابع ()get و ()set ستسمح لك بالوصول إلى متغيرات الاستعلام ولانستخدمها إلا في حالات قليلة جدًا.

لمزيد من المعلومات حول توابع استعلام الوورد بريس، يمكن الإطلاع على Method Documentation.

سلامة البيانات: التحقق Validating، التنظيف Sanitizing، والتهريب Escaping

تقترن بعض الاستعلامات المخصصة مع واجهات المستخدمين. والسيناريو الأمثل لضمان سلامة المعلومات هو إضافة فلتر مخصص يتحكم بصلاحيات الوصول للمستخدم للمواضيع. يمكن الإطلاع على المزيد من المعلومات في المقالة Adding Post Filters To Your WordPress Site.

وفي حال كنت تملك مكان من الواجهة يستطيع المستخدم فيه إدخال بيانات ما، فيجب دوما التحقق وتهريب البيانات المدخلة لمنع الهجومات التي تحصل على قاعدة البيانات. ويمكن الإطلاع على معلومات أكثر في المقالة   Validating, Santitizing And Escaping User Data.

تعديل استعلامات SQL

يوجد عدد من الفلاتر التي تسمح لك بالنفاذ إلى استعلامات SQL الفعلية والتي تُنفّذ بناء على استعلامات WP_Query. وغالبًا لا نستخدم هذه الفلاتر لذلك من الأفضل أن تتعامل مع المعاملات التي ذكرناها سابقًا.

تسمح الفلاتر مثل posts_where و posts_join بتعديل شروط معينة في استعلام SQL بينما تكون استعلامات الوورد بريس أكثر مرونة ولكنها لاتسمح بوجود شروط معقدة بعد WHERE بما في ذلك التصنيفات المتعددة أو العلاقات المتعددة. في هذه الحالة يمكن استخدام الفلاتر التي ذكرناها.

يمكن الإطلاع على WP_Query Filters للمزيد من المعلومات.

الخلاصة

أرجو أن تكون قد كونت فكرة أفضل عن صنف استعلام الوورد بريس WP_Query Class، وكيفية الحصول على المعلومات التي نريدها عبر بناء قوائم من المواضيع، كما يمكنك الدمج بين أنواع المواضيع المختلفة، التصنيفات والبيانات الأساسية لبناء نظام إدارة محتوى قوي.

إذا كنت مهتمًا ببرمجة الوورد بريس، يوجد مجموعة من الأصناف التي تعمل بشكل مشابه لصنف WP_Query مثل صنف WP_Comment_Query الذي يُستعمل لتجميع التعليقات بنفس الطريقة التي يعمل بها صنف WP_Query. كما أن صنف WP_Meta_Query يتعامل مع الاستعلامات الأساسية meta_queries، بينما يتعامل صنف WP_Date_Query مع كل حدود التواريخ.

ترجمة -وبتصرّف- للمقال An In-Depth Guide to Conquering WP_Query لصاحبه Daniel Pataki

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

فهم الخطأ 404

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

الصفحة الافتراضية للخطأ 404

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

ملف 404.php

<?php get_header(); ?>


<h2>Error 404 - Page Not Found.</h2>


<?php get_sidebar(); ?>

<?php get_footer(); ?>

التعليمات البرمجية السابقة ستقوم بإظهار مخرجات بسيطة، ضمن وسم h2. كما تستدعي أيضًا رأس الموقع (header)، الشريط الجانبي (sidebar)، وتذييل الموقع (footer) وكل هذه العناصر افتراضية ويمكنك تعديلها طبعًا لتناسب القالب الذي تقوم بتصميمه.

العمل على قالب الصفحة

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

ملف 404 – مع إضافة مربع البحث

<?php get_header(); ?>

<h2>Error 404 - Page Not Found.</h2>

Search:

<?php include(TEMPLATEPATH . "/searchform.php"); ?>

<?php get_sidebar(); ?>

<?php get_footer(); ?>

جعل الصفحة أكثر ديناميكية

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

<?php if (is_404()) { $redirectHome = get_option('home'); ?>
<?php echo $redirectHome; ?>

بعد إضافة هذه التعليمات، سنقوم الآن بتعديل ملف 404.php ليصبح بالشكل التالي:

<?php get_header(); ?>

<h1>Error 404 - File Not Found.</h1>

<h3>Please <a href="<?php bloginfo('home'); ?>" Click here</a> to return to our home page, or you can wait to be redirected in 15 seconds.</h3>

<?php get_footer(); ?>

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

التأكد من عمل الصفحة

يمكن التأكد أن صفحة 404 تعمل بكتابة رابط موقعك وإلحاقها بعنوان صفحة أو مقال تعرف أنه غير متواجد في موقعك.
مثال: http://www.yourwebsitedomain.com/test404page.php

إذا لم تعمل

إذا لم يتم توجيهك إلى الصفحة هذا يعني أنه علينا تعديل ملف htaccess. على الخادم (server) كي نجعل صفحة 404 تعمل ابحث عن ملف htaccess. في تنصيب ووردبريس الخاص بك وأضف السطر التالي له:

ErrorDocument 404 /index.php?error=404

لكن إذا لم يكن تنصيب الووردبريس في المجلد الجذر للخادم الخاص بك يجب الإشارة إلى المجلد الفرعي الذي نصبت عليه ووردبريس:

ErrorDocument 404 /YOURSUBFOLDERNAME/index.php?error=404

هذا سيجبر الخادم على استخدام ملف 404.php

مثال كامل

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

<?php get_header(); ?>

<h1>404 Error</h1>

We cannot seem to find what you were looking for.

Maybe we can still help you.

<ul>

<li>You can search our site using the form provided below.</li>

<li>You can visit <a href="<?php bloginfo?>"</a></li>

<a href="<?php ('url'); ?>" the homepage.</a>

<li>Or you can view some of our recent posts.</li>

</ul>

Search:

TEMPLATEPATH . "/searchform.php"); ?>

<h3>Recent Posts</h3>

<ul>
	<?php query_posts('posts_per_page=5'); if (have_posts()) : while (have_posts()) : the_post(); ?>

<li><a href="<?php the_permalink() ?>" title="Permalink for : <?php the_title(); ?>"><?php the_title(); ?></a>
	endwhile; endif; ?>
	</ul>

<?php get_footer(); ?>

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

جعل الصفحة أكثر ملائمة وبهجة للمستخدم

لجعل هذه الصفحة أكثر جاذبية للمستخدم، يمكن استخدام العديد من الأفكار كوضع صور خلفية لهذه الصفحة أو كتابة تعليمات html خاصة لجعل هذه الصفحة أكثر قوة وتنوعًا وإليك بعض الأمثلة لصفحات 404 مميزة:

1. Mundofox.com

2. CSSRemix.com

3. CSSRemix.com

4. ChrisJennings.com

5. ook.co.uk

6. Youcastr.com

7. Mixx.com

8. JustCreativeDesign.com

9. Agens.no

10. Mushroomdigital.co.uk

استخدمها بحكمة

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

ترجمة -وبتصرّف- للمقال How to Create a Custom WordPress 404 Error Page 

حقوق الصورة البارزة محفوظة لـ Freepik

تعرّفنا في الدرس السابق على المعلِّقات، الأفعال و المرشِّحات (Hooks, Actions, Filtres ) وسنتعرّف في هذا الدرس على أساسيات إنشاء الإضافة وكيفية إضافة خصائص القالب للإضافات…

أساسيّات إنشاء إضافةٍ:

الآن وقد صِرنا نعرف كلّ شيءٍ عن المعلِّقات فإن الخطوة التاليّة ستكون معرفة طريقة استخدامها. لنعد خطوة للوراء ولنلق نظرة عامّة على الإضافات.
يتم وضع الإضافات في المجلّد الرئيسي للإضافات في موقعك ووردبريس، يوجد هذا الملف عادة في هذا المسار "wp-content/plugins". كمثال لنقم بإنشاء إضافة تقوم بإضافة رابط تغريده تحت مقالاتك.
أوّلا، فلننشئ مجلّدًا في مجلّد الإضافات الرئيسي ولنسمّه مثلا "tweet-plugin-tutorial". الآن أنشئ ملفًّا داخل هذا المجلّد وسمّه "tweet-plugin-tutorial.php". الآن قم بفتح الملف وقم بنسخ البرمجيّة التالية بداخله:

<?php 
/**
 * Plugin Name: Tweet Plugin Tutorial
 * Plugin URI: http://danielpataki.com
 * Description: This plugin adds a simple tweet link below posts.
 * Version: 1.0.0
 * Author: Daniel Pataki
 * Author URI: http://danielpataki.com
 * License: GPL2
*/

هذه المعلومات سيتم عرضها في لوحة تحكّم المدير في قسم الإضافات. بمجرّد حفظك للملف ستلاحظ ظهور إضافةٍ جديدةٍ في قائمة الإضافات، تهانينا! لقد أنشأت أوّل إضافة لك بإتقان ولكن لا تفرح كثيرًا فهذه الإضافة لا تقوم بأيّة وظيفة بعد، ولكن يمكنك تفعيلها الآن وهو ما ندعوك للقيام به.
حاليًّا قمنا بـ 90% من العمل. كلُّ ما علينا القيام به الآن هو إيجاد طريقة لإضافة رابط التغريدة أسفل محتوى المقال. ربّما أنت تفكّر بتعديل محتوى المقال عن طريق إضافة نصٍّ إضافي له. هذا يعني أنّك تفكّر في استخدام معلِّق the_content مثلما قمنا بهذا سابقًا:

<?php 
function tweet_link( $content ) {
  return $content . '<p><a href="https://twitter.com/intent/tweet?url='.get_permalink().'">Tweet about this</a></p>';
}
add_action( 'the_content', 'tweet_link' );

هذه البرمجيّة ستقوم بإضافة رابطٍ بعد محتوى مقالِتنا، ما سيتيح لمستخدمينا مشاركة رابط المقال عن طريق تغريده.

في الواقع هذا كلّ ما يجب عليك معرفته لإنشاء إضافة ووردبريس. جميع الإضافات هي عبارة عن مزيج من الدّوال والمعلِّقات التي تحدِّد المكان الذي سيتم منه تشغيل هذه الدّوال. لذا من الآن فصاعدًا عليك التركيز على تعلُّم الأنظمة الفرعية مثل Options API, Metadata API وغيرها.

إضافة خصائص القالب للإضافات:

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

<?php 
add_action('admin_menu', 'tweetlink_settings_menu');

function tweetlink_settings_menu() {
    add_menu_page('Tweet Link Settings', 'Tweet Link', 'manage_options', 'tweetlink-settings', 'tweetlink_settings_page', 'dashicons-twitter');
}

function tweetlink_settings_page() {
  echo '<div class="wrap"><h2>Tweet Link Options</h2></div>';
}

دالّة ()tweetlink_settings_menu تمّ تعليقها بمعلِّق admin_menu. حسب دليل الووردبريس هذه هي الطريقة الصحيحة التّي يجب استخدامها لإنشاء قائمة مدخلات في لوحة التحكّم. العمل سيتّم عن طريق دالّة ()add_menu_page التي تأخذ مجموعة مُعامِلات صفحة ذات مستوى أعلى. المعاملات التي تأخذها هذه الدّالة هي:

• عنوان الصّفحة – يستخدم في وسم العنوان
• عنوان القائمة – يستخدم في كتابة اسم القائمة في الجهة اليسرى/اليمنى من لوحة تحكم المدير.
• الإمكانيّة – لتحديد أقل مستوى يمكنه مشاهدة القائمة (مثلا القائمة ستكون ظاهرة فقط للمدير والمحرّرين)
• الاسم اللطيف للقائمة – يستخدم في الرابط المؤدّي لصفحة القائمة.
• الدّالة - اسم الدّالة التي تقوم بالتحكّم بالمُخرجات.
• الأيقونة – رابط صورة او نص لأيقونات ووردبريس.
• الموقع – تموضع العنصر ضمن القائمة.

إليك كيف تبدو صفحة الخصائص في لوحة التحكم:

قد تبدو لك هذه الصّفحة رائعة ولكن في الحقيقة هي مبالغةٌ كبيرة إنشاء صفحة كاملة من أجل إضافة بسيطة كالتّي نعمل عليها الآن، لذا سيكون من الأفضل وضع هذه الصفحة داخل قائمة الإعدادات الموجودة سلفا بالووردبريس. يمكنك القيام بذلك باستخدام دالّة ()add_options_page.
الخطوة التّالية ستكون جعل الووردبريس يعلم حول إعدادات تغريدتنا. هذا الأمر سيتطلب استخدام دالّة ()register_settings داخل دالّة معلّقة إلى ()to admin_init.
إليك كيف سيكون شكل البرمجيّة:

<?php 
add_action( 'admin_init', 'tweetlink_settings' );

function tweetlink_settings() {
    register_setting( 'tweetlink_settings', 'twitter_account' );
}

كلّ شيءٍ تمام. الخطوة الأخيرة ستكون إضافة استمارة تستخدم خصائصنا. استخدم البرمجيّة التاليّة كنموذج لإنشاء إعداداتك الخاصّة، لا تنسَ استخدام دوال ()settings_fields و ()do_settings_sections لضمان قيام الووردبريس بحفظ البيانات لك.

<?php 
function tweetlink_settings_page() {
?>
<div class="wrap">
<h2>Tweet Link Settings</h2>

<form method="post" action="options.php">
    <?php settings_fields( 'tweetlink_settings' ); ?>
    <?php do_settings_sections( 'tweetlink_settings' ); ?>
    <table class="form-table">        
        <tr valign="top">
        <th scope="row">Twitter Account</th>
        <td><input type="text" name="twitter_account" value="<?php echo esc_attr( get_option('twitter_account') ); ?>" /></td>
        </tr>
    </table>
    
    <?php submit_button(); ?>

</form>
</div>

<?php
}

عند نهاية العمليّة يجب أن ترى ظهور حقل جديد يُمكّنك من إدخال حسابك على تويتر ثم الضغط على حفظ. بعد ذلك يمكنك استخدام دالّة  'get_option( 'twitter_account ( لاسترجاع القيمة المُدخلة واستخدامها بأي مكان داخل إضافتك.

يمكننا الآن التعديل على رابط التغريدة لإضافة "via @username" إذا قام المستخدمون بإضافة حسابهم على تويتر في صفحة الخصائص.
إليك كيف عدّلت دالّة ()tweet_link

<?php 
function tweet_link( $content ) {
    $url = 'https://twitter.com/intent/tweet';
    $url .= '?url=' . get_permalink();

    $account = get_option( 'twitter_account' );
    if( !empty( $account ) ) {
        $url .= '&via=' . $account;
    }

    return $content . '<p><a href="' . $url . '">Tweet about this</a></p>';
}

خاتمة

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

ترجمة -وبتصرّف- للمقال WordPress Development for Beginners: Building Plugins لصاحبه Daniel Pataki