הרחבה:InputBox

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:InputBox and the translation is 80% complete.
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎polski • ‎português • ‎português do Brasil • ‎čeština • ‎русский • ‎עברית • ‎中文 • ‎日本語 • ‎한국어
This extension comes with MediaWiki 1.21 and above. Thus you do not have to download it again. However, you still need to follow the other instructions provided.
MediaWiki extensions manual
OOjs UI icon advanced.svg
InputBox
Release status: stable
Simple Input Form.png
Implementation Tag , Page action , Search
Description מאפשרת למשתמשים להוסיף טפסי HTML מוגדרים מראש לדפי ויקי
Author(s)
  • Erik Möller
  • Leonardo Pimenta
  • Rob Church
  • Trevor Parscal
  • Daniel Schuba
Latest version Continuous updates
MediaWiki 1.30+
Database changes No
License MIT License
Download
* <inputbox>
Translate the InputBox extension if it is available at translatewiki.net
Check usage and version matrix.
Issues Open tasks · Report a bug

הרחבת InputBox (בעברית: "תיבת־קלט") מוסיפה טפסי HTML שנוצרו מראש לדפי ויקי. משתמשים יכולים "להשלים" טופס (להזין טקסט, לבחור פריטי תפריט וכו') על ידי הקלדת טקסט לתוך תיבה.

InputBox נוצרה במקור על ידי Erik Möller במטרה להוסיף תיבת Create an article לוויקיחדשות.

התקנה

  • Download and place the file(s) in a directory called InputBox in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'InputBox' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension(). If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier), instead of wfLoadExtension( 'InputBox' );, you need to use:

require_once "$IP/extensions/InputBox/InputBox.php";

דוגמה

תיבה להתחלת ערך חדש.

קוד ויקי

<inputbox>
type=create
break=no
</inputbox>

תוצאה

תחביר כללי

תיבות קלט נבנות בערך כך:

<inputbox>
type=
bgcolor=
width=
page=
default=
preload=
editintro=
buttonlabel=
hidden=
searchbuttonlabel=
fulltextbutton=
labeltext=
break=
namespaces=
prefix=
placeholder=
minor=
nosummary=
summary=
id=
inline=
dir=
preloadparams[]=
searchfilter=
useve=
arialabel=
</inputbox>

הפרמטר type הוא חובה. כל שאר הפרמטרים הם אופציונליים. preloadparams[] יכולים להופיע יותר מפעם אחת.

סוגי תיבות

מיקום ברירת המחדל של כפתור(י) ה־"Submit" הוא מתחת לתיבת הקלט.


כפתור ה־"Submit" ניתן להזזה לימין לתיבה באמצעות שימוש בפרמטר שבירת השורה כדי לבטל את השבירה בין התיבה לכפתור: break=no.

Having the “Submit” button to the right is useful for search boxes when search suggestions would otherwise cover up a search button below the search box.

סוג דוגמה תיאור
type=search
יוצר תיבת חיפוש בעלת רוחב ברירת מחדל של 50 תווים. מידע שמתווסף לתיבת הטקסט מועבר לדף החיפוש.
type=create

יוצר דף חדש. המידע שמתווסף לתיבת הטקסט מהווה את השם של הדף שאותו רוצים לערוך.
type=comment

מוסיף פסקה חדשה בסוף הדף שצויין בתיבת הטקסט.
type=commenttitle

מוסיף פסקה חדשה עם הכותרת שהוזנה בתיבת הטקסט. ניתן לציין את הכותרת עם הפרמטר default=. הדף חייב להיות מצויין בפרמטר page=. (introduced in rev:47203)
type=fulltext
חיפוש רק עם הכפתור לחיפוש טקסט־מלא, ללא כפתור ה־"Go". (introduced in rev:45269)
type=move

העברת דף לשם אחר. (introduced in gerrit:97559)

