NemoPS » customers

Private Orders Shop in PrestaShop and thirty bees part 1: manual customer verification

Nemo — Wed, 30 May 2018 12:39:37 +0000

In this 2-part tutorial series, we will see how to create a private orders shop in PrestaShop and thirty bees.
In this first part we will see how to add a manual approval for new customers while in the second on we will learn how to prevent orders from people who are not registered and approved by us.

Watch the screencast

Subscribe Post Scriptum's Youtube Channel

Text Version

I will use PrestaShop 1.6 for the demo but the modification works in thirty bees as well. Bear in mind it DOES NOT work in PrestaShop 1.7.

Open up controllers/front/AuthController.php

Look for the following code, around line 455. If it’s not in those whereabouts, just make sure you change every instance

$customer->active = 1;

set to 0, so that the user cannot perform any action right away.

Now we also want to give the user some feedback, so let’s redirect him to a custom page. Scroll down a few lines, and where you see all these redirects:

if (($back = Tools::getValue('back')) && $back == Tools::secureReferrer($back)) {
                            Tools::redirect(html_entity_decode($back));
                        }

And add a new one before

  Tools::redirect($this->context->link->getPageLink('welcome'));

Of course this page does not exist yet but we will create it in a moment.

Before that though, we have to take care of a little issue. Since the user has been created but set to inactive, the system treats it as banned by default. Even if we are to redirect to a page, we would instantly be kicked out of the session and redirected to the login. We want to create an exception so that the welcome page can be displayed.

Let’s go ahead and open up the customer class, so classes/customer.php
Look for the following method:

public static function isBanned($id_customer)

And at the very beginning, add:

        if(Context::getContext()->controller->php_self == 'welcome')
            return false;

That’s settled! Now for our welcome page, I will create a new controller and a template file in the theme folder

Let’s head to controllers/front, and create a new PHP file first, named WelcomeController.php:

class WelcomeControllerCore extends FrontController
{
    public $php_self = 'welcome';


    public function initContent()
    {
        parent::initContent();
        $this->setTemplate(_PS_THEME_DIR_.'welcome.tpl');
    }
}

Then in the theme folder, create a new file named welcome.tpl, adding the following code inside

{capture name="path"} {l s='Welcome'}{/capture}
{l s='Welcome to'} {$shop_name}! 


	{l s='Your account is currently under review, you will receive an email as soon as it is validated'}

So let’s go ahead and try it out now… but before let’s clear cache by erasing cache/class_index.php, since we added a new controller and the system wouldn’t read it otherwise.

The next step is to send out and email when a status is changed to active for the customer, in the back office.
Open controllers/admin/admincustomerscontroller.php

We will add a new method, which is inherited from the admincontroller class:


    public function processStatus()
    {
        if($object = parent::processStatus()) {
            if(get_class($object) == 'Customer' && $object->active) // the customer has been activated, send out an email
            {
                Mail::Send($object->id_lang, 'account_activated', $this->l('Your account has been activated'),
                    ['name' => $object->firstname .' '. $object->lastname],
                $object->email,
                $object->firstname .' '. $object->lastname,
                Configuration::get('PS_SHOP_EMAIL'),
                Configuration::get('PS_SHOP_NAME'));
            }
        }

       return $object;
    }

Of course, there is no such email template so we have to create it. I suggest copying an existing one, like the order confirmation, and adding new text, just to be quicker. The code is different for every template, just bear in mind to add the {name} variable inside it, so that the customer name is displayed!

This is it for part 1, make sure you test the email as well since sometimes they do fail for odd reasons, if you don’t see it coming, triple check the template names and make sure they are located in the proper path for each language you use.

In part two we will see how to prevent orders in case a customer is not registered, which is fundamental not to break the system if you have a one page checkout, as right now it would display an error.

The post Private Orders Shop in PrestaShop and thirty bees part 1: manual customer verification appeared first on NemoPS.

Creating welcome coupons for your clients in PrestaShop

Nemo — Mon, 19 Sep 2016 10:46:49 +0000

In this quick tip we will create welcome coupons for our clients, to reward the ones who decide to sign up for an account on our shop.

In order to create a discount code for clients who register new accounts on our store, we must edit the AuthController file. As always, the best practice is to create an override for it, so let’s add a new one inside override/controllers/front/, named AuthController.php
Open it up and add some generic override code inside php tags:

