The version 1.1.4 has multi-language module for the front-end shop. You can add any number of languages as you like. After adding languages in the languages module, you are able to input other languages to pages, products, menus and category. After adding languages in the backend, you need to add a directory and a file for the system languages. For example modules/welcome/language/french/kaimonokago_lang.php.

Another new features

• Slideshow module to control the front-end slideshow.
• Common functions, such as change status, delete etc are moved to kaimonokago modules

Download from github

Related posts:

1. Kaimono Kago v 1.1.1 Beta released
2. Shopping Cart v1.1 Beta updates
3. How to add Course and Booking module to Kaimonokago CMS

Kaimono Kago is a shopping cart built on Codeigniter.
I have minor updates and it is ready to download.
Kaimono Kago v1.1.3 Beta.

Related posts:

1. Kaimono Kago: New name for our shopping cart
2. Kaimono Kago: Installation added
3. Kaimono Kago v 1.1.1 Beta released

Some updates and two more slideshows are added for the front page.

Related posts:

1. Kaimonokago version 1.1.4 Beta released
2. Adding Slideshows Setting to Kaimono Kago
3. Kaimono Kago update

Kaimono Kago v1.1c Beta

Installation is added.

How to install

1. Download the zip file and unzip it.

2. Tranfer the unzipped files in your server.

3. Visit http://www.yourwebsite.com/install.
If it is in your local server, visit http://127.0.0.1/kaimonokago/install or http://localhost/kaimonokago/install.

4. Fill up all necessary information. For your Encryption Key, visit http://www.ideaspace.net/misc/hash/
or http://www.whatsmyip.org/hash_generator/ to generate at least 32 characters long code.

5. For your reCaptcha, visit http://recaptcha.net/ to get your keys.

6. After successful installation delete the installation folder.

7. Visit http://www.yourwebsite.com for index page.

8. Visit http://www.yourwebsite.com/index.php/auth to login the back-end.

Related posts:

1. Kaimono Kago: New name for our shopping cart
2. Kaimono Kago update
3. Kaimono Kago v 1.1.1 Beta released

We have more than 2000 downloads since we released Shopping Cart v1.0.
This shopping cart is built on Codeigniter. We use BackendPro for the administration and Ajax file manager for file management.

We thought it is a good idea to give a name to this shopping cart.
The name is KAIMONO KAGO which means ‘shopping basket’ in Japanese.
Well it is not a big difference in terms of meaning but at least you and we will know what we are talking about.

We also moved from Box.net to Sourceforge.net and you can download file from https://sourceforge.net/projects/kaimonokago/.

We added a license document and a updates text in the download files and you can read it here as well.

We appreciate any feed-backs or comment on Kaimono Kago.

The above icon is from a free icon set made by playground.ebiene.de/

You can find great free shopping icons from the followings.

http://bestdesignoptions.com/?p=1904
http://webdesignledger.com/freebies/the-best-e-commerce-icons-all-in-one-place

Related posts:

1. Kaimono Kago update
2. Kaimono Kago: Installation added
3. Adding Slideshows Setting to Kaimono Kago

Every ‘BUY’ button under a product is linked to cart method with it’s id. This adds details of the product to our shopping cart.

A link ‘SHOPPING CART’ at the top right and this will take a customer to our shopping cart page. The link is pages/cart and redirected to cart method.

If a customer has any products in the shopping cart, it displays the details as you see on the left image.
We display names, number of orders, subtotal of each product and total price.

A shipping charge will be calculated and added under the order details.

On the left column, each product has a delete button. This will recalculate subtotal and total cost and returns the result.

A customer can change the number of order and by clicking ‘UPDATE’ button, it will return the subtotal and total price.

‘GO to Checkout’ button will take a customer to a checkout page.

As I mentioned it before, the following code creates each product with a link to cart.

echo '<a href="' . site_url()."/".lang('webshop_folder'). '/cart/'.$image['id']. '"><p class="addtocart">'.lang('webshop_buy').'</p></a></div>';

Controllers: Calculating shipping price

This code is geared for Norwegian shipping rules, so you need to change according to your shipping method.

function shippingprice(){
		// You need to modify this. This is for Norwegian system. At the moment, if a max of individual product is more
		// than 268 kr, then shipping price will be 65 kr otherwise 0 kr or 25 kr.
		$maxprice = 0;
		if(isset($_SESSION['cart'])){
		foreach ($_SESSION['cart'] as $item) {
					    if ($item['price'] > $maxprice) {
					        $maxprice = $item['price'];
					    }
					}
		$data['maxprice']=$maxprice;
		$shippingprice = 0;
		if ($maxprice > 268 ){
			  $shippingprice = 65.0;
		}elseif($maxprice == 0){
			  $shippingprice = 0;
		}else{
			  $shippingprice = 25.0;
		}
		$_SESSION['shippingprice'] = $shippingprice;
		$data['shippingprice']=$shippingprice;
		return $data;
		}
  	}

