# About Dirhand Shopify Apps

Best solution for optimizing and growing your business

## About Dirhand

Shopify stands as a remarkable platform, offering immense value and possibilities to explore. Our ambition at Dirhand is to elevate into a distinguished premium app service provider, committed to ensuring Shopify users fully appreciate the value we bring to their endeavors.

Founded in 2018, Dirhand has embarked on a journey with the overarching objective of acting as a catalyst for customer success. We strive to achieve this by consistently developing and delivering top-tier, high-quality apps that not only meet but exceed the evolving needs and expectations of our users. Our dedication to excellence fuels our commitment to making the Shopify experience not just efficient but truly exceptional.

As we continue to evolve and innovate, our vision remains unwavering - to be a reliable partner in your journey towards success on the Shopify platform. Join us in this pursuit, and let Dirhand be the driving force behind the growth and prosperity of your online business.

{% hint style="success" %}
Here you can find us 

<https://apps.shopify.com/partners/dirhand>
{% endhint %}

{% hint style="info" %}
Contact us via **<hi@dirhand.com.au>** for any questions. 😄
{% endhint %}

## Apps for Shopify

<table data-card-size="large" data-view="cards" data-full-width="false"><thead><tr><th></th><th></th><th data-hidden data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>DH: Estimated Delivery Date</strong></td><td>Show estimated delivery date, delivery time and create urgency with countdown timer.</td><td></td><td><a href="/pages/Jof5AKAbi6Y3u9F2fOu7">/pages/Jof5AKAbi6Y3u9F2fOu7</a></td><td><a href="/files/Gz9vHpmuL6KDpT8wBlJT">/files/Gz9vHpmuL6KDpT8wBlJT</a></td></tr></tbody></table>


# General settings

This page describe general settings for EDD App.

<figure><img src="/files/TOBrONUN6tIAQZk17cvz" alt=""><figcaption></figcaption></figure>

### Enabling DH: Estimated Delivery Date&#x20;

Estimated Delivery Date (EDD) is enabled by default after you install it. Although the app is enabled, it will not impact the store unless a widget is set up in the storefront.

### **Dispatching date**

The date of the customer's order is processed, packaged, and handed over to the courier ready for dispatch. It is also called Shipping date (the date of handover to the start point of shipping).

> Factors affecting the calculation:&#x20;
>
> 1. *Dispatching Working days*
>
> Which days within a week does the business operate and accept orders for processing?&#x20;
>
> 2. *Processing days*
>
> How long does it take from the moment a customer's order is received to when it is fully processed and ready to be handed over to the courier for delivery?&#x20;
>
> 3. *Cutoff time*
>
> What is the deadline time after which customer orders are no longer processed on the same day and are instead deferred to the next working day?&#x20;
>
> 4. *Time zone*
>
> What is the time zone of your warehouse?

### **Delivery date**

The date on which your customer can expect to receive their order. If you have specific rules for the buyers' region or certain products have special logistics rules, the app fully supports customisation, which can be viewed separately in [Customise Delivery Areas](/dh-estimated-devilry-date/delivery-areas) and [Customise Products](/dh-estimated-devilry-date/products).

> Factors affecting the calculation:
>
> 1. *Delivering working days*
>
> Which days in a week when shipping is possible?&#x20;
>
> 2. *Min delivery days*
>
> What is the minimum number of days it takes for an order to be shipped and delivered in general?
>
> 3. *Max delivery days*
>
> What is the maximum number of days it takes for an order to be shipped and delivered in general?


# Widgets

This page describe Widget part for EDD App.

Widgets are essential when you need to display estimated delivery dates in your store.

<figure><img src="/files/yXnGanIqTagQILq1eCQZ" alt=""><figcaption></figcaption></figure>

### Widget Type

There are three types of widgets in EDD, each containing distinct content:

* Text base: The EDD message in this type is displayed solely in text form.
* Visual: This type enhances the Text Base by incorporating visual styles for three distinct order steps.
* Multiple options: This type allows you to customize the names and shipping fees for different delivery methods based on your preferences.&#x20;

{% hint style="info" %}
Please note that an active subscription is required to enable Multiple options type. For more information, see Plan.
{% endhint %}

