שימוש בשדות מיוחדים בפוסט (ACF)

כדי להשתמש בשדות מיוחדים ACF בפוסט, יש להשתמש בקצרקוד הבא:

[acf field="name"]

כאשר יש לשבץ בו את שם השדה המיוחד (שם ייחודי באנגלית)

לעיתים צריך להשתמש בשדה מיוחד באופן מותנה, במבנה ייחודי או מורכב, ואז ניתן לפעול בצורה הבאה:

לבנות את המבנה הנדרש ולהעתיק את ה-HTML דרך לחיצה ימנית ו-inspect

לשים את המבנה המיוחד בתוך פונקציה ייעודית בקובץ functions.php ולהגדיר את המבנה המיוחד כקצרקוד

add_shortcode('phonestr', 'new_external_acf');

function new_external_acf($atts) {
	global $post;
	$field1 = get_field('agentphone', $post->ID);
	return '<a href="tel:' . $field1 . '">' . $field1 . '</a>';
}

לשבץ את הקצרקוד – לדוגמא [phonestr]

הערה: אם משתמשים בקצרקודים שונים (יותר מ-1) – יש לשנות את שם הפונקציה בכל פעם.

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

add_shortcode('youtubeembed', 'new_external_acf2');


function new_external_acf2($atts) {
global $post;
$field2 = get_field('youtubecode', $post->ID);
$field2 = substr($field2, -11); //Truncate the beginning, get only the Youtube Code
return '<div class="column mcb-column mcb-item-oe4bz99hs one column_video"><div class="content_video iframe auto-wh"><iframe class="scale-with-grid" width="" height="" src="https://www.youtube.com/embed/' . $field2 . '?rel=0" allowfullscreen=""></iframe></div></div>';
}

הערה: מה שמיוחד בהגדרה הזו שעושה את החיתוך של ההתחלה, זה שאפשר להנחות את הלקוח ללחוץ על "SHARE" תחת סרטון ה-Youtube ושם ללחוץ "COPY" – ואז להדביק.

דוגמא: שילוב iframe:

add_shortcode('iframeit', 'new_external_acf3');

function new_external_acf3($atts) {
global $post;
$field3 = get_field('theiframe', $post->ID);
return '<iframe src="' . $field3 . '" style="border:0px #ffffff none;" name="VirtualTour" scrolling="no" frameborder="1" marginheight="0px" marginwidth="0px" height="700px" width="1400px" allowfullscreen></iframe>';
}

דוגמא מורכבת יותר: שדה עם אופציות

למשל, לקוח ביקש להוסיף אופציה לבחירת סוכן, אשר תשלוף את כל הנתונים אוטומטית.
נוסף שדה ACF מסוג SELECT עם אופציות תחת a1 : ערך, a2 : ערך וכו'…
להלן המימוש:

add_shortcode('agentstr', 'new_external_acf');

function new_external_acf($atts) {
	global $post;
	$field1 = get_field('theagent', $post->ID);
	switch ($field1) {
		case 'a2':
			$agentname = 'אהרון קמיש';
			$agenttel = '058-5100418';
			$agentpic = 'https://www.relocation-tlv.co.il/wp-content/uploads/2023/07/a2.jpg';
			break;
		case 'a3':
			$agentname = 'משיח שמא';
			$agenttel = '052-2538769';
			$agentpic = 'https://www.relocation-tlv.co.il/wp-content/uploads/2023/07/a3.jpg';
			break;
		default:
			$agentname = 'משה אקי';
			$agenttel = '054-7109025';
			$agentpic = 'https://www.relocation-tlv.co.il/wp-content/uploads/2023/07/a1.jpg';
			break;
	}
	
	return '<img class="imgagent" src="' . $agentpic . '" /><p><strong>סוכן מטפל:</strong> '. $agentname . ' | <strong>טלפון:</strong> <a href="tel:' . $agenttel . '">' . $agenttel . '</a></p>';
}

עם סגנון קוד CSS הבא:

img.imgagent {
  max-height:80px !important;
  border-radius:50px;
  display:inline;
  clear:none;
  float:none;
  margin-right:20px;
  margin-left:20px;
  position:relative;
  top:-10px;
}
.agentfield p {
  display:inline;
  position:relative;
}
.agentfield p:nth-child(2) {
  position:relative;
  top:-40px;
}
.agentfield {
  text-align:center;
  margin-bottom:0px !important;
}

הערה: ניתן גם לשלוף פרמטרים של הפוסט עצמו, (למשל שימוש בתמונה המובילה של הפוסט בהמשך הפוסט) – כך:

wp_get_attachment_url(get_post_thumbnail_id($post->ID))

עריכה של מספר (פסיקים)

כדי להוסיף פסיקי הפרדה למספרים גדולים, יש להוסיף את הקוד הבא לקובץ functions.php, כך:

add_filter('acf/format_value/name=assetprice', 'fix_number', 20, 3);
function fix_number($value, $post_id, $field) {
$value = number_format($value);
return $value;
}

כאשר יש לכתוב את שם השדה ב-ACF בשורה הראשונה של הקוד.

אזור מותנה

כדי להוסיף אזור (או אזורים) בעמוד המותנים בפרמטר ACF, יש להוסיף Class ל-body של העמוד, באמצעות שיבוץ הקוד הבא בקובץ functions.php:

function my_custom_body_class($classes) {
    global $post;
	$field1 = get_field('youtubecode', $post->ID);
	$field2 = get_field('theiframe', $post->ID);
    if ($field1) {
		$classes[] = 'videoready';
	}
	if ($field2) {
		$classes[] = 'iframeready';
	} // Add to classes array as needed
    return $classes;
}
add_filter('body_class', 'my_custom_body_class');

להוסיף Classים מתאימים לאזור (או אזורים), כך לדוגמא – thevideosection, ולהוסיף את קוד ה-CSS הבא:

.thevideosection, .theiframesection {
  display:none;
}
.videoready .thevideosection {
  display:block;
}
.iframeready .theiframesection {
  display:block;
}

דוגמא: כיתוב "נמכר בהצלחה" מותנה בפרמטר מכירה

נוסף שדה עם 2 כפתורי רדיו "נמכר" ו-"טרם נמכר" עם הגדרות sold : נמכר כדי לעבוד עם הפרמטר מאחורי הקלעים.

להלן הקוד לשיבוץ בקובץ functions.php להגדרת ה-Class של ה-body:

function my_custom_body_class($classes) {
global $post;
$field3 = get_field('sold', $post->ID);
if ($field3 == 'sold') {
$classes[] = 'assetsold';
}
return $classes;
}
add_filter('body_class', 'my_custom_body_class');

וקוד CSS לסגנון (נוסף Classים של ifsold ו-tobesold למסגרת):

.assetsold .tobesold .image_frame img {
opacity:0.5;
}
.assetsold .ifsold {
display:block;
position:absolute;
top:225px;
background:rgba(0,173,240,1);
right:-7px;
}
.assetsold .ifsold h2 {
color:white;
font-size:50px;
line-height:50px;
padding-top:5px;
}

.ifsold {
display:none;
}

רפרנסים:

How to call ACF fields from my functions.php file

Shortcode

Insert Commas into ACF number field