Doctreat - Doctors Directory WordPress Theme

Contents

1. ​​WP Guppy - A live chat plugin compatible with Doctreat

2. How to extend/change ​Elementor shortcodes

3. How to setup trail package

4. How to setup offline payments

5. Google Map API KEY

6. How to import users in bulk in Doctreat Theme

7. How to change currency and formatting

8. How to enable real-time chat

9. How to Update Theme, When New Update release

10. How to install theme and import demo contents

11. Read more about doctreat theme here

12. How to setup page templates in Doctreat

13. Booking Settings

14. What are spaces in appointments - Doctreat

15. How to use elementor page builder in doctreat theme

16. How to translate or rename strings in theme and plugins

17. Why email took time to arrive or not working

18. How doctor send request to hospital/clinic

19. How to setup CRON job and What is the purpose of CRON job

20. Why email took time to arrive or not working​

21. How to change the slug from back-end

22. How to create registration page in doctreat

23. How to translate Calendar in Doctreat Theme

24. How to create/import users from admin

25. How to change default avatar for doctors, hospitals and patients

26. How to make the system paid/free for doctors

27. How to make Hospital base locations or custom locations

28. Why some WooCommerce payment gateway doesn't complete the booking or hiring process

29. How to create a messenger page with WP Guppy

30. ​How to Update Theme, When New Update release

31. How to translate WP Guppy

32. Mobile APP API Plugin

33. Why email took time to arrive or not working

34. ModSecurity and Theme Settings saving trigger 403 Errors

35. Import demo pages separately

36. Start chatting with a specific user on the messenger page

37. How to enable real time chat experience with WP Guppy

38. WordPress 5.8 widgets area issue

39. How to change currency and formatting

40. Server requirements

1. ​​WP Guppy - A live chat plugin compatible with Doctreat

WP Guppy - A live chat plugin compatible with Doctreat

Doctreat theme is compatible with WP Guppy - A live chat plugin compatible with Doctreat. Please make sure if you are using minimum theme version 1.4.9 because we added compatibility with doctreat theme version 1.4.9 and above

You must buy this plugin and install this. After the installations go to

https://codecanyon.net/item/wpguppy-a-live-chat-plugin-for-wordpress/34619534?s_rank=1

Theme Settings > Directory Settings

Admin can select user's roles to show the users on the front-end. Like You can show only doctors to the patients or patients to show doctors


Admin can also hide users listing tab from the Settings page

If still, you see any issue, please create a support ticket and we will be happy to assist you

2. How to extend/change ​Elementor shortcodes

Extend Elementor shortcode

Create folder extend/elementor/shortcodes in child theme and copy the shortcode file from doctreat_core/elementor/shortcodes to this folder.

For example you want to change anything in search form on home page. Just copy 

dc-search-form.php and paste into themes > doctreat-child > extend > elementor > shortcodes >



3. How to setup trail package

How to setup trail packages

Admin can setup a trial package for new users. This trial package will be assigned to new registered users on the site. 

This package will be assigned automatically. Also users  will not see any trial package in their dashboard. 

To create trial package go to Packages/Products > Select trial for doctor.


4. How to setup offline payments

Setup offline payments

Admin can setup the offline payment for booking or packages.

Go to admin > Theme settings > payment settings

Now, Select the offline payment types.

Note : Offline payment support WooCommerce default payment gateways cod,cheque and bacs.

How to update packages in offline payment

After place offline payment admin is able to complete the order.

After complete the order doctors package is automatically update. 


How to update booking in offline payment

By using offline payment, Doctor is able to accept/reject the booking.Payment on arrival.

5. Google Map API KEY

Very Important

Please note: There can be a Google Maps API key in demo content. We suggest you change the Google Maps API key before using our plugin and google maps. 

Also please note, you must enable the billing for your Google project and then you must enable the below API in your project to work the google maps with our theme

https://developers.google.com/maps/billing/gmp-billing?hl=en

