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

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

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

  • פוסט או עמוד – כאשר נכנסים לעריכה שלהם הכתובת דומה ל
    .http://mysite.co.il/wp-admin/post.php?post=1079&action=edit.
    המספר המזהה הוא המספר שליד השם post, במקרה הזה 1079
  • קובץ מדיה – כאשר נכנסים לעריכה מתוך ספרית המדיה הכתובת דומה ל
    .http://mysite.co.il/wp-admin/media.php?attachment_id=1088&action=edit.
    המספר המזהה הוא המספר שליד השם attachment_id, במקרה הזה 1088
  • קטגוריה או תגית– כאשר נכנסים לעריכה של קטגוריה או עריכה של תגיתהכתובת דומה ל
    http://mysite.co.il/wp-admin/edit-tags.php?action=edit&taxonomy=category&tag_ID=3&post_type=post.
    המספר המזהה הוא המספר שליד השם tag_ID, במקרה הזה 3

קוד מקוצר caption

הקוד המקוצר הזה מאפשר הכנסה של כיתוב/תיאור לתמונות, כך שבתצוגת הדף המתקבלת יהיה חיווי ויזואלי המקשר בין הכיתוב לתמונה.

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

צורת השימוש היא (המרחאות מסביב למילה caption הן בכדי למנוע את הפעלת קוד הקיצור וצריך להוריד אותן בשימוש אמיתי)

['caption' width="300" caption="הופעה"]<a href="http://wordpress.marksw.com/wp35/files/2013/01/IMG_0526.jpg"><img title="IMG_0526" src="http://wordpress.marksw.com/wp35/files/2013/01/IMG_0526-300×224.jpg" alt="" width="300" height="224" /></a>[/'caption']

הופעה

פרמטרים:

  • caption (חובה) – הכיתוב שיוצג
  • width (חובה) – רוחב הכיתוב
  • align – לאן ייושר טקסט הכיתוב. ערכים אפשריים:
    • alignnone – ללא ישור
    • alignright – מיושר לימין
    • alignleft – מיושר לשמאל
    • aligncenter – ממורכז
  • id – שם מזהה למתן אפשרות לעיצוב יעודי

קוד מקוצר gallery

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

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

צורת השימוש הפשוטה היא (המרחאות מסביב למילה gallery הן בכדי למנוע את הפעלת קוד הקיצור וצריך להוריד אותן בשימוש אמיתי)

['gallery']

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

פרמטרים אפשריים:

  • columns – מספר העמודות שישמשו להצגת הגלריה
  • link – אם הערך שלו הוא "file", במקום קישור לדף המדיה יהיה קישור לגירסאת התמונה המלאה
  • size – גודל התמונות המוצגות. הערכים האפשרים הם:
    • thumbnail – יוצגו תמונות קטנות בגודל המוגדר בהגדרות המדיה תחת "תמונה מוקטנת"
    • medium – יוצגו תמונות קטנות בגודל המוגדר בהגדרות המדיה תחת "בינוני"
    • large – יוצגו תמונות קטנות בגודל המוגדר בהגדרות המדיה תחת "גדול"
    • full – יוצגו התמונות המלאות
      תבניות ותוספים עשויים להגדיר גם גדלים אחרים בהם ניתן יהיה להשתמש.
  • include – רשימה של מספרים מזהים של קבצי המדיה של תמונות אותן רוצים להציג כחלק מהגלריה. תמונות אלו לא חייבות להיות משויכות לפוסט. אם include="5,8" יוצגו תמונות שקבצי המדיה שלהן מזוהים במספרים 5 ו 8 (איך למצוא מספר מזהה של קובת מדיה)
  • exclude – רשימה של מספרים מזהים של קבצי המדיה של תמונות אותן לא רוצים להציג כחלק מהגלריה למרות שהן משויכות לפוסט. אם exclude="5,8" לא יוצגו תמונות שקבצי המדיה שלהן מזוהים במספרים 5 ו 8 (איך למצוא מספר מזהה של קובת מדיה)
  • id – בגלריה יוצגו תמונות המשויכות לפוסט שהמספר המזהה שלו ניתן בפרמטר הזה. אם id="5" יוצגו תמונות המשויכות לפוסט מספר 5. (איך למצוא מספר מזהה של פוסט)
  • ids – רשימה של מספרים מזהים של קבצי המדיה של תמונות אותן רוצים להציג כחלק מהגלריה. תמונות אלו לא חייבות להיות משויכות לפוסט. אם ids="5,8" יוצגו תמונות שקבצי המדיה שלהן מזוהים במספרים 5 ו 8 (איך למצוא מספר מזהה של קובת מדיה)
  • orderby – קביעת פרמטר המיון לפיו תבוצע הצגת התמונות. האפשרויות הן:
    • menu_order – לפי מספר ה"סדר" של התמונה בין התמונות המוצגות
    • title  – לפי כותרת קובץ המדיה של התמונה
    • post_date – לפי תאריך הפרסום של קובץ המדיה של התמונה
    • rand – אקראי
    • ID – לפי סדר העלאת התמונות
  • order – סוג המיון עולה או יורד. ערכים אפשריים הם
    • ASC – עולה
    • DESC – יורד
  • itemtag – תג הHTML  בו מוכלת כל תמונה והכותרת שלה. ברירת המחדל היא dl
  • icontag – תג הHTML  בו מוכלת כל תמונה. ברירת המחדל היא dt
  • captiontag – תג הHTML  בו מוכלת כל כותרת של תמונה. ברירת המחדל היא dd

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

קוד מקוצר embed

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

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

  • width – מספר המציין את הרוחב המירבי בפיקסלים שהתוכן יתפוס. אם לא מצוין הרוחב המירבי יעשה שימוש ברוחב המוגדר תחת "מידות מרביות להטמעה" בהגדרות המדיה
  • height – מספר המציין את הגובה המירבי בפיקסלים שהתוכן יתפוס. אם לא מצוין הגובה המירבי יעשה שימוש בגובה המוגדר תחת "מידות מרביות להטמעה" בהגדרות המדיה

[’embed' width="200" height="200"]http://www.youtube.com/watch?v=iUrzicaiRLU[/’embed']

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

קובץ מדיה

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

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

קבצי מדיה יש תמיד את התכונות הבאות:

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

לתמונות יש גם

  • טקסט חלופי – הטקסט שיוצג כאשר הדפדפן לא מצליח להציג את התמונה