### Widget Preview

<figure><img src="/files/7YQoccFlJi0OJCxpf1mV" alt=""><figcaption></figcaption></figure>

### Content

When different widget types are selected, the content in the content area changes accordingly. This gives merchants great flexibility to customise and display the information you want. See more in type details pages.

You have complete control over the widget content. Every aspect can be customised to suit your preferences. The content can be edited separately for each language, making it ideal for multilingual stores.

To include dynamic content, such as the estimated delivery date, use placeholders like `{edd_date}`. These placeholders can be easily inserted into the widget's content fields. A comprehensive list of available placeholders is provided below each field.

### Widget integration in Theme Editor

{% hint style="warning" %}
If your store uses Shopify Theme 2.0, you need to add the widget block to the desired location to display the widget correctly (usually near the buy button on the product page). Please note that since the app supports multiple languages, ensure that the store's language matches the app's language settings; otherwise, the widget will not be displayed.
{% endhint %}

You can integrate widgets by adding a DH-EDD block.

Please follow the below steps:

1. From the Shopify menu, navigate to `Sales channels` > `Online Store` > `Themes`
2. Find the current theme you want to edit and click on `Customize`
3. Locate the section you want to add the widget and click `Add block` > `Apps` >`DH-EDD`
4. Click on the `save` button before leaving the screen.

<figure><img src="/files/l0wLB1p5ojzQfatVo3TC" alt=""><figcaption></figcaption></figure>

If this method does not work in your store, you can try other approaches as well. Refer [Widget placement method](/dh-estimated-devilry-date/widgets/widget-placement-method) for more information.


# Type 1 - Text Base

<figure><img src="/files/w3A8FHMe3OsGFnbDGTrO" alt=""><figcaption></figcaption></figure>

The EDD message in this type is displayed solely in text form.

To present customized content, you can freely modify and add text, placeholders, and emojis.&#x20;

For instance, you can select `{edd_max_date}` from the list to insert it in the content or alter the emojis.&#x20;

<figure><img src="/files/WwSDk40LgzXu5OcW5mxq" alt="" width="563"><figcaption></figcaption></figure>

The list of placeholders and emojis can be easily found below the text box.


# Type 2 - Visual

<figure><img src="/files/HKiGSgUVlaWOzHA0s0qL" alt=""><figcaption></figcaption></figure>

This type enhances the Text Base by incorporating visual styles for three distinct order steps.

There are two visual timer styles available:

* *Classic*
* *Advanced:*  In addition to the classic features, you can add a status description for each step according to your preferences.

By default, the three order steps are: Ordered, Order ready, and Delivered. You can modify the titles, display dates, and Icons for each of the three steps.

<figure><img src="/files/lSTHBCbXs1zuf33pnaqM" alt="" width="563"><figcaption></figcaption></figure>

For example, in the first step, you can change the title *"Ordered"* to *"Purchased"*, or change the placeholders from `{shipping_date}` to `{date_of_today}`.


# Type 3 - Multiple options

{% hint style="info" %}
Please note that an active subscription is required to enable Multiple options type. For more information, see Plan.
{% endhint %}

<figure><img src="/files/nqNo4eE0V8qqLzc4zViO" alt=""><figcaption></figcaption></figure>

This type allows you to create multiple shipping options, such as postal service, courier, and next-day delivery.

<figure><img src="/files/BUD2MBmJx4fEcKQfz2bz" alt=""><figcaption></figcaption></figure>

You need to customise the estimated arrival time for each shipping option and set different fees. These fees are for display purposes only; all shipping costs will be based on the settings in your Shopify store.

<figure><img src="/files/srVUY86NpZbQ9tKsiNPG" alt=""><figcaption></figcaption></figure>


# Show EDD in different pages

You can config which page you need to show EDD info. By default, `Product` page will always show EDD widget. You can optionally choose `Cart` , `Checkout` and `Thank you` page to show such info.&#x20;

Themes that support Shopify Online Store 2.0 can embed app easily by clicking a button in our app, adding `DH-EDD` block. Alternatively, you can also integrate block by adding code manually or choose `Auto` method.

<figure><img src="/files/wswe05pUtvhIavhx64oA" alt=""><figcaption></figcaption></figure>