https://developers.google.com/maps/documentation/javascript/get-api-key

Please enable the following API for google Map

1. Maps JavaScript API 2. Geolocation API 3. Places API 4. Geocoding API

API key go to Theme Settings > API Settings > Google Map Key


6. How to import users in bulk in Doctreat Theme

How to import users in bulk in Doctreat Theme


Importing for bulk users (doctors, hospitals and regular users) need to create a excel file with the following formats :

7. How to change currency and formatting

How to change currency

Admin can change the currency from WooCommerce settings page


8. How to enable real-time chat

*****************************************************************************************************************

How to enable real-time chat

Please note real-time chat will only work if your server does support node.js and you are allowed to run forever commands to run server file. Mostly VPS and Dedicated servers allow you to run node server files.

*****************************************************************************************************************

Admin can enable real-time chat from the Theme Settings

First make sure that you have installed node and npm installed on your server. 

Either its shared hosting or dedicated hosting, and also make sure from your hosting provider that the port is enabled on which you have sending requests.

On shared hosting contact to your hosting provider and ask them to install node and npm, so you can easily run server.js file by writing this command node server.js from the terminal.

In case of dedicated server you have full access to install node and npm.

After verifying Please ask your hosting provider to run server.js file through SSH commands

Themes > doctreat > js > server.js


If you have not used any SSL certificate for your domain then without any problems you can run node chat server file. Just follow the below instructions.

Please ask your hosting provider how we can setup node server file

Then from Theme Settings you can enable either Inbox or real-time chat

Just add your host and open port in Theme Settings. Please note if you have used port other than 81 then please update port in server.js as well.

In simple inbox system, users will get messages on page refresh while in real-time chat system users will get instant messages without refreshing the page. 

If you have used SSL certificate for you domain, then make sure that you have access to your certificate files on your cpanel.

Normally SSL certificate files could be found below path on cpanel.

To make sure that which keys and cert file have used for SSL certificate, you can find that information on Cpanel SSL/TLS

After that click on Manage SSL

After clinking on Managed SSL Sites.

Copy the name of certificate file and then go to SSL folder path. ( ssl/certs )

Download the file on you PC and then go to ssl/keys folder to download the key file.

After that go to you theme directory and create the below folder path in your theme root location.

/doctreat/chat_ssl/

Rename the both files so you can remember them easily.

And upload your downloaded key and cert file to this folder.

Now open doctreat/js/server-ssl.js file


Now run the node server file from terminal like this node server-ssl.js

And check the chat it will work now on https secure protocol.

Note: Only Authorized certificates install on your domain will be recognize for your chat node server and no self-signed certificate will work on production server.

Extra Notes:

This below process is same for both situations either with SSL or without SSL.

Node JS Chat server only available or worked if terminal open, If you have mistakenly closed the terminal or logged out your session then the node chat server will be stop.

To run the node js chat app in background process install the npm process manager which is forever.

Run the below commands from your terminal.

npm install forever -g

It will install forever package globally, Note: If you have not installed forever globally then it will not work.

To start the node chat server run the following command.

forever start server-ssl.js

Do not bother the warnings it will run your application in background now.

To check which node processes are running on background enter the following command.

forever list 

(It will list down the all running processes for node js)

And to stop the node chat server enter the below command.

forever stop server-ssl.js

For your eyes only


9. How to Update Theme, When New Update release

How to Update Theme, When New Update release

Please download the latest version of the theme package from themeforest.net

Please go to your download section at themeforest and then download theme files :

And then you need to make sure that:

-- You have taken a complete backup of your theme and plugin(doctreat_core) files. This is important because just in case you have made any mistakes or had made any changes in the theme or plugin, you can recover those from your backup.

-- Once the backup has been taken, you can either delete the theme and plugin and upload a newer one or replace files by using FileZilla or another file transfer protocol.

Please note: Don't import users or demo content. It will override and delete your database contents. You just need to replace/delete files.

