Black Friday : -40 % sur tout dès le 23 novembre avec le code BF40 Voir les offres →

Slotlane documentation

Everything you need to install, set up and run Slotlane, the self-hosted appointment booking script with a booking page, a website widget and deposits. Want to see it first? Open the démo en ligne.

Contents

Prérequis

  • PHP 8.3 or newer with the extensions pdo, mbstring, openssl, curl, json, tokenizer, xml, ctype, fileinfo, zip and iconv (all usual on shared hosting).
  • A database: MySQL 8 / MariaDB 10.6+ (an empty database and its user), or SQLite for small sites (nothing to create).
  • A domain or subdomain, with HTTPS (needed for the booking page and the widget).
  • A way to run a task every minute: a cron line, or a web cron calling a secret URL.

The installer checks all of this and shows what is missing in red.

Services and what they cost

Slotlane itself has no monthly fee and takes no commission. Some features use outside services that you choose and pay to them directly:

Service Needed for Cost
Web hosting with PHP 8.3 and a database Running Slotlane Your hosting plan (any shared host that meets the requirements works).
An email account (SMTP) Confirmations, reminders, team notifications and password links Usually included with your hosting or domain; otherwise a transactional email service (many have a free tier).
Google Cloud and/or Microsoft Entra app (optional, free) Syncing the team’s Google or Outlook calendars, Meet and Teams links Free for these uses.
Zoom (optional) Zoom links for video appointments Your Zoom plan.
Twilio (optional) Text messages (SMS or WhatsApp) to customers Billed by Twilio per message.
An AI provider (optional): OpenAI, Anthropic, Google or a compatible service The question box of the booking page, “Improve with AI” Billed by the provider per use, on your own API key.
Stripe and/or PayPal (optional) Deposits or the full price paid when booking Their own fees per payment, on your own accounts; Slotlane takes no commission.
Zapier, Make or n8n (optional) Webhooks to your other tools Their own plans; Slotlane sends the webhooks for free.

Installation steps

  1. Create the site in your hosting panel and point its document root to the public folder of Slotlane. If your host does not let you choose the document root, upload Slotlane into the site folder anyway: the .htaccess file at the root sends visitors to public and blocks the private files.
  2. MySQL only: create an empty database and a user with all rights on it.
  3. Upload the zip into the site folder and extract it. The storage and bootstrap/cache folders and the .env file must be writable by PHP (most shared hosts already allow this). For SQLite, the database folder must be writable too.
  4. Open https://your-site.com/install and fill in the form: name, address, database, your owner account. The installer creates the tables, then locks itself for good.
  5. Add the cron job shown at the end of the installer (also in Settings):
    • with a command line: * * * * * php /path/to/slotlane/artisan slotlane:cron >> /dev/null 2>&1
    • with a web cron only: call https://your-site.com/cron/YOURKEY every minute.

First steps in the admin

  1. Mon compte: turn on two-factor sign-in.
  2. Licence & updates: enter your licence key (copies bought on the Aluleth Market). Copies bought on a marketplace update by uploading the new zip on the same page.
  3. Settings: name, default language, time zone of your business (hours and appointments use it), sending emails.
  4. Entreprise: your business name, email (customers reply to it and new bookings are announced there), phone, website and logo.
  5. Équipe et horaires: add the people customers book (or rooms, chairs…), the services each one gives, their weekly hours (up to three ranges a day, for a lunch break) and their time off.
  6. Services: name, category, duration, free time kept before and after (clean-up, travel), start times (by default every length of the service with its free time), price, who gives it, minimum notice, how far ahead, places at a time (more than 1 for a class), “I confirm each booking myself”, extra questions, its link.
  7. Booking page and widget: copy your booking page link, set the rules (phone asked or not, customers choose who they see, move and cancel until how many hours before, reminder, currency, 12 or 24 hour clock) and add the widget to your website.
  8. Accounts: add the people who sign in. Roles: Owner (everything), Admin (everything except licence, updates and owners), Staff member (their own calendar and appointments: link them to their profile in Équipe et horaires), Viewer (sees the calendar and appointments, changes nothing).

How customers book

  • The booking page is at /book (the home page of the site goes there). Each service has its own link (/book/link-of-the-service), shown in Services and Booking page and widget.
  • The customer chooses the service, who they see (or Anyone: the first free person, sharing the work), a day in the calendar (days without a free time are greyed), a time, then gives their name, email, phone (if asked) and the answers to your questions.
  • Times are shown in the time zone of your business. A booking is checked again at the very moment it is saved: two people can never get the same time.
  • The customer gets an email with the details and a calendar file (.ics), and a private link to their appointment: they can add it to their calendar, move it or cancel it until the number of hours you set before it (24 by default). After that, the page asks them to contact you.
  • Services you confirm yourself: the customer gets “request received”, the appointment shows To confirm in the admin, and the time stays taken until you confirm or cancel it.
  • Reminder: an email the number of hours you choose before the visit (24 by default), sent by the cron job. It is not sent for appointments booked inside that time (the confirmation was just sent).