עבור type=search2, מיקום ברירת המחדל של כפתור החיפוש הוא מימין לתיבה. נכון לעכשיו לא נראה אפשרי להוסיף פרמטרים אחרים לסוג זה של תיבת טקסט. תיבת הטקסט הזאת מחפשת בכל אתר הוויקי שבו היא ממוקמת.

סוג דוגמה
type=search2
 

פרמטרים

פרמטר תיאור Scope תאימות דוגמה תוצאה
arialabel= Supply the aria-label attribute to the inputbox to allow generated markup be accessible to screen readers All types
1.35
Gerrit change 572050
<inputbox>
type=search
arialabel=Search the Wiki
</inputbox>
bgcolor= מגדיר את צבע הרקע (ערכי צבע של HTML). לא להשתמש במירכאות. כל הסוגים ?
<inputbox>
type=search
bgcolor=#eeeeff
</inputbox>
width= מגדיר את רוחב תיבת הקלט כמספר התווים המותרים להזנה. כל הסוגים ?
<inputbox>
type=create
width=24
</inputbox>

default= טקסט ברירת מחדל שיוכנס לתיבת הקלט. כל הסוגים ?
<inputbox>
type=comment
default=User talk:Eloquence
</inputbox>

preload= The page under this title will be preloaded (see Manual:Creating pages with preloaded text ) into the blank editbox when a new page is created. create, comment, commenttitle ?
<inputbox>
type=create
preload=Log
</inputbox>

יש להכניס את כותרת הדף (דף שעדיין לא קיים) בדוגמה הבאה לתוך תיבת הקלט, וללחוץ על "Create page" או על "New section" בהתאמה על מנת לנסות את האפקט.
editintro= הדף שהוגדר בפרמטר הזה יוצג, בתור תיבת הנחיות, "מעל" לחלון העריכה. create, comment ?
<inputbox>
type=comment
editintro=MediaWiki:Missingcommenttext
</inputbox>

buttonlabel= תווית זאת תופיע בכפתור הראשי בטופס. כל הסוגים ?
<inputbox>
type=comment
buttonlabel=Add new rumor
</inputbox>

hidden= פרמטר זה קובע שלא תהיה תיבת קלט.

אם עושים בו שימוש יחד עם הפרמטר "default", כעת לא יהיה טקסט ברירת מחדל, אלא ערך קבוע של שם הדף.

create, comment ?
<inputbox>
type=comment
editintro=Extension:InputBox/editintro comment
preload=Extension:InputBox/preload
hidden=yes
default=Extension talk:InputBox
buttonlabel=לפרסם תגובה בדף השיחה
</inputbox>

searchbuttonlabel= תווית זו תופיע בכפתור ה"חיפוש טקסט־מלא" בטופס החיפוש. search, fulltext ?
<inputbox>
type=search
searchbuttonlabel=לחפור לעומק
</inputbox>
fulltextbutton= הצגת כפתור החיפוש אחר טקסט־מלא בטופס החיפוש השני (search2) search2 ?
<inputbox>
type=search2
searchbuttonlabel=לחפור לעומק
fulltextbutton=true
</inputbox>
labeltext= טקסט להדפסה לפני הכפתור search2 ?
<inputbox>
type=search2
searchbuttonlabel=לחפור לעומק
labeltext=לחפש אחר: 
</inputbox>
 
break= Whether or not to insert a line break between the input box and the button(s). ברירת המחדל היא yes (להשתמש בשבירת שורה). כל הסוגים ?
<inputbox>
type=create
width=24
break=no
</inputbox>
namespaces= Support for namespace checkboxes in fulltext search.

With "Main**", main article namespace is checked by default.

search, fulltext ?
<inputbox>
type=search
namespaces=Main**,Help
</inputbox>
prefix=
  • Narrow down search to pages beginning with certain prefix. Note this only works with certain search back-ends, currently only Extension:CirrusSearch . Defaults to empty string (search all pages).
  • Create new page beginning with a certain prefix.
  • In type=move, the prefix is prepended to the default parameter.

