• Your autoresponder or broadcast emails are not going out (hourly cron job dap-cron.php)
• Your Affiliates aren’t being credited with sales (hourly cron job dap-cron.php)
• Your 1SiteAutomation/1ShoppingCart Orders are not being processed. (10-minute cron job dap-emailorder.php)

The Solution

One possible solution is that your cron job(s) aren’t running correctly.

DAP has two cron jobs. One that runs once an hour (dap-cron.php), and one that runs every 10 minutes (dap-emailorder.php).

You can see how to set them up here.

But in this post, we will see how to make sure your cron is actually set up correctly, or if it’s running correctly.

How To Know If Cron Is Running

1. Go to System > Logs and click on “Empty Logs”. That will fully clear out all logs.
2. Go to Setup > Config > Basic and set “DAP Log Level” to “5″ and update row.
3. Wait for the top of the hour for the hourly cron job to run. So if the time when you’re doing this, is say 11:20 AM, then wait for 12:00 Noon. If time is 3:45 PM, then wait for 4:00 PM.
4. A few minutes past the top of the hour and go back to the System > Logs screen.
5. If you see hundreds of lines of text in the logs, then that means your cron job is running correctly. If you only see maybe 10-20 lines of text, then your cron job is NOT running correctly, and you need to make sure the cron job is actually set up correctly.

Possible Solutions & Troubleshooting Tips

1. CSV File created?

First check if there's a .csv file that has been created in the folder /dap/bulk/ on your server. If there's more than one .csv file in there (from a previous import/bulk-add), then see if there's a file whose timestamp is close to the time when you actually did the "Users > Add > Bulk-add Multiple Users To A Product" action.

If there's no .csv file, then it's possible that the folder doesn't have the right permissions for DAP to be able to create the file. So CHMOD the "bulk" folder (in /dap/ folder) to 755. Then re-try the bulk-add again.

2. Is Cron job running?

You see a .csv file in there sitting for a few hours, but none of the users inside the .csv file have been added to DAP.

It's possible that the hourly cron job has either not been set up at all, or may have been setup incorrectly. Make sure the cron is setup and running correctly.

See both these links:

i) Setting up Cron

ii) All about Cron

3. Error in CSV File

Sometimes, it is possible that the .csv file was actually created, but it was actually corrupt. And you won't know this until the cron runs and that specific bulk-add job shows an error.

Short answer: Fire them and get a better host.

Ok, the basic idea of a cron jobs is that it allows you to run scheduled tasks, that run automatically, frequently, silently, in the background, without requiring manual intervention.

DAP uses cron jobs to do things like…

• Send out autoresponder emails
• Send out broadcast emails
• Manage your outgoing queue of emails so that you can stay within your cheap web host’s strict hourly email sending limits
• Process and manage affiliate data & commissions , and
• Do some clean up jobs

Any membership script worth more than $1, should ask you to set up cron jobs for sending out emails. You couldn’t possibly send out an email blast to even 100 members in real time. If your membership script doesn’t require you to set up a cron job, then they’re worth absolutely nothing.

But DAP requires you to set up a cron job to do all of the tasks above.

And even the cheapest of the cheapest web hosts will allow you to set up a cron job.

If yours doesn’t, seriously you have only 2 choices…

1. Stick to your pathetic host, and lose the ability to use powerful scripts like DAP
2. Or do the smart thing and move to a better host. There are plenty of good ones out there, and there are a few we recommend highly, and they’re very inexpensive.

The choice is pretty obvious, no?

DAP directly integrates with the following Payment Processors without the need for any additional third-party shopping carts:

• Authorize.net
• 2Checkout.com
• ClickBank
• Digiresults
• Google Checkout
• e-Junkie (e-J does not allow recurring payments)
• JVZoo
• Paypal Standard
• Paypal Website Payments Pro
• Plimus
• WorldPay
• WSO Pro (Warrior Plus)

DAP also integrates with the following Shopping Carts

• 1SiteAutomation.com (a 1shoppingcart private label)
• Premium Web Cart
• InfusionSoft
• WP eStore

