COWOA (for ZC v1.5.x)

[joejoejoe]

I'm back.... So so close yet so so far. I finished comparing all the files on the install_txt.html. So far I've only found one file that I need to merge with an existing (/includes/templates/YOUR_TEMPLATE/common/tpl_header.php). I found a few files that weren't listed as overwrite or new (five are in the same folder I mentioned above, and then includes/language/english/extra_definitions/checkout_process). Since none of them were modified by my template, I'm just going to upload them and if they exist I'll overwrite and pray.

A couple more notes for the errata page:
/includes/templates/YOUR_TEMPLATE/templates/tpl_checkout_shipping.php
is really tpl_checkout_shipping_default.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_checkout_success.php
is really tpl_checkout_success_default.php
and that same folder holds another file not mentioned on the install_txt.html:
tpl_order_status_default.php

All simple things except the last: the install_txt says that one of the files to upload/overwrite is /includes/templates/YOUR_TEMPLATE/tpl_header.php and that file does not exist in the unzipped pile of files. I'm assuming it's different than the other tpl_header.php that is specifically mentioned farther down the list?

thanks again
Joe

[countrycharm]

Thanks for pointing the Install txt problems. This has been corrected and uploaded to the plugin and addon directory.

Here is a out line of the Install Txt.

1) - BACKUP YOUR STORE AND YOUR DATABASE, BACKUP YOUR STORE AND YOUR DATABASE. To do this, download your zen cart directory to your computer. I usually download it to my computer twice, because shoddy FTP programs sometimes miss files. You can read the faq's on the Zen-Cart Site for instructions on backing up your database or you can use the database backup module.

2) - If you have a Brand New Zen Cart v1.5.0 or Zen Cart v1.5.1 installation, just merge these files into yours.

3) - Change the "YOUR_TEMPLATE" directory names to the name of your actual template under the install/includes/templates.

4) - Change the "ADMIN" folder name to match the name of your custom directory.

5) - Install the SQL Patch. To do this, open the file COWOA_Full_Install.sql. In your admin panel, open Tools -> Install SQL Patches. Copy the query from COWOA_Full_Install.sql into the text box and hit 'send'. This will add the necessary COWOA fields and setup COWOA inthe Configuration Section. It will also set Split Login to True which is necessary for this mod to work.

6) - Upload the includes and admin directory to your zen cart directory. For most FTP clients the directory structure of the /includes directory should be preserved, and the files should "fall" into their proper places. If your FTP client isn't capable of this, you might have to manually place each file according to where they appear in this mod.

7) - 21 Zen Cart Core files are over-written for this module (The included files are modified from Zen-Cart 1.5.1 files)
If you have any other Modules installed that uses these files, compare and merge the files and look for the COWOA word that is before all of the entries,
just copy and paste those lines into your files. Some have very minor changes, others have a lot of additions:

/admin/orders.php
/admin/customers.php
/admin/index.php
/includes/classes/order.php
/includes/languages/english/YOUR_TEMPLATE/checkout_confirmation.php
/includes/languages/english/YOUR_TEMPLATE/checkout_payment.php
/includes/languages/english/YOUR_TEMPLATE/checkout_process
/includes/languages/english/YOUR_TEMPLATE/checkout_shipping.php
/includes/languages/english/YOUR_TEMPLATE/gv_redeem.php
/includes/languages/english/YOUR_TEMPLATE/login.php
/includes/languages/english/YOUR_TEMPLATE/logoff.php
/includes/languages/english/YOUR_TEMPLATE/time_out
/includes/modules/pages/gv_redeem/header_php.php
/includes/modules/pages/login/header_php.php
/includes/modules/pages/password_forgotten/header_php.php
/includes/modules/pages/checkout_shipping/header_php.php
/includes/templates/YOUR_TEMPLATE/common/tpl_header.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_checkout_confirmation_default.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_checkout_payment_default.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_checkout_shipping.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_checkout_success.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_login_default.php
/includes/filenames.php

---

Files that make up this module are:

/admin/orders.php
/admin/customers.php
/admin/index.php
/admin/includes/languages/english/extra_definitions/COWOA.php
/admin/includes/extra_datafiles/Cowoa.php
/includes/classes/order.php /includes/extra_datafiles/no_account_filenames.php
/includes/extra_datafiles/order_status_filenames.php
/includes/language/english/extra_definitions/checkout_process.php
/includes/language/english/extra_definitions/order_status.php
/includes/language/english/extra_definitions/order_steps_defines.php
/includes/languages/english/YOUR_TEMPLATE/checkout_confirmation.php
/includes/languages/english/YOUR_TEMPLATE/checkout_payment.php
/includes/languages/english/YOUR_TEMPLATE/checkout_process
/includes/languages/english/YOUR_TEMPLATE/checkout_shipping.php
/includes/languages/english/YOUR_TEMPLATE/gv_redeem.php
/includes/languages/english/YOUR_TEMPLATE/login.php
/includes/languages/english/YOUR_TEMPLATE/logoff.php
/includes/languages/english/YOUR_TEMPLATE/no_account
/includes/languages/english/YOUR_TEMPLATE/order_status
/includes/languages/english/YOUR_TEMPLATE/time_out
/includes/modules/YOUR_TEMPLATE/create_account.php
/includes/modules/YOUR_TEMPLATE/no_account.php
/includes/modules/YOUR_TEMPLATE/os_downloads.php
/includes/modules/pages/checkout_shipping/header_php
/includes/modules/pages/gv_redeem/header
/includes/modules/pages/login/header
/includes/modules/pages/no_account/header_php.php
/includes/modules/pages/no_account/jscript_addr_pulldowns.php
/includes/modules/pages/no_account/jscript_form_check.php
/includes/modules/pages/no_account/on_load_main.js
/includes/modules/pages/order_status/header_php.php
/includes/modules/pages/order_status/jscript_main.php
/includes/modules/pages/password_forgotten/header_php
/includes/templates/YOUR_TEMPLATE/common/tpl_header.php
/includes/templates/YOUR_TEMPLATE/css/checkout_confirmation.css
/includes/templates/YOUR_TEMPLATE/css/checkout_payment.css
/includes/templates/YOUR_TEMPLATE/css/checkout_shipping.css
/includes/templates/YOUR_TEMPLATE/css/checkout_success.css
/includes/templates/YOUR_TEMPLATE/css/no_account.css
/includes/templates/YOUR_TEMPLATE/images/arrow_checkout.gif
/includes/templates/YOUR_TEMPLATE/images/orderstep.png
/includes/templates/YOUR_TEMPLATE/templates/tpl_checkout_confirmation_default.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_checkout_payment_default.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_checkout_shipping.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_checkout_success.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_login_default.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_modules_no_account.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_modules/os_downloads.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_no_account_default.php
/includes/templates/YOUR_TEMPLATE/templates/tpl_order_status_default
/includes/filenames.php

---

8) - The COWOA_Full_Install.sql file should take care of this for you but you may want to check it to be sure. In your admin section, under configuration>layout settings>use split-login page,
you want it to say "true". You will not be able to see the Checkout Without Account section on the login page unless you turn this switch on.

9) - **** Go to your Admin Configuration screen and open up COWOA There are 4 configuations that need to be set to True or False.

You now have Checkout WithOut an Account Installed.

UNINSTALL: To uninstall this mod, replace the files that were over written with your backed up files. You did make a copy Right? Run the uninstall_COWOA.sql file to remove the database entries.

[4jDesigns]

Hello,

This is an awesome mod and tx for it, Got 3 questions though...

1.) I have 'forced logoff' set to true so that I am not left with any 'logged in / logged off' issues. I have 'order status' set to true so the customer and receive the link in their order confirmation email and so they do, which all of this works great and fine. But my concern I have is that when the customer is directed to their order_status page and then go to 'Login' link they are directed to 'My Account' page i.e. 'logged in / logged off' issue. I understand that an account has actually been created regardless to keep the order details, but is there a way that the customer could be directed to normal login page so that they are not under the impression they do have an actual account?

--- Which leads me to my next query...

2.) If an account exists and a customer uses cowoa with the same email address it would notify them that they already have an account?

--- and...

3.) If a customer has already used cowoa and wants to create an account with the same email address, could their order history be merged into a single account?

If you could help that would be greatly appreciated.

Thanks
Jay.

[4jDesigns]

1.) I have 'forced logoff' set to true so that I am not left with any 'logged in / logged off' issues. I have 'order status' set to true so the customer and receive the link in their order confirmation email and so they do, which all of this works great and fine. But my concern I have is that when the customer is directed to their order_status page and then go to 'Login' link they are directed to 'My Account' page i.e. 'logged in / logged off' issue. I understand that an account has actually been created regardless to keep the order details, but is there a way that the customer could be directed to normal login page so that they are not under the impression they do have an actual account?

Ok so I have come up with a possible solution for my own question

In my 'includes/modules/pages/login/header_php.php find the lines:

// if the customer is logged in already, redirect them to the My account page
if (isset($_SESSION['customer_id']) and $_SESSION['customer_id'] != '') {
  zen_redirect(zen_href_link(FILENAME_ACCOUNT, '', 'SSL'));
}

And change it to:

// if the customer is logged in already, redirect them to the My account page
if ((isset($_SESSION['customer_id']) and $_SESSION['customer_id'] != '') && ($check_customer->fields['COWOA_account'] == '0')) {
  zen_redirect(zen_href_link(FILENAME_ACCOUNT, '', 'SSL'));
}

This now fixes my issue with COWOA customers being directed to 'My Account' page when clicking link 'Login'.

-----------------------------------------
As well, and I'm not sure if it is the wrong or right thing to do, but If a guest had added a product to a cart, then uses the 'order status' link in a previous email at the same time, they get to see the order status as well as 'items in their basket' (as per their current session), but if they continue to checkout via COWOA, they skip 'Billing' and go straight to 'Shipping' without having to add their details, which obviously screws up the process.