cart method

function cart($productid=0){
		$shippingprice = $this-> shippingprice();
		$data['shippingprice']=$shippingprice['shippingprice'];
		if ($productid > 0){
			$fullproduct = $this->MProducts->getProduct($productid);
			$this->MOrders->updateCart($productid,$fullproduct);
			redirect( lang('webshop_folder').'/product/'.$productid, 'refresh');
		}else{
			$data['title'] = lang('webshop_shop_name')." | ". "Shopping Cart";

			if (isset($_SESSION['cart'])){
				$data['page'] = $this->config->item('backendpro_template_shop') . 'shoppingcart';
				$data['module'] = lang('webshop_folder');
				$this->load->view($this->_container,$data);
			}else{
				flashMsg('info',lang('orders_no_item_yet'));
				// $this->session->set_flashdata('msg',lang('orders_no_item_yet'));
				$data['page'] = $this->config->item('backendpro_template_shop') . 'shoppingcart';
				$data['module'] = lang('webshop_folder');
				$this->load->view($this->_container,$data);
			}
		}
  }

  	function ajax_cart(){
	  	// this is called by assets/js/shopcustomtools.js
	  	// this is used when a customer click a update button in /index.php/webshop/cart page
	   	$this->MOrders->updateCartAjax($this->input->post('ids'));
  	}

	function ajax_cart_remove(){
		// this is called by assets/js/shopcustomtools.js
	  	// this is used when a customer click a delete button in /index.php/webshop/cart page
	   	$this->MOrders->removeLineItem($this->input->post('id'));
	}

view shoppingcart

modules/webshop/views/shop/shoppingcart.php

<h1><?php echo lang('general_shopping_cart'); ?></h1>
<div id='pleft'>
<?php
if ($this->session->flashdata('msg')){
	echo "<div class='status_box'>";
	echo $this->session->flashdata('msg');
	echo "</div>";
}
?>
<?php echo form_open(lang('webshop_folder').'/checkout'); ?>
<table border='1' cellspacing='0' cellpadding='5' width='90%'>
<?php
if(isset($_SESSION['totalprice'])){
	$data['totalprice'] = $_SESSION['totalprice'];
	}

if (isset($_SESSION['cart'])){
	foreach ($_SESSION['cart'] as $PID => $row){
		$data = array(
				'name' => "li_id[$PID]",
				'value'=>$row['count'],
				'id' => "li_id_$PID",
				'class' => 'process',
				'size' => 5
		);

		echo "<tr valign='top'>\n";
		echo "<td>". form_input($data)."</td>\n";
		echo "<td id='li_name_".$PID."'>". $row['name']."</td>\n";
		echo "<td id='li_price_".$PID."'>".lang('webshop_currency_symbol'). $row['price']."</td>\n";
		echo "<td id='li_total_".$PID."'>".lang('webshop_currency_symbol').number_format($row['price'] * $row['count'], 2,'.',',')."</td>\n";
		echo "<td><input type='button' name='delete' value='".lang('webshop_delete')."' onclick='jsRemoveProduct($PID)'></td>\n";
		echo "</tr>\n";
	}
	$TOTALPRICE = $_SESSION['totalprice'];
	$TOTALPRICE = number_format($TOTALPRICE,2,'.',',');
	$total_data = array('name' => 'total', 'id'=>'total', 'value' => $TOTALPRICE);
	echo "<tr valign='top'>\n";
	echo "<td colspan='3'>".lang('orders_total_price')."</td>\n";
	echo "<td colspan='2'>".lang('webshop_currency_symbol')."$TOTALPRICE ".form_hidden($total_data)."</td>\n";

	echo "</tr>\n";

	echo "<tr valign='top'>\n";
	echo "<td colspan='3'>&nbsp;</td>\n";
	echo "<td colspan='2'><input type='button' name='update' value='".lang('webshop_update')."' onclick='jsUpdateCart()'/></td>\n";
	echo "</tr>\n";	

	echo "<tr valign='top'>\n";
	echo "<td colspan='3'>&nbsp;</td>\n";
	$data = array(
    'name'        => 'submit',
    'value'       => lang('webshop_checkout'),
    );
	echo "<td colspan='2'>".form_submit($data)."</td>\n";
	echo "</tr>\n";
}else{
	//just in case!
	echo "<tr><td id='tdmes'>" . lang('webshop_no_items_to_show') . "</td></tr>\n";
}//end outer if count
?>
</table>
<?php echo form_close(); ?>
<br />
<?php
	if($shippingprice>0){
		echo "<div class='status_box'><h2>";
	echo lang('webshop_shipping_charge');
	if (isset($shippingprice)){
	echo " ". lang('webshop_currency_symbol')."$shippingprice";
	}else{
		echo "0 ". lang('webshop_currency');
	}
	echo " " . lang('webshop_will_be_added');
	echo "</h2></div>";
	}
	?>

