Difference between revisions of "Email Orders"
From Custom Scriptz
(Created page with ''''Email Orders developed by Diego Vieira'''<br /> '''Cannot be resold or freely distributed. This is not a free product.'''<br /><br /> '''To get your license key, go to <a href...') |
|||
| (34 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | '''Email Orders | + | '''Email Orders''' is a module developed by [[Custom Scriptz]] for [http://www.zen-cart.com Zen Cart] where Manufacturers (often called Designers by Scrapbooking Stores) can receive email reports with their sold products for each order. |
| − | + | ||
| − | + | ||
| − | + | ||
| + | === This module is free? === | ||
| + | * No, this module is available at our [http://customscriptz.com scripts store]. | ||
| − | + | === This module is supported by Zen Cart Team? === | |
| − | + | * No, we support this module. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | === This module will overwrite any of my files? === | |
| − | + | * No, this module does not overwrite any core file from Zen Cart. | |
| − | + | == System Requirements == | |
| − | < | + | [http://www.zen-cart.com Zen Cart v1.3.8a or newer]<br /> |
| + | [http://ioncube.com ionCube Loaders]<br /> | ||
| + | [http://php.net PHP 5 or newer]<br /> | ||
| + | [http://www.mysql.com MySQL 5]<br /> | ||
| − | + | == Features == | |
| − | + | * Send email messages separately by manufacturer that have their products purchased in the same order. | |
| + | * '''Example:''' | ||
| + | Customer buy 10 products from 3 different Manufacturers. When you use Email Orders, 3 email messages will be sent out with the following contents: | ||
| − | + | * '''ManufacturerA:''' receive an email message with 3 products and his totals (with discount if any) | |
| − | + | * '''ManufacturerB:''' receive an email message with 2 products and his totals (with discount if any) | |
| − | + | * '''ManufacturerC:''' receive an email message with 5 products and his totals (with discount if any) | |
| − | + | * '''Store Owner:''' receive an email message containing an report with the orders totals sent to manufacturers. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | * If '''any''' coupon is used, the discount will be restricted only to the products/categories that have restriction to it. If a coupon is used and no restriction is applied, the discount is applied to all products for all emails with his own discount.<br /><br /> | |
| − | + | This module is aimed to be used at Stores that have their default currency set to USD. In the future versions will support different currencies. | |
| − | + | == Demo Message == | |
| − | + | '''Email sent to ManufacturerA''' | |
| − | < | + | <pre>EMAIL ORDER #328 |
| − | Order Number | + | Order Number #6255 |
| − | Date: 2009-05- | + | Date: 2009-05-30 23:23:39 |
| − | PRODUCTS ORDERED | + | PRODUCTS ORDERED |
| − | --------------------------------- | + | --------------------------------- |
| − | Product name: | + | Product name: Example1 |
| − | + | Product price: $2.50 (Coupon Applied) | |
| − | Product price: $ | + | Product quantity: 1 |
| − | Product quantity: 1 | + | Download 01 of 01 |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | Product name: Example2 | |
| − | + | Product price: $2.50 (Coupon Applied) | |
| + | Product quantity: 1 | ||
| + | Download 01 of 01 | ||
| − | + | Product name: Example3 | |
| − | + | Product price: $4.00 | |
| + | Product quantity: 1 | ||
| + | Download 01 of 01 | ||
| − | + | --------------------------------- | |
| − | + | Sub-Total: $9.00 | |
| − | + | Coupon Discount: $5.00 (Coupon Code: coupon_test_code) | |
| − | + | Total: $4.00 | |
| − | + | </pre> | |
| − | + | ||
| + | '''Email sent to ManufacturerB''' | ||
| + | <pre>EMAIL ORDER #329 | ||
| − | + | Order Number #6255 | |
| − | + | Date: 2009-05-30 23:23:39 | |
| − | + | ||
| + | PRODUCTS ORDERED | ||
| + | --------------------------------- | ||
| + | Product name: Example4 | ||
| + | Product model: Model_Test4 | ||
| + | Product price: $3.50 | ||
| + | Product quantity: 1 | ||
| + | Download 01 of 01 | ||
| − | + | --------------------------------- | |
| − | + | Sub-Total: $3.50 | |
| − | + | Coupon Discount: $0.00 | |
| − | + | Total: $3.50 | |
| − | + | </pre> | |
| − | + | '''Email sent to ManufacturerC''' | |
| + | <pre>EMAIL ORDER #330 | ||
| − | + | Order Number #6255 | |
| − | + | Date: 2009-05-30 23:23:39 | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | PRODUCTS ORDERED | |
| − | + | --------------------------------- | |
| − | + | Product name: Example5 | |
| − | + | Product model: Model_Test5 | |
| − | + | Product price: $3.50 | |
| − | + | Product quantity: 1 | |
| + | Download 01 of 01 | ||
| − | + | Product name: Example6 | |
| − | + | Product model: Model_Test6 | |
| − | + | Product price: $3.00 | |
| + | Product quantity: 1 | ||
| + | Download 01 of 01 | ||
| − | + | --------------------------------- | |
| − | + | Sub-Total: $6.50 | |
| + | Coupon Discount: $0.00 | ||
| + | Total: $6.50 | ||
| − | + | </pre> | |
| − | + | ''' And finally, this is the email that the Store Owner receive at each batch sent:''' | |
| + | <pre>Email Orders Sent Report | ||
| + | 05/30/2009 23:23:39 | ||
| − | + | Email Messages Sent: 3 | |
| − | + | --------------------------------- | |
| − | + | ManufacturerA | |
| + | --------------------------------- | ||
| + | Email Order #328 - Order #6255 - Sub-Total: $9.00 - Coupon Discount: $5.00 (Coupon Code: coupon_test_code) | ||
| − | + | ManufacturerB | |
| − | + | --------------------------------- | |
| − | + | Email Order #329 - Order #6255 - Sub-Total: $3.50 | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ManufacturerC | |
| − | + | --------------------------------- | |
| − | + | Email Order #330 - Order #6255 - Sub-Total: $6.50 | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| + | Sub-Total: $19.00 | ||
| + | Discounts Total: $5.00 | ||
| + | Orders Total: $14.00</pre> | ||
| − | + | == Before Installing / Upgrading == | |
| + | '''Thought our modules are exhausted tested, we do not guarantee that everything goes smoothly, so please, BACKUP YOUR DATABASE AND FILES before proceed.''' | ||
| − | ''' | + | == Installation Instructions == |
| + | * Download the license manager from http://customscriptz.com/downloads/license-manager.zip | ||
| + | * Extract both license manager and the module file that you downloaded from our [http://customscriptz.com/customers Customers Area] to a temp dir on your computer. | ||
| + | * Cut the "uploads" dir from the license manager package and past over the extracted module dir. | ||
| + | * Inside the extracted dir, you will notice one dir called "uploads". | ||
| + | * If your "admin" directory has a different name, rename the dir "admin" dir that's inside the "uploads" dir to match yours. | ||
| + | * Now, upload all the contents of the dir "uploads" to the root of your store. Don't upload the "uploads" dir, but what's inside of it. There are no overwrites. | ||
| − | + | * Wait for the upload of all files to complete. | |
| − | 1. | + | * If your Zen Cart version is equals to 1.3.x -> go to Admin -> Customers -> Email Orders |
| + | * If your Zen Cart version is equals or above 1.5.x -> go to Admin -> Custom Scriptz -> Email Orders | ||
| − | + | * You will then be redirected to the License Manager to enter your license. | |
| − | + | * After you enter the license, the module will redirect you to it's main page and show you that the installation was succeed. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | == Upgrading Instructions == | |
| − | + | * Download the license manager from http://customscriptz.com/downloads/license-manager.zip | |
| − | + | * Extract both license manager and the module file that you downloaded from our [http://customscriptz.com/customers Customers Area] to a temp dir on your computer. | |
| − | + | * Cut the "uploads" dir from the license manager package and past over the extracted module dir. | |
| − | + | * Now, upload all the contents of the dir "uploads" to the root of your store. Don't upload the "uploads" dir, but what's inside of it. Overwrite everything. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | * Wait for the upload of all files to complete. | |
| − | 1. | + | * If your Zen Cart version is equals to 1.3.x -> go to Admin -> Customers -> Email Orders |
| − | + | * If your Zen Cart version is equals or above 1.5.x -> go to Admin -> Custom Scriptz -> Email Orders | |
| − | + | ||
| − | 5. | + | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | * Email Orders will update itself if necessary. | |
| − | - | + | == Settings == |
| − | - | + | '''Settings can be found at the Admin Panel of your Store -> Configuration -> Email Orders''' |
| − | - | + | * Mostly settings are self-explanatory and has a description when you click on it. Just click the setting and look at the right panel to know what is it for. |
| − | - | + | |
| + | The setting below can be found at the Admin Panel of your Store -> Customers -> Email Orders | ||
| + | * '''Send Old:''' You can resend products that have been sent already, when you access the Email Orders page, you will see a 'Send Old' button at the top of the page (allright, I'll move that button to the statistics panel :p). So you click the Send Old and do a search for the period that you want and send the products again as you do normally. Note: Products that have been sent will not disappear for this list, instead the column 'Sent Times' will increase by 1 each time you send the order. If you want to send new emails, just click the Send New button.<br /><br /> | ||
| + | |||
| + | ''Note: If you have PrivateArea installed, you may edit the Manfanufacturer (a.k.a Designers) at Tools -> Providers'' | ||
| + | The setting below can be found at the Admin Panel of your Store -> Customers -> Email Orders - Edit Email | ||
| + | * '''Manufacturers Email:''' Set the email for the manufacturers.<br /><br /> | ||
| + | |||
| + | == Tutorial == | ||
| + | ''Note: If you have PrivateArea installed, you may skip the step below.'' | ||
| + | |||
| + | * If your Zen Cart version is equals to 1.3.x -> go to Admin -> Customers -> Email Orders - Edit Email | ||
| + | * If your Zen Cart version is equals or above 1.5.x -> go to Admin -> Custom Scriptz -> Email Orders - Edit Email | ||
| + | |||
| + | * Edit each Manufacturer Email Address. If you don't enter the email address for a particular Manufacturer, when you try to send a email order for him/her, you will get a error and the email will not be sent until you enter his/her email address. | ||
| + | |||
| + | * By default the software is set to work in Debug Mode, after you are done testing, you may want to change it to live mode, to do this go to the Admin Panel of your Store -> Configuration -> Email Orders -> Debug Mode and set this to False. While debug mode is On, you will see a report at your screen like how the email message would be sent, but no emails will be send until you set debug mode to False. | ||
| + | |||
| + | * Go to the Admin Panel of your Store -> Customers -> Email Orders. | ||
| + | * In this page you will see a list of Products with their respective Manufacturers. Check the products (99% of the time you will leave all products checked - but you can un/check all the boxes at once - just click the link on the top of the checkboxes column) that you want your manufacturers to receive the email from it and press the button "Send". If everything nothing goes wrong, your manufacturers should receive a email right way with his purchased products. Now you are done sending and the next batch/page (if there are remaining products) will be displayed and you press the button "Send" to start again. If failed to send the email out (manufacturer with no email address for example) the products will be displayed again until you you correct the email address at the Manufacturers page. After you are confortable using email orders, if you haven't done so, activate AutoSend and it will do it for you. | ||
| + | |||
| + | === Emails Note === | ||
| + | This module send a email for each order for each manufacturer that has products in the order. Ex. Order #1234 -> 3 Manufacturers envolved, 3 email messages will be sent out, Order #1235 -> The same 3 Manufacturers, 3 email will sent out for that and this particular order, total = 6 messages. Before complaining that the tool is not working, check your email settings at My Store -> E-Mail Options or ask your host to increase the limit of email messages that you can send per hour. Maybe you have reach this limit. | ||
| + | |||
| + | == FAQ == | ||
| + | '''* One product does not appear on the list for me to send, why?''' | ||
| + | * Check if this a product have a manufacturer set up on the Products Page. This is a free product and your configuration is set to 'False' to include free products. | ||
| + | |||
| + | |||
| + | '''* How to reset the old products to not being sent to my manufacturers?''' | ||
| + | * Just click the link 'Reset Old Products' on the right. Then, it will just disappear and only new orders will be available to be sent. | ||
| + | |||
| + | |||
| + | '''Got Questions, Bugs or Requests? | ||
| + | http://customscriptz.com/support''' | ||
Latest revision as of 23:34, 27 April 2012
Email Orders is a module developed by Custom Scriptz for Zen Cart where Manufacturers (often called Designers by Scrapbooking Stores) can receive email reports with their sold products for each order.
Contents
This module is free?
- No, this module is available at our scripts store.
This module is supported by Zen Cart Team?
- No, we support this module.
This module will overwrite any of my files?
- No, this module does not overwrite any core file from Zen Cart.
System Requirements
Zen Cart v1.3.8a or newer
ionCube Loaders
PHP 5 or newer
MySQL 5
Features
- Send email messages separately by manufacturer that have their products purchased in the same order.
- Example:
Customer buy 10 products from 3 different Manufacturers. When you use Email Orders, 3 email messages will be sent out with the following contents:
- ManufacturerA: receive an email message with 3 products and his totals (with discount if any)
- ManufacturerB: receive an email message with 2 products and his totals (with discount if any)
- ManufacturerC: receive an email message with 5 products and his totals (with discount if any)
- Store Owner: receive an email message containing an report with the orders totals sent to manufacturers.
- If any coupon is used, the discount will be restricted only to the products/categories that have restriction to it. If a coupon is used and no restriction is applied, the discount is applied to all products for all emails with his own discount.
This module is aimed to be used at Stores that have their default currency set to USD. In the future versions will support different currencies.
Demo Message
Email sent to ManufacturerA
EMAIL ORDER #328 Order Number #6255 Date: 2009-05-30 23:23:39 PRODUCTS ORDERED --------------------------------- Product name: Example1 Product price: $2.50 (Coupon Applied) Product quantity: 1 Download 01 of 01 Product name: Example2 Product price: $2.50 (Coupon Applied) Product quantity: 1 Download 01 of 01 Product name: Example3 Product price: $4.00 Product quantity: 1 Download 01 of 01 --------------------------------- Sub-Total: $9.00 Coupon Discount: $5.00 (Coupon Code: coupon_test_code) Total: $4.00
Email sent to ManufacturerB
EMAIL ORDER #329 Order Number #6255 Date: 2009-05-30 23:23:39 PRODUCTS ORDERED --------------------------------- Product name: Example4 Product model: Model_Test4 Product price: $3.50 Product quantity: 1 Download 01 of 01 --------------------------------- Sub-Total: $3.50 Coupon Discount: $0.00 Total: $3.50
Email sent to ManufacturerC
EMAIL ORDER #330 Order Number #6255 Date: 2009-05-30 23:23:39 PRODUCTS ORDERED --------------------------------- Product name: Example5 Product model: Model_Test5 Product price: $3.50 Product quantity: 1 Download 01 of 01 Product name: Example6 Product model: Model_Test6 Product price: $3.00 Product quantity: 1 Download 01 of 01 --------------------------------- Sub-Total: $6.50 Coupon Discount: $0.00 Total: $6.50
And finally, this is the email that the Store Owner receive at each batch sent:
Email Orders Sent Report 05/30/2009 23:23:39 Email Messages Sent: 3 --------------------------------- ManufacturerA --------------------------------- Email Order #328 - Order #6255 - Sub-Total: $9.00 - Coupon Discount: $5.00 (Coupon Code: coupon_test_code) ManufacturerB --------------------------------- Email Order #329 - Order #6255 - Sub-Total: $3.50 ManufacturerC --------------------------------- Email Order #330 - Order #6255 - Sub-Total: $6.50 Sub-Total: $19.00 Discounts Total: $5.00 Orders Total: $14.00
Before Installing / Upgrading
Thought our modules are exhausted tested, we do not guarantee that everything goes smoothly, so please, BACKUP YOUR DATABASE AND FILES before proceed.
Installation Instructions
- Download the license manager from http://customscriptz.com/downloads/license-manager.zip
- Extract both license manager and the module file that you downloaded from our Customers Area to a temp dir on your computer.
- Cut the "uploads" dir from the license manager package and past over the extracted module dir.
- Inside the extracted dir, you will notice one dir called "uploads".
- If your "admin" directory has a different name, rename the dir "admin" dir that's inside the "uploads" dir to match yours.
- Now, upload all the contents of the dir "uploads" to the root of your store. Don't upload the "uploads" dir, but what's inside of it. There are no overwrites.
- Wait for the upload of all files to complete.
- If your Zen Cart version is equals to 1.3.x -> go to Admin -> Customers -> Email Orders
- If your Zen Cart version is equals or above 1.5.x -> go to Admin -> Custom Scriptz -> Email Orders
- You will then be redirected to the License Manager to enter your license.
- After you enter the license, the module will redirect you to it's main page and show you that the installation was succeed.
Upgrading Instructions
- Download the license manager from http://customscriptz.com/downloads/license-manager.zip
- Extract both license manager and the module file that you downloaded from our Customers Area to a temp dir on your computer.
- Cut the "uploads" dir from the license manager package and past over the extracted module dir.
- Now, upload all the contents of the dir "uploads" to the root of your store. Don't upload the "uploads" dir, but what's inside of it. Overwrite everything.
- Wait for the upload of all files to complete.
- If your Zen Cart version is equals to 1.3.x -> go to Admin -> Customers -> Email Orders
- If your Zen Cart version is equals or above 1.5.x -> go to Admin -> Custom Scriptz -> Email Orders
- Email Orders will update itself if necessary.
Settings
Settings can be found at the Admin Panel of your Store -> Configuration -> Email Orders
- Mostly settings are self-explanatory and has a description when you click on it. Just click the setting and look at the right panel to know what is it for.
The setting below can be found at the Admin Panel of your Store -> Customers -> Email Orders
- Send Old: You can resend products that have been sent already, when you access the Email Orders page, you will see a 'Send Old' button at the top of the page (allright, I'll move that button to the statistics panel :p). So you click the Send Old and do a search for the period that you want and send the products again as you do normally. Note: Products that have been sent will not disappear for this list, instead the column 'Sent Times' will increase by 1 each time you send the order. If you want to send new emails, just click the Send New button.
Note: If you have PrivateArea installed, you may edit the Manfanufacturer (a.k.a Designers) at Tools -> Providers The setting below can be found at the Admin Panel of your Store -> Customers -> Email Orders - Edit Email
- Manufacturers Email: Set the email for the manufacturers.
Tutorial
Note: If you have PrivateArea installed, you may skip the step below.
- If your Zen Cart version is equals to 1.3.x -> go to Admin -> Customers -> Email Orders - Edit Email
- If your Zen Cart version is equals or above 1.5.x -> go to Admin -> Custom Scriptz -> Email Orders - Edit Email
- Edit each Manufacturer Email Address. If you don't enter the email address for a particular Manufacturer, when you try to send a email order for him/her, you will get a error and the email will not be sent until you enter his/her email address.
- By default the software is set to work in Debug Mode, after you are done testing, you may want to change it to live mode, to do this go to the Admin Panel of your Store -> Configuration -> Email Orders -> Debug Mode and set this to False. While debug mode is On, you will see a report at your screen like how the email message would be sent, but no emails will be send until you set debug mode to False.
- Go to the Admin Panel of your Store -> Customers -> Email Orders.
- In this page you will see a list of Products with their respective Manufacturers. Check the products (99% of the time you will leave all products checked - but you can un/check all the boxes at once - just click the link on the top of the checkboxes column) that you want your manufacturers to receive the email from it and press the button "Send". If everything nothing goes wrong, your manufacturers should receive a email right way with his purchased products. Now you are done sending and the next batch/page (if there are remaining products) will be displayed and you press the button "Send" to start again. If failed to send the email out (manufacturer with no email address for example) the products will be displayed again until you you correct the email address at the Manufacturers page. After you are confortable using email orders, if you haven't done so, activate AutoSend and it will do it for you.
Emails Note
This module send a email for each order for each manufacturer that has products in the order. Ex. Order #1234 -> 3 Manufacturers envolved, 3 email messages will be sent out, Order #1235 -> The same 3 Manufacturers, 3 email will sent out for that and this particular order, total = 6 messages. Before complaining that the tool is not working, check your email settings at My Store -> E-Mail Options or ask your host to increase the limit of email messages that you can send per hour. Maybe you have reach this limit.
FAQ
* One product does not appear on the list for me to send, why?
- Check if this a product have a manufacturer set up on the Products Page. This is a free product and your configuration is set to 'False' to include free products.
* How to reset the old products to not being sent to my manufacturers?
- Just click the link 'Reset Old Products' on the right. Then, it will just disappear and only new orders will be available to be sent.
Got Questions, Bugs or Requests?
http://customscriptz.com/support