Indirect Integration through 3rd Party Shopping Carts

Since DAP integrates with Shopping carts like 1SiteAutomation.com (our white label of 1Shoppingcart), e-Junkie, Premium Web Cart and Infusionsoft, that means that it also integrates (albeit indirectly) with all of the Payment processors and gateways that these carts support. So, or example, since DAP works with 1SiteAutomation, it essentially integrates with all payment providers supported by 1SiteAutomation, like:

2CheckOut.com (direct integration too)
Authorize.net (direct integration too)
Bank of America
BluePay
Concord EFSNet
Cybercash
DPI Merchant Services
e-Commerce Exchange
Echo Inc.
ECX QuickCommerce 3.0
Epoch Systems
eProcessing Network
EPS SecureNet
EWAY (Australia)
FastTransact
Firepay
Google Checkout (direct integration too)
GoRealTime/EPP
GoRealTime
iBill
IntelliPay ExpertLink
IONGate (Costco)
iTransact RediCharge
LinkPoint Secure
MCPS WebLink
MerchantPartners
Moneris
NETbilling
Network Merchants
Paradata
PayCom Processing
Paymentech (direct integration via Authorize.net)
PayPal (direct integration too)
PayPal Payflow Pro (via e-Junkie)
PayReady
Planet Payment
PRIGate
PSiGate
RightConnect
RTWare WebLink
Shift4
SkipJack
StrataPay
Surepay
TrialPay (via e-Junkie)
TrustCommerce
USAEpay
uSight
VeriPayment
VeriSign PayFlow Pro
ViaKlix (Nova Systems)
WorldPay (direct integration too)
YourPay

For the full list and more details, click here

1-Click Upsells

If you use DAP as a shopping cart, then you can do 1-Click Upsells/Downsells like the pros, without the need for any external shopping cart or upsell service provider.

DAP directly allows you to do 1-Click Upsells using Authorize.net, Paypal Website Payments Pro and Paypal Standard. Upsell-Tree plugin for Authorize.net and Paypal Website Payments Pro is included for free along with your purchase of DAP. However, the Upsell-Tree plugin for Paypal Standard is sold separately.

Of course, if you need advanced shopping cart features – like ability to calculate shipping, tax, and coupons, then you’re better off using 1SiteAutomation.com.

1ShoppingCart & GoDaddy

If you want automated recurring order processing using 1ShoppingCart (1SC) or 1SiteAutomation.com, then DAP needs to be able to process the recurring email notifications sent by 1ShoppingCart, which it does on the back-end when the DAP Cron Job runs every 10 minutes.

However, if you’re using Godaddy as your web host, then because GoDaddy disables a mandatory PHP library (“imap”) on all their servers for some reason, DAP is unable to process the recurring order email notifications from 1ShoppingCart.

This is not an issue if you are using GoDaddy as just your domain name registrar, and using some other service like Dreamhost or Hostmonster as your web host.

But if you’re using 1SC & GoDaddy hosting, you will have to end up doing manual cancellations if any member cancels their subscription, or if their credit card fails and their recurring payments don’t get processed.

Please note that 1ShoppingCart order processing works great with all other (non-GoDaddy) hosts.

The most common ones being:

• A good clean test was not carried out, allowing the proper cookies to be set, or
• You were already logged in as DAP admin, and did not log in correct as your new buyer
• You were using the same browser to log in as DAP admin, DAP user, new buyer, etc, thus causing a problem for DAP to set and track the affiliate cookies.

A clean test is:

• You log out of DAP as admin, clear your browser cookies, and restart your browser
• You click on an affiliate link (that you have previously sent yourself via email)
• You go to your web site, and make a real purchase
• If you were automatically logged in to the member’s area (Login Xpress – keep reading to learn more about this), then nothing further to do regarding this test as a buyer
• BUT… if you were NOT automatically logged in to the member’s area, then check your email for the welcome email DAP would’ve sent you, and using the login information in the email, you must log in to the member’s area as the new buyer.