<div id='ajax_msg'></div>
</div>

Related posts:

1. Codeigniter shopping cart v1.1 Part 7: orders module
2. Shopping cart v1.1 Part 12: product page
3. Shopping cart v1.1 Part 16: Registration page and customer log in page

Newsletter is one of effective marketing tool for a web shop. I am going to cover subscribe and unsubscribe function in this article.

Download Page

Modifying right.php

We need to add ‘subscribe to’ and ‘unsubscribe from’ our newsletter link in the right column.

We add the following after login status div.
system/application/views/shop/right.php

// add this after login status
<div id="newsletter" class="signtop paddingright">
				<b><?php
					echo lang('subscribe_newsletter')."<br />\n";
					echo anchor(base_url()."index.php/".lang('webshop_folder')."/subscribe/", lang('subscribe_subscribe'));
					echo "<br />\n";
					echo anchor(base_url()."index.php/".lang('webshop_folder')."/unsubscribe/", lang('subscribe_unsubscribe'));

				?></b><br />
			</div>

CSS

/* newsletter */

#newsletter{
	background-color:#E4E0EF;
	margin-top: 5px;
}

Language

Let’s add some texts to our language file.
modules/webshop/language/english/webshop_lang.php

// modules/webshop/controllers/subscribe function
$lang['subscribe_newsletter'] = 'Newsletter';
$lang['subscribe_subscribe'] = 'Subscribe';
$lang['subscribe_unsubscribe'] = 'Unsubscribe';
$lang['subscribe_name'] = 'Name';
$lang['subscribe_registed_before'] = 'Your email is already in our list.';
$lang['subscribe_thank_for_subscription'] = 'Thanks for subscribing our newsletter!';
$lang['subscribe_you_been_subscribed'] = 'You have been unsubscribed!';
$lang['subscribe_need_login'] = 'You need to login first';
$lang['subscribe_you_been_unsubscribed'] = 'You have been unsubscribed from Newsletter';

subscribe method

In our subscribe method, we are going to use recaptcha as you see the above image. We set a recaptcha as we did in ‘Contact us’ and ‘Registration’ pages.
Setting rules and fields and validate. If validation is FALSE, then outputs errors.
If validation is ok, we use MSubscribers->checkSubscriber function to check if the email exists in our database. This model function returns TRUE or FALSE as you see below.
If it is TRUE, the email exists in our database, so we set a message to tell you are registered and redirect.
Otherwise we create a new subscriber with MSubscribers->createSubscriber function.
We set a message and redirect.

modules/subscribers/models/msubscribers.php

function checkSubscriber($email){
		$numrow = 0;
		$this->db->select('id');
		$this->db->where('email',db_clean($email));
		$this->db->limit(1);
		$Q = $this->db->get('omc_subscribers');
		if ($Q->num_rows() > 0){
			$numrow = TRUE;
			return $numrow;
		}else{
			$numrow = FALSE;
			return $numrow;
		}
	}

modules/webshop/controllers/webshop.php

function subscribe(){
		$data['title']=lang('webshop_shop_name')." | ".'Subscribe to our News letter';

		$captcha_result = '';
		$data['cap_img'] = $this->_generate_captcha();
		if ($this->input->post('name')){
			$rules['name'] = 'required';
			$rules['email'] = 'required|valid_email';
			$rules['recaptcha_response_field'] = 'trim|required|valid_captcha';

			$this->validation->set_rules($rules);

			$fields['email']	= lang('webshop_email');
			$fields['name']	= lang('subscribe_name');
			$fields['recaptcha_response_field']	= 'Recaptcha';

			$this->validation->set_fields($fields);

					if ($this->validation->run() == FALSE)
					{
						// if false outputs errors
						$this->validation->output_errors();
					}
					else
					{
						$email = $this->input->post('email');
						// otherwise check if the customer's email is in the database
						$numrow = $this->MSubscribers->checkSubscriber($email);
						if ($numrow == TRUE){
						// you have registered before, set the message and redirect to login page.
						flashMsg('info',lang('subscribe_registed_before'));
						redirect( lang('webshop_folder').'/subscribe','refresh');
						}
						$this->MSubscribers->createSubscriber();
						flashMsg('success',lang('subscribe_thank_for_subscription'));
						redirect( lang('webshop_folder').'/subscribe','refresh');
					}
		}
		$data['page'] = $this->config->item('backendpro_template_shop') . 'subscribe';
		$data['module'] = lang('webshop_folder');
		$this->load->view($this->_container,$data);
  	}

view subscribe

<?php print displayStatus();?>
<?php
if ($this->session->flashdata('subscribe_msg')){
	echo "<div class='status_box'>";
	echo $this->session->flashdata('subscribe_msg');
	echo "</div>";
}
?>

<?php echo form_open($this->lang->line('webshop_folder')."/subscribe"); ?>
<h1>
<?php echo form_fieldset('Subscribe To Our Newsletter'); ?>
</h1>
<h5>*Name</h5>
<input type="text" name="name" id="name" value="<?php echo set_value('name'); ?>" size="40" />

