Nette Framework má mnoho předností. Hlavní z nich je rychlá a efektivní tvorba kvalitních webových aplikací.
Už dávno jsou ty doby, kdy jsem v PHP půl odpoledne patlal obstojný formulář s kontrolou vyplněných textových polí, validitou e-mailové adresy a jakž-takž ucházejícím vzhledem odesílané zprávy.
V Nette je tvorba dokonalého a neprůstřelného kontaktního formuláře práce na 10 minut. Framework totiž obsahuje třídu jak pro práci s formuláři, tak třídu pro odeslání e-mailu (včetně podpory tvorby zprávy šablonovým způsobem).
Jak vypadá zdrojový kód takového formuláře? Vytvoříme si ho v továrničce v Presenteru:
protected function createComponentContactForm() {
$form = new BaseForm;
$form->addText('name', 'Vaše jméno')
->addRule(Form::FILLED, 'Vyplňte vaše jméno');
$form->addText('email', 'Váš e-mail')
->setEmptyValue('@')
->addRule(Form::FILLED, 'Vyplňte váš e-mail')
->addRule(Form::EMAIL, 'E-mail má nesprávný tvar');
$form->addTextarea('text', 'Zpráva')
->addRule(Form::FILLED, 'Vyplňte zprávu');
$form->addSubmit('okSubmit', 'Odeslat');
$form->onSubmit[] = array($this, 'contactFormSubmitted');
return $form;
}Jednoduchým zavoláním makra widget vykreslíme formulář v té šabloně, kde ho chceme:
{widget contactForm}Napíšeme metodu, která se při odeslání formuláře zavolá (a dbáme při tom na pattern Post/Redirect/Get):
public function contactFormSubmitted(BaseForm $form) {
try {
$this->sendMail($form->getValues());
$this->flashMessage('Zpráva úspěšně odeslána!');
$this->redirect('this');
} catch (IOException $e) {
$form->addError($e->getMessage());
}
}Napíšeme samotné odeslání e-mailu (včetně plnění souboru se šablonou):
private function sendMail($values) {
$mail = new Mail;
$mail->setSubject('Nová zpráva z kontaktního formuláře');
$mail->setFrom($values['email'], $values['name']);
$mail->addTo('ondrej@mirtes.cz', 'Ondřej Mirtes');
$template = $this->createTemplate();
$template->setFile(Environment::getVariable('templatesDir') . '/Mail.phtml');
$template->name = $values['name'];
$template->email = $values['email'];
$template->text = $values['text'];
$mail->setHtmlBody($template);
try {
$mail->send();
} catch (InvalidStateException $e) {
throw new IOException('Nepodařilo se odeslat e-mail, zkuste to prosím za chvíli.');
}
}A vytvoříme šablonu, jak bude e-mail vypadat (Mail.phtml):
<h3>Nová zpráva z kontaktního formuláře</h3>
<ul>
<li><strong>Jméno</strong> {$name}</li>
<li><strong>E-mail</strong> <a href="mailto:{$email}">{$email}</a></li>
</ul>
<h4>Text zprávy</h4>
{!$text |texy}To je celé. Máme formulář, který se neodešle, pokud nejsou vyplněna všechna povinná pole (včetně klientské validace Javascriptem), u kterého nebude hrozit vícenásobné odeslání pomocí F5 a který by nám zabral daleko více času, kdybychom se ho snažili vytvořit bez frameworku.
P.S. Vložit tento článek do mého CMS (tento blog jsem programoval půl roku před tím, než jsem začal s Nette dělat) se ukázalo jako daleko náročnější, než tvorba celého formuláře – neescapuje mi správně znaky (vyřešilo by dibi) a neobarví mi PHP kód (vyřešilo by Texy!). Davide, co bychom bez tebe dělali? :)
P.P.S. Začátkem října jsem celý blog přepsal do Nette, dibi a Texy, takže přesun článku a obarvení kódu v novém systému bylo daleko pohodlnější :)
RSS
