A simple contact form for the micro CMS Pico

You may find more info on gidlov.com/code/pico_contact

This is a simple contact form for your Pico-project.

##Example Running example

##Setup We use the nice PHPMailer class in this plugin, so we have to update the require key of composer.json. If we want to use captcha, we need to add a library for that too. Add the following:

"phpmailer/phpmailer": "dev-master",
"gregwar/captcha": "dev-master"

Run the composer update comand.

Now open your config.php file and add insert this:

$config['contact'] = array(
	'post' => $_POST,
	'send_to' => 'klas.gidlov@gmail.com',
	'captcha' => true,
);

Create a contact.md page (or whatever you want to call it) and insert your contact form there, like this:

<!--CONTACT-MESSAGE-->
<form role="form" method="post" name="contact">
	<div class="form-group contact-name-class">
		<label for="name">Name*</label>
		<input type="text" name="name" class="form-control" id="name" placeholder="Enter Name">
	</div>
	<div class="form-group contact-mail-class">
		<label for="mail">Email address*</label>
		<input type="email" class="form-control" id="mail" name="mail" placeholder="Enter email">
	</div>
	<div class="form-group contact-subject-class">
		<label for="subject">Subject</label>
		<input type="text" class="form-control" id="subject" name="subject" placeholder="Subject">
	</div>
	<div class="form-group contact-message-class">
		<label for="message">Message*</label>
		<textarea class="form-control" id="message" name="message" rows="5"></textarea>
	</div>
	<div class="form-group">
		<label for="captcha">Prove you're not a computer*</label>
		<input id="captcha" name="captcha" type="text" class="form-control" placeholder="Write the characters in the picture">
	</div>
	<div class="form-group ">
		<img src="captcha.php" alt="" class=""">
	</div>
	<button type="submit" class="btn btn-default" name="contact" value="true">Submit</button>
</form>

##Captcha

If you want to use captcha, you need to add a page that draws the picture. In the HTML example above creates the image from captcha.php, so create such a file in your root directory and add this in it:

<?php

include('vendor/gregwar/captcha/Gregwar/Captcha/CaptchaBuilderInterface.php');
include('vendor/gregwar/captcha/Gregwar/Captcha/PhraseBuilderInterface.php');
include('vendor/gregwar/captcha/Gregwar/Captcha/CaptchaBuilder.php');
include('vendor/gregwar/captcha/Gregwar/Captcha/PhraseBuilder.php');

use Gregwar\Captcha\CaptchaBuilder;

$builder = new CaptchaBuilder;
$builder->build();
session_start();
$_SESSION['phrase'] = $builder->getPhrase();

header('Content-type: image/jpeg');
$builder->output();

That's it!

##Notice

<!--CONTACT-MESSAGE--> at the top of the form is used to display messages, so leave it alone (or move it). Also leave the name attribute of the form element as it is, and the name and value of the submit button. The required fields are namn, mail and message.

##Tweaks

If your server is not configured to send mail, try to use SMTP instead by adding this to config['contact']:

'smtp' => array(
	'host' => 'your_host',
	'username' => 'your_username',
	'password' => 'your_password',
	'port' => 587,
	'auth' => 'true',		// Enable SMTP authentication, true or false
	'encryption' => 'tls',	// Enable encryption, tls or ssl
),

Define a custom subject like this:

// %1$s = name, %2$s = mail, %3$s = input subject, %4$s = site_title, %5$s = base_url
'subject' => 'New mail from %1$s sent via %4$s', 

Adding custom body data example:

// %1$s = name, %2$s = mail, %3$s = input subject, %4$s = site_title, %5$s = base_url
'body_header' => 'New mail from %4$s'."\n".'Name: %1$s'."\n".'Mail: %2$s'."\n".'Subject: %3$s'."\n".'Message:'."\n\n".'',
'body_footer' => '',

Alert messages example:

'alert_messages' => array(
	'error' => '<div class="uk-alert uk-alert-danger"><h2>Whops, error!</h2><p>Your message could not be sent. Sorry. %1$s</p></div>', //%1$s = PHPMailer error
	'validation_error' => '<div class="uk-alert uk-alert-danger"><h2>Try again!</h2><p>Your message could not be sent.</p><p>%1$s</p></div>', //%1$s = Validation errors
	'success' => '<div class="uk-alert uk-alert-success"><h2>Thanks for your message!</h2><p>I will reply as soon as possible.</p></div>',
),

Validation messages example:

'validation_messages' => array(
	'required' => '', 		// %1$s = field name
	'invalid_mail' => '',	// %1$s = field name
),

A custom form input validation error class:

'error_class' => 'form-danger',

##License

Contact is released under LGPL.