<h5>*Email</h5>
<input type="text" name="email" id="email" value="<?php echo set_value('email'); ?>" size="40" />

<h5>*Are you human?</h5>
<?php echo "<p>$cap_img</p>" ;?>

<div><input type="submit" value="Subscribe" /></div>
<?php echo form_fieldset_close(); ?>

<?php echo form_close(); ?>

unsubscribe function

Unsubscribe page has ‘Email’ and Recapcha field to fill in.

If email field is not filled out, it must be the first visit to the page. Set a recapcha and other valiables.
Otherwise a customer must have filled out email field, so set rules and fields.
Run validation.
If the validation is FALSE, outputs errors and redirect to the same page.
If it is ok, remove the subscriber from out database and set a success message and redirect.

function unsubscribe($email=''){
  		if (!$this->input->post('email')){
  			$data['title']=lang('webshop_shop_name')." | ".'Unsubscribe our Newsletter';
  			$captcha_result = '';
			$data['cap_img'] = $this->_generate_captcha();
  			$data['page'] = $this->config->item('backendpro_template_shop') . 'unsubscribe';
			$data['module'] = lang('webshop_folder');
			$this->load->view($this->_container,$data);
  		}else{

  			$rules['email'] = 'trim|required|max_length[254]|valid_email';
			$rules['recaptcha_response_field'] = 'trim|required|valid_captcha';

			$this->validation->set_rules($rules);

			$fields['email']	= lang('webshop_email');
			$fields['recaptcha_response_field']	= 'Recaptcha';

			$this->validation->set_fields($fields);

			if ($this->validation->run() == FALSE)
					{
						// if false outputs errors
						$this->validation->output_errors();
						redirect( lang('webshop_folder').'/unsubscribe','refresh');
					}
					else
					{
						$email = $this->input->post('email');
						$this->MSubscribers->removeSubscriber($email);
						flashMsg('success',lang('subscribe_you_been_unsubscribed'));
						redirect( lang('webshop_folder').'/index','refresh');
					}
  		}
  	}

view unsubscribe

<?php print displayStatus();?>
<?php
if ($this->session->flashdata('subscribe_msg')){
	echo "<div class='status_box'>";
	echo $this->session->flashdata('subscribe_msg');
	echo "</div>";
}
?>

<?php echo form_open($this->lang->line('webshop_folder')."/unsubscribe"); ?>
<h1>
<?php echo form_fieldset('Unsubscribe Our Newsletter'); ?>
</h1>

<h5>*Email</h5>
<input type="text" name="email" id="email" value="<?php echo set_value('email'); ?>" size="40" />

<h5>*Are you human?</h5>
<?php echo "<p>$cap_img</p>" ;?>

<div><input type="submit" value="Subscribe" /></div>
<?php echo form_fieldset_close(); ?>

<?php echo form_close(); ?>

Related posts:

1. Shopping cart v1.1 Part 15: contact page and sending email message
2. Codeigniter shopping cart v1.1 Part 5: subscribers module
3. Shopping cart v1.1 Part 16: Registration page and customer log in page

jquery ketchup-plugin

Codeigniter Language Helper

http://codeigniter.com/user_guide/helpers/language_helper.html

We can simplify

echo $this->lang->line();

to

echo lang('language_key', 'form_item_id');

Updating Preferences/Settings

Adding all the webshop languages in the back-end so that it will be automatically used.

External link in menu

$uri = $menu['page_uri'];
			$external_link   = 'http';
			$pos = strpos($uri, $external_link);

			// Note our use of ===.  Simply == would not work as expected
			// because the position of 'a' was the 0th (first) character.
			if ($pos === false) {
			    echo anchor ("welcome/pages/".$menu['page_uri'], $menu['name']);
			} else {
			    echo anchor ($menu['page_uri'], $menu['name']);
			}

Related posts:

1. Minor Updates for Portofolio CMS with Codeigniter
2. Codeigniter shopping cart v1.1 Part 3: menus module
3. Codeigniter shopping cart v1.0 code updates

Our customers uses this registration page to keep their information in our database. Once registered, this information will be displayed in a checkout page for a speedy process. This post covers the customer registration function, login and logout function.

Download Page

All the fields are required and rules are set in function registration.

function registration

This function sets the recaptcha as we did in the previous post, then sets rules and fields. If the validation is false outputs errors and load the same page.
Otherwise check if the customer’s email is in our database by using MCustomers’s checkCustomer function. If it returns TRUE, then set a flash message and redirect to login page.
If it returns FALSE, then add the customer to our database and set a success message and redirect to login page.

Be aware that due to $rules['city'] = ‘trim|required|alpha_dash’; a customer has to enter ‘NewYork’, ‘New-York’ or ‘New_York’ instead of ‘New York. If you don’t like this rule, you need to take out ‘alpha_dash’