Payments, discount codes and packages

Paiements (admin):

  • Stripe: paste your secret key (Stripe › Developers › API keys) and tick Take card payments with Stripe. In Stripe › Developers › Webhooks, add the address shown on the page with the event checkout.session.completed and paste its signing secret: payments are then recorded even when a customer closes the tab before coming back.
  • PayPal: paste the client ID and secret of your app (PayPal developer dashboard › Apps & Credentials) and choose Live or Sandbox (tests). PayPal does not take every currency: only Stripe is offered for the others.
  • Click Check the keys. Use Stripe test keys (sk_test_…) or the PayPal sandbox first: the page says when no real money moves.
  • In each service, choose Pay at the visit, Pay a deposit when booking (with its amount) or Pay the full price when booking. With an account set up, the booking page shows the amount to pay now; the customer pays on the secure page of Stripe or PayPal and the appointment counts once paid. Its time is kept meanwhile (the time set in Booking page and widget, at least 31 minutes with Stripe); not paid by then, the time is offered again. Without an account, customers pay at the visit.
  • Remboursements: Give back online payments when the customer cancels in time (on by default). From an appointment, the team can give back all or part of an online payment, and record payments taken at the desk (cash, card, transfer).
  • Discount codes: a percentage or an amount, for some services or all, between two dates, with a most number of uses. Customers type them in the booking form.
  • Packages: prepaid visits (“5 cuts”, valid 365 days). Sell one from the customer’s page (with how it was paid). The customer books with it from My visits (/my-visits: they type their email and get a link valid 2 hours), or the team ticks Use the package when booking for them. A cancelled visit goes back to the package.

Calendars, video, text messages and AI

Intégrations (admin) holds your own app keys; each page section tells where to create them:

  • Google Calendar and Google Meet: an OAuth client (Web application) in Google Cloud Console with the Google Calendar API turned on, and the redirect address shown on the page. Outlook and Teams: an app in Microsoft Entra (Azure) › App registrations with the permission Calendars.ReadWrite and its redirect address.
  • Then each staff member connects their calendar in Équipe et horaires (or in Mon compte when their sign-in account is linked to their profile). The busy events of that calendar block bookings (read every 5 minutes by the cron job), and each appointment is written into it, moved and removed with it.
  • Video meetings: in a service, choose Google Meet, Microsoft Teams (both need the staff member’s calendar) or Zoom (a Server-to-Server OAuth app; set each staff member’s Zoom user). The link is in the confirmation email, the customer’s page, the calendar file and the reminders.
  • Text messages (Twilio): the Account SID, auth token and your Twilio number; choose SMS or WhatsApp and which messages (confirmation, reminder, new time, cancellation). WhatsApp only takes templates approved by Meta: create them in Twilio and paste their Content SID. Send a test text message checks everything.
  • AI (optional): your own provider and key. Show the question box on the booking page lets customers ask in their own words (“a cut on Saturday morning?”): the AI only reads the question and your services, and the free times shown always come from your calendar. Improve with AI writes the description of a service; the team reads it before saving. Most AI calls per day caps the bill.

Waiting list, reviews and reports

  • Waiting list (Booking page and widget): customers who find no time that suits them leave their email for a day; when a time frees up there (a cancellation, new hours), the cron job emails them all with the booking link. The list is in Appointments › Waiting list.
  • Done automatically: confirmed appointments are marked as done 2 hours after they end (turn it off to mark them yourself).
  • Review request: after a visit marked as done, an email with the link to your review page (Google, Facebook, Yelp…), at most once a week per customer.
  • Rapports: appointments, booked value, money received (packages included, refunds taken off), no-shows, new customers, appointments per day, by service, by staff member (with the share of their hours booked) and by source, for this month, last month, the last or next 30 days and this year. Download the appointments (CSV) for your spreadsheet.

The widget on your website

