ולידציה של טפסים בדרופל 6 ו-7

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

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

hook_form_alter

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

/**
 * 
 * Implementation of hook_form_alter - adding validation function
 * @param $form
 * @param $form_state
 * @param $form_id
 */
function MY_MODULE_form_alter(&$form, &$form_state, $form_id) {
	$form['#validate'][] ='MY_MODULE_validate'; //for sending mail to admin in publish
}

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

MY_MODULE_validate

זו הפונקציה העיקרית שבה מתרחשת הולידציה. היא מקבלת שני פרמטרים עיקריים – form_id$ ו-form_values$ כאשר form_values$ הוא לא רק פוינטר אלא משהו שאנחנו יכולים לשלוט עליו. הוא מכיל את כל הערכים של הטופס שנשלח. אם נעשה לצורך העניין var_dump נוכל לראות את כל המערך ולשנות אותו כרצוננו.

function MY_MODULE_validate($form_id, &$form_values) {
	var_dump($form_values);
}

בואו ונניח שאני רוצה לבדוק את ה-teaser ולוודא שיש בו את המילה moshe. מה שאצטרך לעשות הוא:

function MY_MODULE_validate($form_id, &$form_values) {
	$teaser = $form_values['values']['field_teaser'][0]['value'];
	if(!preg_match('/moshe/', $teaser)) {
		//error
	}
}

form_set_error

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

function MY_MODULE_validate($form_id, &$form_values) {
	$teaser = $form_values['values']['field_teaser'][0]['value'];
	if(!preg_match('/moshe/', $teaser)) {
		form_set_error('teaser', t('Please add the name moshe!') );
	}
}

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