django-appointment 1.1.1

A Django app for managing appointment scheduling with ease and flexibility.

Appointment Scheduler

Appointment Scheduler is a Django app designed for managing appointment scheduling with ease and flexibility. It allows users to define custom configurations for time slots, lead time, and finish time, or use the default values provided. The app also handles conflicts and availability for appointments, ensuring a smooth user experience.

Detailed documentation is in the "docs" directory. Please refer to the release notes for changes and migration information here.

Features

1. Customizable time slots, lead time, and finish time.
2. Handles appointment conflicts and availability.
3. Easy integration with Django admin interface for appointment management.
4. User-friendly interface for viewing available time slots and scheduling appointments.
5. Send email notifications to clients when they schedule an appointment.

Quick start

1. Add "appointment" to your INSTALLED_APPS setting like this:

   INSTALLED_APPS = [
       # other apps
       'appointment',
   ]
   

2. Include the appointment URLconf in your project urls.py like this:

   from django.urls import path, include
   
   urlpatterns = [
       # other urls
       path('appointment/', include('appointment.urls')),
   ]
   

3. In your Django's settings.py, add the following:

   APPOINTMENT_CLIENT_MODEL = models.UserModel  # Not optional (e.g. auth.User, or client.UserClient)
   

   For example, if you use the default Django user model:

   APPOINTMENT_CLIENT_MODEL = auth.User
   

   Or, if you use a custom user model:

   APPOINTMENT_CLIENT_MODEL = client.UserClient
   

   If you have a custom user model, make sure your create_user function includes the following arguments, even if you don't use all of them:

   def create_user(first_name, email, username, **extra_fields):
       pass
   

   This will create a user with a password in the format: f"{APPOINTMENT_WEBSITE_NAME}{current_year}"

   For example, if you add this to your settings.py:

   APPOINTMENT_WEBSITE_NAME = 'Chocolates'
   

   And the current year is 2023, the password will be "Chocolates2023". If you don't provide an APPOINTMENT_WEBSITE_NAME, the default value is "Website", so the password will be "Website2023".

   This name is also used in the footer of the emails sent to the clients when they schedule an appointment.

    <p>® 2023 {{ APPOINTMENT_WEBSITE_NAME }}. All Right Reserved.</p>
   

4. Run python manage.py migrate to create the appointment models.

5. Start the development server and visit http://127.0.0.1:8000/admin/ to create appointments, manage configurations, and handle appointment conflicts (you'll need the Admin app enabled).

6. You have to create at least a service before using the application in the admin page. If your service is free, add 0 as the price. If you want to charge for your service, add the price in the price field. You can also add a description for your service.

7. Visit http://127.0.0.1:8000/appointment/request/<service_id>/ to view the available time slots and schedule an appointment.

Customization

1. In your Django project's settings.py, you can override the default values for the appointment scheduler:

   # Default values
   APPOINTMENT_SLOT_DURATION = 30  # minutes
   APPOINTMENT_LEAD_TIME = (9, 0)  # (hour, minute) 24-hour format
   APPOINTMENT_FINISH_TIME = (16, 30)  # (hour, minute) 24-hour format
   
   # Additional configuration options
   APPOINTMENT_BASE_TEMPLATE = 'base_templates/base.html'  # your base template
   APPOINTMENT_WEBSITE_NAME = 'Website'
   APPOINTMENT_PAYMENT_URL = None  # example of pattern 'payment:payment_linked
   APPOINTMENT_THANK_YOU_URL = None  # example of pattern 'payment:thank_you'
   
   # Additional to the default email settings
   APP_DEFAULT_FROM_EMAIL = "webmaster@localhost"  # the default from email that you're using
   

2. Modify these values as needed for your application, and the scheduler will adapt to the new settings.

3. To further customize the app, you can extend the provided models, views, and templates or create your own.

Support

For support or questions regarding the Appointment Scheduler app, please refer to the documentation in the "docs" directory or visit the GitHub repository for more information.

Notes

The application doesn't send confirmation emails on appointment creation yet, but it will be implemented soon. Also the application doesn't send email reminders yet.