Then, you log in to DAP Admin in a completely different browser, and see if an affiliate was credited for the buyer. If yes, then you must wait for the top of the next hour for the cron job to run, and credit the actual commissions to the affiliate’s account.

Here are some more troubleshooting steps:

1A) Affiliate was not credited with a sale

There could be many reasons for why the affiliate was not credited to the sale.

1) Buyer didn’t click on any affiliate links before purchasing the product
2) Buyer did click on an affiliate link, but somehow (intentionally – or not) cleared her cookies before buying the product
3) If you haven’t set up Login Xpress, then buyer needs to log in to your membership site – which they probably haven’t done yet (if this is the case, see if DAP supports Login Xpress for your payment processor)
4) The hourly cron job on your DAP site hasn’t run yet (hourly cron has to have run *after* the buyer has logged in to their account)
5) You have not set up any affiliate commissions for the Product on the “Affiliates > Set Commissions” page

1B) Affiliate was credited with the “Lead”, but not the “Sale” (no commissions awarded)

Short answer: You’re not using “Login Xpress”. And you probably forgot to initially set up the affiliate commission for the Product in question, under “Affiliates > Commissions“, and only set up the commission record 7 days (or more) after the actual sale happened (the sale for which your affiliate got the “Lead”, but not the “Sale” (and in effect, no commissions). We call this the “7 Day Commission Cutoff Period”. So affiliate will not be awarded the commission. You just have to pay them offline.

Long answer: DAP has two ways of awarding commissions:

a) Using Login-Xpress, where affiliates are attached to buyers instantly after purchase, and when the cron job runs at the top of the next hour, the affiliate commissions are credited to the affiliate’s account.

b) In situations where Login-Xpress is not possible (due to restrictions with the specific payment processor), the affiliate is attached to the buyer only when the buyer actually logs in to your membership site. Believe it or not, not everyone logs in the same day (sometimes not even for a few days after) they’ve purchased your product. So it’s possible that the affiliate/buyer connection is not made by DAP until a couple of days later.

Now consider these scenarios…

Case X: Buyer clicked on affiliate link at work. They purchased the product at work. You don’t have Login-Xpress setup. So only way for affiliate/buyer connection to be made, is when your member logs in to your site for the first time. So they went home that evening, logged in for the first time from home, but there’s no affiliate cookie at home. Normally your affiliate is screwed. But DAP goes the extra mile to be fair to affiliates. If your buyer logs in to your membership site even a couple of days later from work, since the cookie is still on their work computer, the affiliate and buyer are now connected, and affiliate gets credit for the sale.

Case Y: Buyer never clicked on any affiliate link. They bought your product. You did not have Login-Xpress setup. So only way for affiliate/buyer connection to be made, is when your member logs in to your site for the first time. So since they never clicked on any affiliate link, there’s no affiliate cookie. They buy your product, log in to your site, and their account has no affiliate attached to it. Then a couple of days later, they’re surfing the web, and happen to read an article from one of your affiliates, and intentionally or not, click on that affiliate’s link. Now that affiliate’s cookie is stored on their computer. The next time they login, DAP thinks “Ah, this is the same as Case X (above): No affiliate attached already, but now finding affiliate cookie – same as the buy at work/login at home example. So DAP will go ahead and give that affiliate credit for the sale, even though the referral was not made prior to purchase. So to avoid awarding affiliates incorrectly (after the sale), DAP is deliberately programmed to look for transactions only for the last 7 days, every time the DAP hourly cron job runs.

2) Affiliate Program Life Cycle

1. You have already set up a “Per Sale” commission for the Product being purchased.
2. Visitor clicks on affiliate link and affiliate cookie is set on her computer
3. Visitor goes on to buy the product
4. a) If you HAVE setup Login Xpress, then member is logged right into the members’ area.
   b) If your payment processor does not support (or you HAVE NOT setup) Login Xpress, then buyer gets welcome email and logs in to your member’s area: This is when the affiliate is actually credited with the referral. So it is critical that if you’re testing the affiliate program, make sure you log in to the new member’s account.