Class AuthController extends AuthControllerCore
{

}

The method we are interested in is sendConfirmationMail. We can get it straight out of the original controller, and I suggest you take it from yours since it might differ from mine (I am using PrestaShop 1.6.1.6):

    protected function sendConfirmationMail(Customer $customer)
    {
        if (!Configuration::get('PS_CUSTOMER_CREATION_EMAIL')) {
            return true;
        }

        return Mail::Send(
            $this->context->language->id,
            'account',
            Mail::l('Welcome!'),
            array(
                '{firstname}' => $customer->firstname,
                '{lastname}' => $customer->lastname,
                '{email}' => $customer->email,
                '{passwd}' => Tools::getValue('passwd'))
            $customer->email,
            $customer->firstname.' '.$customer->lastname
        );
    }

Copy and paste it inside our new override. At this point we can add our code to create the new cart rule, right before it returns the Mail::Send method:

        $cartRuleObj = new CartRule();
        $cartRuleObj->date_from = date('Y-m-d H:i:s');
        $cartRuleObj->date_to = '2046-12-12 00:00:00';
        $cartRuleObj->name[Configuration::get('PS_LANG_DEFAULT')] = 'Welcome coupon';
        $cartRuleObj->quantity = 1;
        $code = Tools::passwdGen();
        while (CartRule::cartRuleExists($code)) { // let's make sure there is no duplicate
            $code = Tools::passwdGen();
        }
        $cartRuleObj->code = $code;
        $cartRuleObj->quantity_per_user = 1;
        $cartRuleObj->reduction_percent = 20;
        $cartRuleObj->reduction_amount = 0;
        $cartRuleObj->free_shipping = 0;
        $cartRuleObj->active = 1;
        $cartRuleObj->minimum_amount = 0;
        $cartRuleObj->id_customer = $customer->id;
        $cartRuleObj->add();

For this example, I am creating a coupon with discount code that will give 20% off the price, that is going to be valid for a virtually indefinite period of time, with a single usage and restricted to this customer.
Make sure you add the following line:


$cartRuleObj->id_customer = $customer->id;

As it is what binds the rule to the current customer instance. Also notice I am generating a random code, and checking if there is any identical one in the database already using a while loop. While there is, we try creating a new one.

At this point, as soon as the customer accesses his account page, he will see the code in the My coupons section. However, as good practice we should really inform him in the account creation email as well. Let’s therefore amend the Mail:Send call as follows, by passing $code to the list of variables:

 return Mail::Send(
            $this->context->language->id,
            'account',
            Mail::l('Welcome!'),
            array(
                '{firstname}' => $customer->firstname,
                '{lastname}' => $customer->lastname,
                '{email}' => $customer->email,
                '{passwd}' => Tools::getValue('passwd')),
                '{coupon}' => $code,
            $customer->email,
            $customer->firstname.' '.$customer->lastname
        );

Great, we are done with php. What we need to do now is edit the corresponding account.html and account.txt emails to reflect the {coupon} variable.
Here is the final php code:

    protected function sendConfirmationMail(Customer $customer)
    {
        if (!Configuration::get('PS_CUSTOMER_CREATION_EMAIL')) {
            return true;
        }

        // nemo tut welcome coupon
        
        $cartRuleObj = new CartRule();
        $cartRuleObj->date_from = date('Y-m-d H:i:s');
        $cartRuleObj->date_to = '2046-12-12 00:00:00';
        $cartRuleObj->name[Configuration::get('PS_LANG_DEFAULT')] = 'Welcome coupon';
        $cartRuleObj->quantity = 1;
        $code = Tools::passwdGen();
        while (CartRule::cartRuleExists($code)) { // let's make sure there is no duplicate
            $code = Tools::passwdGen();
        }
        $cartRuleObj->code = $code;
        $cartRuleObj->quantity_per_user = 1;
        $cartRuleObj->reduction_percent = 20;
        $cartRuleObj->reduction_amount = 0;
        $cartRuleObj->free_shipping = 0;
        $cartRuleObj->active = 1;
        $cartRuleObj->minimum_amount = 0;
        $cartRuleObj->id_customer = $customer->id;
        $cartRuleObj->add();


        return Mail::Send(
            $this->context->language->id,
            'account',
            Mail::l('Welcome!'),
            array(
                '{firstname}' => $customer->firstname,
                '{lastname}' => $customer->lastname,
                '{email}' => $customer->email,
                '{passwd}' => Tools::getValue('passwd')),
                '{coupon}' => $code
            $customer->email,
            $customer->firstname.' '.$customer->lastname
        );
    }

