[מדריך] חלק אחרון - קבצי שפה, שחרור המוד - הפעם זה המדריך :)

מדריכים שונים ומגוונים לגרסה phpBB2. שימו לב - פורום זה הינו פורום ארכיון. התמיכה במערכת phpBB2 הופסקה.
BBman
חבר צוות phpBB ישראל לשעבר
חבר צוות phpBB ישראל לשעבר
הודעות: 1595
הצטרף: 13/02/2005 ב-13:50:52

[מדריך] חלק אחרון - קבצי שפה, שחרור המוד - הפעם זה המדריך :)

הודעה שלא נקראהעל ידי BBman » 10/04/2007 ב-15:36:40

שלום!

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


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

קבצי שפה

קבצי שפה נמצאים בתיקייה : phpBBHeb/language

קבצי השפה הם קבצים אשר בתוכם מוגדרים מפתחות של מערך שפה בשם lang.
ב-phpBB אנו יכולים לגשת לקבצי השפה על ידי קריאה להם :

קוד: בחר הכל

$lang['Name_of_key'];


כך שבמקום Name_of_key יהיה שם המפתח אליו אנו רוצים לגשת, כלומר המחרוזת או המילה אותה אנו רוצים לקרוא.

לדוגמא, ארצה לגשת למפתח המוגדר כבעל הערך "משתמשים רשומים", לכן אכתוב :

קוד: בחר הכל

$lang['Registered_users'];


כברירת מחדל, ל-phpBB מספר קבצי שפה :

  1. lang_main.php - פשוטו כמשמעו, קובץ שפה ראשי - מכיל את רוב המרוזות השימושיות
  2. lang_admin.php - אחראי על התוכן הכתוב הקשור בלוח הבקרה ובאפשרויות מנהל ראשי
  3. lang_bbcode.php - אחראי על התוכן של הפירוט של BBcode
  4. lang_faq.php - אחראי על תוכן השו"ת

הוספת פריטים לקובץ שפה

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

קוד: בחר הכל

$lang['The_Name_We_Want'] = 'תוכן המפתח';


כך שבמקום The_Name_We_Want יבוא שם שאנו בוחרים למפתח, ובמקום "תוכן המפתח" (אין להתעלם מגרשיים!) יבוא התוכן של המפתח אותו אנו רוצים.

משימה: הגדר 3 מפתחות של שפה אשר כל אחד לפי הסדר מכיל מחרוזת אחת מבין המחרוזות:

1.זה - מפתח 1
2.מפתח השפה - מפתח 2
3.החדש שלי - מפתח 3

ומשתנים לשימוש ב-TPL שיכילו מחרוזות אלו, ויציגו אותן בדף אחר.

פיתרון :

נפתח את lang_main.php ונוסיף באחד המקומות את המפתחות :

קוד: בחר הכל

$lang['ze'] = 'זה';
$lang['lang_key'] = 'מפתח השפה';
$lang['hadash'] = 'החדש שלי';


עצור! האם למדת להגדיר משתנים? אם לא, אנא קרא את המדריך ליצירת עמודים חדשים והגדרת משתנים (קישור בתחילת המדריך).

וכעת בקובץ php אחר (מומלץ הקובץ אותו יצרנו במדריך ליצירת עמודים חדשים) שנרצה נגדיר את המשתנים (וגם את התבנית) :

קוד: בחר הכל

   $template->assign_vars(array(
      'ZE'=>$lang['ze'],
      'LK'=>$lang['lang_key'],
      'NEW'=>$lang['hadash'],
                            )
                       );


ובקובץ TPL שנרצה פשוט נכתוב :

קוד: בחר הכל

{ZE} {LK} {NEW}


והנה התוצאות :

תמונה

* * *


בניית מדריך התקנה

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

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

קוד: בחר הכל

//My Mod

code

//End : My Mod


אם תפעלו על פי הטיפים האלו תחסכו לעצמכם זמן רב, זה מניסיון לא טוב :).

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

קובץ התקנה פשוט נראה כך:

קוד: בחר הכל

##############################################################
## MOD Title:      שם המוד
## MOD Author:      יוצר המוד
##
##
##
##תיאור המוד : תיאור המוד ופעולותיו בעברית
##
##Mod description : תיאור המוד ופעולותיו באנגלית (לא חובה, מומלץ)
##
##
## MOD Version:      גרסת המוד
##
## Installation Level:   רמת הקושי בהתקנה
## Installation Time:   זמן התקנה ממוצע
## Files To Edit: ( מספר הקבצים שצריכים לערוך )
##          קבצים שצריכים לערוך
##          מהראשון
##          לאחרון
##
##          
############################################################################################
## Before Adding This MOD To Your Forum, You Should Back Up All Files Related To This MOD
##לפני התקנת המוד מומלץ לגבות את כל הקבצים לעריכה ואת מסד הנתונים
############################################################################################
##

#-----[ פקודה ]------------------------------------------
#

 בלה בלה בלה

#
#-----[ פקודה ]-----
#

 בלה בלה בלה

#
#-----[ SAVE/CLOSE ALL FILES ]------------------------------------------
#
 


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

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

זמן התקנה: אותו הסיפור, ליוצר זמן ההתקנה לרוב יהיה קצר מהרגיל, לכן הכפילו את הזמן שלכם לקח להתקין ב-2 ועגלו את המספר שיצא, לדוגמא לקח לי 2 דקות להתקין את המוד, נכפיל ב-2 ונקבל 4- ונעגל ל-5 דקות.

פקודות

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

open - פתיחת קובץ
find - מציאת קטע קוד
add before/after - הוסף קטע X אחרי/לפני קטע Y
Replace, with - החלף קטע X ב- Y
SQL - הרץ שורות SQL
Copy - העלה קבצים לשרת
in line, find - חפש בתוך שורה/קטע

ויש עוד אני מניח, אבל אלו החשובות.

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

בהצלחה לכל יוצרי המודים!
BBman.
מור.
"Give a man a fish, and you feed him for a day. Teach a man to fish, and you feed him for a lifetime"

davidman
משתמש מתקדם
משתמש מתקדם
הודעות: 1078
הצטרף: 17/11/2004 ב-21:40:15
מיקום: ערד :-)

הודעה שלא נקראהעל ידי davidman » 10/04/2007 ב-17:46:50

כול הכבוד סדרת המדריכים הזאת מצויינת !
:)

idan0610
חבר צוות phpBB ישראל לשעבר
חבר צוות phpBB ישראל לשעבר
הודעות: 2126
הצטרף: 14/11/2004 ב-20:29:18

הודעה שלא נקראהעל ידי idan0610 » 10/04/2007 ב-18:59:37

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


חזור אל “מדריכים - ארכיון”

מי מחובר

משתמשים הגולשים בפורום זה: אין משתמשים רשומים ו־ 3 אורחים