Please backup you files and database before update

Thanks!

10. How to install theme and import demo contents

How to install theme and import demo contents

-- Install Theme and required plugins
-- Please note php zip extension should be installed at your server
-- Install required unyson plugin Extensions
-- Then go to Tools > Demo Content Install

Before installation's please make sure of your server meets the minimum server requirements 

https://amentotech.ticksy.com/article/14849/


Please uninstall the Unyson plugin after the demo import because this is only being used for the demo content install

11. Read more about doctreat theme here

You can read more about our theme here : https://amentotech.ticksy.com/articles/100016137


Or check video Guide on YouTube 

12. How to setup page templates in Doctreat

How to setup page templates in Doctreat

For the search page, dashboard and health forum you have to create pages and then assign templates to them

And then go to Theme Settings > Search Doctors Settings > Search result page

and select created page here.

For Dashboard

Theme Settings > Directory  Settings >  Select dashboard page

13. Booking Settings

Booking Settings

 Product/Packages section and create a booking product for payments.

Please make sure you have checked the Booking. Then set price to 1 or what you want, this price will be override by the booking price while booking process.




14. What are spaces in appointments - Doctreat

What are spaces in appointments - Doctreat

Spaces mean that how many patients a doctor will check in the time slot. Like if the doctor has a time slot from 9:00 AM to 10:00 AM and spaces are 3 then the doctor will check 3 patients in 1 hour(9:00 AM to 10:00 AM).

15. How to use elementor page builder in doctreat theme

How to use elementor page builder in doctreat theme

Please check below video


16. How to translate or rename strings in theme and plugins

How to translate theme

You can use Loco translate plugin to translate theme to any language or to update/change any text in the theme and plugin.


-- Install loco translate plugin

-- Please note : For translations your WordPress should have selected same language as language created in Loco translation.

-- Please make sure you have sync the pot templates for both theme (doctreat)and plugin (doctreat_core)

-- Then create and sync the  language  templates before add your translations.

-- Go to admin > loco translate > New Language :

-- Select the new language and choose location Other folder options :

-- Please note, Due to the plugin territory  some of our theme functionality can be found in the plugin. So you need to translate the both theme and plugin(doctreat_core).

Now you can find your each string in .po template

-- Please avoid to search long strings. Long string may be in parts so start typing word by word. For example don't search "Find your NEAREST" but search by typing "Find"

-- Select string from source text and translate it on below textarea.

One thing which is more important : Please check loco translate settings. Extracting Strings should have minimum size : 1000k


17. Why email took time to arrive or not working

Why email is not working

Please make sure if emails are not in spams or junks folders.

Why email took time to arrive

Email delay(arrival to the inbox) could be due to any reason. First of all, this could be your email content. Some email providers like Gmail take time to read content and decide to either put it to spam or in the inbox.

So your content should be strong and don't write such kind of content which could be suspicious.

This is not related to the theme because when any event trigger then it send an email because PHP functions run.

For testing purposes, you can install this plugin https://wordpress.org/plugins/email-log/

When your click it will trigger an email and you can see the email log it on the back-end.

18. How doctor send request to hospital/clinic

Send request to hospital/clinic

Go to Doctor dashboard menu > Appointment Setting :

Search from available hospitals or location and fill the form :

And send request to hospitals.

After accept the request hospital is available for bookings list.

19. How to setup CRON job and What is the purpose of CRON job

How to setup CRON job and What is the purpose of CRON job

First of all you need to install the Doctreat CRON plugin and then you need to set cron job interval to run the cron job as "once a monthly, once a weekly or once a day" in admin > Theme Settings > Payment Settings

Note : After change of cron job interval we need to deactivate and then active the Doctreat Cron Plugin (for save intervals in wp cron job)

After that we need to set cron job from cPanel for  wp-cron.php file located in WordPress root.

Go to the cPanel and then click on Cron Jobs