### Cart/Checkout Page

<figure><img src="/files/QwCadNAP9etrd1FmvvhC" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ImGYR8IxWvEvh6E4Aah3" alt=""><figcaption></figcaption></figure>

### Thank you Page

<figure><img src="/files/pI1FAqaSmWzxkD9vMg4D" alt=""><figcaption></figcaption></figure>

### Order Confirmation Email

TBA


# Widget Appearance

You can customize the appearance of widgets based on your preferences.

Key features include:

1. **Basic Configuration appearance**

Customize the pixel distance of the widget's outer border from the top, bottom, left, and right edges.

2. **Message Text Appearance**

* *Border*:  customize the pixel distance of the EDD information border from the edges, the roundness of the corners, and the style of the border lines.
* *Color*:  customize the text, background, and border colors of the EDD message.
* *Other:*  customize the inner and outer padding.

3. **Progress Bar Appearance**

* *Color*:  customize the icon, text, and date colors for each of the three different order steps.
* *Font*:  customize the icon, text, and date sizes for each of the three different order steps.
* *Other:*  customize the distance of the order status bar's outer border.

4. **Modal Popup Country**

#### Notice:

You can preview your widget after customizing. Navigate to the `product page`on the right side and click on the `View in Store` button.&#x20;


# Widget placement method

<figure><img src="/files/SScj9aGkMDBNEjSXyLWT" alt=""><figcaption></figcaption></figure>

There are three methods to add DH-EDD to your theme.

### Recommend: Theme 2.0

For your customers to see the widget we need you to add DH-EDD as an app embed on your Shopify theme 2.0 settings.

1. Click the button `Enable App Embed` to be taken to Shopify.
2. Click the DH-EDD io toggle to enable it.
3. Click "Save" at the top right to add the app to your store.

<figure><img src="/files/l0wLB1p5ojzQfatVo3TC" alt=""><figcaption></figcaption></figure>

### Auto - Compatible with vintage themes

This works for some old or vintage themes. DH-EDD will decide where to embed the code.

### Manual - Add the code below to your theme

In this way, you need to manually add code to Liquid templates.&#x20;

```html
<div class="edd-app__manual"></div>
```


# Delivery areas

Configure delivery times based on customer location.

A delivery area is a set of countries that have similar shipping times and delivery schedules.

<figure><img src="/files/KgnixuQGau89TNwSir5O" alt=""><figcaption></figcaption></figure>

DH-EDD matches visitors to delivery areas by using IP geolocation to identify their location, including country and region.&#x20;

If no matching delivery area is identified, the default transit time and delivery days from your general settings are applied.

{% hint style="info" %}
Please note that an active subscription is required to enable Delivery areas. For more information, see Plan.
{% endhint %}

### Add Delivery Areas

You can select and add delivery areas from the country list, and customize the transit times for specific areas.

<figure><img src="/files/wW99w08mxRufPRYF4Bwh" alt="" width="563"><figcaption></figcaption></figure>

Please follow these steps:

1. Click the `Add Area` button.
2. Select the countries you want to add from the list, check the box, and then click `Next`.
3. Customize the minimum and maximum delivery days for the country you chose.
4. Click `Save`.

&#x20;


# Products

CollectionsConfigure delivery times for individual products.

<figure><img src="/files/KdOJSnGwyVEc54zj2uyA" alt=""><figcaption></figcaption></figure>

If you have products with unique transit time requirements or wish to customize the display of delivery messages for specific products, utilize the product settings.

Regarding shipping and delivery delays, you can set delays for individual products similar to those configured in the general settings. Delays specified at the product level will be cumulative with those set in the general settings.

{% hint style="warning" %}
If you have set both a default time and customised times for the delivery area and specific products, the time set for the product will be used as the final effective time for calculating the delivery date.&#x20;

In other words, the product's settings take priority over the delivery area and the default values.
{% endhint %}

### Customize product visibility

You can customize the visibility of any product in your store.

Please follow these steps:

1. Navigate to `All product`
2. Locate the product you wish to edit
3. Click the `Edit` button > `Visible` > `Hidden`

### Customize product transit time

You can customize the delivery time for specific products.

