Thank you for using our WooCommerce Delivery Time Picker for Shipping plugin. In the following sections, we will show you how to set up, and then use the WooCommerce Delivery Time Picker for Shipping plugin in the easiest way possible.

Installation

After download, the .zip package, unzip it and you will see a folder woocommerce-delivery-time.

Go to Dashboard → Plugins → Add New and then click Upload Plugin.

WooCommerce Delivery Time Picker for Shipping – Admin Screenshot

Select the woocommerce-delivery-time.zip file and, then click Install Now.

Product Time Countdown for WooCommerce – Admin Screenshot

After uploading the Woocommerce Delivery Time Picker for Shipping plugin, then click Activate Now link to activate the plugin.

How to activate your license key

Our pro plugin come with a license key, a license which you will find in your accounts ProWC Plugins / Envato  plugins purchase history.

To activate the license key for your plugin, follow these steps:

1. The Purchase key field can be found in Dashboard → WDT Settings tab.

WooCommerce Delivery Time Picker for Shipping – WDT Settings

2. Keep your license key handy and filled the form.

• Purchase Source : Select your purchase source where you have purchase the plugin.
• Purchase Key: Insert the purchase key into the field.
• Email Address: Insert your email address.

Click Activate.

3. To make sure that your license key is properly activated, check Activate button text will be changed to Deactivate.

Important

When you first activated the WooCommerce Delivery Time Picker for Shipping plugin, there’s a notification asking for installing theMeta Boxplugin. It’s required to install Meta Box to access the plugin settings page. If you dismissed it, please go to Plugins 
→ Add New and then search for “meta box”, install and then activate it.

After that, you’ll see the plugin settings page Delivery Time in the main admin menu as shown below screenshot.

WooCommerce Delivery Time Picker for Shipping – Admin Settings

Upgrade

If you have an old version of the WooCommerce Delivery Time Picker for Shipping plugin, as well as please follow the steps below to update it to the latest version:

Configuration

All the WooCommerce Delivery Time Picker for Shipping plugin settings are available in the Delivery Time menu in the main admin menu.

As you can see there are five settings tab namely: General, Date, Time, Language, and as well as Appearance.
Below are descriptions of all the settings:

The first tab is General.

General

The below screenshot is for General settings.

WooCommerce Delivery Time Picker for Shipping – Admin Settings

Required

This option makes the delivery time a mandatory field. Hence, customers must enter the delivery time to make the order. It is a checkbox, and as well as it is unchecked by default.

Label

This is the text label that appeared above the input on the checkout page. By default, it is Delivery Time, but you can change it to anything.

On the checkout page, you can see the pointed label (Delivery Time) as shown below screenshot.

Front-end Checkout Page

Disable for shipping methods

This option allows you to disable the date, time picker for specific shipping methods. Note that, the field is still shown in the checkout page, but when people select a shipping method which is marked as disabled in this option, the input does not show date, time picker for them to select.

Maximum number of shipments per day

Some stores offer a limited number of shipments per day, due to their limited resources. Also, this option can help you to do this.
As well as, this option allows you to enter the maximum number of shipments per day that your store can support.

Notification for exceeded shipments

These options are the notification message that customers can see when the number of shipments for a specific day exceeds the limit set by the store.

The second tab is the Date.

Date

The below screenshot is for Date settings.

WooCommerce Delivery Time Picker for Shipping – Admin Settings

Date format

Format a date into a string value with a specified format. The format can be combinations of the following:

There are also a number of predefined standard date formats available:

Default : mm/dd/yy

On the checkout page, also you can see the delivery date picker is available as shown below screenshot.

Front-end Checkout Page

Holidays (Enter dates OR date ranges)

This is the most powerful weapon the plugin supports. With this feature, you’re able to provide shipping to customers in only some certain days or months.

In holidays (like Easter holidays, Black Friday, Christmas, etc…) obviously you are not able to provide delivery to the customers. So you can restrict the customers to choose out those dates by disabling them. You can say Restrict Dates as well.

In order to do above all, you need to do is enter your rules into the text box.

Simply, you have to follow this guide:

Examples:

1. Single date