5. So regardless of whether they’re auto-logged in right after purchase, or whether they log in a few minutes after the purchase after they’ve received their log in information via email, the login action takes place at this point.
6. At the time of this login, the only thing that happens is:
   a) DAP records in the database that this buyer was referred by the affiliate set in the affiliate cookie.
   b) If you have set up any “Per Lead” commission, then this lead commission amount is instantly credited to the affiliate’s account. So if the affiliate were to log in to his account exactly at this second, they would just see that they have gotten the “Per Lead” commission credited to their account. If there is no “Per Lead” commission, then nothing is credited to Affiliate account at this point. So the affiliate would see no “Sale” commissions yet.
7. At the top of the hour after the buyer has logged in to their member’s area, the DAP Hourly Cron (dap-cron.php) runs. It sees that Buyer X has been referred by Affiliate Y. It also sees that no “Sale” commissions have yet been credited to the affiliate for the purchase. It then looks up the Affiliate Commissions that you have previously set up at “Affiliates > Set Commissions”, calculates the commission to be credited (“Per Sale Fixed” or “Per Sale Percentage”), and then credits affiliate’s account with that amount.
8. If the affiliate were to log in to his account at this point, they would just see that they have gotten the “Per Sale” commission credited to their account.

3) Affiliate is unable to access the Affiliate-Info page.

So you created an “Affiliate” product, created a free sign-up form, and an affiliate signed up to this product, and is trying to log in and access the page, but is unable to, and is getting the “Sorry, you don’t have access to this product” error.

There could be many reasons for that (main one is #1 below):

a) Anyone who signs up through the “Direct Signup HTML Form” is added as a “Free” user. Which means, they can only access content that has been marked as free. So if you have created an “Affiliate” Product, and have added the affiliate-info page to that product, make sure that page is accessible by free users too, by clicking on the “edit” link next to the page, and on the resulting popup, set “Accessible to
Free users too?” to “Y”.

b) You have not even made the affiliate-info page protected under the “Affiliate” product

4) Double Credit of Affiliate Commissions for the same purchase

This is not really a double-credit for the same purchase, even though it appears to be so.

Sometimes you may enter a manual transaction for a purchase around the same time that DAP is processing an automated transaction for that purchase.

That means, there are now two transactions in DAP for the same purchase – one manual, and one automated – which can cause problems in accounting.

That’s usually how you end up crediting double commissions to the affiliate who referred the user, because all affiliate commissions are calculated from sales, and if you have two separate transactions for the same purchase, then the affiliate will get credited twice for the same referral.

So if you see two credits for the affiliate, you must first note that it is not for the same transaction, but for different transactions (note the different Trans Id‘s) on the Affiliates > Reports page.

So be careful when you’re entering Manual transactions. Those are meant only for when there is no way to automate the recording of a purchase (because they paid offline) and you’re unable to bring the transaction into DAP automatically.

If you see two affiliate commission credits (one for the automated transaction that DAP picked up, and one for the Manual transaction that you entered), then just refund the manual transaction in DAP. There will probably be a change to the user’s access because of the refund. So make a note of the current access of the user BEFORE you do the refund, and then AFTER you’ve processed the refund, go back to the User’s details on the Users > Manage page, and manually adjust their access to make sure it’s accurate.

1. Check if Cron is running

The DAP email-processing cron that processes the 1SC emails may not be running. Check your webhost control panel -> Cron job settings. Make sure dap-emailorder.php is setup to run once every 10 minutes.

2. Incorrect Setup of Billing Email Id

The billing email id you have entered in DAP at Setup > Config > Payment Processing , should be entered into the “Order Notice Email – Primary Destination” field in your 1SiteAutomation/1Shoppingcart account, on the Setup > Orders > Notifications section. If by chance you enter it into the “Order Notice Email – Primary Destination” field, it WILL NOT WORK.

3. No Notification Emails from 1SC

