MU-Plugins בוורדפרס: 5 שימושים חכמים שכדאי להכיר

עדכנתם את התבנית של האתר, נכנסתם לכתבה וגיליתם שאזור התגובות חזר לעיצוב הישן. שינויים שעושים ישירות בקובצי התבנית עלולים להימחק בעדכון הבא¹. תיקיית MU-Plugins של וורדפרס מאפשרת להימנע מזה בלי לערוך את קובצי התבנית.

כל קובץ PHP שתשימו בתיקייה הזו נטען אוטומטית². בסוף הכתבה תדעו מה כדאי לשמור בה, איך יוצרים קובץ ראשון ומה עלול להשתבש. הכתבה מיועדת למי שמנהל אתר וורדפרס ויודע להעלות קבצים לשרת.

מה זה MU-Plugins ואיך זה עובד?

MU-Plugins הוא קיצור של Must-Use Plugins, כלומר תוספי חובה. הקבצים יושבים בתיקייה wp-content/mu-plugins. וורדפרס מפעיל אותם תמיד ועוד לפני התוספים הרגילים, בלי שתצטרכו ללחוץ על שום כפתור². פרט אחד מכשיל מתחילים: וורדפרס מחפש קובצי PHP רק ישירות בתיקייה הראשית.

קובץ שנמצא בתיקיית משנה לא ייטען, אלא אם קובץ מהתיקייה הראשית טוען אותו. במסך התוספים של לוח הבקרה תוספי החובה מופיעים בלשונית נפרדת בשם "תוספים אוטומטיים" ואי אפשר לכבות אותם משם. כדי לעצור תוסף כזה, הסירו את הקובץ מהתיקייה.

1. שמרו על עיצוב התגובות גם אחרי עדכון תבנית

במקום לערוך את comments.php בתוך התבנית, שמרו עותק מעוצב בתיקיית משנה והפנו אליו את וורדפרס בעזרת המסנן comments_template³. מספיקים שני קבצים:

wp-content/mu-plugins/my-comments.php
wp-content/mu-plugins/my-comments/comments.php

בקובץ הראשון כתבו את השורות הבאות:

<?php
add_filter( 'comments_template', fn() => __DIR__ . '/my-comments/comments.php' );

קובץ ההפניה נטען לבד כי הוא יושב בתיקייה הראשית. דרכו נטען גם קובץ התגובות. שימו לב לשתי מגבלות: המסנן פועל רק בתבניות שקוראות לפונקציה comments_template⁴ והקוד דורש PHP בגרסה 7.4 ומעלה⁵.

אם העותק של comments.php קורא לפונקציות של התבנית, בדקו אותו לפני החלפת תבנית. אולי תשאלו למה לא תבנית בת (Child Theme). היא באמת שומרת על השינויים שלכם כשתבנית האם מתעדכנת¹, אבל הקוד נשאר קשור לתבנית. אם תחליפו אותה, תצטרכו להעביר הכול מחדש.

2. רכזו פונקציות בקובץ שלא תלוי בתבנית

קוד בקובץ functions.php של התבנית רץ רק כשהיא פעילה ואם מחליפים תבנית הוא מפסיק לעבוד⁶. העבירו אותו לקובץ בשם my-functions.php בתיקיית mu-plugins והוא ימשיך לרוץ גם אחרי ההחלפה.

בסיום מחקו את הקוד מהקובץ functions.php, כי PHP לא מאפשר להגדיר אותה פונקציה פעמיים והשגיאה עלולה להפיל את האתר⁷. למשל, הקוד הבא מציג תזכורת בלוח הבקרה⁸:

<?php
add_action( 'admin_notices', function() {
    echo '<div class="notice notice-info"><p>תזכורת: גבו את האתר לפני כל עדכון.</p></div>';
} );

כשהקובץ גדל, הוסיפו ליד כל קטע הערה קצרה שמסבירה למה הוא קיים. גם התיעוד הרשמי ממליץ לתעד למה כל תוסף כזה נמצא באתר ומי מתחזק אותו².

3. הוסיפו סוג תוכן מותאם (Custom Post Type) שנשאר גם אחרי החלפת תבנית

רוצים אזור נפרד של מדריכים, פרויקטים או המלצות? וורדפרס מאפשר ליצור סוגי תוכן משלכם (Custom Post Types). התיעוד הרשמי ממליץ להגדיר אותם בתוסף ולא בתבנית, כדי שהתוכן יישאר נגיש גם אם תחליפו תבנית⁹.

<?php
add_action( 'init', function() {
    register_post_type( 'my_guides', array(
        'labels' => array(
            'name' => 'מדריכים',
            'singular_name' => 'מדריך',
        ),
        'public' => true,
        'has_archive' => true,
        'rewrite' => array( 'slug' => 'guides' ),
        'show_in_rest' => true,
        'supports' => array( 'title', 'editor', 'thumbnail' ),
    ) );
} );

למזהה שבקוד יש קידומת, כי מזהה כללי כמו product עלול להתנגש עם תוספים ותבניות אחרים. אחרי ההעלאה יופיע בלוח הבקרה אזור ניהול חדש.

אם דפי המדריכים מחזירים שגיאת 404, היכנסו להגדרות ומשם למבנה קישורים ולחצו פעם אחת על "שמור שינויים" כדי לרענן את כללי הכתובות¹⁰. העיצוב של הדפים עדיין יגיע מהתבנית.

