ויקיפדיה:פיתוח התשתית/וקטור/התאמה אישית של כפתורים

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

• את הקוד יש להכניס לדף דף המשתמש שלי/vector.js.
• את הקוד יש להעתיק ישירות מדף זה, ולא במצב עריכה. ניתן להיעזר בכפתור Ctrl + עכבר שמאלי (או שלושה קליקים רצופים) כדי לסמן טקסט מנקודה מסוימת עד סוף הבלוק.
• ניתן להיעזר בדלפק הייעוץ אם אתם נתקלים בתקלה.

התחלה וסוף

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

if ( typeof $j != 'undefined' && typeof $j.fn.wikiEditor != 'undefined' ) {
$j(document).ready( function() {


	// put your configuration here


} );
}

כפתור חדש

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

לכן, תחילה יש לאתר היכן אתם מעוניינים להכניס את הכפתור החדש. למשל, אם תרצו להכניס אותה תחת תפריט מתקדם, בסוף, תבחרו בקטע advanced ובקבוצה more. דוגמה נוספת, אם תרצו להכניס את הכפתור בתצוגה הראשית, תבחרו בקטע main ובקבוצות others או insert או format.

להלן הקוד הבסיסי אותו יש להעתיק, על בסיס כפתור מרכוז:

	// כפתור למרכוז הטקסט
	$j( '#wpTextbox1' ).wikiEditor( 'addToToolbar', {
		'section': 'advanced',
		'group': 'more',
		'tools': {
			'center': {
				label: 'טקסט ממורכז',
				type: 'button',
				icon: 'http://upload.wikimedia.org/wikipedia/commons/thumb/c/ce/center.png',
				action: {
					type: 'encapsulate',
					options: {
						pre: '<center>',
						peri: "טקסט ממורכז",
						post: "</center>"
					}
				}
			}
		}
	} );

לאחר שהעתקתם את הקוד הנ"ל, יש לשנות כמה דברים:

• בתחילת הקוד כדאי לשנות את השורה הראשונה ולהוסיף תיאור של הכפתור החדש.
• יש לבחור ב-section וב-group המתאים. אם למשל, בחרתם בקטע main, יש לשנות את advanced ל-main. אם בחרתם בקבוצה insert, יש לשנות את ה-more ל-insert.
• יש לשנות את המילה center בשורה החמישית לתיאור הכפתור, ללא רווחים. למשל, אם הוספתם כפתור מקף, כתבו hyphen או תיאור דומה אחר.
• בשורה שלאחר מכן, יש לשנות את הכיתוב "טקסט ממורכז".
• שתי שורות אחר כך, היכן שאפשר לראות קישור לקובץ, יש להוסיף קישור לאייקון הכפתור. שימו לב שמדובר בנתיב המלא של הקובץ.
• כמה שורות לאחר מכן מוגדר התוכן שנוסף לתיבת העריכה, בשלוש שורות. בראשונה יש את תג הפתיחה, בשנייה מופיע הטקסט ברירת המחדל ובשלישית תג הסגירה. שנו את הטקסט בהתאם.
• אם אין לכם תגי פתיחה וסגירה (למשל, הוספת מקף):
  • השאירו את טקסט ריק (כלומר, זוג גרשיים בלי תוכן), או
  • מחקו את שתי השורות האחרונות peri ו-post, וגם את הפסיק שבשורה pre. את התוכן הוסיפו בשורה pre.

שינוי כפתור קיים

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

בכל מקרה, להלן דוגמה לשינוי כפתור החתימה מארבעה סימני ~~~~ לשלושה סימני ~~~:

addOnloadHook(function() {
	if ( typeof $j != 'undefined' )
	{
		$j( '#wpTextbox1' ).bind( 'wikiEditor-toolbar-buildSection-main', function( e, section ) {
			section.groups.insert.tools.signature.action.options.post = '~' + '~~';
		} );
	}
});

הוספת קודים ותבניות

ראו שיחת מדיה ויקי:Templateslist.js להוראות.