<figure><img src="/files/90cJRFi60zVgpgkGJZh7" alt="" width="563"><figcaption></figcaption></figure>

Key settings include:

1. **Max Delivery Days**: The *latest* delivery time you want for this product.
2. **Min Delivery Days**: The *earliest* delivery time you want for this product.

#### Notice:

After editing, you can click the eye icon to preview how the product will appear in your store.

### Customize by Collections

Apply these settings for items with specific transit time requirements or to control the display of the message for certain collections.

{% hint style="info" %}
Please note that an active subscription is required to enable Customize by Collections. For more information, see Plan.
{% endhint %}

&#x20;


# Holidays

Establish holidays and monitor upcoming public holidays.

With DH-EDD, you can add your own holidays for dispatch and delivery date calculations, even if they coincide with public holidays.

Key features of custom holidays include:

1. Specify whether shipping providers can pick up deliveries on certain days.
2. Adjust the latest pickup time for deliveries on specific days.
3. Choose whether deliveries can be made to your customer's address on certain days.

**Public Holidays**: Public holidays, typically non-working days, are considered for delivery date calculations, but not for shipping date calculations.

We ensure the calculated delivery date avoids public holidays by considering relevant ones in the customer's country and region.

DH-EDD provides updated public holiday data for 250 countries and regions, ensuring delivery dates don't coincide with public holidays.

{% hint style="info" %}
Please note that an active subscription is required to enable Public holidays (Auto). For more information, see Plan.
{% endhint %}


# Multi-languages

<figure><img src="/files/trV33UUOUGMtwrDhI2wn" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/h6alAl5whyUP5wrjWpx3" alt=""><figcaption></figcaption></figure>

### How to add more languages

<figure><img src="/files/2E9Fxw5xjqsJoZO9dUp5" alt=""><figcaption></figcaption></figure>

By default, when you install the App, it will identify the default language you choose for your store. If you need to add more languages, you can click "Manage" and select the languages you need. By default, when you add a new language, some preset content will appear in the content area, which you can modify according to your needs.

{% hint style="warning" %}
The widget will only display the content in the specific language correctly if the language selected by the storefront buyer matches the one set in the app.
{% endhint %}

<figure><img src="/files/voX9bn7iz5Mpi2sagXrE" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please note that an active subscription is required to enable Multi-languages. For more information, see Plan.
{% endhint %}

If you need other languages that are not listed here, please [contact](https://www.dirhand.com.au/contact) us.


# Extra topics


# How date estimation works

### In the warehouse

When customers set orders, the store manager will process the order in the warehouse. We will consider

* Current date and time
* Working days (Weekends and Holidays)
* Process time
* Cutoff time
* Products or Collections

### Outside of warehouse

After the order is handed over to a shipping service provider, such as DHL, Australia Post, we will consider

* Shipping date (working days)
* Transit time
* Custom holidays
* Public holidays (Auto)
* Delivery area
* Products or Collections


# Time format

<figure><img src="/files/nSBBavOv9NH0K5Mkpawc" alt=""><figcaption></figcaption></figure>

You can also choose the date and countdown format you want.&#x20;

You just need to simply click on the expand arrow and select your favorite format from the data format list and countdown format list respectively.

<figure><img src="/files/VunPxzAgCAmnwIcrVnJ6" alt=""><figcaption></figcaption></figure>


# How to set 'Order Confirmation Email'?

To be added.


# Uninstall DH-EDD

You can easily uninstall EDD-Max via `Shopify Settings` by locate `DH: Estimated Delivery Date` and then click `Remove`.

When you uninstall this app, any active subscriptions will be automatically cancelled, and Shopify will refund the unused portion.

We keep our app code clean so please don't worry about unused code after uninstallation.

{% hint style="info" %}
If you uninstall and then reinstall, the app will install in a completely new state (i.e., it will not cache any historical data).
{% endhint %}


# FAQs


# What is the purpose of the Custom CSS in the Delivery Date tab?

Custom CSS is used for adding some custom fields or themes for the date & time picker display at your storefront, apart from the certain changes supported by us.


# Changelog

### 1.2

Bug fixing

### 1.1

Bug fixing

### 1.0

Set up new app

* Add core features