The DAP cron is running but 1SC payment notification emails are not reaching your mail server. Check the email account where you expect to receive your 1SC payment notification emails and see if the order notification email from 1SC is in that mail box.

4. Incorrect Mail Server Settings

The cron is running and the 1SC order notification email is reaching your mail server – but you did not configure the mail server settings correctly in DAP Dashboard -> Setup -> Config -> Payment Processing.

Email Server Where Order Emails Come In
Email Server User Name
Email Server Password

5.”Read” Or Deleted Emails

DAP only processes order notification emails that are in the “Unread” status, to prevent previously processed emails and other non-DAP emails from being repeatedly processed.

Also, if you “pop” off the emails from that mail box (means, your email client like Outlook or Thunderbird or Gmail is “removing” your emails from the server when it retrieves them), it means that when DAP logs in to that billing email address, there are no emails there to be processed – the mailbox is empty, or the 1SC payment notification emails have somehow gotten deleted from that mailbox.

So it is possible that DAP is able to connect to your email server, but DAP is not finding any “unread” emails. Please login to your email server and mark all the payment emails that you want DAP to process… as “unread”. And also make sure that your email client does not remove the emails from that mail box.

6.Product Name Mismatch

There might be a “Product Name” mismatch. The product name has to be EXACTLY the same (including case, spaces, etc) in both DAP as well as in 1ShoppingCart. So if you have created a product by name “Widget A”, make sure your 1shoppingcart product also has the exact same name “Widget A”.

If everything is setup correctly, DAP cron will run every 10 minutes and try to process all 1SC emails.

The next time the DAP cron will run (every 10 minutes), it will pick up all the unread payment emails from 1SC.

7. Empty “Thankyou-Email Body/Subject”

Welcome email is not getting sent.

Select the product, and make sure there is some text in the “Thankyou-Email Subject” and “Thankyou-Email Body”. Whatever is in these fields is what gets sent immediately after someone purchases that product (or right after you give them access from the backend).

Now go to DAP Dashboard -> Users -> Add .

Select the product and manually add user. Now see if the thankyou email gets sent to that email id. If it got sent, then your product setup is correct.

Also check the DAP Dashboard -> Orders . Search for all orders, look up the order for the particular user in question by email.

Check the payment status and make sure there is no error there.

If you did all this and things are still not working, please do this:

1. Set DAP Dashboard > Setup Config -> Basic > Log Level = 5
2. Re-run the 1SC test purchase
3. Check the DAP Logs (DAP Dashboard > System > Logs) and send us the log text in there for troubleshooting by pasting it into a new support ticket.

8. Sending Email & Password To Buyer

Make sure you have set the thank-you message with the right merge tags for Email and Password.

9. Manually Running Cron

First set DAP Dashboard > Settings > Config > Log Level = 5

If you feel that the orders were not processed in dap, then just login to the 1SC email account where the sales/payment notification emails are sitting, and mark those orders/emails as UNREAD that you want dap to process.

Then manually run the cron script dap-emailorder.php cron by visiting the following link in the browser.

http://www.yoursite.com/dap/dap-emailorder.php

Replace yoursite.com with the name of your site.

It will just display an empty screen when complete.

Then check “Users > Manage” to see if user has been created.

- Veena Prashanth

You may want to do this, say, if you wanted to import a bunch of users into DAP first, without DAP sending them any kind of emails at all, do some preliminary testing, make sure their settings, product access, etc, are all correct, before notifying them of any changes.

Here’s how to do a “Silent Import” with DAP

1. Remove the “ThankYou-Email Subject” and “ThankYou-Email Body” from the Product into which you wish to import users. Save it in a text file for later, and save the Product.

2. Go ahead and do the bulk-add of users from “Users > Add > Bulk-Add Multiple Users To A Product”.

3. Wait for the DAP Hourly Cron to run and finish importing all users. Since the “ThankYou-Email Subject” and “ThankYou-Email Body” of the Product is empty at the time of import, DAP won’t send out those emails.

