מהי הפונקציה: the_title() וכיצד נכון להשתמש בה?

the_title()

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

1. הפרמטר ראשון: $before פרמטר זה הינו אופציונלי ומשמש להצגת טקסט לפני הצגת הכותרת
2. הפרמטר שני: $after פרמטר זה הינו אופציונלי ומשמש, בדומה לסעיף מס' 1, להצגת טקסט אחרי הצגת הכותרת
3. פרמטר שלישי: $echo פרמטר זה הינו אופציונלי ומסוג Boolean אשר מאפשר לקנפג האם להציג (echo) את הכותרת או לחילופין- להחזיר אותה (return) כאשר הערך הדיפולטי הוא True, מה שאומר שהכותרת תוצג.

דוגמאות למימוש הפונקציה the_title()

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

ובכן, יש שיגידו (ובצדק) שניתן לעשות זאת בדרך הבאה:

<h1> <?= the_title(); ?> </h1>

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

<?php the_title( '<h1>', '</h1>'); ?>

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

עוד אודות הפונקציה ניתן לקרוא ב- Codex הרשמי של וורדפרס

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