Editing emails in PrestaShop

We have two ways to edit emails in PrestaShop: one is through the back office translations interface, the other is manual. Either will be fine, but I personally usually prefer to modify the html code directly.

Editing PrestaShop emails using the back-office interface

If you choose the first way, you can simply log in to the back office, and reach Localization > Translations. Choose
Email Templates translations from the first dropdown, then your template, and lastly the language, then hit modify.
In the next screen, toggle the Core emails section, and look for one labeled account.

What we want to do is edit the HTML template first, so click on Edit HTML version, and find a good spot where to add the new variable:

Save, then do the same with the text version.

Editing PrestaShop emails’ HTMl directly

The second way is the one I prefer, as the built in editor can often be confusing, when not messy. Once more, we need to make sure we are editing the correct email templates, usually located in the current theme’s folder /mails/ followed by the language ISO.
The files we are interested in are account.html and account.txt. Here is the snippet I added to the html version”


     


    
        
            
                 
                
                    
                        20% off welcome code: {coupon}

Which is basically a copy/paste of the one above, with a modified text. Once again, edit the txt version to add the variable there too.

At this point, make sure the modification is working by creating a new account and seeing if your customer gets the new email template, we are done!

The post Creating welcome coupons for your clients in PrestaShop appeared first on NemoPS.

Prestashop 101 Day 10 – Prestashop Customers

Nemo — Tue, 10 Mar 2015 09:40:20 +0000

Time to get in touch with your customers. In this lesson we will have a look at all features concerning Prestashop customers: their information, customer groups, and the customer service.

Running time: 19 mins

Watch the screencast – 1.6 version

Subscribe Post Scriptum's Youtube Channel

Watch the screencast – 1.5 version

Subscribe Post Scriptum's Youtube Channel

All series’ lessons

Prestashop 1.6

Prestashop 1.5

Additional Resources

PrestaShop Ticket System

The post Prestashop 101 Day 10 – Prestashop Customers appeared first on NemoPS.

Prestashop Ticket System Updated!

Nemo — Mon, 02 Mar 2015 10:47:37 +0000

The Prestashop Ticket System module has been upgraded! Customers can finally open tickets without being forced to register!

As I received plenty of requests (quite a lot really), I worked on the ticket system and re-coded part of it, so that you can finally allow guest tickets. Exactly, no more need for people to register, anyone can open a new ticket that can be followed as any other customer ticket, with email updated, etc.

It will be 20% off for a week so don’t miss the chance!

See the module

The post Prestashop Ticket System Updated! appeared first on NemoPS.

Get email notifications for new customers registrations

Nemo — Mon, 05 Jan 2015 11:38:16 +0000

In this quick tip we will see how to enable email notifications for when a new client registers to our shop.

The Plan

Since we want to be informed when a new user registers, we need to add our code snippets right where the user itself is notified about it. For this reason, we will be extending the sendConfirmationMail method of the AuthController.php file, and create a new email template as well.

The AuthController override

As always it’s good practice to use overrides instead of modifying core files directly (to preserve changes after updates). Therefore, create a new file called AuthController.php inside override/controllers/front. Inside php tags, paste the following override code:

Class AuthController extends AuthControllerCore
{

	
}

As mentioned above, we need to extend the default sendConfirmationMail method, so let’s grab it from the original controller and paste it inside our override (this is from Prestashop 1.6.0.9):

Class AuthController extends AuthControllerCore
{
	protected function sendConfirmationMail(Customer $customer)
	{
		if (!Configuration::get('PS_CUSTOMER_CREATION_EMAIL'))
			return true;

		return Mail::Send(
			$this->context->language->id,
			'account',
			Mail::l('Welcome!'),
			array(
				'{firstname}' => $customer->firstname,
				'{lastname}' => $customer->lastname,
				'{email}' => $customer->email,
				'{passwd}' => Tools::getValue('passwd')),
			$customer->email,
			$customer->firstname.' '.$customer->lastname
		);
	}
	
}

Just in case, let’s make sure emails still work. Erase the class_index.php located in the cache/ folder. Then, try registering a new user and make sure you get the confirmation email. If you do, it’s time to add another rule to inform the admin; right before the return, add:

