מה זה WordPress ShortCode

מבוא:

החל מגרסה 2.5 הוכנס לוורדפרס מנגנון short code. מדובר במרכיב מאוד חשוב שלא ניתן לו מספיק תשומת לב. למעשה shortcode (שורטקוד) הוא מאקרו קוד שהוכן מראש וניתן לייצג אותו בכל מקום בבלוג/אתר.
בעזרת שורטקודים ניתן להפוך תהליכים מאוד מסובכים לבסיסיים ביותר. לדוגמא כדי להציג פרסומות Adsense כבר לא צריך להשתמש בתוספים שונים ולסבול ממיקום לא מוצלח, אלה להכין שורטקוד ולמקם אותו בכל מקום שבא לכם.
שורטקודים משתמש בWordpress ShortCode API המובנה בתוך מערכת ומתרגם את הפונקציה לקוד HTML מוכן.רישום של שורטקוד מתבצע בעזרת פונקציה add_shortcode().

מתי כדי להשתמש בשורטקודים:

1. הצגת פרסומות של גוגל אדוורדס או באנרים אחרית בתוך הטקסט.
2. יצירת לחצנים יפים בתוך הפוסט ללא תמונות.
3. הוספת פריטים מיוחדים בתוך הטקסט.
4. ועוד…

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

לפני הכול, דוגמאות:

אחד הדוגמאות הכי שמישות זה Contact Form7, לאחר בנייה נכונה של טופס צור קשר תוסף מספק שורטקוד [contact form]. למעשה מערכת מזהה את הקוד ומתרגמת אותו לטופס צור קשר.

ניתן לראות את הדוגמה כאן יצרתי שני קודים ועיצבתי אותם question ו answer.

תחילת עבודה:

אנחנו נשתמש בקבץ functions.php. כדי לא לפגוע בקובץ הזה אני מציע לעבוד בדרך קצת שונה, ליצור קובץ שנקרא shortcodes.php ופשוט לחבר אותו לקובץ פונקציות של תבנית.
בתוך קובץ functions.php להוסיף את השורה הבאה בסוף לפני סגירה של PHP או בהתחלה אחרי פתיחה.

חובה לגבות את הכול

 include 'shortcodes.php'; 

שורטקוד בסיסי:

 function hw_shortcode() {
	return 'Hello World!'; 
} 
add_shortcode('hw', 'hw_shortcode'); 

אין כאן משהוא מיוחד, פונקציה בסיסית. כשאר נכתוב בעורך תוכן [hw] אז נקבל את הערך הזה Hello World.

שורטקוד משולב

זה כמובן ללא ספק השורטקוד הקשה והמורכב ביותר. צריך להבין אותו ורק אז להישתמש. כך נראת הפונקציה.

 function myurl_shortcode($atts, $content = null) {
	extract(shortcode_atts(array(
		"href" => 'http://',
		"title" => null
	), $atts));
	return ''.$content.'';
}
add_shortcode('myurl', ' myurl_shortcode '); 

עכשיו הולכים לעורך תוכן וכותבים בו את הקוד הבא:

 [myurl 
	href="https://www.alechko.name/alechko" 
	title=" בלוג של אלכס יודייב"
]
		בלוג של אלכס יודייב 
[/myurl] 

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

 extract(shortcode_atts(array(
	"href" => 'http://',
	"title" => null
), $atts)); 

במקרה הזה השתמשתי אך ורק בפרמטר href ו title. לכן אין לי יותר פרמטרים אבל אם הייתי משתמש בעוד פרמטרים של תג a כמו לדוגמא target.
בשלב השני יצרתי פקודה שמתרגמת את כל הפונקציה שיצרתי לקוד HTML.
וכמובן בשלב השלישי הוספתי shortcode לוורדפרס.

סיכום ודיון

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