מה זה WordPress ShortCode

מבוא:

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

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

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

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

 

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

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

 

את הפוסט הזה כתבתי בעזרת שורטקודים מוכנים מראש. יצרתי שני קודים ועיצבתי אותם question ו answer.

 

aeditoraexampleacode
באתר האחרון שבניתי לאחרונה, בעמוד שאלות ותשובות ישנו קוד Ajax שפותח וסוגר את התשובות. כך נראה הקוד: וכך נראה העורך תוכן.

fexample

 

 3. תחילת עבודה:

אנחנו נשתמש בקבץ functions.php. כדי לא לפגוע בקובץ הזה אני מציע לעבוד בדרך קצת שונה, ליצור קובץ שנקרא shortcodes.php ופשוט לחבר אותו לקובץ פונקציות של תבנית.
בתוך קובץ functions.php להוסיף את השורה הבאה בסוף לפני סגירה של PHP או בהתחלה אחרי פתיחה.
[cc lang=”php”] include ‘shortcodes.php’;[/cc]
חובה לגבות לפני כל שינוי!!!

 

4. סוגי שורטקוד

  1. בסיסי ביותר – [shortcode]
  2. בעל ערכים בסיסיים – [shortcode array=’value’ /]
  3. תוכן בסיסי – [shortcode]  text [/shortcode]
  4. שילוב של הכול ביחד – [shortcode array=’value’] text [/shortcode]

 

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

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

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

 

 

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

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

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-ים שחוזרים על עצמם כל פעם.
בפוסט הזה ניסיתי לתת מבוא לשורטקודים. בעתיד אנסה לכתוב פוסטים נוספים עם טיפים וטריקים כוללים שורטקודים נוספים.
באיזה שורטקודים אתם משתמשים?

2 תגובות

  1. שלום ראיתי את התג עננים שלך ואהבתי

    חיפשתי תוסף כזה ומצאתי את
    WP-Cumulus
    אבל הוא לא מראה אצלי תגים\קטגוריות בעברית

    אשמח אם תוכל לעזור לי

הפוסט סגור לתגובות