שימוש ב Advanced Custom Fields ללא תלות ב Frontend

התוסף Advanced Custom Fields מספק ממשק פשוט וויזואלי ליצירת metaboxes. התוצאה אינטואטיבית ונוחה לעריכה על ידי הלקוח. ACF כולל מספר פונקציות למשיכת ערכי שדות בתבניות שלכם, אך אני ממליץ לא להשתמש בהן בצד הלקוח (frontend).

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

ניתן לעקוב אחר כמות השאילתות למסד הנתונים באמצעות התוסף Query Monitor. בבדיקות, מעבר מפונקציות ACF ל-get_post_meta() הוריד את מספר השאילתות מ-146 ל-22 בעמוד בודד.

שימוש ב-get_post_meta במקום get_field

אין סיבה להשתמש ב-get_field() כשאפשר להשתמש בפונקציית הליבה של וורדפרס get_post_meta().

מעבר לעלות הביצועים, פונקציות ACF יוצרות תלות ב-frontend. אם התוסף מושבת או מוסר מסיבה כלשהי, הגולשים יראו שגיאה קריטית ודף ריק במקום האתר שלכם.

עטיפת כל קריאות הפונקציות של ACF ב-function_exists() מונעת את השגיאה הקריטית, אך הגולשים עדיין לא יראו את ה-metadata שהכנסתם דרך ACF – למרות שהוא עדיין קיים במסד הנתונים.

אם תשתמשו בפונקציות הליבה של וורדפרס במקום, האתר שלכם ממשיך להציג את כל ה-metadata בצורה תקינה גם כש-ACF אינו פעיל. הדבר היחיד שתאבדו הוא ממשק העריכה בפאנל הניהול.

הדוגמאות להלן מראות כיצד לשלוף נתוני ACF באמצעות get_post_meta() ו-get_option() במקום פונקציות ACF. גישה זו פשוטה עבור שדות סטנדרטיים אך דורשת הבנה של אופן האחסון של ACF עבור סוגי שדות מורכבים יותר.

Repeater Field עם get_post_meta

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

קריאה למפתח ה-meta של ה-repeater מחזירה את מספר הפריטים:

get_post_meta( get_the_ID(), 'my_videos', true );

לאחר מכן ניתן לבצע לולאה על כל פריט ולגשת לערכי תתי-השדות שלו. כך מציגים את הסרטונים ללא שימוש ב-get_field():

$videos = get_post_meta( get_the_ID(), 'my_videos', true );
if ( $videos ) {
    for ( $i = 0; $i < $videos; $i++ ) {
        $title     = esc_html( get_post_meta( get_the_ID(), 'my_videos_' . $i . '_title', true ) );
        $video     = esc_url( get_post_meta( get_the_ID(), 'my_videos_' . $i . '_video', true ) );
        $thumbnail = (int) get_post_meta( get_the_ID(), 'my_videos_' . $i . '_thumbnail', true );

        $thumbnail = $thumbnail
            ? wp_get_attachment_image( $thumbnail, 'medium' )
            : '<img src="' . get_stylesheet_directory_uri() . '/images/default-video.png" />';

        $class = ( 0 === $i % 2 ) ? 'one-half first' : 'one-half';

        echo '<div class="' . $class . '"><a href="' . $video . '">' . $thumbnail . '</a>' . $title . '</div>';
    }
}

שימו לב שה-ACF Image field שומר את ה-attachment ID במסד הנתונים. את ה-markup של התמונה מקבלים באמצעות הפונקציה wp_get_attachment_image():

wp_get_attachment_image( $image_id, 'image_size' );

נתוני Options Page

כשמוסיפים metaboxes לעמוד Options של ACF, הנתונים נשמרים בטבלת wp_options, לא כ-post meta. המפתח הוא שם השדה עם תחילית options_.

אם בעמוד ה-Options יש שלושה שדות, שלפו אותם כך:

$title       = esc_html( get_option( 'options_title' ) );
$button_text = esc_html( get_option( 'options_button_text' ) );
$button_url  = esc_url( get_option( 'options_button_url' ) );

if ( $title && $button_text && $button_url ) {
    echo '<div class="call-to-action"><div class="wrap"><p>' . $title . '</p><p><a href="' . $button_url . '" class="button">' . $button_text . '</a></p></div></div>';
}

Term Metadata

אם הוספתם שדה בשם "כותרת משנית" לקטגוריות, ACF שומר נתונים אלו בטבלת wp_termmeta (החל מ-ACF 5.5 ו-WordPress 4.4+). ניתן לשלוף באמצעות get_term_meta():

if ( ! is_category() ) {
    return;
}

$category = get_queried_object();
$subtitle = esc_html( get_term_meta( $category->term_id, 'my_subtitle', true ) );

if ( $subtitle ) {
    echo '<p class="subtitle">' . $subtitle . '</p>';
}

בגרסאות ACF לפני 5.5, term metadata נשמר בטבלת wp_options בפורמט [taxonomy]_[term_id]_[field_name]. החל מ-ACF 5.5, נתוני terms נשמרים בטבלת wp_termmeta, ונגישים דרך פונקציית וורדפרס הסטנדרטית get_term_meta().

שאלות נפוצות

שאלות נפוצות על שימוש ב-ACF ללא תלות ב-frontend:

סיכום

שימוש בפונקציות הליבה של וורדפרס כמו get_post_meta(), get_option(), ו-get_term_meta() במקום get_field() של ACF מבטל את התלות ב-frontend בתוסף, מצמצם שאילתות למסד הנתונים, ומבטיח שהאתר שלכם ממשיך להציג תוכן גם אם ACF מושבת.

הפשרה היא שצריך להבין כיצד ACF שומר נתונים במסד הנתונים עבור כל סוג שדה – אבל ברגע שמבינים, הגישה פשוטה ובעלת ביצועים טובים יותר.

הנה פוסטים קשורים:

• העברת נתונים מ-ACF ל-JavaScript עם wp_localize_script
• הוספת בלוקים חדשים לגוטנברג באמצעות ACF והקובץ block.json