Sample Code

class email_BasicContact, class email_PreviewEmail

Purpose: A php class that displays an email submission form, validates the input, and sends the email.

There are two main classes to this sample, both in the previously mentioned control/view format. The first example, email_BasicContact, illustrates the use of logic in a control method to determine component state from the input as opposed to acheiving it through a series of redirects between script pages. The second class, email_PreviewEmail, is an example of using class inheritance to override and extend component behavior--in this case to add a preview state to the component.

<?php define(STATE_INITIAL, 1); define(STATE_MISSING, 2); define(STATE_SUCCESS, 3); define(STATE_ERROR, 4); class email_BasicContact { var $objEmailCtrl; var $objUI; var $state; var $redirectURL; function email_BasicContact($name, $email) { $this->SetInitialState(); $this->objEmailCtrl =& new EmailCtrl(); $this->objUI =& new email_BasicContactUI(); $this->objEmailCtrl->SetTo($name, $email); $this->redirectURL = $_SERVER['PHP_SELF']; } function SetRedirect($sURL){ $this->redirectURL = $sURL; } function SetInitialState() { $this->state = STATE_INITIAL; } function SetMissingDataState() {$this->state = STATE_MISSING; } function SetSuccessState() { $this->state = STATE_SUCCESS; } function SetErrorState() { $this->state = STATE_ERROR; } function Control() { //read data $this->objUI->ContactFormIn($this->objEmailCtrl, $action); // print_r($this->objEmailCtrl); switch($action) { case "sendEmail": { if($this->IsDataValid($this->objEmailCtrl)) { if($this->objEmailCtrl->Send()) { $this->SetSuccessState(); } else { $this->SetErrorState(); } } else { $this->SetMissingDataState(); } break; } default: { $this->SetInitialState(); } } } function IsDataValid($objEmailCtrl) { if($objEmailCtrl->message == "" || !$objEmailCtrl->IsValidEmail($objEmailCtrl->fromEmail) || $objEmailCtrl->fromName == "") //validate data { return false; } else { return true; } } function View() { switch($this->state) { case STATE_SUCCESS: // message sent { $this->objUI->ViewSuccess($this->objEmailCtrl, $this->redirectURL); break; } case STATE_ERROR: { $this->objUI->ViewError(); break; } case STATE_MISSING: //error { $bMissing = true; } case STATE_INITIAL: //blank form default: { $this->objUI->ContactFormOut($this->objEmailCtrl, $bMissing); } } } function DisplayMessage() { switch($this->state) { case STATE_MISSING: { $this->objUI->MessageMissingData($this->objEmailCtrl); break; } case STATE_ERROR: { $this->objUI->MessageErrorSending(); break; } } } } //end class email_BasicContact class email_BasicContactUI { function email_BasicContactUI(){} function MessageErrorSending(){ echo "<p class='warning'>Error sending message</p>"; } function MessageMissingData($objEmailCtrl) { echo "<div class='warning'><p>Please fill the following fields:<br/>"; if($objEmailCtrl->fromName == "") { echo "<br/>*Name"; } if( !$objEmailCtrl->IsValidEmail($objEmailCtrl->fromEmail) ) { echo "<br/>*Email"; } if($objEmailCtrl->message == "") { echo "<br/>*Message"; } echo "</p></div>"; } function ViewError() { echo "<p><span class='message'>There was an error. Please try again later.</span><br/>"; echo "<a href='javascript:history.go(-1);'>Go Back</a><br/>"; echo "<a href='index.php'>Home</a></p>"; } function ViewSuccess($emailCtrl, $sURL) { echo "<p><span class='message'>The message has been sent</span></p>"; echo "<p>Wait to be redirected or <a href='". $sURL ."'>Click to Continue</a></p>"; ?> <script language="JavaScript"> function GoHome(sURL) { window.location = sURL; } setTimeout("GoHome('<?php echo $sURL; ?>')",3000); </script> <? } function ContactFormIn(&$emailCtrl, &$action) { $name = email_BasicContactUI::decodeHTML(stripslashes($_REQUEST[txtName])); $email = email_BasicContactUI::decodeHTML(stripslashes($_REQUEST[txtEmail])); $subject = email_BasicContactUI::decodeHTML(stripslashes($_REQUEST[txtSubject])); $message = email_BasicContactUI::decodeHTML(stripslashes($_REQUEST[txtMessage])); $emailCtrl->SetFrom($name, $email); $emailCtrl->SetEmail($subject, $message); $action = $_REQUEST[action]; } function ContactFormOut($emailCtrl, $bMissing) { /*echo "<pre>cf"; print_r($emailCtrl); echo "</pre>";*/ if($bMissing) { if($emailCtrl->fromName == ""){ $name_req = "class='required'"; } if(!$emailCtrl->IsValidEmail($objEmailCtrl->fromEmail)){$email_req = "class='required'"; } if($emailCtrl->message == ""){ $mess_req = "class='required'"; } } ?> <form action="<?php echo $_SERVER[PHP_SELF]; ?>" method="post"> <input type="hidden" name="action" value="sendEmail" /> <div> <table border="0" cellspacing="5" cellpadding="0"> <tr> <td><label <?php echo $name_req; ?>>Name:</label></td> <td><input name="txtName" type="text" size="30" value="<? echo htmlentities($emailCtrl->fromName, ENT_QUOTES); ?>"/></td> </tr> <tr> <td> <label <?php echo $email_req; ?>>Email:</label> </td> <td> <input name="txtEmail" type="text" size="30" value="<? echo htmlentities($emailCtrl->fromEmail, ENT_QUOTES); ?>"/> </td> </tr> <tr> <td> <label>Subject:</label> </td> <td> <input name="txtSubject" type="text" size="40" value="<? echo htmlentities($emailCtrl->subject, ENT_QUOTES); ?>"/> </td> </tr> <tr> <td> <label <?php echo $mess_req; ?>>Message:</label> </td> <td><textarea name="txtMessage" cols="30" rows="10"><? echo htmlentities($emailCtrl->message, ENT_QUOTES); ?></textarea></td> </tr> <tr> <td> </td> <td><input name="submit" type="submit" class="button" value="Send Email" /></td> </tr> </table> </div> </form> <? } function decodeHTML($string) { $string = strtr($string, array_flip(get_html_translation_table(HTML_ENTITIES))); $string = preg_replace("/&#([0-9]+);/me", "chr('\\1')", $string); return $string; } }//end class email_BasicContactUI class EmailCtrl { var $toName; var $toEmail; var $fromName; var $fromEmail; var $subject; var $message; function EmailCtrl() { $this->toName = ""; $this->toEmail = ""; $this->fromName = ""; $this->fromEmail = ""; $this->subject = ""; $this->message = ""; } function GetMessage(){ return nl2br($this->message); } function SetFrom($fromName, $fromEmail) { $this->fromName = $fromName; $this->fromEmail = $fromEmail; } function SetTo($toName, $toEmail) { $this->toName = $toName; $this->toEmail = $toEmail; } function SetEmail($subject, $message) { //if($subject == "") { $subject = "No Subject"; } $this->subject = $subject; $this->message = $message; } function Send() { $rURL = $_SERVER['PHP_SELF'] . "?success=true"; $to = $this->toName . ' <' . $this->toEmail . '>'; $subject = $this->subject; if($subject == "") { $subject = "No Subject"; } $body = "<p><strong>The following was submitted message was submitted from " . $_SERVER[SERVER_NAME] . "</strong></p>\r\n"; $body .= $this->GetMessage(); // To send HTML mail, the Content-type header must be set $headers = 'MIME-Version: 1.0' . "\r\n"; $headers .= 'Content-type: text/html; charset=iso-8859-1' . "\r\n"; // Additional headers //$headers .= 'To: '. $this->toName . ' <' . $this->toEmail . '>' . "\r\n"; $headers .= 'From: '. $this->fromName . ' <' . $this->fromEmail . '>' . "\r\n"; //$headers .= 'Cc: user@domain.com' . "\r\n"; //$headers .= 'Bcc: user@domain.com' . "\r\n"; if (mail($to, $subject, $body, $headers)) { return true; } else { return false; } } function IsValidEmail($email) { if( !eregi("^[_a-z0-9-]+(\.[_a-z0-9-]+)*@[a-z0-9-]+(\.[a-z0-9-]+)*(\.[a-z]{2,3})$", $email) ) { return false; } else { return true; } } } // end class emailControl ?> <?php define(STATE_PREVIEW, 5); class email_PreviewEmail EXTENDS email_BasicContact { function email_PreviewEmail($name, $email) { Parent::email_BasicContact($name, $email); $this->objUI =& new email_PreviewEmailUI(); } function SetPreviewState() { $this->state = STATE_PREVIEW; } function Control() { //read data $this->objUI->ContactFormIn($this->objEmailCtrl, $action); // print_r($this->objEmailCtrl); switch($action) { case "previewEmail": { if($this->IsDataValid($this->objEmailCtrl)) { $this->SetPreviewState(); } else { $this->SetMissingDataState(); } break; } case "sendEmail": { if($this->IsDataValid($this->objEmailCtrl)) { if($this->objEmailCtrl->Send()) { $this->SetSuccessState(); } else { $this->SetErrorState(); } } else { $this->SetMissingDataState(); } break; } default: { $this->SetInitialState(); } } } function View() { switch($this->state) { case STATE_SUCCESS: // message sent { /*echo "<pre>"; print_r($this); echo "</pre>";*/ $this->objUI->ViewSuccess($this->objEmailCtrl, $this->redirectURL); break; } case STATE_ERROR: { $this->objUI->ViewError(); break; } case STATE_PREVIEW: { $this->objUI->ViewPreview($this->objEmailCtrl); break; } case STATE_MISSING: //error { $bMissing = true; } case STATE_INITIAL: //blank form default: { $this->objUI->ContactFormOut($this->objEmailCtrl, $bMissing); } } } } //end class email_BasicContact class email_PreviewEmailUI EXTENDS email_BasicContactUI { function email_PreviewEmailUI(){} function ViewPreview($emailCtrl) { /*echo "<pre>"; print_r($emailCtrl); echo "</pre>";*/ ?> <form action="<?php echo $_SERVER[PHP_SELF]; ?>" method="post"> <div> <p><strong>Name:</strong> <? echo $emailCtrl->fromName; ?> <<?php echo htmlentities($emailCtrl->fromEmail, ENT_QUOTES); ?>><br/> <strong>Subject:</strong> <? echo htmlentities($emailCtrl->subject, ENT_QUOTES); ?><br/> <strong>Message:</strong><blockquote><?php echo nl2br($emailCtrl->message); ?></blockquote> </p> </div> <p> <input type="hidden" name="action" value="sendEmail" /> <input name="txtName" type="hidden" size="30" value="<? echo htmlentities($emailCtrl->fromName, ENT_QUOTES); ?>"/> <input name="txtEmail" type="hidden" size="30" value="<? echo htmlentities($emailCtrl->fromEmail, ENT_QUOTES); ?>"/> <input name="txtSubject" type="hidden" size="40" value="<? echo htmlentities($emailCtrl->subject, ENT_QUOTES); ?>"/> <input name="txtMessage" type="hidden" value="<?php echo htmlentities($emailCtrl->message, ENT_QUOTES); ?>" /> <p> <input type="submit" value="Send Email" class="button" /> </p> </form> <? } function ContactFormOut($emailCtrl, $bMissing) { /*echo "<pre>cf"; print_r($emailCtrl); echo "</pre>";*/ if($bMissing) { if($emailCtrl->fromName == ""){ $name_req = "class='required'"; } if(!$emailCtrl->IsValidEmail($objEmailCtrl->fromEmail)){$email_req = "class='required'"; } if($emailCtrl->message == ""){ $mess_req = "class='required'"; } } ?> <form action="<?php echo $_SERVER[PHP_SELF]; ?>" method="post"> <input type="hidden" name="action" value="previewEmail" /> <div> <table border="0" cellspacing="5" cellpadding="0"> <tr> <td><label <?php echo $name_req; ?>>Name:</label></td> <td><input name="txtName" type="text" size="30" value="<? echo htmlentities($emailCtrl->fromName, ENT_QUOTES); ?>"/></td> </tr> <tr> <td> <label <?php echo $email_req; ?>>Email:</label> </td> <td> <input name="txtEmail" type="text" size="30" value="<? echo htmlentities($emailCtrl->fromEmail, ENT_QUOTES); ?>"/> </td> </tr> <tr> <td> <label>Subject:</label> </td> <td> <input name="txtSubject" type="text" size="40" value="<? echo htmlentities($emailCtrl->subject, ENT_QUOTES); ?>"/> </td> </tr> <tr> <td> <label <?php echo $mess_req; ?>>Message:</label> </td> <td><textarea name="txtMessage" cols="30" rows="10"><?php echo htmlentities($emailCtrl->message, ENT_QUOTES); ?></textarea></td> </tr> <tr> <td> </td> <td><input name="submit" type="submit" class="button" value="Preview Email" /></td> </tr> </table> </div> </form> <?php } }//end class email_BasicContactUI ?>

Portfolio - Evan White

A collection of recent websites and code samples

Sample Code