Webforms - Revision history

Zack at 21:05, 17 August 2012

2012-08-17T21:05:46Z

Zack: /* Manipulating the Form Using hook_mod_alter */

2012-08-17T21:01:18Z

Manipulating the Form Using hook_mod_alter

Zack: /* Manipulating the Form Using hook_mod_alter */

2012-08-17T20:59:59Z

Manipulating the Form Using hook_mod_alter

Zack: /* Manipulating the Form Using hook_mod_alter */

2012-08-17T19:16:51Z

Manipulating the Form Using hook_mod_alter

Zack: /* Manipulating the Form Using hook_mod_alter */

2012-08-17T19:16:32Z

Manipulating the Form Using hook_mod_alter

Zack: /* Manipulating the Form Using hook_mod_alter */

2012-08-17T19:15:40Z

Manipulating the Form Using hook_mod_alter

Zack: /* Manipulating the Form Using hook_mod_alter */

2012-08-17T19:15:01Z

Manipulating the Form Using hook_mod_alter

Zack: /* Manipulating the Form Using hook_mod_alter */

2012-08-17T19:09:05Z

Manipulating the Form Using hook_mod_alter

Zack: /* Manipulating the Form Using hook_mod_alter */

2012-08-17T19:04:44Z

Manipulating the Form Using hook_mod_alter

Zack at 00:02, 17 August 2012

2012-08-17T00:02:11Z

← Older revision		Revision as of 21:05, 17 August 2012
Line 86:		Line 86:
	}		}
	}</pre>		}</pre>
		+	#Test the form to see if it works!
		+
		+	===Customization===
		+	If you want to customize the text body of the emails that are sent you can do that in content->WEBFORM_NAME->edit->Webform tab->E-Mails-Form Settings->Advanced

@@ Line 68: / Line 68: @@
 :*An example would be $form['submitted']['recipient']['#value'] and $form['submitted']['recipient']['#webform_component']['value']
 #You should also note the structure of the array that contains the recipients name as well as the nid of the page node.
-#Within the switch we created on Templates.php, type:
+#Within the switch we created on Templates.php, type (changing capitalized parts to your field names as instructed):
   		case 'webform_client_form_[WEBFORM_NODE_HERE'] :

@@ Line 61: / Line 61: @@
   		switch ($form_id)