4. טענו קובץ CSS בלי לגעת בתבנית

לפעמים רוצים רק לשנות מרווח או צבע של כפתור. שמרו את קובץ העיצוב בתיקיית משנה:

wp-content/mu-plugins/my-style/style.css

ואז צרו בתיקייה הראשית קובץ בשם my-style.php שטוען אותו¹¹:

<?php
add_action( 'wp_enqueue_scripts', function() {
    wp_enqueue_style(
        'my-custom-style',
        WPMU_PLUGIN_URL . '/my-style/style.css'
    );
} );

הקובץ יישאר במקומו גם אחרי החלפת תבנית, אבל זה לא אומר שהעיצוב ייראה אותו דבר. אם הוא נשען על מחלקות (classes) של התבנית הנוכחית, תצטרכו להתאים אותו.

5. צרו קיצור קוד (Shortcode) שחוסך העתקות

קיצורי קוד (Shortcodes) מאפשרים לשלב רכיב קבוע בתוך עמודים וכתבות¹². הקוד הבא יוצר הודעת ברוכים הבאים:

<?php
add_shortcode( 'site_message', function() {
    return '<div class="site-message">ברוכים הבאים לאתר שלנו!</div>';
} );

מעכשיו מספיק לכתוב בעורך את הקיצור:

[site_message]

רוצים לשנות את ההודעה? עדכנו אותה בקובץ אחד וכל העמודים שבהם היא מופיעה מתעדכנים יחד. אם הקיצור מציג נתונים שמגיעים מהגולשים, סננו אותם לפני שהם מוצגים באתר.

איך מתחילים לעבוד עם MU-Plugins?

צריך רק גישה לקובצי האתר דרך מנהל הקבצים של חברת האחסון או דרך FTP.

1. היכנסו לתיקייה wp-content. אם אין בה תיקייה בשם mu-plugins, צרו אותה.
2. צרו בתוכה קובץ בשם my-first-plugin.php.
3. הדביקו בו את השורות הבאות והוסיפו אחריהן את הקוד שלכם:

<?php
/**
 * Plugin Name: My First MU Plugin
 * Description: Custom functionality for this website.
 */

// Add your custom code here.

שמרו והעלו לשרת. אין מה להפעיל בלוח הבקרה, כי וורדפרס טוען את הקובץ לבד². כדי לוודא שהכול עובד, נסו קודם את קוד התזכורת מסעיף 2: אם ההודעה מופיעה בלוח הבקרה, הקובץ נטען. רוצים לחלק את הקוד לכמה קבצים? שמרו אותם בתיקיית משנה וטענו אותם מהקובץ הראשי:

<?php
require_once __DIR__ . '/includes/custom-functions.php';

מה חשוב לדעת לפני שמעלים קוד

לפי התיעוד הרשמי של וורדפרס²:

• תקלה עלולה לפגוע בכל האתר: התיקייה נטענת תמיד ולכן גם קובץ שבור בה משפיע מיד. שמרו גיבוי ונסו כל שינוי קודם בסביבת בדיקה. אם האתר נתקע, הסירו את הקובץ דרך מנהל הקבצים.
• אין התראות עדכון: לכן האחריות לעדכן את התוספים האלה עליכם.
• לא כל תוסף מתאים: תוסף שצריך הפעלה וכיבוי מלוח הבקרה או שתלוי בפעולות שרצות בזמן ההפעלה עדיף להתקין כרגיל.
• בדקו את התיקייה מדי פעם: קשה יותר לזהות תוסף כזה שנפרץ, כי אי אפשר לכבות אותו מהרשימה הרגילה. ודאו שאתם יודעים מה יושב שם ולמה.

המנגנון עצמו לא מאיץ את האתר ולא מאבטח אותו והתוצאה תלויה בקוד שתכניסו לתיקייה. לכן התחילו בקובץ קטן שעושה פעולה אחת, בדקו שהוא עובד ושמרו ממנו עותק.

מקורות

1. WordPress Developer Resources. Child Themes. Theme Handbook. developer.wordpress.org
2. WordPress Developer Resources. Must-Use Plugins. Advanced Administration Handbook. developer.wordpress.org
3. WordPress Developer Resources. comments_template (hook). Code Reference. developer.wordpress.org
4. WordPress Developer Resources. comments_template (function). Code Reference. developer.wordpress.org
5. PHP Manual. Arrow Functions. php.net
6. WordPress Developer Resources. Custom Functionality (functions.php). Theme Handbook. developer.wordpress.org
7. PHP Manual. User-defined Functions. php.net
8. WordPress Developer Resources. admin_notices. Code Reference. developer.wordpress.org
9. WordPress Developer Resources. Registering Custom Post Types. Plugin Handbook. developer.wordpress.org
10. WordPress Developer Resources. register_post_type. Code Reference. developer.wordpress.org
11. WordPress Developer Resources. wp_enqueue_style. Code Reference. developer.wordpress.org
12. WordPress Developer Resources. Basic Shortcodes. Plugin Handbook. developer.wordpress.org

💌 יש לכם ידיעה? שלחו לנו, ואולי ניתן לזה את הבמה!