Booking page and widget → Widget for your website:

  1. Add the address of your website to Websites allowed to show the widget (one per line, https://*.example.com for all its subdomains). Other sites cannot show your booking page.
  2. Paste the code shown before </body> on the pages of your site, for example <script src="https://book.example.com/widget.js" data-slotlane="https://book.example.com" data-label="Book now" defer></script>.
  3. Options: data-service="link-of-a-service" opens one service; data-button="none" hides the round button, and any link or button of your page with the attribute data-slotlane-open opens the panel; data-lang="fr" chooses the language of the panel (by default the language of your page).

The admin day to day

  • Tableau de bord: today’s appointments, this week, to confirm, booked in the last 7 days, and the getting-started list.
  • Calendar: the week, one column a day, coloured by staff member; tick who to show. Appointments to confirm are striped, time off is greyed.
  • Appointments: upcoming, today, to confirm, past, cancelled, all; search by name, email, phone or reference. One appointment: confirm, mark as done or no-show, move (the customer is told by email), cancel (with or without an email), record a payment taken at the desk, a private note, the answers and the history.
  • New appointment: choose the service, the person and the day, then a free time; or tick Choose a time by hand to book outside the hours or over another appointment. The team is not held by the minimum notice or the booking window. Untick the email box for a booking you only note.
  • Customers: everyone who booked, found again by their email, with their visits, no-shows and notes. Delete the customer deletes their details and all their appointments (for a person who asks you to delete their data).
  • Staff members who sign in see only their own calendar, appointments and customers.

Sending emails

Settings → Sending emails: choose SMTP server and enter the details your host gives in “Email accounts” (server, port 465 with SSL or 587 with TLS, user name, password). Use a sender address of your own domain, then click Send a test email to me. Until this is set up, emails are only written to storage/logs.

Colors and look

  • Widget: Booking page and widget → Widget for your website → Colour, Button text, Position. No file to edit.
  • Admin and booking pages: one stylesheet, public/css/slotlane.css. Its first block, :root { … }, holds every color; change the values there:
    • --accent: #4338ca buttons, links, the selected menu entry, the free days; --accent-ink: #ffffff text on the buttons; --accent-soft: #e9e8fb light backgrounds of the selected entries and free days;
    • --bg page background, --panel cards, --panel-2 light grey areas, --line borders, --text text, --muted secondary text;
    • --good, --warn, --bad (and their -soft versions) for the green, orange and red labels;
    • --radius the corners, --font the font. The block just after it, @media (prefers-color-scheme: dark), holds the same names for dark mode: change both. Reload the page with Ctrl+F5 (or Cmd+Shift+R) to see the change.
  • Staff colours in the calendar: Équipe et horaires, for each person.
  • Your logo appears on the booking page and in the admin: Company → Logo.
  • Emails: the button color is #4338ca in resources/views/emails/booking.blade.php; the frame is resources/views/emails/layout.blade.php. After a change, run php artisan view:clear (or delete the files in storage/framework/views).
  • An update replaces these files: keep a copy of your changes (the replaced files are also saved in storage/app/updates).

Updating

  • With an active licence: Licence & updates → Update to x.y.z.
  • Without: download the new full zip, then Licence & updates → Update from a zip.
  • If the server refuses the upload (the zip is about 17 MB and some hosts allow less): extract the zip on your computer and upload its files over the old ones by FTP, keeping your .env file and storage folder. Database changes apply on the next visit.

Before copying, Slotlane checks the zip (Slotlane package, newer version, safe paths, writable files) and saves the files it replaces in storage/app/updates (the 3 newest backups are kept). Your .env file, storage folder and database are never replaced. Database changes are applied automatically.

Bon à savoir

  • The admin is at /admin. Change it with SLOTLANE_ADMIN_PATH= in .env.
  • Keep APP_DEBUG=false in production.
  • Back up the database and the .env file: it holds the encryption key of the installation.
  • Locked out with no email set up? On the server, run php artisan slotlane:reset-password you@example.com: it prints a new password and turns off two-factor sign-in for that account.

Troubleshooting

Problem What to do
The installer shows a line in red Install the missing PHP extension or version in your hosting panel, or make the folder writable, then reload the page.
Reminders or background work do not happen The cron job never ran: add the cron line or the web cron (Settings → Cron job shows the last run), then wait one minute.
Blank page or error 500 Check that PHP is 8.3 or newer and that storage, bootstrap/cache and .env are writable. The details are in storage/logs/laravel.log.
Emails do not arrive Settings → Sending emails → Send a test email to me. Check the spam folder, use a sender address of your own domain, and ask your host for the right port and security (SSL 465 or TLS 587).
Locked out and no email set up On the server, run php artisan slotlane:reset-password you@example.com: it prints a new password and turns off two-factor sign-in for that account.
A day shows no free time Check the person’s weekly hours and time off (Équipe et horaires), the services they give, and the service’s minimum notice and At most (days ahead). Times are in the time zone of Settings.
The widget opens an empty panel Add your website’s address to Websites allowed to show the widget (with https:// and www. if your site uses it).
Where is the admin? At /admin. Change it with SLOTLANE_ADMIN_PATH= in .env.

Support

  • Bought on a marketplace (WPBay, Codester…): contact the author through the support or message page of the item on that marketplace. Updates are downloaded there too.
  • Bought on the Aluleth Market: write to us from https://market.alulethmarketing.com/support/ with your order number. Updates come with one click while your licence is active.

Please give the Slotlane version (bottom of the admin menu and Licence & updates), your PHP version and, for an error, the last lines of storage/logs/laravel.log. Support covers installing and using Slotlane; it does not cover changes to its code, your hosting or the outside services above.