Then Setup a Cron Job according to your needs. 

Command will look something like that

wget -q -O - http://yoursite.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1

Why CRON JOB Is Required?

CRON Job is being used in doctreat for two purposes.

1) Generate Payouts for the doctors. 

2) Remove featured doctors listing if their package get expired


20. Why email took time to arrive or not working​

Why email are not working

There are couple of issues could be for email which are not being sent. Please make sure if you have added From Email in Theme Settings > Email Settings > From Email Settings 


This should be your server email address or you can try with your personal email address as well.

Or please make sure if emails are not in spams or junks folders.

Why email took time to arrive

Email delay(arrival to the inbox) could be due to many reason. First of all this could be your email content. Some email providers like gmail take time to read content and decide either put it to spam or in inbox.

So your content should be strong, and don't write such kind of content which could be a suspicious.

Secondly This could be due to your server and from email. We have from email settings on the back-end. It could be your domain email or your personal email.

You can try with gmail, it would come arrive early than your domain host email address etc.

This not related to theme because when any event trigger then it send email because php functions runs.

For testing purpose you can install this plugin https://wordpress.org/plugins/email-log/

When your click it will trigger an email and you can see on the back-end.

21. How to change the slug from back-end

How to change the slug from back-end

You can change the slug from the Settings page for any custom post type 

Like

https://abc.com/doctor/javied123

Change ‘doctor’ = myslug,

A new URL will be 

https://abc.com/myslug/javied123

22. How to create registration page in doctreat

To create a registration page you can do that with elementor


23. How to translate Calendar in Doctreat Theme

How to translate Calendar in Doctreat Theme

To change language you can add language two digit code in Theme Settings > Directory Settings


24. How to create/import users from admin

Create doctor or hospital  from admin: 

To create users (doctors,hospitals) from admin go to admin > Users > add user :

And Select the role type doctor or hospital.

To Import Users from csv,excel file

Go to Docteat Import user and then upload csv,excel file.

You can download sample file.click to download file

25. How to change default avatar for doctors, hospitals and patients

How to change default avatar for doctors, hospitals and patients

Images can be change from Theme Settings > Directory Settings > Images Settings 


26. How to make the system paid/free for doctors

How to make the system paid/free for doctors

To make system free for the doctors, admin can make it free from Theme Settings > Directory Settings.


If you want to make hiring as offline and want to remove checkout process the  you can do that from Theme Settings > Payment Settings 

 

27. How to make Hospital base locations or custom locations

How to make Hospital base locations or custom locations

Admin can set either doctors should be select hospitals from available hospitals in the system or add custom locations or both 

Just go to Theme Settings > Directory Settings > Doctors locations?

 



28. Why some WooCommerce payment gateway doesn't complete the booking or hiring process

We have used WooCommerce for the packages and booking process and have used the below hooks

Any gateways that default status goes to On Hold or Pending Payment instead of Processing will not process the order against packages update or booking.

As this is not a delivery order which needs to be processing, this should be complete the order straightforward because online bookings

In your payment gateway, this doesn't call the WooCommerce hook which we have used once the order gets completed

29. How to create a messenger page with WP Guppy

How to create a messenger page with WP Guppy

Admin can create a message page with WP Guppy plugin. We have Elementor & WP Bakery Page builder compatibility as well as the shortcode options to create the messenger page

30. ​How to Update Theme, When New Update release

How to Update Theme, When New Update release

Please download latest version of theme package from themeforest.net

Please go to your download section at themeforest and then download theme files :

And then you need to make sure that:

-- You have taken a complete backup of your theme and plugin(tuturn) files. This is important because just in case you have made any mistakes or had made any changes in the theme or plugin, you can recover those from your backup.

-- Once the backup has been taken, you can either delete the theme and plugin and upload a newer one or replace files by using FileZilla or another file transfer protocol.

Please note: Don't import users or demo content. It will override and delete your database contents. You just need to replace/delete files.

