دليل المبتدئين لتطوير البرنامج المساعد وورد

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

سنتعرف على بعض الطرق للبدء في تطوير المكونات الإضافية لـ WordPress. الخطوات بسيطة إلى حد ما ولا تتطلب تفانيًا كبيرًا للدراسة. المعرفة الأولية لـ PHP ستكون مفيدة حتى مع فهم أساسي لبنية ملف وورد ولوحة الإدارة.

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

لماذا تطوير لورد?

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

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

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

1. هيكل مجلد WP

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

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

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

2. بدء ملف PHP الخاص بك

عند إنشاء مكون إضافي جديد ، يجب أن تبدأ بملف PHP بسيط. يمكن تسمية هذا بأي شيء ولكن يجب أن يعكس الاسم الرسمي للمكونات الإضافية بشكل عام. لذلك ، على سبيل المثال ، قمت بإنشاء كودنا الأساسي وقمت بتسمية ملفي hongkiat-excerpt.phps.

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

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

3. اصطلاحات تسمية ووردبريس وأفضل الممارسات

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

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

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

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

4. الغوص في المرشحات والإجراءات

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

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

فهم add_filter ()

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

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

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

add_filter ('wp_title'، 'hongkiat_func')؛

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

ال add_filter وظيفة أصلية لبرنامج WordPress وتستخدم لإضافة مرشح جديد لمتغير موجود داخل محتوى الصفحة. في السطر أعلاه ، نحن نستهدف $ wp_title الذي يحتوي على عنوان صفحتنا الحالية. بعد ذلك نقوم بتمرير هذا المتغير إلى وظيفة وهمية بعنوان hongkiat_func () والتي يمكن بعد ذلك التلاعب وإرجاع علامة عنوان جديدة لأي غرض من الأغراض.

فهم add_action ()

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

• publish_post - يسمى عندما يتم نشر منشور أو عندما يتم تغيير الحالة إلى “نشرت”
• save_post - يسمى عندما يتم إنشاء وظيفة / صفحة من البداية أو تحديثها
• wp_head - دعا عندما يتم تحميل القالب ويدير wp_head () وظيفة
• loop_end - تم الاتصال فورًا بعد النشر النهائي من خلال حلقة WordPress
• trackback_post - يتم استدعاء كلما تمت إضافة trackback جديدة في منشور

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

add_action ('save_post'، 'notify')؛

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

الانتهاء من منطق البرنامج المساعد لدينا

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

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

لذلك على سبيل المثال ، يمكننا الحد من مقتطفات القصة من 55 حرفًا فقط hk_trim_content () وظيفة. يمكنك بسهولة استدعاء هذا الجزء من الشفرة من أداة الشريط الجانبي أو أحد ملفات السمات لاستبدالها $ the_content.

= حد $) array_pop (محتوى $) ؛ $ content = implode (""، $ content). '...'؛  محتوى = implode ("" ، $ محتوى) آخر ؛  $ content = preg_replace ('/\ Budap.+\\/'، "، $ content)؛ $ content = application_filters ('the_content'، $ content)؛ return $ $ content؛؟> 

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

قد تلاحظ أيضًا أننا نستخدم مكالمة إلى apply_filters وهي وظيفة أخرى خاصة بـ WordPress. هذا جانب آخر لا تحتاج إلى إدراكه بالكامل ولكنه يساعد في البرمجة المستقبلية عبر WP. تحقق من الصفحة المرجعية application_filters لمزيد من التفاصيل والأسئلة الشائعة حول هذا الموضوع.

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

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

تثبيت وتشغيل البرنامج المساعد

لقد قمت بإنشاء ملف نموذج للمكون الإضافي للعرض التوضيحي إذا كنت ترغب في تخطي الترميز الثابت. ما عليك سوى تنزيل هذا الملف (إعادة تسميته إلى .php) أو نسخ / لصق الرمز في مستند PHP جديد وتحميله إلى / الفسفور الابيض بين المحتوى / الإضافات دليل.

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

يحتوي هذا الملف على كل قالب HTML / CSS لصفحة نشر المقالة الأساسية. انتقل لأسفل حتى تجد المحتوى() واستبدالها مع رمز المثال أعلاه. سيؤدي هذا إلى قصر جميع صفحات المقالة على 55 حرفًا بغض النظر عن طريقة العرض المستخدمة. يمكنك أيضًا إضافة هذه الوظيفة إلى صفحات مشابهة في دليل القوالب مثل search.php أو archive.php.

استنتاج

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

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