Difference between revisions of "SAM V2:customization"

From CIDI Wiki
Jump to navigation Jump to search
Line 68: Line 68:
==How to Add a Field to a Table and Form==
==How to Add a Field to a Table and Form==


1. Add the field to the underlying table in MySQL.  For example, to add a field called Evaluator Name to the disabilities table, you would execute a SQL statement similar to:
1. Add the field to the underlying table in MySQL.  For example, to add a field called evaluator_name to the disabilities table, you would execute a SQL statement similar to:


<pre>alter table disabilities add column evaluator_name varchar(50) … </pre>
<pre>alter table disabilities add column evaluator_name varchar(50) … </pre>
Line 76: Line 76:
2. In the disability subdirectory, you will need to modify the programs add.php, edit.php, and view.php to handle the new evaluator_name field.
2. In the disability subdirectory, you will need to modify the programs add.php, edit.php, and view.php to handle the new evaluator_name field.


3. In add.php, you would add a table row for the new field with 2 table columns, one for the label, and one for the input of the value for evaluator_name.  
3. In add.php, you would add a table row for the new field with 2 table columns, one for the field label, and one for the input of the value for evaluator_name.  


<pre>
<pre>
Line 85: Line 85:
   </td>
   </td>
</tr>
</tr>
</pre>
4.  If the field requires validation, then the validateForm javascript function should be modified to perform validation.  For example, to make the evaluator_name field required, add:
<pre>
if(theForm.evaluator_name.value == "") {
  alert('Please enter a value for the "Evaluator Name" field.');
  theForm.evaluator_name.focus();
  return (false);
}
</pre>
</pre>

Revision as of 14:14, 17 May 2011

Since SAM V2 is open-source software, it is easily customized with a working knowledge of HTML, PHP, MySQL, and the SAM source code/database structure.

Tables Names and Directory Structure

  Table Name Subdirectory Name
Student students student
Disabilities disabilities disability
Accommodations accommodations accommodation
Consents consent_types consent
Referrals referrals referral
Case Notes case_notes case
Tasks tasks task
Documentation documentation doc
Tests tests test
Class Schedules class_schedules schedule
Orders orders order

How to Add a Field to a Table and Form

1. Add the field to the underlying table in MySQL. For example, to add a field called evaluator_name to the disabilities table, you would execute a SQL statement similar to:

alter table disabilities add column evaluator_name varchar(50) … 

Or you could use the MySQL workbench to alter the table.

2. In the disability subdirectory, you will need to modify the programs add.php, edit.php, and view.php to handle the new evaluator_name field.

3. In add.php, you would add a table row for the new field with 2 table columns, one for the field label, and one for the input of the value for evaluator_name.

<tr>
   <td align="right"><label for="evaluator_name"><strong>Evaluator Name</strong></label></td>
   <td>
      <input type="text" name="evaluator_name" />
   </td>
</tr>

4. If the field requires validation, then the validateForm javascript function should be modified to perform validation. For example, to make the evaluator_name field required, add:

if(theForm.evaluator_name.value == "") {
   alert('Please enter a value for the "Evaluator Name" field.');
   theForm.evaluator_name.focus();
   return (false);
}