function registration(){
	/* If you are using recaptcha, don't forget to configure modules/recaptcha/config/recaptcha.php
	 * Add your own key
	 * */
		$captcha_result = '';
		$data['cap_img'] = $this->_generate_captcha();

	if ($this->input->post('email')){

	 	$data['title'] = lang('webshop_shop_name')." | "."Registration";

		// set rules
		$rules['email'] = 'trim|required|matches[emailconf]|valid_email';
		$rules['emailconf'] = 'trim|required|valid_email';
		$rules['password'] = 'trim|required';
		$rules['customer_first_name'] = 'trim|required|min_length[3]|max_length[20]';
		$rules['customer_last_name'] = 'trim|required|min_length[3]|max_length[20]';
		$rules['phone_number'] = 'trim|required|min_length[8]|max_length[12]|numeric';
		$rules['address'] = 'trim|required';
		$rules['city'] = 'trim|required|alpha';
		$rules['post_code'] = 'trim|required|numeric';
		// if you want to use recaptcha, set modules/recaptcha/config and uncomment the following
		$rules['recaptcha_response_field'] = 'trim|required|valid_captcha';

		$this->validation->set_rules($rules);

		// set fields. This will be used for error messages
		// for example instead of customer_first_name, First Name will be used in errors
		$fields['email']	= lang('webshop_email');
		$fields['emailconf']	= lang('webshop_email_confirm');
		$fields['password']	= lang('webshop_pass_word');
		$fields['customer_first_name']	= lang('webshop_first_name');
		$fields['customer_last_name']	= lang('webshop_last_name');
		$fields['phone_number']	= lang('webshop_mobile_tel');
		$fields['address']	= lang('webshop_shipping_address');
		$fields['city']	= lang('webshop_city');
		$fields['post_code']	= lang('webshop_post_code');
		$fields['recaptcha_response_field']	= 'Recaptcha';

		$this->validation->set_fields($fields);

		// run validation
		if ($this->validation->run() == FALSE)
			{
				// if false outputs errors
				$this->validation->output_errors();
				// and take them to registration page to show errors
				$data['page'] = $this->config->item('backendpro_template_shop') . 'registration';
				$data['module'] = lang('webshop_folder');
				$this->load->view($this->_container,$data);
			}
			else
			{
				$e = $this->input->post('email');
				// otherwise check if the customer's email is in the database
				$numrow = $this->MCustomers->checkCustomer($e);
				if ($numrow == TRUE){
					// you have registered before, set the message and redirect to login page.
					flashMsg('info', lang('webshop_registed_before'));
					// $this->session->set_flashdata('msg', lang('webshop_registed_before'));
					redirect( lang('webshop_folder').'/login','refresh');
				}
			// a customer is new, so create the new customer, set message and redirect to login page.
			$this->MCustomers->addCustomer();
			flashMsg('success', lang('webshop_thank_registration'));
			// $this->session->set_flashdata('msg', lang('webshop_thank_registration'));
			redirect( lang('webshop_folder').'/login');
			}
	}// end of if($this->input->post('email'))

	$data['title'] = lang('webshop_shop_name')." | ". "Registration";
	$data['page'] = $this->config->item('backendpro_template_shop') . 'registration';
	$data['module'] = lang('webshop_folder');
	$this->load->view($this->_container,$data);

  }

view registration

module/webshop/views/shop/registration.php

 	<div class="gallerimain">
    	<h1><?php echo $title; ?></h1><br />
	<?php print displayStatus();?>
		<h2><?php echo $this->lang->line('webshop_regist_plz_here'); ?></h2><br />
		<h2><?php echo sprintf( $this->lang->line('genral_login_msg'), anchor( $this->lang->line('webshop_folder').'/login', $this->lang->line('genral_login') ) );?></h2>
		<br />

		<?php
		if ($this->session->flashdata('msg')|| $this->session->flashdata('error')){
			echo "<div class='status_box'>";
			echo $this->session->flashdata('msg');
			echo $this->session->flashdata('error');
			echo "</div>";
		}
		?>
		<?php echo validation_errors('<div class="message error">','</div>'); ?>

		<?php echo form_open($this->lang->line('webshop_folder')."/registration",array('class' => 'expose')); ?>

		<h3>*<?php echo $this->lang->line('webshop_email'); ?></h3>
		<input type="text" name="email" value="<?php echo set_value('email'); ?>" size="40" />

		<h3>*<?php echo $this->lang->line('webshop_email_confirm'); ?></h3>
		<input type="text" name="emailconf" value="<?php echo set_value('emailconf'); ?>" size="40" />

		<h3>*<?php echo $this->lang->line('webshop_pass_word'); ?></h3>
		<input type="password" name="password" value="" size="20" />

		<h3>*<?php echo $this->lang->line('webshop_first_name'); ?></h3>
		<input type="text" name="customer_first_name" value="<?php echo set_value('customer_first_name'); ?>" size="30" />

		<h3>*<?php echo $this->lang->line('webshop_last_name'); ?></h3>
		<input type="text" name="customer_last_name" value="<?php echo set_value('customer_last_name'); ?>" size="30" />

		<h3>*<?php echo $this->lang->line('webshop_mobile_tel'); ?></h3>
		<input type="text" name="phone_number" value="<?php echo set_value('phone_number'); ?>" size="15" />

		<h3>*<?php echo $this->lang->line('webshop_shipping_address'); ?></h3>
		<input type="text" name="address" value="<?php echo set_value('address'); ?>" size="50" />

		<h3>*<?php echo $this->lang->line('webshop_post_code'); ?></h3>
		<input type="text" name="post_code" value="<?php echo set_value('post_code'); ?>" size="8" />

		<h3>*<?php echo $this->lang->line('webshop_city'); ?></h3>
		<input type="text" name="city" value="<?php echo set_value('city'); ?>" size="20" />

		<h3>*Are you human?</h3><?php echo "<p>$cap_img</p>" ;?>

		<br />
		<input type="submit" name="submit" value="<?php echo $this->lang->line('webshop_register'); ?>" />

		<?php echo form_close(); ?>

