KiviCare WordPress - Documentation
KiviCare Lite
Shortcodes & Widgets
Last updated 19 hours ago

Clinic List Widgets

Shortcode & Elementor Widget

The KiviCare Clinic List feature allows you to display a modern, responsive directory of your clinics on the frontend. Patients can browse clinic details and click “Book Appointment” to start booking directly (with the selected clinic pre-filled in the modal).

It works identically whether used as a shortcode (anywhere on your site) or as an Elementor widget (drag-and-drop in Elementor pages).

How to Add It

Via Shortcode (Gutenberg, Classic Editor, Widgets, etc.)

Use the Shortcode block or directly insert:

JAVASCRIPT 
[kivicare_clinic_list]

Via Elementor Widget

  1. Edit a page with Elementor.
  2. Search for “KiviCare Clinic List”.
  3. Drag it onto the page.

Widget Details:

  • Category: KiviCare
  • Icon: Building (eicon-building)
  • Keywords: clinic, list, kivicare

Customization Options

Shared Options (Shortcode Attributes = Elementor Controls)

Option (Shortcode Attribute)Elementor Control TypeDefaultDescription
enable_filterSwitcherYesShow filter bar (Specialty, Service, Search).
per_pageNumber5 (shortcode) / 2 (widget)Clinics per page – pagination auto-appears for more.
show_imageSwitcherYesShow clinic profile image.
show_nameSwitcherYesShow clinic name.
show_specialitySwitcherYesShow specialties (comma-separated).
show_numberSwitcherYesShow clinic phone.
show_emailSwitcherYesShow clinic email.
show_addressSwitcherYesShow full address.
show_administratorSwitcherYesShow administrator name.
show_admin_numberSwitcherYesShow admin phone.
show_admin_emailSwitcherYesShow admin email.

Additional Elementor-Only Options:

  • Hide Space Between Clinics (Switcher) – Removes card gaps for compact layout.

Label Customization

Each visible field has a custom label (text field in Elementor; attribute in shortcode).

Attribute / ControlDefault ValueExample
name_labelName“Our Clinic”
speciality_labelSpeciality“Departments”
number_labelContact No“Phone”
email_labelEmail ID“Email”
address_labelAddress“Location”
administrator_labelAdministrator“Clinic Manager”
admin_number_labelContact No“Manager Phone”
admin_email_labelEmail ID“Manager Email”

Styling (Elementor Only – Style Tab)

Full design control:

  • Card: Background, shadow, border, radius
  • Image: Height, width, border, radius, style, color
  • Individual Fields: Separate sections for label & value (color, typography, margin, padding, alignment)
  • Administrator Section: Dedicated label styling
  • Book Appointment Button: Background color, text color, typography, radius, padding

Key Features

  • Filtering Options (when enable_filter=”yes”):
  • Specialty Filter: Dropdown of all unique specialties available across clinics.
  • Service Filter: A dropdown of all services offered in any clinic.
  • Search Box: Searches by clinic name or email.
  • Click the “Filter Clinic” button to apply filters.
  • Pagination: Automatic “Previous” and “Next” buttons with page info (e.g., “Page 2 of 5”) when there are more clinics than per_page.
  • Clinic Cards:
  • Clean, modern card layout.
  • Optional image (with automatic placeholder showing clinic initials if no image is set).
  • All information is configurable via attributes.
  • Book Appointment Button:
  • Each clinic card has a “Book Appointment” button.
  • Clicking it opens the KiviCare booking modal with that clinic automatically pre-selected.
  • Security:
  • Staff users (Administrator, Doctor, Receptionist, Clinic Admin) cannot view the list.
  • They see a friendly message: “Current user can not view the widget. Please open this page in incognito mode or use another browser.”
  • No Clinics Message:
  • If no clinics are found (or after filtering), it displays: “No clinics found.”

Example Usages

Default List with Filters

JAVASCRIPT 
   [kivicare_clinic_list]

More Clinics Per Page, No Filters

JAVASCRIPT 
   [kivicare_clinic_list per_page="12" enable_filter="no"]

Minimal Card (Name + Address + Book Button Only)

JAVASCRIPT 
   [kivicare_clinic_list show_image="no" show_speciality="no" show_number="no" show_email="no" show_administrator="no"]

Custom Labels

JAVASCRIPT 
   [kivicare_clinic_list name_label="Clinic" address_label="Visit Us At"]

Suggestions & Improvements

Your email address will not be published. Required fields are marked *