4. Once all the users have been imported, put back the “ThankYou-Email Subject” and “ThankYou-Email Body” text content, and save the Product.

OPTIONAL

5. At a later point, if you want, you can send out an Autoresponder email – or even better, a Broadcast email – with the merge codes for the email and password, if you want the newly imported users to get their passwords, or if you wish to notify them of anything at all (like the new system you’re using, their new account info, a general “what has changed recently” type of email, etc).

See “Minimum web-hosting requirements”

What web hosts to you recommend?

See “DAP-Certified Web Hosts”

I’m getting an error during installation

See this post for more details about errors .

How can I avail of Free Installation?

See “Free Installation”

How do I setup Cron?

Setting up Cron Jobs

All about Cron Jobs

Your host does not support Cron Jobs

If you only sell one-time products, then the 1SC Login Xpress is the only thing you will need to integrate DAP and 1SC.

However, if you sell RECURRING products via 1SC, then you need to set up the email parsing of orders to allow DAP to process recurring payment notification from 1SC, as described below.

The reason for this, is that 1ShoppingCart, while very robust as a cart, does not trigger payment notification messages on the backend (like Paypal can do with IPN) when recurring payments comes in for a member.

So, we at DAP have created an exclusive “Email Order Processing” feature, where DAP will log in to your billing email inbox (where your 1SC email notifications come in) and then check your emails as if it were your personal assistant, and then process any orders that match your DAP Product names.

That is how DAP is able to do automated processing of Cancellations and Failed Recurring Payments.

For 1ShoppingCart and ClickBank, DAP does “Email Parsing” of orders.

Setting Up “Email Parsing”

Basically all you will be doing here is telling DAP where your payment notification emails from 1SC come in, and how to go fetch those emails so the recurring payments can be processed automatically, without you having to lift a finger.

1. Log in to your 1SC account. Then go to “Setup > Orders”. Copy the email id that you have entered into the “Order Notice Email – Primary Destination” field. Please note that 1SC DOES NOT send recurring billing notifications to the email id in the “Secondary Destination”. So be sure you use the email id from the “Primary Destination” field.

So let’s say you have set the primary destination email currently, to point to say ‘billing@yoursite.com’. Now make sure that the emails in your billing@yoursite.com inbox remain in ‘Unread‘ status, because when DAP logs in to check your recurring notifications, it will be looking at only Unread emails. It will not touch the ones that are already read.

2. Go to DAP Admin Dashboard > Setup >  Config > Payment Integration .

3. On this screen, configure the following fields…

Email Server Where Order Emails Come In : mail.yoursite.com

Email Server Protocol (pop3/imap) : imap (no need to change this)

Email Server Port :  143 (probably won’t need to change this)

Email Server Protocol (ssl/nossl) :  nossl (probably won’t need to change this)