Thanks!

31. How to translate WP Guppy

How to translate WP Guppy

You can change any string from the WP Guppy > Translation or you can also use the loco translate plugin to find the strings and replace them with your own strings

https://www.youtube.com/watch?v=4BOMzVC3aqU





32. Mobile APP API Plugin

If you are using React native mobile APP then you must install this plugin Doctreat API Plugin

You can download the plugin from here https://amentotech.com/autoupdate/doctreat/doctreat_api.zip

33. Why email took time to arrive or not working

Why email took time to arrive or not working

1) Why email are not working

Please make sure if emails are not in spams or junks folders.

2) Why email took time to arrive

Email delay(arrival to the inbox) could be due to many reason. First of all this could be your email content. Some email providers like gmail take time to read content and decide either put it to spam or in inbox.

So your content should be strong, and don't write such kind of content which could be a suspicious.

This not related to application because when any event trigger then it send email because php functions runs.

You might check other SMTP host other than gmail, like sendgrid which give the 100% accuracy to target the inbox and send emails timely

https://sendgrid.com/docs/for-developers/sending-email/laravel/

34. ModSecurity and Theme Settings saving trigger 403 Errors

ModSecurity and Theme Settings saving trigger 403 Errors

If while saving the Theme Settings, your server is throwing the 403 error then this means that your server is blocking the request.

So you must consult with your hosting provider by telling them that this issue appears while saving some data. 

They will be able to fix that issue, this issue could be maybe because of some ModSecurity settings or something else with your hosting permissions 

What is ModSecurity

ModSecurity is for increasing the security of servers. It is an Apache module that works as a web application firewall. It blocks known exploits and provides protection from a range of attacks against web applications. Its activity may cause such issues from time to time when requests sent to the server match with ModSecurity rules. Sometimes such requests are false-positive

If still, you are facing an issue, please provide requested details to our support team and we will be happy to investigate the issue

35. Import demo pages separately

We have demo content for all the pages. Please don't try to import demo content because it will erase your current data. So backup files and database before import the demo data.

Or import demo data on the staging site and then export elementor templates and import into your live site

36. Start chatting with a specific user on the messenger page

Start chatting with a specific user on the messenger page

You may create a messenger page and then you can open the link below to start a chat with a specific user

https://yoursite.com/messenger/?chat_id=606&chat_type=1

chat_id => This is WordPress user ID
chat_type=1 => Leave this as it is

37. How to enable real time chat experience with WP Guppy

How to enable real time chat experience with WP Guppy

We have used Pusher Channel API for the real-time experience https://pusher.com/channels

You just need to create a channel api and add this into WP Guppy

https://wp-guppy.com/documentation/#ins_step7

38. WordPress 5.8 widgets area issue

WordPress 5.8 widgets area issue

In WordPress 5.8 widget area of Unyson has been deprecated, if you would use the Unyson plugin sidebar then please try to install and activate the Classic Widget plugin https://wordpress.org/plugins/classic-widgets/

39. How to change currency and formatting

How to change currency

Admin can change the currency from WooCommerce settings page


40. Server requirements

Below are the server requirements for the theme

  1. The PHP version should be 7.4(PHP 8.0 is not tested officially with our plugin/theme)
  2. PHP Zip extension Should be Installed
  3. max_execution_time = 300
  4. max_input_time = 300
  5. memory_limit = 512
  6. max_input_vars = 3000
  7. post_max_size = 50M
  8. upload_max_filesize = 50M
  9. CURL should be enabled to download Unyson extensions and demo content.
  10. Node.js server should be installed( required only for real-time chat ) 
  11. allow_url_fopen and allow_url_include 
  12. Make sure GD & Imagemagick libraries should be installed on your server. Which is required to upload and generate images sizes

Please note due to a lot of Theme Options, your server should have max_input_vars =3000 minimum, otherwise, your last tabs settings will not be saved