From what I understand, its because the cart thinks they are 'logged in' but not really as they don't have an actual account, so what I have done until a better solution comes along is this:

In 'includes/modules/pages/order_status/header_php.php' find this line:

$zco_notifier->notify('NOTIFY_HEADER_START_ORDER_STATUS');

Then underneath it place this:

if (($check_customer->fields['COWOA_account'] == '1') && ($_SESSION['cart']->count_contents() > 0)) {
	unset ($_SESSION['cart']);
}

This will basically clear the cart of items if the user was using COWOA checkout and has items added in cart from a previous session. From what I believe this should only happen if the user as a guest has items in the basket and uses the 'order status' link in a previous order confirmation from a COWOA checkout.

Note: these are only my solution, so they may be wrong or right and any feedback regarding would be greatly appreciated.

Thanks,
Jay

[countrycharm]

Hi Jay,

What Cowoa version are you using?
For question (1) in the latest version of Cowoa v2.2 the force logoff issue should have been corrected.

As well, and I'm not sure if it is the wrong or right thing to do, but If a guest had added a product to a cart, then uses the 'order status' link in a previous email at the same time, they get to see the order status as well as 'items in their basket' (as per their current session), but if they continue to checkout via COWOA, they skip 'Billing' and go straight to 'Shipping' without having to add their details, which obviously screws up the process.

You are right if a former guest had added a product to a cart, then uses the 'order status' link in a previous email at the same time, they get to see the order status as well as 'items in their basket, but again in version 2.2 if you tried to go to checkout it would empty your shopping cart.

For question (2)

If an account exists and a customer uses cowoa with the same email address it would notify them that they already have an account?

If a customer already has a full account with your store they can not checkout with Cowoa.
If a returning customer uses Cowoa again and again, No it would not notify them that they already have an account.

For question (3)

If a customer has already used cowoa and wants to create an account with the same email address, could their order history be merged into a single account?

No, they would have to make a full account with your store. Any suggestion are welcome.

[DivaVocals]

2.) If an account exists and a customer uses cowoa with the same email address it would notify them that they already have an account?

If a customer has an account in your store, they no longer can use any of the COWOA options..

3.) If a customer has already used cowoa and wants to create an account with the same email address, could their order history be merged into a single account?

Not without some significant changes to the COWOA code to add this feature..

[4jDesigns]

Hi CountryCharm,

I am using V2.2 . I had not tested / noticed the 'on checkout their basket is emptied' scenario, but none the less I would rather just get rid of their basket contents asap so to not have a frustrated customer realizing only when they get to checkout that their basket is now cleared. But please if you do have further thoughts on this please do let me know.

Re my 2nd question, from what I understand, If you are logged into your account you do not have the COWOA function (for obvious reasons), but what if I am not logged in and thus I am able to use COWOA and use the same email address already registered (but not logged into of course), is it possible to be prompt/notified to use another address as the system has already got this email address registered?

And Re my 3rd Question... not sure why I asked it. As the name says Checkout WITHOUT an Account, so as far as a customer is aware, they don't have any history saved anyway.

Thanks,
Jay

--------------------------------------------------------------------------------

Hi DivaVocals,

Thanks for the reply too, but think my 2nd question was a little misunderstood.

[DivaVocals]

Re my 2nd question, from what I understand, If you are logged into your account you do not have the COWOA function (for obvious reasons), but what if I am not logged in and thus I am able to use COWOA and use the same email address already registered (but not logged into of course), is it possible to be prompt/notified to use another address as the system has already got this email address registered?

This is EXACTLY how it works now..

[countrycharm]

I am using V2.2 . I had not tested / noticed the 'on checkout their basket is emptied' scenario, but none the less I would rather just get rid of their basket contents asap so to not have a frustrated customer realizing only when they get to checkout that their basket is now cleared. But please if you do have further thoughts on this please do let me know.

I hear what your saying but it is design to kill and current session when the customer checks the order status from there email. If they have and item in the cart or not it still is going to kill there session from the email order status.

Re my 2nd question, from what I understand, If you are logged into your account you do not have the COWOA function (for obvious reasons), but what if I am not logged in and thus I am able to use COWOA and use the same email address already registered (but not logged into of course), is it possible to be prompt/notified to use another address as the system has already got this email address registered?

I would assume they would understand the warning message if they already have a full account with your shop. The warning message is.....

Our system already has a record of that email address - please try logging in with that email address. If you do not use that address any longer you can correct it in the My Account area.

And Re my 3rd Question... not sure why I asked it. As the name says Checkout WITHOUT an Account, so as far as a customer is aware, they don't have any history saved anyway.

As far as they are ware they don't..

[4jDesigns]

Hey Countrycharm and Divavocals...

Well... what can I say... I'm an @$$. I have been using 2 different emails to test purchases and auto-filling the fields with what has been cached, so been running tests with 2 separate 'users'... no wonder I wasn't seeing what you 2 were saying...

Anyways, tx for your time.

Jay

AND TO ANYWAY READING THIS POST... IT DOES WORK, TRY DOING IT PROPERLY!!!