Remark: underscores aren't recognized as spaces.

search, fulltext, create ?
<inputbox>
type=search
prefix={{FULLPAGENAME}}/Archive
</inputbox>

The button below prefixes the name with Special:Mypage/.


placeholder= Define placeholder text that will display in the input box when it is empty. כל הסוגים
1.19
<inputbox>
type=search
placeholder=לחפש בוויקי הזה
</inputbox>
page= הדף שאליו רוצים לפרסם תגובות, או הדף שרוצים להעביר. comment, move
<inputbox>
type=comment
page=Project:Sandbox
</inputbox>

minor= עריכה משנית. comment, create
<inputbox>
type=comment
page=Project:Sandbox
minor=true
</inputbox>

nosummary= תקציר עריכה (כותרת) היא לא חובה לתגובה חדשה. comment
<inputbox>
type=comment
page=Project:Sandbox
nosummary=true
</inputbox>

summary= תקציר עריכה או סיבת העברה. create, move
<inputbox>
type=create
default=Special:Mypage/inputbox test
summary=Foo
</inputbox>

id= מאפיין id עבור <form>. כל הסוגים
1.23
for some types
<inputbox>
type=comment
page=Project:Sandbox
summary=Foo
id=bar
</inputbox>

inline= הפיכת תיבת הקלט לאלמנט שמוכנס לאותה השורה (ללא שבירת שורה בהתחלה). search2
Text here: <inputbox>
type=search2
inline=true
width=10
</inputbox>
Text here:
 
dir= Right to left (rtl) or left to right (ltr). Defaults to directionality of the page's language. כל הסוגים
<inputbox>
dir=rtl
type=comment
page=Project:Sandbox
summary=Foo
</inputbox>

preloadparams[]= ציון פרמטרים לטקסט מוגדר מראש. ר' יצירת דפים עם טקסט מוגדר מראש. create, comment, commenttitle
1.25
<inputbox>
type=create
preload=Log
preloadparams[]=param1
preloadparams[]=param2
</inputbox>

searchfilter= Specify parameters to append to the search search
1.30
<inputbox>
type=search
searchfilter=insource:foo
</inputbox>
useve= When creating a page the input box will use the new visual editor, if the extension is installed, and this parameter is set to true. create, comment
<inputbox>
type=create
break=no
useve=true
</inputbox>

הגדרת create כשהוכנס שם של דף קיים פשוט תביא את דף העריכה. במקרה כזה אין התייחסות ל־preload. הגדרת comment עבור דף חדש תעבוד.

הטקסטים שנלקחו ממרחב MediaWiki: הם רק דוגמאות, כל דף קיים יכול להיות משומש ב־"editintro" או ב־"preload". לרוע המזל preload עדיין לא עובד בתקציר העלאת קובץ.

יישור

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

<div style="float:{{dir|{{pagelang}}|left|right}}; width:42em">
<inputbox>
type=create
</inputbox>
</div>

פונקציית מפענח

שימוש בתיבת קלט בתוך תבנית

כדי ליצור מספר תיבות קלט דומות, ניתן להשתמש ב־InputBox בתבנית. However, passing template parameters to InputBox parameters only works if the <inputbox>...</inputbox> tag is written as {{#tag:inputbox | ...}} inside the template.

הדוגמה הבאה היא תבנית ליצירת דף ויקי חדש מתוך תבנית קיימת:

{{#tag:inputbox |
type=create
buttonlabel=יצירת {{{1|ערך}}} חדש
preload={{{2|Template:Article}}} }}

When instantiating the template, the first parameter gives the item that is created (default: article) as spelled out in the button, the second parameter gives the name of the template used to create the item (default: Template:Article).

E.g., the code for an input box to create a new project from a project template might look like this:

{{Template:CreateNew|project|Template:Project}}

ראו גם