Purchase Order Basic

After upgrading to Zen-Cart1.5, my PO program stopped working, Since I couldnt find one that worked for ZC 1.5 I created one as my client had to have one. Therefore I have just finished creating a working Purchase Order Basic Module for Zen-Cart 1.5.x.
This module allows the customer to select Purchase Order as an option for payment and then requires a PO Number be added.

Works in 1.5.x. Has not been tested in 1.3.9 but should work.

For questions comments please leave them here.

The module can be downloaded from the Free Software Addons section of Zen-Cart

http://www.zen-cart.com/index.php?main_page=product_contrib_info&products_id=2058

Hi,

This looks great and something I need, but I could not find it in the downloads section.

Is there a feature to this mod like That Software Guys' 'Invoice' add-on. As I need to select which customers can pay by PO/Invoice and restrict some customers (slow bad payers) to not have this checkout option available.

Thanks
Ray

sounds like a great mod, but couldn't find it either, is it awaiting approval from the zen cart team?

I just realized that it takes a bit longer than I thought once you upload it to zencart for approval.
They tell me it could take up to a week. I will make it available through another means here shortly.

I was just looking at that option about adding the ability of choosing which customers can pay with purchase orders. So that is something I will be working on shortly.

Thanks for the suggestion, please keep them coming, I will look to incorporate them.
Mike

Hi Mike,

How can I get a copy of your po module?

I am new to zen cart and tried to modify the moneyorder module, however it doesn't have any input field, and I haven't yet figured out how to add it to the module and save it to the order details.

Thanks,
Tbone

I just received some great feedback from Dr. Byte.
I will need to make some quick changes to the code based on his recommendations and this should eliminate any edits and make the module better.
Please bear with me this will take about a day and I will have this online. I apologize for any delay. Working to make this right for all of us.
Mike

OK,
Here it is...

I have made the changes and works beautifully. I have resubmitted to Free Software Addons on ZenCart.com and it is awaiting approval.
With Dr. Bytes suggestions, this module now makes no changes to the database and no files are changed in any way.

Installation is a snap!

The module is here:

http://www.zen-cart.com/index.php?main_page=product_contrib_info&products_id=2058

Please leave feedback and support questions in this thread.
If you are using this module and you find it helpful... please drop me a line and let me know.

Thanks
Mike

l3ackdraft:

I just received some great feedback from Dr. Byte.
I will need to make some quick changes to the code based on his recommendations and this should eliminate any edits and make the module better.
Please bear with me this will take about a day and I will have this online. I apologize for any delay. Working to make this right for all of us.
Mike

no worries fella, no hurry. We all appreciate the effort and complexities of your tasks. I for one am just greatful the simple folk like me have the smart chaps like you leading the way!

The module is now available for download from Zen Cart Free Software Addons.

I will be removing the other URL and this will be the only place I will have made it available for download.

http://www.zen-cart.com/index.php?main_page=product_contrib_info&products_id=2058

This works a Dream, How/where would i include some additional instructions to the customer asking to Fax/Email a copy of the purchase order. Ideally after the selection has been on made on step 3 of the checkout before the order is confirmed and sent to pending

An easy way to do that would be by customizing the code to emulate the check/moneyorder module's field that lets the admin indicate where to send the check. And stuff that value into the $this->email_footer variable.

There is a problem with the following code which shows error box if no order number is entered. It should read

define('MODULE_PAYMENT_PO_TEXT_JS_PO_NUMBER', 'You must enter your Purchase Order number.');
?>

Also i require the description text below to show on confirmation (step 3), all i am getting is the title text twice (purchase order)

define('MODULE_PAYMENT_PURCHASEORDER_TEXT_DESCRIPTION', 'We Verify All Purchase Orders Prior to Shipment!.');

what is the correct code so this shows?

would it go here somewhere?

function confirmation() {

  $confirmation = array('title' => $this->title,
                        'fields' => array(array('title' => MODULE_PAYMENT_PURCHASEORDER_TEXT_PURCHASEORDER_NUMBER,
                                                'field' => $_POST['po_number'])));

  return $confirmation;

mattee77:

There is a problem with the following code which shows error box if no order number is entered. It should read

define('MODULE_PAYMENT_PO_TEXT_JS_PO_NUMBER', 'You must enter your Purchase Order number.');
?>

No, quite the opposite. Don't change the language file. The module itself should refer to MODULE_PAYMENT_PURCHASEORDER_TEXT_JS_PURCHASEORDER_NUMBER instead of MODULE_PAYMENT_PO_TEXT_JS_PO_NUMBER on line 66

I already reported this to Mike, but he hasn't updated the addon yet.

mattee77:

Also i require the description text below to show on confirmation (step 3), all i am getting is the title text twice (purchase order)

define('MODULE_PAYMENT_PURCHASEORDER_TEXT_DESCRIPTION', 'We Verify All Purchase Orders Prior to Shipment!.');

what is the correct code so this shows?
Try this:```
function confirmation() {
$confirmation = array('title' => $this->title,
'fields' => array(array('title' => MODULE_PAYMENT_PURCHASEORDER_TEXT_PURCHASEORDER_NUMBER,
'field' => $_POST['po_number'])[B],
array('title' => '',
'field' => MODULE_PAYMENT_PURCHASEORDER_TEXT_EMAIL_FOOTER)[/B]));

  return $confirmation;
}

and
function before_process() {
global $order;
$order->info['payment_method'] .= ': ' . $_POST['po_number'];
[B] $this->email_footer = MODULE_PAYMENT_PURCHASEORDER_TEXT_PURCHASEORDER_NUMBER . " " . $_POST['po_number'] . "\n" . MODULE_PAYMENT_PURCHASEORDER_TEXT_EMAIL_FOOTER;[/B]
}

Brilliant, thanks for that. I spent half the day trying to figure it out. It works perfecly now :clap:

Does this module allow the client to select which customers will see that option? She understandably doesn't want all of her customers to know that is an option for certain customers.

No this module does not do that. I have received a couple of requests for such and will look into making this option available. Right now there is no completion date proposed.

I thought about it, and as I have received a number of requests for this same addon, I have decided I will write the changes tonight and hopefully upload tonight or tomorrow.
So stay tuned and this will be available shortly.

With this module my intent is to not have the end user modify any core files.

I will keep you posted.

Thanks
Mike

Summary of what to change:

• in the install() section add a new settings field, for which customer groups should be allowed to use it
• in the update_status() section check whether the current customer is in one of the allowed groups, and if not then set $this->enabled = false;

Then the storeowner can manually add the appropriate customers to the appropriate group. (The group should can be set to give 0% discount if needed.)
And in the p/o module can specify that group-number as the allowed group.

Maybe consider a comma-separated list of multiple groups in the module's group field in case that's needed.
ie: if (!in_array($customer_group, explode(',', DEFINED_CONSTANT_HERE))) $this->enabled = false;