Mail::Send(
			Configuration::get('PS_LANG_DEFAULT'),
			'account_for_admin',
			Mail::l('New client!'),
			array(
				'{firstname}' => $customer->firstname,
				'{lastname}' => $customer->lastname,
				'{email}' => $customer->email
				),
			Configuration::get('PS_SHOP_EMAIL'),
			Configuration::get('PS_SHOP_NAME')
		);

Explanation: we just copied the returned code and adapted it to our needs; first, instead of using the customer language to grab the email template, we use the shop’s default one. This way we don’t need to create multiple/translated templates. Then, we pass in ‘account_for_admin’ as email template name; it doesn’t exist yet so don’t try running a new registration or it won’t work. Then, to preserve the user’s credentials we get rid of the password. Lastly we set the “to” parameter to the shop’s email, and set the receiver to the shop’s name. That’s all there is to it. Let’s now create that template.

Creating a new email template

Instead of proceeding from scratch, I generally copy an existing html template, to have them all uniform. Let’s use that user welcome as base. Reach mails/en (or whatever your default language’s ISO is, you can check it in the back office, localization, languages); Clone both account.html and account.txt, and then rename them to account_for_admin.html and account_for_admin.txt. Open up the .txt file, it will look something like:



[{shop_url}] 

Hi {firstname} {lastname},

Thank you for creating a customer account at {shop_name}. 

Here are your login details:

E-MAIL ADDRESS: {email}

PASSWORD: {passwd} 		 

Important Security Tips:

* Always keep your account details safe.

* Never disclose your login details to anyone.

* Change your password regularly.

* Should you suspect someone is using your account illegally, please
notify us immediately.

You can now place orders on our shop: {shop_name}
[{shop_url}] 

{shop_name} [{shop_url}] powered by
PrestaShop(tm) [http://www.prestashop.com/]

Let’s modify it so to fit our needs:



[{shop_url}] 

Hi!

A new customer just signed up for an account at {shop_name}. 

Here are the details:

E-MAIL ADDRESS: {email}

NAME: {firstname} {lastname}

Then, apply the same modifications to the html file (please note I am only copying relevant parts of the template):



	
		
			Hi {firstname} {lastname},

			Thank you for creating a customer account at {shop_name}.



	
		
			Hi!

			A new customer just signed up for an account at {shop_name}.

Then



	
		
			
				 
				
					
						
							Your {shop_name} login details						
						
							Here are your login details:
 
							E-mail address: {email}

							Password: {passwd}



	
		
			
				 
				
					
						
							Your {shop_name} login details						
						
							Here are your login details:
 
							E-mail address: {email}

							Password: {passwd}

Lastly, you can get rid of this:


	 


	
		
			
				 
				
					
						Important Security Tips:
						
							Always keep your account details safe.
							Never disclose your login details to anyone.
							Change your password regularly.
							Should you suspect someone is using your account illegally, please notify us immediately.
						
					
				
				 
			
		
	


	 


	
		
			You can now place orders on our shop: {shop_name}
		
	


						
							 
						
						
							
								{shop_name} powered by PrestaShop™

And it’s done! Time to test the outcome!

Troubleshooting

When dealing with emails and Prestashop, there is a high chance of failure. Don’t be discouraged if if doesn’t work at the first attempt, and check the following:

- Send out a test email from advanced parameters -> emails to your mail address
- Make sure it didn’t end up in the spam folder
- Double-check the new template name, it must be account_for_admin everywhere
- Make sure you added the template to the correct iso folder. If unsure, clone it to every of them

If you still don’t receive the email, it’s worth trying to kill the Mail::Send method in case of failure, by using the following code instead:

Mail::Send(
			Configuration::get('PS_LANG_DEFAULT'),
			'account_for_admin',
			Mail::l('New client!'),
			array(
				'{firstname}' => $customer->firstname,
				'{lastname}' => $customer->lastname,
				'{email}' => $customer->email
				),
			Configuration::get('PS_SHOP_EMAIL'),
			Configuration::get('PS_SHOP_NAME'),
			null,null,null,null,_PS_MAIL_DIR_,true
		);

The last parameter I passed in is telling the method to die in case of failure. If that happens, you should be given more info about what went wrong.

The post Get email notifications for new customers registrations appeared first on NemoPS.