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