התקנה

לפני שתוכלו להתחיל להשתמש בנגיש לי, עליכם לדעת להשתמש בתכונות בסיסיות במחשב שלכם כמו חילוץ קבצים ולאחר מכן להעלות ולהגדיר את המיקום של התוסף בשרת שלכם. לאחר שחילצתם את כל הקבצים של התוסף, העלו את הקובץ 'nagishli.js' יחד עם התיקייה 'nl-files' אל השרת שלכם.

בדרך כלל, קוד ההתקנה של נגיש לי ייראה כך:

<script>
nl_lang = "he";
nl_pos = "tl";
nl_link = "0";
nl_color = "blue";
nl_compact = "0";
nl_accordion = "0";
</script>
<script type="text/javascript" charset="utf-8" src="path/to/nagishli.js" defer></script>

path/to/nagishli.js בקוד ההתקנה מייצג את מיקום קובץ התוסף על השרת שלכם.
לדוגמה, אם כתובת השרת שלכם היא http://www.mywebsite.co.il ושמתם את התוסף בתיקייה בשם "plugins", כדי להימנע מהתעסקויות מיותרות רצוי להשתמש בכתובת המלאה של מיקום התוסף. במקרה כזה, ככה השורה האחרונה של קוד ההתקנה צריכה להיראות:
<script type="text/javascript" charset="utf-8" src="http://www.mywebsite.co.il/plugins/nagishli.js"></script>

לאחר שהתקנתם, לנגיש לי יש מספר הגדרות שבאפשרותכם לשנות ולהגדיר.

nl_lang - מייצגת את שפת התוסף.
שתי האפשרויות הן:

  1. he (ברירת מחדל) עברית
  2. en אנגלית
דוגמה: nl_lang = "he";

nl_pos - מייצגת את מיקום התוסף בדפי האתר שלכם.

ארבעת האפשרויות הן:

  1. tl (ברירת מחדל) הפינה השמאלית העליונה
  2. bl הפינה השמאלית התחתונה
  3. tr הפינה הימנית העליונה
  4. br הפינה הימנית התחתונה
דוגמה: nl_pos = "tl";

nl_link - מייצגת את הצהרת הנגישות עבור התוסף.
שתי האפשרויות הן:

  1. 0 או ללא הגדרה (ברירת מחדל) התוסף ישתמש בהצהרת הנגישות שלו.
  2. קישור (לדוגמה: http:///www.mywebsite.co.il/negishut.html) התוסף יפתח את הקישור הזה בחלון חדש בעת לחיצה על האפשרות המתאימה.
דוגמה: nl_link = "http://www.localize.co.il/nagishli/accessibility.html";

nl_color - מייצגת את צבע התוסף.
האפשרויות הן:

  1. blue או ללא הגדרה - כחול (ברירת מחדל)
  2. red - אדום
  3. green - ירוק
  4. purple - סגול
  5. yellow - צהוב
  6. pink - ורוד
  7. gray - אפור
  8. brown - חום
  9. orange - כתום
  10. turquoise - טורקיז
דוגמה: nl_color = "orange";

nl_lic - מייצגת את רישיון התוסף.
הרישיון הנוכחי לא מאפשר לבצע אף שינוי בנגיש לי. רישיון הסרת זכויות היוצרים של התוסף מאפשרת בנוסף לשנות גם את הויזואליות שלו.

nl_dir - מייצגת את מיקום תיקיית קובצי התוסף (החל מנגיש לי בגירסה 2.1.1).
ההגדרה הזו מאפשרת להעביר את הקבצים של התוסף לכתובת אחרת ולהגדיר לו היכן הם נמצאים. מאז הוספת התמיכה באינטרנט אקספלורר 11, קבצים מסוימים שנלווים לתוסף נמצאים בתיקייה nl-files. לדוגמה, אם התוסף עצמו נמצא בתיקייה http://www.mywebsite.co.il/plugins/ (כמו בדוגמה למעלה), אז הוא יחפש את הקבצים הנלווים בכתובת http://www.mywebsite.co.il/plugins/nl-files/.
שתי האפשרויות הן:

  1. ללא הגדרה או nl-files (ברירת מחדל)
  2. כתובת מקומית או חיצונית
דוגמה: nl_dir = "http://www.mywebsite.co.il/images/";

nl_compact - מייצגת את גודל תוסף הנגישות כשהוא ממוזער (החל מנגיש לי בגירסה 2.2).
ההגדרה הזו משפיעה רק על סרגל התוסף ומאפשרת להציג רק את הלוגו כשתוסף הנגישות ממוזער וכך בעצם להפוך את תוסף הנגישות לסוג של לחצן.
שתי האפשרויות הן:

  1. ללא הגדרה (ברירת מחדל) התוסף יוצג כסרגל נגישות.
  2. 1 התוסף יוצג כלחצן נגישות.
דוגמה: nl_compact = "1";

nl_accordion - מייצגת את אופן הפתיחה והסגירה של תפריטי התוסף (החל מנגיש לי בגירסה 2.2).
ההגדרה הזו משפיעה רק על תפריטי התוסף ומאפשרת להציג רק תפריט אחד בכל פעם. הגדרה זו פועלת באופן אוטומטי במכשירים ניידים כדי להקל על השימוש בתוסף.
שתי האפשרויות הן:

  1. ללא הגדרה (ברירת מחדל) ניתן לפתוח כמה תפריטים בו זמנית.
  2. 1 ניתן לפתוח תפריט אחד בכל פעם.
דוגמה: nl_accordion = "1";