עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=globalpreferences
- יחידה זו דורשת הרשאות קריאה.
- היחידה הזאת דורשת הרשאות כתיבה.
- יחידה זו מקבלת רק בקשות POST.
- מקור: GlobalPreferences
- רישיון: GPL-2.0-or-later
שינוי ההעדפות הגלובליות של המשתמש הנוכחי.
ניתן לשנות באופן מקומי רק העדפות שקיימות באתר הוויקי הנוכחי.
- reset
איפוס ההעדפות הגלובליות. אפשרות זו תסיר את כל ההעדפות הגלובליות, או רק סוגים מסוימים שלהן בהתאם לערך של הפרמטר
resetkinds
, ותגרום לכך שהן לא תהיינה גלובליות יותר.- סוג: בוליאני (פרטים)
- resetkinds
רשימה של סוגי ההעדפות שתאופסנה כשהאפשרות reset מוגדרת.
- ערכים (מופרדים באמצעות "|" או or תו חלופי): all, registered, registered-checkmatrix, registered-multiselect, special, unused, userjs
- ברירת המחדל: all
- change
רשימת השינויים, בתסדיר name=value (למשל skin=vector). אם לא מצוין ערך (וגם לא סימן =), למשל, preferencename|otherpreference|..., ההעדפה תוגדר כבלתי־גלובלית. אם הערך הרלוונטי מכיל תו קו ניצב (|), יש להשתמש במפריד הערכים החלופי כדי שהפעולה תתבצע כראוי.
- הפרדה בין ערכים נעשית באמצעות | או תו חלופי.
- המספר המרבי של ערכים הוא 50 (או 500 עבור לקוחות שמותרות להם מגבלות גבוהות יותר).
- optionname
שם ההעדפה שתוגדר לערך שסופק על־ידי optionvalue.
- optionvalue
הערך של ההעדפה המצוינת בפרמטר optionname.
- token
אסימון "csrf" שאוחזר מ־action=query&meta=tokens
- הפרמטר הזה נדרש.
- הפיכת העדפה אחת לבלתי־גלובלית.
- api.php?action=globalpreferences&change=skin=&token=123ABC [פתיחה בארגז חול]
- הפיכת כל ההעדפות לבלתי־גלובליות.
- api.php?action=globalpreferences&reset=&token=123ABC [פתיחה בארגז חול]
- שינוי ההעדפות skin ו־hideminor.
- api.php?action=globalpreferences&change=skin=vector|hideminor=1&token=123ABC [פתיחה בארגז חול]