Manual:Extensions/he

הרחבות:

הרחבה מאפשרת לך להתאים אישית את המראה והפעולה של מדיה-ויקי.

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

בחירת הרחבות

הרחבות מקובצות

מספר הרחבות כלולות במדיה-ויקי כסטנדרט.

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

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

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

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

הרחבות גלישה

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

בדיקת הרחבות מותקנות

ניתן לבדוק אילו הרחבות פעילות במופע מסוים של מדיה-ויקי על ידי גישה לדף Special:Version וגלילה מטה לכותרת הרחבות מותקנות (קישור עוגן #mw-version-ext). לדוגמה, הרחבות אלה מותקנות בויקי זה, והרחבות אלה פעילות בויקיפדיה האנגלית.

הרחבות פופולריות

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

לתוספים שמורדים מ-MediaWiki.org דרך מנגנון ExtensionDistributor נאספים נתונים סטטיסטיים מסוימים. 15 ההרחבות שהורדו הכי הרבה רשומות ב-Special:ExtensionDistributor, וספירת ההורדות של ההרחבות הרלוונטיות מוצגת בתיבת המידע שלהם. שימו לב שמספרים אלה אינם מתחשבים בדרכים חלופיות להתקנת הרחבות, כגון דרך Git או Composer.

אפשרות נוספת היא לבדוק את ספירת הויקי של WikiApiary שבהם מותקנות הרחבות. יש לכך יתרון בכך שהוא מייצג התקנות בפועל ולא רק הורדות (כלומר, הוא מבצע שאילתות על ממשקי ה-API של הויקי), אך הוא גם (נכון לשנת 2023) אינו מעודכן לחלוטין. הוא גם לא סופר התקנות באתרי ויקי פרטיים.

התקנת הרחבה

להדרכה נוספת, ראו גם Manual:Extensions/Installation and upgrade

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

  1. לפני שאתם מתחילים
    הרחבות רבות מספקות הוראות שנועדו להתקנה באמצעות פקודות יוניקס.אתה זקוק לגישת מעטפת (SSH) כדי להזין פקודות אלה המפורטות בדפי העזרה של ההרחבה.
  2. הורידו את ההרחבה שלכם
    Extension Distributor עוזר לך לבחור ולהוריד את רוב התוספים הפופולריים.
    הרחבות מופצות בדרך כלל כחבילות מודולריות.הן בדרך כלל נכנסות לתת-ספרייה משלהן של $IP/extensions/.רשימת הרחבות המאוחסנות במאגר Git של ויקימדיה נמצאת בכתובת git:mediawiki/extensions.חלק מההרחבות אינן משתמשות בבקרת גרסאות ואינן מומלצות.
    חלק מההרחבות זמינות גם בקבוצות, Composer או מאגרי חבילות.
    מומלץ לקרוא את קובץ README לפני ההתקנה.בדרך כלל הוא מכיל מידע חשוב על תצורה.
  3. התקינו את ההרחבה שלכם
    בסוף קובץ ה-LocalSettings.php, הוסף:
    wfLoadExtension( 'ExtensionName' );
    שורה זו מאלצת את מפרש ה-PHP לקרוא את קובץ ההרחבה, ובכך להפוך אותו לנגיש למדיה-ויקי.
    חלק מההרחבות עלולות להתנגש עם סקריפטים של תחזוקה, לדוגמה אם הן ניגשות ישירות ל-$_SERVER (לא מומלץ). במקרה זה, ניתן לעטוף אותם בתנאי כך שהסקריפטים לתחזוקה עדיין יוכלו לפעול.
    if ( !$wgCommandLineMode ) {
   wfLoadExtension ( 'ExtensionName' );
}
    סקריפט התחזוקה importDump.php ייכשל עבור כל הרחבה הדורשת מרחבי שמות מותאמים אישית אשר כלולים בתוך התנאי שלמעלה, כגון Extension:Semantic MediaWiki, Extension:Page Forms.
ודא שההרשאות הנדרשות מוגדרות עבור ההרחבות!
בעוד שהליך התקנה זה מספיק עבור רוב ההרחבות, חלקן דורשות הליך התקנה שונה.עיין בתיעוד של ההרחבה שלך לקבלת פרטים.
אם ברצונך לשנות משתני תצורה ב-LocalSettings.php, עליך לעשות זאת בדרך כלל לאחר הכללת ההרחבה.אחרת, ברירות המחדל המוגדרות בהרחבה ידרסו את ההגדרות שלך.

שדרוג הרחבה

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

  1. הורד את הגרסה החדשה של ההרחבה
  2. החלף את כל קבצי ההרחבה בספריית extensions/ExtensionName בקבצים החדשים.אל תסיר את תצורת ההרחבה הקיימת ב-LocalSettings.php
  3. אם ההרחבה דורשת שינויים במסד הנתונים של מדיה-ויקי, תצטרכו להפעיל את סקריפט התחזוקה של update.php.רוב התוספים יציינו אם יש להריץ סקריפט זה או לא.(בצע גיבוי של הנתונים שלך לפני ביצוע הסקריפט).אם אין לך גישה משורת הפקודה, תוכל גם להשתמש במעדכן אתרים.
הוראות אלה מכסות 99% מההרחבות.אם להרחבה הספציפית שאתה משדרג יש הוראות שונות מאלה, כנראה שעליך לפעול לפי ההוראות של ההרחבה הספציפית.

הסרת התקנת הרחבה

הסר את השורה מ-LocalSettings.php עם שם ההרחבה כדי להסיר אותה:

wfLoadExtension( 'ExtensionName' );
  • עליך גם להסיר כל שורה הקשורה לתצורת ההרחבה.

פיתוח הרחבות

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

משתמשים יכולים גם להגיש בקשה כללית ב-Phabricator, ולקוות שהרעיון הטוב שלכם ייקלט על ידי מפתח. ראו https://phabricator.wikimedia.org/tag/mediawiki-extension-requests/


ראו גם

Category:Customization techniques/he#Extensions/he Category:Extension creation/he
Category:Customization techniques/he Category:Extension creation/he