I have input the date string: 10/*/2021. This date string would disable the whole October month in the date picker.
You can see the following output:

Front-end checkout page

2. Date range

The date range is just a combination of from date and to date. Additionally, each date in the range must be well-formatted as a single date.

I have input one date string : 10/12/2021 - 10/22/2020. This date string would disable dates from October 12th, 2021 to October 22th, 2021 in the date picker.

You can see the following output:

Front-end Checkout Page

In both examples, you can also disable more dates by clicking + Add more button, and as well as entering only one date string.

Move ahead in the Date tab you can see more options in below screenshot:

WooCommerce Delivery Time Picker for Shipping – Admin Settings

Do not deliver on

WooCommerce Delivery Time Picker for Shipping 
– Admin Settings

In this option, you can disable dates using day names. Just select which days you do not want to provide shipping from the checkbox list and save. It’s called Restrict by weekdays too. Here, we will check Saturday as well as Sunday.

You can see in the screenshot Saturday and Sunday are disabled. You can’t select Saturday, and as well as Sunday of any month of any year.

Do not delivery in the next (days)

You can disable date picker for some days, counting from today.
For e.g.

If you do not enter any value, the plugin will disable all past days excepting today.
Here, we would enter 4 into that text box and it will disable 5 days in the date picker. Because the index starts at 0.

In the screenshot marked 5 days are disabled. Today is 13th October 2021.

WooCommerce Delivery Time Picker for Shipping 
– Admin Settings

Count only working day

Count only working day in the “Do not delivery in the next (days)” above.
Do not count holidays and as well as restricted weekdays above.

Deliver only in the next (days)

Similar to the “Do not delivery in the next (days)” above, also you can enable date picker for only some days, counting from today.
For e.g.

WooCommerce Delivery Time Picker for Shipping
 – Admin Settings

If you do not enter any value, the plugin will enable all days.
Here, we would enter 4 into that textbox, and then it will enable 5 days in the date picker. Because the index starts at 0.

In the screenshot marked 5 days are enabled. Today is 7th April 2020.

The third tab is the Time.

Time

The below screenshot is for Time settings.

WooCommerce Delivery Time Picker for Shipping – Admin Settings

Show Time

This option is used to enable or disable the time option in the date picker on the checkout page.
Sometimes you do not want users to select the time for delivery, only dates.
Default: Unchecked

You can see the time option in the below screenshot by checking that checkbox.

WooCommerce Delivery Time Picker for Shipping – Admin Settings

Time format

Format a time into a string value with a specified format. The format can be combinations of the following:

Default : hh:mm TT

Here, you can limit the hours when customers can get their goods delivered. This is very convenient for the shop with high quality of delivery. Also, you can say Restrict by hours as well. Using the below options you can do that.

Minimum hour

Here, you can set a minimum hour by using this option. Just enter the hour. e.g. 11, 12.
We will enter 11 as a minimum hour. See the below screenshot.

A customer can’t get the delivery before 11:00 AM.

WooCommerce Delivery Time Picker for Shipping 
– Admin Settings

Maximum hour

You can set a maximum hour by using this option. Then just enter the hour. e.g. 18, 19.
We will enter 18 as a maximum hour. See the below screenshot.

A customer can’t get the delivery after 06:00 PM.

Note: Please enter the hour with the 24-hour format in both the case otherwise it will not work as expected.

WooCommerce Delivery Time Picker for Shipping 
– Admin Settings

The fourth tab is the Language.

Language

Below screenshot is for Language settings.

WooCommerce Delivery Time Picker for Shipping – Admin Settings 

The plugin supports most languages in the world. You just need to select them from the dropdown box on the WordPress Admin → Settings → General page. Change the Site Language you want to change.

With the selected language, all text in the date time picker will be translated, such as text for prev, next, today, weekdays, and as well as, etc.

Since version 2.1.4, If you see the text are not translated to your language you can also set custom text for all buttons, month names, and as well as, etc. Just in case the auto-translation is not as good as expected.

We have change site language from English to French.

Front-end Checkout Page

The fifth and as well as last tab is Appearance.

Appearance

The below screenshot is for Appearance settings.

WooCommerce Delivery Time Picker for Shipping – Admin Settings

Themes

You can choose any theme from 24 available themes. It’s helpful when you want the calendar matches to your website color.

For example We have selected the 2nd-row 2nd column theme. The output is below:

Front-end Checkout Page

Note: Don’t forget to click the Save Settings button to save your changes.

Shortcodes

Showing input for entering shipping time

By default the plugin shows the input for entering shipping time on the Checkout page, but you might want to display it on other pages as well.

To do that, you can use the short-code [wdt_field]. This short-code does not have any attributes. So, use the code follow to insert the short-code to your page template:

<?php echo do_shortcode( '[wdt_field]' ); ?>

Showing picked shipping time

To show picked shipping time of an order, then please use the shortcode [wdt_shipping_time id="ORDER_ID"]. This shortcode requires an order ID (please replace it with yours).

To show shipping time in your template, then please use the following code:

<?php echo do_shortcode( '[wdt_shipping_time id="ORDER_ID" format="DATE_FORMAT"]' ); ?>

The shortcode accepts 2 parameters:

Display time picker field in other places on the checkout page

If you are a developer, also you can do that by changing the hook used in the plugin:

add_action( 'woocommerce_before_order_notes', array( $this, 'show_field' ), 20 );

Display time picker field in other pages than checkout

To place the date picker field on another page, for example the cart page, you need to overwrite the WooCommerce template file in your theme. These are the basic steps:

<?php echo do_shortcode( '[wdt_field]' ); ?>

Then preview in the front end. You might want to move the line to an appropriate place.

To understand about the WooCommerce template, as well as please read this documentation

Email

By default, the shipping time is attached to the default WooCommerce email sent to admin. But if your theme is using a custom email template, then the new template might overwrite the WooCommerce template.

To fix that, please find the file woocommerce/emails/email-addresses.php in your theme, and as well as add the following code to the place where you want the shipping time to appear:

<?php if ( $delivery_time = get_post_meta( $order->id, '_delivery_time', true ) ) : ?>
    <?php
    $option = wdt_option();
    $label = $option['label'];
    ?>
    <h3><?php echo $label; ?></h3>
    <p class="text"><?php echo do_shortcode( "[wdt_shipping_time id='" . $order->id . "']" ); ?></p>
<?php endif; ?>