1. Home
  2. Docs
  3. Dokan Extensions
  4. Dokan Subscription

Dokan Subscription

This add-on allows you to create subscription packs for your vendors before they can start selling their products. Generally, vendors buy your subscription packs so that they can start selling their products and receive commissions.

You can define how many products they can sell with each subscription packs, how much it will cost, how long it will be valid, and how many times the billing will recycle. You can also create as many subscription packs as you want.

Buy a Subscription Pack

How it works

This document describes how a vendor can activate a desired pack and the admin role behind it.

  1. Admin goes through the settings
  2. Admin creates packages
  3. Vendor buys the package or Admin assigns the package
  4. Vendor is notified before package ends
  5. After subscription end, the products go into draft mode
  6. Why you should brush up products for non recurring packs

How to Create a Subscription Product

Subscription packs are stored as regular products although they will not show up on your website to your customers. To create a subscription, simply go to WordPress Dashboard → Products → Add Product.

Important: you will have to do this from the WordPress dashboard (wp-admin, backend) of your site.

In the Product Title and Body, give your subscription pack a name and a brief description.

When done, scroll down to the Product Data and select “Dokan Subscription” from the drop-down menu, as shown in the screenshot below.

In the Regular Price field, enter the price of the subscription pack you’re about to create. Then in Number of Products field, type in the number of products the vendor will be able to publish using this subscription.

Next you can select the validity of the subscription pack. By default, subscriptions will have a validity of 30 days. You can increase or decrease it by typing in a custom number of days you want this subscription pack to be valid for.

You can also add different vendor commission for different subscription pack. Just enter the value in percentage (%). From v1.2.0, you can specify allowed categories for each subscription. Click on the Allowed Category field and you will view available categories of your marketplace. If you want to include all categories, just leave the field empty.

There is also an option for Recurring Payment. You can enable this feature if you want automatic payment from your customers.

Menu Order for Subscription Packs

You can also specify menu order for your subscription packs in the vendor dashboard from your Dokan admin panel. You can edit menu order for each subscription and rearrange them according to your requirements.

This option  is in the Advanced tab of WooCommerce Product Creation page. You have to input the order number for each subscription to rearrange them.

Step 1: Enable Subscription by Admin

Navigate to- WordPress Dashboard → Dokan → Settings → Product Subscription

Check the Enable Product Subscription option. There are some other options for better management. You can check them as well.

Step 2: Vendors can now View and Buy Subscription

To see the available subscription packs and buy one, vendor must go to: Vendor Dashboard → Subscription.

Please note that the vendor may not buy a subscription pack along with any other product from the marketplace. Due to restrictions in payment gateway, the vendor must only purchase the subscription pack at a time, and do other shopping in a separate cart at a later time. See the FAQ section for more information. Also, you cannot buy a subscription by bank, cheque or cash on delivery methods.

Step 3: Activate the Package Bought by the Vendor – Admin

When a subscription pack is purchased, the admin has to activate it for the vendor . For activating admin have to go to wp-admin → WooCommerce → Orders and approve the purchase order of the vendro .

approve subscription

Alternative to Step 2 & 3: Assigning a Package Manually by Admin

An admin can even manually assign a package to a vendor . To do this admin must go to WordPress Dashboard → Users and pick the user. Then at the bottom of that page you will find something like this.

Select the desired subscription pack from the drop down menu and hit Update User. The user will get the pack activated instantly.
NB. Only non-recurring packs can be added this way.

Now the Vendor gets a Confirmation

To check validity, limit of a package vendor can simply go to Dashboard → Subscription, something like this will appear.

Before they can purchase a subscription pack, you need to create one (or more). So let’s checkout how to create a subscription pack.

Subscription packs are extremely customizable. You can choose how many products a vendor can publish under a subscription, how long until the subscription expires, whether or not the subscription will be recurring, and if yes, for how many billing cycles the subscription will recur.

Advanced Section

Enabling Recurring Subscription Payment and Billing Cycle

Alternatively, you can also choose this to be a recurring subscription. To do so, simply click the checkbox titled “Recurring Payment.”

Clicking on the Recurring Payment checkbox will reveal three new fields.

First two will let you set the billing cycle for this subscription. In simpler words, this is “How long the subscription will be valid for before it is automatically renewed.” For example, if you set 3 months, it will mean the subscription will be valid for three months and then it will be automatically renewed.

Billing Cycle Stop

Billing Cycle Stop is whether you want the subscription to be continuously running or end after a certain number of cycles. By default it is set to Never, meaning the billing cycle will be recurring until the vendor stops. However, since the subscription packs are highly customizable, you can choose to stop the recurring billing after a while.

In the example above, you can see we have set billing cycle for 1 month, which means the customer will be charged for 1 month, and the cycle will keep recurring 12 times. So this subscription pack will charge per month and will run for 12 months.

However, you can also set it like the following:

There you see billing cycle has been set to 1 year, and billing cycle is set to stop after 1 time. That means the subscription pack will be valid for 1 year.

You can customize the subscription pack to your liking. As you can see the subscriptions are highly customizable.

Translation Text Domain

You have to rename the .mo file according to this format for translating: pluginname-languagecode_countrycode.mo
for this extension, just rename the .mo and .po file to the following –
dps-languagecode_countrycode.po/mo
For example, in case of French Language, the code will be- dps-languagecode-fr_FR.mo

FAQ

Here are some answers to the most frequently asked questions about Dokan Subscription add-on.

Q. Subscription pack disappears from the cart when purchasing.
A. Subscription pack needs to be purchased alone. The vendor may not purchase a subscription pack and another product from your shop at the same time. In short, if you’re a vendor, you need to buy a subscription pack, proceed to checkout with the cart, finish the transaction and then buy any other product you want to purchase.
Q. Unable to add new products.

A. vendors need to purchase a subscription before they can add any new product to the marketplace. If your site is in development, you will need to disable Dokan Subscription settings from the settings. See an overview of Dokan Subscription settings here.

Q. Vendors can add products without purchasing a subscription pack.

A. Make sure to enable Dokan Subscription pack from wp-admin → Dokan → Settings → Product Subscription → Enable Product Subscription.

Q. Will deleting a published product count against my quota?

A. No. If your subscription pack allows you to publish 10 products, you can only publish 10 products. If you delete one or more products after publishing them, your quota will not be back. Even if you have 1 remaining product, and you delete an existing product, you will still have 1 remaining product. Deleting your published products will not increase your number of available quota.

Q. Where can I see the remaining number of products I can add?

A. The remaining number of products you can add will show up on your vendor dashboard.

Q. What will happen to a vendor’s published products when their subscription expires?

A. You can choose what happens to the published products after the vendor’s subscription expires from the settings. Go to WordPress dashboad -> Dokan -> Settings -> Product Subscription -> Product Status and choose the status from the drop-down menu.

Q. When does the vendor get to start adding products after buying a subscription pack?

A. As soon as the checkout is completed via PayPal, the vendro will be automatically enabled to add products according to the pack to which they subscribed. If they choose bank transfer or other method, you can manually go to your WooCommerce Orders and complete their subscription purchase. However, this will not work for recurring subscription pack purchases.

Was this article helpful to you?

How can we help?