Get Started

Documentation

Tiba Calendar – User Guide

Role: Business Operating System for Service Providers

This plugin transforms your WordPress site into a professional booking platform. Unlike standard plugins, Tiba acts as a “hub,” handling payments, SEO, and client reputation automatically.

🚀 Phase 1: Installation & Setup

Before accepting bookings, you must configure the core infrastructure.

1. Activate the License

  • Go to: Reservations > Settings > License
  • Action: Enter the License Key provided by Nyumbani Hosting.
  • Why? The system uses a secure RSA encryption (license.php). Without a valid key, the booking form and network sync will not load.

2. Create Your Pages

You need to create two specific pages in WordPress and paste the following “Shortcodes” into them:

Page Purpose Shortcode to Paste Description
Booking Page [.tiba_booking_flow] The step-by-step wizard where clients book. Make sure you remove the . before tiba
Reviews Page [.tiba_reviews_carousel] Displays verified 5-star reviews to visitors. Make sure you remove the . before tiba

Tip: After creating these pages, go to Reservations > Settings and link these pages so the plugin knows where to redirect users.

🛠 Phase 2: Building Your Service Menu

You can add services one by one or import a bulk list.

Option A: Manual Creation

  1. Go to: Reservations > Services > Add New.
  2. Fill in:
    • Title: Name of the service (e.g., “Luxury Spa Treatment”).
    • Duration: In minutes (Critical for the calendar slots).
    • Price: The deposit or full amount to be charged via Stripe.
    • Category: Use the sidebar to group services (e.g., “Hair”, “Nails”).

Option B: Bulk Import (For Large Catalogs)

  1. Go to: Reservations > Import Services.
  2. Step 1: Click “Download Template” to get the CSV file.
  3. Step 2: Fill out your services in Excel/Google Sheets and save as CSV.
  4. Step 3: Upload the file. The system will create all services automatically.

💳 Phase 3: Connecting Payments (Stripe)

Tiba Calendar is designed to take payments during the booking to reduce no-shows.

  1. Go to: Reservations > Settings > Payments.
  2. Enter Keys: Paste your Stripe Publishable Key and Secret Key.
    • Note: You can toggle “Test Mode” on to practice booking without spending real money.
  3. Webhooks (Crucial):
    • In your Stripe Dashboard, set the Webhook URL to: https://yoursite.com/wp-json/tiba/v1/stripe-hook
    • Why? When a payment succeeds, Stripe talks to this URL to flip the booking status from “Pending” to “Paid/Confirmed”.

📊 Phase 4: Daily Management

Do not use the standard “All Posts” view. Use the custom dashboards designed for efficiency.

1. The Calendar Overview

  • Go to: Reservations > Calendar Overview.
  • View: You will see a visual calendar (Month/Week/Day).
  • Status Codes:
    • Green: Confirmed & Paid.
    • Orange: Pending Payment (User might have abandoned checkout).
    • Red: Cancelled.

2. Analytics Dashboard

  • Go to: Reservations > Dashboard & Stats.
  • Check:
    • Revenue Chart: See how much you earned this month.
    • Status Donut: Quickly see your cancellation rate.

3. Handling Cancellations

  • Automation: Clients receive an email with a unique “Self-Cancel” link.
  • Manual: If a client calls you, find the reservation in the list and change status to Cancelled. The slot will immediately open up for new bookings.

⭐ Phase 5: The “Reputation Loop”

This is the most unique feature of Tiba Calendar. You cannot manually add fake reviews; they must come from clients.

  1. How it works:
    • 1 hour after an appointment ends, the system automatically emails the client.
    • The email contains a secure, one-time link.
  2. The Review:
    • The client clicks the link and rates you.
    • If they leave a review, it automatically appears on your Reviews Page (

      5.0 / 5.0

      0 Verified Reviews

      No reviews yet.

      ).
  3. Your Job: Nothing! This runs automatically via Cron jobs.

🌐 Phase 6: Network & SEO

Google Visibility

You do not need an SEO plugin for your services. Tiba automatically injects Schema.org code.

  • Action: Whenever you update a price or service description, the system automatically “Pings” Google to update your search listing.

Network Sync (If applicable)

If you are part of the “Tiba Marketplace”:

  1. Go to: Tiba Network Client in the main menu.
  2. Sync: Ensure the connection status is “Connected”.
  3. Benefit: This syncs your availability to the main marketplace so new clients can find you on the app.

🆘 Troubleshooting

Q: A client paid, but the slot is still showing “Pending”.

  • A: Your Stripe Webhook is likely missing. Check Phase 3 above. The system needs that “Webhook” to know the money actually arrived.

Q: I can’t add a review manually.

  • A: This is a security feature. To test it, book an appointment for yourself, set the time to “1 hour ago”, wait for the email, and click the link.

Q: The Calendar looks broken or unstyled.

  • A: Ensure your theme allows jQuery to load. The calendar relies heavily on JavaScript. Check your browser console (F12) for errors.
Last updated: January 7, 2026