</div>

login function

A cutomer will be redirected to a login page.
If email is filled, verify the customer by using MCustomers->verifyCustomer function.
This verifyCustomer function as you see below, check if the customer exist in our database. If data exists, set the PHP session, customer_id, first name, last name and other details which the customer entered in the registration page previously.

Then in the controller, it checks if the PHP session ‘customer_id’ exists. If so, set a flash message and redirect and display it. If not, set an error message and redirect.

modules/customers/models/mcustomers.php

function verifyCustomer($e,$pw){
		$this->db->where('email',db_clean($e,50));
		$this->db->where('password', db_clean(dohash($pw),16));
		$this->db->limit(1);
		$Q = $this->db->get('omc_customer');
		if ($Q->num_rows() > 0){
			$row = $Q->row_array();
			$_SESSION['customer_id'] = $row['customer_id'];
			$_SESSION['customer_first_name'] = $row['customer_first_name'];
			$_SESSION['customer_last_name'] = $row['customer_last_name'];
			$_SESSION['phone_number'] = $row['phone_number'];
			$_SESSION['email'] = $row['email'];
			$_SESSION['address'] = $row['address'];
			$_SESSION['city'] = $row['city'];
			$_SESSION['post_code'] = $row['post_code'];
		}else{
			// $_SESSION['customer_id'] = 0; // this will eliminate error
		}
	}

webshop/controllers/webshop.php

function login(){
		if ($this->input->post('email')){
			$e = $this->input->post('email');
			$pw = $this->input->post('password');
			$this->MCustomers->verifyCustomer($e,$pw);
			if (isset($_SESSION['customer_id'])){
				flashMsg('info',lang('login_logged_in'));
				redirect( lang('webshop_folder').'/login','refresh');
			}
			flashMsg('info',lang('login_email_pw_incorrect'));
			redirect( lang('webshop_folder').'/login','refresh');
		}
		$data['title'] = lang('webshop_shop_name')." | "."Customer Login";
		$data['page'] = $this->config->item('backendpro_template_shop') . 'customerlogin';
		$data['module'] = lang('webshop_folder');
		$this->load->view($this->_container,$data);
  }

cutomerlogin.php

   <div class="gallerimain">
      <h1><?php echo $title;?></h1>
      <br />
<?php
	if($this->data['customer_status']==1){
		echo "<h2>".lang('customer_login_enjoy_shopping')."</h2>";
		echo "<br /><h2>".anchor( lang('webshop_folder').'/checkout', lang('general_check_out') )."</h2><br />" ;

	}else{
		echo "<h2>".lang('customer_login_plz_login')."</h2><br />";
	}
?>

<?php
	if ($this->session->flashdata('msg')){
		echo "<div class='status_box'>";
		echo $this->session->flashdata('msg');
		echo "</div>";
	}
?>

<?php
	$udata = array('name'=>'email','id'=>'email','size'=>30);
	$pdata = array('name'=>'password','id'=>'password','size'=>16);

	echo form_open($this->lang->line('webshop_folder')."/login");
	echo "<p><label for='email'>". lang('orders_email'). "</label><br/>";
	echo form_input($udata) . "</p>";
	echo "<p><label for='password'>Password</label><br/>";
	echo form_password($pdata) . "</p>";
	echo form_submit('submit','login');
	echo form_close();
?>
</div>

We need to add lang(‘customer_login_enjoy_shopping’) etc to modules/webshop/language/english/webshop_lang.php

// modules/webshop/views/customerlogin.php
$lang['customer_login_enjoy_shopping'] = 'Enjoy your shopping!';
$lang['customer_login_plz_login'] = 'Please login. This will fill up your details at check out automatically.';

// you can add more here.

