מה זה הקוד הזה?
המטרה של הדף הזה היא לתת מושג כללי מאיזה קוד בנוי תבנית ג'ומלה.
לא צריך להבהל, ולא להבין הכל. זה רק לתת מושגים כללים, ולהראות שזה לא מסובך.
תבניות ג'ומלה בניות מקוד PHP המשלב בתוכו HTML.
PHP היא שפת סקריפט לא פשוטה, אך בדרך כלל היישום שלה בתבניות ג'ומלה הוא מאוד בסיסי, וניתן להבנה כמעט טבעית. אי אפשר ללמד את כל השיטות והסוגים, אבל בסך הכל, הרוב הגדול של קוד תבניות ג'ומלה דומות מאוד. לכולם יש אותו מבנה בסיסי.
נסו את זה, גשו לתוך תקיות האתר שלכם > גשו לתוך תקיית template > בחרו את התבנית שלכם > גשו לקובץ INDEX.PHP
templates> your templates > index.php
הביטו בקובץ בעזרת עורך טקסט. בדרך כלל ניתן לזהות די בקלות את המבנה:
יש לנו דיבים <div> של HTML
<div class="example"> text </div>
ובתוך דיבים יש לנו קריאה לחלק אחר מהאתר של ג'ומלה. כאן בדוגמה יש לנו קריאה למודול בשם יוזר 1 .<div class="example">
<jdoc:include type="module" name="user1" />
</div>
כל מה שצריך להבין זה שתבניות ג'ומלה הן לא מסובכות, ובהחלט ניתן לשחק איתם בלי להבין יותר מדי בקוד.
מיקומים בתבנית
תבנית ג'ומלה בנויה על "מיקומים" ( position ) .
מיקומים אלו נקבעים על ידי שלד התבנית. התבנית בנויה מקוביות HTML . ובתוך הקוביות ניתן לשים "מיקום".
הנה דוגמה כיצד שמים "מיקום" בתוך קובייה של HTML:
<div class="example">
<jdoc:include type="module" name="mainmenu" title="user1" />
</div>
בתוך מיקום ניתן לשים מודול.
מודול הוא אלמנט סגור, ולרוב מהווה רכיב כל שהוא כמו סקרים, באנר, חדשות רצות ועוד.
בשביל לדעת מה הן המיקומים אשר קיימים בתבנית – נוכל להשתמש במספר דרכים:
1 – לגשת לאתר היצרן ולראות. בדרך כלל מפת המודולים באתר שלכם תופיע גם בתבנית שהורדתם, אם התקנתם מידע לדוגמה.
הנה מפה לדוגמה:

2 – להוסיף את הקוד הבא, אחרי שורת הכתובת: tp=1? - זה יציג לכם את המיקומים על המסך. נסו את זה על האתר הזה.
http://your-domain.co.il/?tp=1
3 – לא הכי יעיל, אבל בהחלט הכי נפוץ, הכנסו לתוך מנהל המודולים בפאנל הניהול של ג'ומלה > בחרו מודול, ושחקו עם המיקום שלו.
גמישות עם המיקומים והמודולים
המיקומים והמודולים מאפשרים גמישות רבה מאוד. זו היא רשימה של התכונות החשובות:
הסרה של מיקום
ניתן פשוט לא להשתמש במיקום. ואז למעשה הוא לא קיים.
שילוב של מיקום
ניתן לשלב מודול בתוך אייטם/מאמר תוכן. אם לדוגמה אנחנו רוצים לשלב משהו בתוך התוכן. למשל לדגומה כאן:
פשוט מוסיפים - אפשר לקרוא על כך עוד כאן.
לדוגמה כמאמר הזה נוסיף מודול של שורות מתחלפות:
הוספת מיקום
ניתן להוסיף מיקומים לכל תבנית ג'ומלה. זה אומנם דורש טיפה של קוד, אבל זה ממש פשוט.
מאתרים את המקום הרצוי עם פיירבאג. מוסיפים את הקוד הבא :
<div class="sample">
<jdoc:include type="modules" name="sample" style="xhtml" />
</div>
את מה שבתוך הקלאס "class="sample – תוסיפו בתוך קובץ ה CSS של האתר שלכם. זה יתן לכם עיצוב ייחודי במידה ואתם רוצים. לדוגמה מיקום עם רקע אדום.
.samp {background:red; }
את השם של המודול שנתתם בקוד שהוספתם, תוסיפו בתוך פאנל הניהול של ג'ומלה > במודול הרצוי > בתוך "מיקום". פשוט לכתוב בפנים, זה הכל.
והנה לכם מיקום חדש בתבנית עם מודול בפנים.