שיחת מדיה ויקי:Common.js/externalsmaker.js

בעיות ושאלות בוויקיפדיה:בוקמרקלטים

הסבר על הDATA

• hostname - כתובת השרת הרלוונטית לתבנית.
• hrefmatch (אופציונאלי) - בדיקה נוספת שמבוצעת מול כל הכתובת.
• minimum (אופציונאלי) - מספר פרמטרים שלא למחוק גם אם הם ריקים ואחרונים. מיועד בעיקר כנוגדן לבעיה של תבניות ישנות שמוסיפות כוכבית לפני הקישור אם פרמטר מסוים לא קיים.
• params - מערך של הפרמטרים. לפי הסדר של התבנית.
  • str (נקודת מוצא) - המחרוזת שממנה יש להתחיל את העיבוד. (לדוגמה שם התבנית (שלא משתנה) או location.href בשביל הכתובת)
  • elem (נקודת מוצא) - XPATH בסגנון jQuery של האלמנט שממנו יש להתחיל. ניתן לשים מערך שהאיבר הראשון הוא הXPATH והשאר הם פונקציות jQuery שישורשרו. (בסוף תמיד מבוצע ()html)
  • telem (נקודת מוצא) - XPATH בסגנון jQuery של האלמנט שממנו יש להתחיל. ניתן לשים מערך שהאיבר הראשון הוא הXPATH והשאר הם פונקציות jQuery שישורשרו. (בסוף תמיד מבוצע ()text)
  • urlparam (נקודת מוצא)- פרמטר GET מהכתובת.
  • elements (נקודת מוצא - להשתמש רק בעת הצורך!) - מערך שהאיבר הראשון הוא XPATH שנותן מספר תוצאות. התוצאה שמתקבלת היא תוכן (html) האלמנטים מופרדים עם האיבר השני.
  • telements (נקודת מוצא - להשתמש רק בעת הצורך!) - מערך שהאיבר הראשון הוא XPATH שנותן מספר תוצאות. התוצאה שמתקבלת היא תוכן (text) האלמנטים מופרדים עם האיבר השני.
  • match - ביטוי רגולרי שיש לתפוס אותו (בסגנון js)
  • split - תו לפיו יש לשבור. (שימושי בשימוש עם פונקציות)
  • func - פונקציה בעלת פרמטר אחד שמחזירה משהו שישמש במקום הערך הנכנס. ניתן לשים מערך של פונקציות והם ישורשרו אחת אחרי השנייה. יש מספר פונקציות שכבר קיימות:
    • dateFormat - הפונקציה מקבלת מערך בן 3 איברים (יום,חודש,שנה) ומחזירה מחרוזת בעברית המתארת את התאריך. אם זה לא מערך היא מוציאה אותו כמו שהגיע. (שימושי יחד עם split)
  • remove - מערך (חובה מערך גם אם איבר בודד!) של מחרוזות/ביטויים רגולרים שיש למחוק. מגיע עם ATags שמוחק תגי פתיחה וסגירה של קישורים.
  • defvalue - ערך ברירת מחדל בתבנית שיש למחוק אם זהה. (לא ב-remove לשינויים עתידיים)
  • shouldnt - אם הביטוי (REGEX) מתקיים התוכן מתנקה.

דוגמה

אקח לדוגמה את {{0404א}}:

		{
			hostname: "www.0404.co.il", // כתיבת האתר הרלוונטית
			params: [
				{ str: '0404א' }, // שם התבנית
				{ telem: '.post_admin' }, // ה"קלאס" לשם הכתב
				{ telem: '.stitle' }, // ה"קלאס" לכותרת הכתבה
				{ urlparam: 'p' }, // פרמטר מה-url
				{ telem: '.post_date', date: '/' }, // קלאס" לתאריך פרסום", יחד עם המידע שהפורמט הוא תאריך מופרד בלוכסנים
			]
		},