When a customer is logged in, a message is displayed and login status and ‘Log out’ link are displayed on the top-right column.

If you see the Shop_controller.php, you will see the code which controlling this function.
system/application/libraries/Shop_controller.php

// This part is used in all the pages so load it here
		// For customer login status
		if(isset($_SESSION['customer_first_name'])){
			$this->data['customer_status']=1;
			$this->data['loginstatus']=lang('general_hello').$_SESSION['customer_first_name'].". ".lang('general_logged_in')."<br />
			<a href=\"index.php/".$this->lang->line('webshop_folder')."/logout \">Log out</a>";
		}else{
			$this->data['customer_status']=0;
			$this->data['loginstatus']="You are not logged in. <a href=\"index.php/".$this->lang->line('webshop_folder')."/login \">".lang('general_login')."</a>
			<br /><a href=\"index.php/".$this->lang->line('webshop_folder')."/registration \">".lang('general_register')."</a>";
		}

logout function

function logout(){
		// this would remove all the variable in the session
		session_unset();

		//destroy the session
		session_destroy(); 

		redirect( lang('webshop_folder').'/index','refresh');
	 }

When a customer is logged out, the customer will be redirected to the index page.

Related posts:

1. Shopping cart v1.1 Part 15: contact page and sending email message
2. Shopping cart v1.1 Part 17: Newsletter
3. Shopping cart v1.1 Part 10: Front page

Contact page allows visitors to send a message through a form. It has a reCaptcha in order to avoid spam. I will cover the contact page and sending email message to an administrator in this article.

Download Page

The contact page uses a recaptcha which is built in the BackendPro.

recaptcha.php

Please open modules/recaptcha/config/recaptcha.php.
This folder comes with the BackendPro.

// other codes here

$config['recaptcha'] = array(
    'public'=>'YOUR PUBLIC KEY HERE',
    'private'=>'YOUR PRIVATE KEY HERE',
    'RECAPTCHA_API_SERVER' =>'http://api.recaptcha.net',
    'RECAPTCHA_API_SECURE_SERVER'=>'https://api-secure.recaptcha.net',
    'RECAPTCHA_VERIFY_SERVER' =>'api-verify.recaptcha.net',
    'theme' => 'white'
); 

// and more here.

You need to register at http://recaptcha.net/ and obtain public and private key. You can use these code for your local development as well.
You need to replace ‘public’=>’YOUR PUBLIC KEY HERE’ and ‘private’=>’YOUR PRIVATE KEY HERE’ with your keys.

Function contact

We add the following in modules/webshop/controllers/webshop.php

function contact(){

		$data['title'] = $this->lang->line('webshop_shop_name')." | "."Contact us";
		$data['cap_img'] = $this->_generate_captcha();
		$data['page'] = $this->config->item('backendpro_template_shop') . 'contact';
		$data['module'] = $this->lang->line('webshop_folder');
		$this->load->view($this->_container,$data);
  	}

	function _generate_captcha(){
		$this->bep_assets->load_asset('recaptcha');
		$this->load->module_library('recaptcha','Recaptcha');
		return $this->recaptcha->recaptcha_get_html();
	}

function contact is nothing special, except calling function _generate_captcha function.

function _generate_captcha load module library ‘recaptcha’ which comes with BackendPro and generates captcha automatically.

We will use this function _generate_captcha in registration page as well.

Contact view

<div id="content">
	<div id="omossleft">
		<div id="logo">
		</div>
		<div class="contentleft">
	<?php print displayStatus();?>
			<?php
			if ($this->session->flashdata('subscribe_msg')){
				echo "<div class='status_box'>";
				echo $this->session->flashdata('subscribe_msg');
				echo "</div>";
			}
			?>

			<div id="contactform">
				<?php echo form_open( $this->lang->line('webshop_folder')."/message"); ?>
				<?php echo form_fieldset('<h3>Send Message</h3>'); ?>

				<p id="name">
					<label for="name">*<?php echo $this->lang->line('orders_name'); ?>: </label>
					<input type="text" name="name" id="name" value="<?php echo set_value('name'); ?>" maxlength="30" size="30"  />

				</p>

				<p id="email">
					<label for="email">*<?php echo $this->lang->line('orders_email'); ?>: </label>
					<input type="text" name="email" id="email" value="<?php echo set_value('email'); ?>" maxlength="30" size="30"  />

				</p>

				<p>
					<label for="message">*<?php echo $this->lang->line('contact_your_message'); ?>: </label><br />
					<?php
					  $data = array(
				      'name'  => 'message',
				      'id'    => 'message',
				      'rows'  => '10',
				      'cols'  => '3',
				      'style' => 'width:60%',
				    );	

				echo form_textarea($data);
				?>
				</p>
				<p>*<?php echo $this->lang->line('contact_captcha'); ?></p><br />
				<?php echo "<p>$cap_img</p>" ;?>
				<div id="contactsubmit"><input type="submit" value="<?php echo $this->lang->line('contact_send'); ?>" />
				</div>
				<?php echo form_fieldset_close(); ?>
				<?php echo form_close(); ?>
			</div>
		</div>
	</div>