Email Server User Name : billing@yoursite.com (enter email id copied from Step #1 above)

Email Server Password : yourpassword (the password to your email inbox for the above email address)

That’s it as far as setup is concerned.

Additional Notes

4. Set up your sales page as you would normally do when accepting payment through 1ShoppingCart. The only thing you need to make sure is to use the exact same “Product Name’ in your cart as well as within DAP.

So, if you set up a product called “My Membership Site” within DAP, then use the same name “My Membership Site” in your 1SC product name.

5. During installation, a Cron job (dap-emailorder.php) would have already been set up in your web hosting cpanel, to run every 10 minutes. So, every 10 minutes, DAP will automatically check the email id specified in Email Server User Name (the email id from Step 1).

If there is a payment notification (first time or recurring payment) for a product name that matches a product name in DAP, then it will automatically add that customer to DAP as a member if they’re a new member, or if they’re an existing member and it was a recurring payment notification, then DAP will “extend” their membership access by a month (or whatever your recurring cycle is), so that they will continue to get access to your membership site until the next payment comes in.

Testing

Try out some test purchases first. Make sure you try out the full purchase and full user experience, end-to-end.

WARNING 1: If you ever change the name of your product in 1ShoppingCart, or within DAP, make sure that both DAP and 1SC Product names are in sync.

WARNING 2: Do not use SKU in 1SC while defining the product. DAP will not parse the emails correctly if you use SKU.

More: Troubleshooting 1ShoppingCart Integration

(Note: You can get this setup as part of your free installation. But if you insist on doing it yourself, keep reading

There are two cron jobs (backend schedulers) that you need to setup.

1. dap-cron.php (mandatory – every 1 hour):
This is the main scheduler. This sends out broadcast emails, autresponder emails, bulk member imports, affiliate commissions processing, clean up, etc. This one is mandatory.

2. dap-emailorder.php (optional – every 10 minutes)
This is the email order processing cron, used ONLY for 1ShoppingCart. Skip setting this cron up if you’re using any of the other carts or payment processors.

Before You Start

(A) Before you can set up the cron jobs, you first need to figure out the “Path to PHP” on your web host. They usually have this somewhere in your web site control panel. If not, just ask them or read their wiki.

For eg., on Hostgator, it looks like this:

/usr/bin/php

(B) Next, visit the following url (replace YourSite.com with your actual domain name):

http://www.YourSite.com/dap/getpath.php

This will show something like this in your browser:

/home/path/to/yoursite.com/dap

This is your “local path” to your root folder.

Make a note of the two things above:

A) “Path to PHP” and

B) “Local Path”

You will be needing both below.

Setting up the Cron jobs

1. dap-cron.php:
This one is mandatory. Should be set up to run Once Every Hour. This hourly process is what sends out all the scheduled broadcast (bulk) emails and processes different types of “bulk actions” – like importing a large list of customers into DAP from an external system, for instance.

The full text to put in where it asks for the “Command to run” on your “Cron Jobs” screen in your control panel, is this:

/usr/bin/php<insert space>/home/path/to/yoursite.com/dap/dap-cron.php

2. dap-emailorder.php (required ONLY if you’re using 1ShoppingCart or any private label of 1SC – like our own 1SiteAutomation.com)

This cron job should be set up to run once every 10 minutes. This is the cron script that processes all of your orders from your customers through email. So, if you set this up to run once every 10 minutes, then every 10 minutes, it will log in to your billing email address (you can configure what this email id is within the admin control panel on the “Config” screen) and process the email notifications that you have received from 1ShoppingCart (and its private labels).

Running it sooner than once every 10 minutes – like say, once every minute or even once every 5 minutes is resource intensive. Your web host may not not even allow it in the first place. But even if they do, it’s not recommended.

The full text to put in where it asks for the “Command to run” on your “Cron Jobs” screen in your control panel, is this:

/usr/bin/php<insert space>/home/path/to/yoursite.com/dap/dap-emailorder.php

MISCELLANEOUS NOTES:

1. Where you see the text <insert space>, replace with an actual space (hitting the space bar).

2. Cron Email Reports:

Your webhost control panel allows you to set an email address where it can send the cron output. So login to your Webhost Control Panel > Cron Jobs page, and add your email address where you want the cron report sent.  If you do not want to receive the cron report, you can just remove the email address, leave it blank, and save changes.

3. To check if you have set up the cron job correctly, you can set DAP Admin -> Setup -> Config -> Log Level to 5 . Then go to DAP Admin -> System -> Logs . Empty the logs by clicking on the “Empty Logs” link, and then revisit the screen and refresh the page, after say 10 minutes (to verify the running of dap-emailorder.php) or at the top of hour (to veryify the running of dap-cron.php).

4. To force run a cron (manually), click on this link:

http://YourSite.com/dap/dap-cron.php
(to run hourly cron)

http://YourSite.com/dap/dap-emailorder.php
(to run the email order cron that runs every 10 minutes)

Replace YourSite.com with the actual domain name of your web site.

5. Disabling Cron Emails:

The cron job by default will send you an email every time it runs (feature of your web host, not that of DAP). If you wish to disable it, go to the Cron tab page and just remove your email address from that page (“Please enter an email address where the cron output will be sent”).