+  		{
-  		case 'webform_client_form_2516' :
+</pre>
-  			$touser = node_load($_GET['uid']);
+#Now you need to check the variable array you created. To do this, refresh the page containing the contact form
-  			$email = $touser->field_e_mail['und'][0]['value'];
+#The array hierarchy should appear at the top of the page above the content you. Search the page for the recipients field name that you created in the webform and note the structure of the array it is contained in.
-  			$name = $touser->title;
+:*This should start with "['submitted']"
-			$lname = $touser->field_bio_last_name['und'][0]['value'];
+:*Note -- the quotation marks within the brackets will not appear in the node array, but should be included in our script as written above.
-  			$form['submitted']['to']['#value'] = $name . " " . $lname;
+:*An example would be $form['submitted']['recipient']['#value'] and $form['submitted']['recipient']['#webform_component']['value']
-  			$form['submitted']['recipient']['#value'] = $email;
+#You should also note the structure of the array that contains the recipients name as well as the nid of the page node.
-  			$form['submitted']['recipient']['#webform_component']['value'] = $email;
+#Within the switch we created on Templates.php, type:
   			break;
+  		}
+  	}
-  	else if($current_url == "/contact-staff")
+  	else if($current_url == "URL_TO_WEBFORM_LOCATION") // (ex. "/webform")
+  	{
   		drupal_set_message($message = "You have not specified a user to email. Please return to <a href='people'>People</a> to chose a recipient.", $type = 'warning', $repeat = FALSE);

@@ Line 49: / Line 49: @@
 #Copy the template file "node.tpl.php" from the base theme templates folder to the "templates" folder within the subtheme directory
 #In the copied file, type at the top
-  <nowiki><?php echo "<pre>" ; print_r(get_defined_vars()); echo "</pre>";  ?></nowiki>
+  <pre><?php echo "<pre>" ; print_r(get_defined_vars()); echo "</pre>";  ?></pre>
 ##This will display the array of variables that are available to the webform on every node page (<strong>remember to remove this code when you are done!</strong>)
 #Go back a directory to your subtheme directory and open the file Template.php
 ##This is where we write the function to modify the form data
 #Type the following (replaceing SUBTHEME_NAME with the name of your subtheme, URL_PATH with the path to your webform)
-<nowiki>function [SUBTHEME_NAME_form_alter(&$form, $form_state, $form_id)
+<pre>function [SUBTHEME_NAME_form_alter(&$form, $form_state, $form_id)
+       {
   	$current_url = url($_GET['q']);
@@ Line 77: / Line 77: @@
   	hide($form);
+  	}
-       }</nowiki>
+       }</pre>

@@ Line 49: / Line 49: @@
 #Copy the template file "node.tpl.php" from the base theme templates folder to the "templates" folder within the subtheme directory
 #In the copied file, type at the top
-  <nowiki><pre><?php echo "<pre>" ; print_r(get_defined_vars()); echo "</pre>";  ?></pre></nowiki>
+  <nowiki><?php echo "<pre>" ; print_r(get_defined_vars()); echo "</pre>";  ?></nowiki>
 ##This will display the array of variables that are available to the webform on every node page (<strong>remember to remove this code when you are done!</strong>)
 #Go back a directory to your subtheme directory and open the file Template.php
 ##This is where we write the function to modify the form data
 #Type the following (replaceing SUBTHEME_NAME with the name of your subtheme, URL_PATH with the path to your webform)
-<pre><nowiki>function [SUBTHEME_NAME_form_alter(&$form, $form_state, $form_id)</code>
+<nowiki>function [SUBTHEME_NAME_form_alter(&$form, $form_state, $form_id)
+       {
   	$current_url = url($_GET['q']);
@@ Line 77: / Line 77: @@
   	hide($form);
+  	}
-       }</nowiki></pre>
+       }</nowiki>

← Older revision		Revision as of 00:02, 17 August 2012
Line 24:		Line 24:
	#Click Add		#Click Add
	#The form is now set up. You can view it by navigating to the URL that you gave the form in step 2(2).		#The form is now set up. You can view it by navigating to the URL that you gave the form in step 2(2).
		+
		+	==Manipulating the Form Using hook_mod_alter==
		+
		+	*hook_mod_alter allows us to extend the functionality of Webform
		+	**For our purposes, we need to make message submissions send to a staff member based on the users selection
		+	*There are three steps to this process
		+	#Sending user id (the node id of the recipients profile) as GET data from the users profile when the link "send email" is clicked
		+	#Retrieving the recipients email address and name from the database based on the NID from the url
		+	#Replacing the default recipient for in the form with the true recipients email
		+	*To send the NID as get data, go to the people or profile view set up for people
		+
		+	#In the view edit menu, add a new field for "NID"
		+	#Rearrange the fields so that "NID" is at the top of the list
		+	#Click the email field
		+	#Click "Rewrite Results"
		+	#Check the box labeled "Rewrite the output of this field"
		+	#In the textarea, type the path to your Webform followed by "?nid=[nid]"
		+	#Click Apply
		+	#Save the view
		+	#Check the link to make sure it takes you to the Webform and contains "?nid=" and then a number at the end of the URL
		+
		+	#Now we need to enter the template files and play around with some PHP
		+	#The template files are located in /sites/all/[subtheme name]/ and the templates folder within that directory
		+	#Copy the template file "node.tpl.php" from the base theme templates folder to the "templates" folder within the subtheme directory
		+	#In the copied file, type at the top
		+	<?php echo "<pre>" ; print_r(get_defined_vars()); echo "</pre>"; ?>
		+	##This will display the array of variables that are available to the webform on every node page (<strong>remember to remove this code when you are done!</strong>)
		+	#Go back a directory to your subtheme directory and open the file Template.php
		+	##This is where we write the function to modify the form data
		+	#Type the following (replaceing SUBTHEME_NAME with the name of your subtheme, URL_PATH with the path to your webform)
		+	function [SUBTHEME_NAME_form_alter(&$form, $form_state, $form_id)
		+	{
		+	$current_url = url($_GET['q']);
		+	if(isset($_GET['nid']) && ($current_url == 'URL_PATH'))
		+	{
		+	switch ($form_id)
		+	{
		+	case 'webform_client_form_2516' :
		+	$touser = node_load($_GET['uid']);
		+	$email = $touser->field_e_mail['und'][0]['value'];
		+	$name = $touser->title;
		+	$lname = $touser->field_bio_last_name['und'][0]['value'];
		+	$form['submitted']['to']['#value'] = $name . " " . $lname;
		+	$form['submitted']['recipient']['#value'] = $email;
		+	$form['submitted']['recipient']['#webform_component']['value'] = $email;
		+	break;
		+	}
		+	}
		+	else if($current_url == "/contact-staff")
		+	{
		+	drupal_set_message($message = "You have not specified a user to email. Please return to <a href='people'>People</a> to chose a recipient.", $type = 'warning', $repeat = FALSE);
		+	hide($form);
		+	}
		+	}