{"id":39,"date":"2025-12-18T09:06:45","date_gmt":"2025-12-18T09:06:45","guid":{"rendered":"http:\/\/192.168.1.159\/wp_plugins\/dev\/kivicare-revamp\/2025\/12\/18\/appointment-booking-shortcode\/"},"modified":"2026-02-18T04:51:58","modified_gmt":"2026-02-18T04:51:58","slug":"appointment-booking-shortcode","status":"publish","type":"post","link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/kivicare-lite\/documentation\/shortcodes-widgets\/appointment-booking-shortcode\/","title":{"rendered":"Appointment Booking Shortcode"},"content":{"rendered":"
\n
\n\n\n\n

Overview<\/strong><\/h2>\n\n\n\n

KiviCare<\/strong> is a WordPress clinic and patient management plugin that provides powerful widgets and shortcodes for integrating appointment booking<\/strong> into your website. These tools allow patients and guest users to book appointments directly from the frontend.<\/p>\n\n\n\n

The appointment booking widgets are available as Gutenberg blocks<\/strong> and as shortcodes<\/strong>, making them flexible for use across different editors and page builders.<\/p>\n\n\n\n

\n\n\n\n

Available Appointment Booking Widgets<\/strong><\/h2>\n\n\n\n

KiviCare offers two primary appointment booking widgets<\/strong>, both powered by the same React-based booking form:<\/p>\n\n\n\n

1. Book Appointment Widget<\/strong><\/h5>\n\n\n\n
    \n
  • Displays the complete multi-step booking form<\/strong> directly on the page.<\/li>\n<\/ul>\n\n\n\n
    2. Book Appointment Button Widget<\/strong><\/h5>\n\n\n\n
      \n
    • Displays a customizable button<\/strong>.<\/li>\n\n\n\n
    • Clicking the button opens the booking form in a popup modal<\/strong>.<\/li>\n<\/ul>\n\n\n\n

      Both widgets share the same booking logic and features. The main difference lies in their presentation and placement<\/strong>.<\/p>\n\n\n

      \n
      \n <\/i>\n <\/div>\n
      \n Note:<\/strong> Some advanced features\u2014such as multi-clinic selection, doctor filtering by clinic, and custom field ordering\u2014require KiviCare Pro<\/strong>. <\/div>\n <\/div>\n \n\n\n
      \n\n\n\n
      \n

      <\/p>\n<\/blockquote>\n\n\n\n

      Shared Functionality (<\/strong>All Widgets & Shortcodes)<\/strong><\/h2>\n\n\n\n

      Both appointment widgets and their shortcodes support the following features:<\/p>\n\n\n\n

        \n
      • Multi-step booking flow:<\/strong><\/li>\n\n\n\n
      • Clinic \u2192 Doctor \u2192 Service \u2192 Date & Time \u2192 Patient Details \u2192 Confirmation<\/li>\n\n\n\n
      • Pre-selection via shortcode parameters:<\/strong> Filter appointments by clinic, doctor(s), or service.<\/li>\n\n\n\n
      • Payment integration:<\/strong> Supports available gateways (WooCommerce, PayPal in Pro).<\/li>\n\n\n\n
      • Print appointment option:<\/strong> Available on confirmation (configurable in settings).<\/li>\n\n\n\n
      • User detection:<\/strong> Logged-in patients have details auto-filled; guests can also book appointments.<\/li>\n\n\n\n
      • Timezone handling:<\/strong> Uses the WordPress site timezone.<\/li>\n\n\n\n
      • Customization options:<\/strong> Colors, images, prices, loader, and field display via Widget Settings.<\/li>\n\n\n\n
      • Access restriction:<\/strong> Hidden for Admin, Doctor, and Receptionist roles (a notice suggests using incognito mode).<\/li>\n\n\n\n
      • Responsive modern UI:<\/strong> Built with React-style components and loads without page refreshes.<\/li>\n<\/ul>\n\n\n\n
        \n\n\n\n

        1. Book Appointment Widget<\/strong><\/h2>\n\n\n\n
        Gutenberg Block<\/h5>\n\n\n\n
          \n
        • Block Name:<\/strong> kivi-care\/book-appointment-widget<\/code><\/li>\n\n\n\n
        • Block Title:<\/strong> Kivi Appointment Widget<\/em><\/li>\n<\/ul>\n\n\n
          \n \n
          \n JAVASCRIPT<\/span>\n