</div>

As you can see the form will be sent to the message function.

form_open( $this->lang->line('webshop_folder')."/message")

So obviously the next one is function message.

Controller: function message

As you can see in the comments, the BackendPro is using Codeigniter’s validation library instead of Form validation library. The validation library is deprecated and the author mentioned that he is going to update to CI’s Form validation library in the next version.

Load the validation library in the constructor, define rules for each field, set rules.
Then define each field and set these fields.
Run validation, if it is FALSE, outputs errors and display another recaptcha and load the page.
If validation has passed, store all the input values in variables.
Get the admin email from preference.
Load Codeigniter’s email library, and set email preferences including setting up from, to, subject and message, and send the email to admin.
Set flash message and redirect to the contact page again and display the thank you message.

–UPDATE March 1st 2010–
This should work for your local server. However your host may have different email protocols. Please read more details here.

class Webshop extends Shop_Controller {

  function  Webshop(){
    parent::Shop_Controller();
    // load the validation library
		$this->load->library('validation');

  }

// other functions here

function message(){

		$rules['name'] = 'trim|required|max_length[32]';
		$rules['email'] = 'trim|required|max_length[254]|valid_email';
		$rules['message'] = 'trim|required';
		$rules['recaptcha_response_field'] = 'trim|required|valid_captcha';

		$this->validation->set_rules($rules);

		$fields['name']	= lang('general_name');
		$fields['email']	= lang('webshop_email');
		$fields['message']	= lang('message_message');
		$fields['recaptcha_response_field']	= 'Recaptcha';

		$this->validation->set_fields($fields);
	    /**
		 * form_validation, next version of Bep will update to form_validation
		 */
		//$this->form_validation->set_rules('name', 'Name', 'required');
		//$this->form_validation->set_rules('email', 'Email',  'required|valid_email');
		//$this->form_validation->set_rules('message', 'Message', 'required');
		//$this->form_validation->set_rules('captcha', 'Captcha', 'required');

        if ($this->validation->run() == FALSE)
		{
			// if any validation errors, display them
			$this->validation->output_errors();

			$captcha_result = '';
			$data['cap_img'] = $this->_generate_captcha();

			$data['title'] = lang('webshop_shop_name')." | ". lang('webshop_message_contact_us');
			$data['page'] = $this->config->item('backendpro_template_shop') . 'contact';
			$data['module'] = lang('webshop_folder');
			$this->load->view($this->_container,$data);
		}
		else
		{
		    // you need to send email
		    // validation has passed. Now send the email
			$name = $this->input->post('name');
			$email = $this->input->post('email');
			$message = $this->input->post('message');
			$myemail = 'admin(at)gmail.com';
			$this->load->library('email');
			$this->email->from($email.$name);
			$this->email->to($myemail);
			$this->email->subject(lang('webshop_message_subject'));
			$this->email->message(lang('webshop_message_sender').
			$name."\r\n".lang('webshop_message_sender_email').": ".
			$email. "\r\n".lang('webshop_message_message').": " . $message);
			$this->email->send();
			flashMsg('success', lang('webshop_message_thank_for_message'));
		    // $this->session->set_flashdata('subscribe_msg', lang('webshop_message_thank_for_message'));
		    redirect(lang('webshop_folder').'/contact');
		}
  	}  

Setting up Webshop Configuration for admin_email

I wrote about how to add preferences in BackendPro yesterday. The line, $myemail = ‘admin(at)gmail.com’; can be improved by using preferences instead of rewriting row php each time when you change email messages.

Add the following to system/application/controllers/admin/settings.php. (Please read the article for details)

'webshop'=> array('name'=> $this->lang->line('preference_webshop_configuration'), 'fields'=>'main_nav_parent_id,categories_parent_id,admin_email'),		

...

$config['field']['admin_email'] = array('rules'=>'trim|valid_email');

Add the following to modules/preferences/language/english/preferences_lang.php.

$lang['preference_label_admin_email'] = 'Admin Email to receive email messages';
$lang['preference_desc_admin_email'] = 'Enter admin email address to receive email messages from customers';

Go to DB, be_preferences field and insert a new field called ‘admin_email’.
Go to the back-end, System > Settings > Webshop Configuration and add your email address.

Now we can use $this->preference->item(‘admin_email’) instead of ‘admin(at)gmail.com’.
Change the line in the function message().

$myemail = $this->preference->item('admin_email');

Please test it by not filling some fields or filling up all. If your local server is not sending email, this article may help you if you are using XAMPP or similar development environment.

Related posts:

1. Shopping cart v1.1 Part 16: Registration page and customer log in page
2. Sending email from localhost using MSMTP with gmail
3. Shopping cart v1.1 Part 17: Newsletter