version 1.0.3-snapshot

Author: adamspd

README.md

@@ -4,14 +4,15 @@ Appointment Scheduler is a Django app designed for managing appointment scheduli
 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"](docs/README.md) directory.
+Detailed documentation is in the ["docs"](https://github.com/adamspd/django-appointment/tree/main/docs) directory.
 
 ## 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. Sends email notifications to clients when they schedule an appointment.
 
 ## Quick start
 
@@ -72,6 +73,11 @@ Detailed documentation is in the ["docs"](docs/README.md) directory.
    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.
+   ```html
+    <p>® 2023 {{ APPOINTMENT_WEBSITE_NAME }}. All Right Reserved.</p>
+   ```
+
 4. Run `python manage.py migrate` to create the appointment models.
 
 
@@ -99,8 +105,11 @@ Detailed documentation is in the ["docs"](docs/README.md) directory.
    # 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'
+   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.

appointment/email_sender/email_sender.py

@@ -1,11 +1,36 @@
 from django.core.mail import mail_admins, send_mail
 from django.template import loader
+from django.conf import settings
 
+from appointment.settings import APP_DEFAULT_FROM_EMAIL
+
+
+def has_required_email_settings():
+    required_settings = [
+        'EMAIL_BACKEND',
+        'EMAIL_HOST',
+        'EMAIL_PORT',
+        'EMAIL_HOST_USER',
+        'EMAIL_HOST_PASSWORD',
+        'EMAIL_USE_TLS',
+        'EMAIL_USE_LOCALTIME',
+        'ADMINS',
+    ]
+
+    for setting_name in required_settings:
+        if not hasattr(settings, setting_name):
+            print(f"Warning: '{setting_name}' not found in settings. Email functionality will be disabled.")
+            return False
+
+    return True
 
 def send_email(recipient_list, subject: str, template_url: str = None, context: dict = None, from_email=None,
                message: str = None):
+    if not has_required_email_settings():
+        return
+
     if from_email is None:
-        from_email = '[email protected]'
+        from_email = APP_DEFAULT_FROM_EMAIL
 
     html_message = ""
 
@@ -15,25 +40,33 @@ def send_email(recipient_list, subject: str, template_url: str = None, context:
             context=context
         )
 
-    send_mail(
-        subject=subject,
-        message=message if not template_url else "",
-        html_message=html_message if template_url else None,
-        from_email=from_email,
-        recipient_list=recipient_list,
-        fail_silently=False,
-    )
-
+    try:
+        send_mail(
+            subject=subject,
+            message=message if not template_url else "",
+            html_message=html_message if template_url else None,
+            from_email=from_email,
+            recipient_list=recipient_list,
+            fail_silently=False,
+        )
+    except Exception as e:
+        print(f"Error sending email: {e}")
 
 def notify_admin(subject: str, template_url: str = None, context: dict = None, message: str = None):
+    if not has_required_email_settings():
+        return
+
     html_message = ""
     if template_url:
         html_message = loader.render_to_string(
             template_name=template_url,
             context=context
         )
-    mail_admins(
-        subject=subject,
-        message=message if not template_url else "",
-        html_message=html_message if template_url else None
-    )
+    try:
+        mail_admins(
+            subject=subject,
+            message=message if not template_url else "",
+            html_message=html_message if template_url else None
+        )
+    except Exception as e:
+        print(f"Error sending email to admin: {e}")

appointment/settings.py

@@ -1,4 +1,5 @@
 from django.conf import settings
+from django.conf.global_settings import DEFAULT_FROM_EMAIL
 
 APPOINTMENT_CLIENT_MODEL = getattr(settings, 'APPOINTMENT_CLIENT_MODEL', 'auth.User')
 APPOINTMENT_BASE_TEMPLATE = getattr(settings, 'APPOINTMENT_BASE_TEMPLATE', 'base_templates/base.html')
@@ -8,4 +9,4 @@
 APPOINTMENT_SLOT_DURATION = getattr(settings, 'APPOINTMENT_SLOT_DURATION', 30)
 APPOINTMENT_LEAD_TIME = getattr(settings, 'APPOINTMENT_LEAD_TIME', (9, 0))
 APPOINTMENT_FINISH_TIME = getattr(settings, 'APPOINTMENT_FINISH_TIME', (16, 30))
-
+APP_DEFAULT_FROM_EMAIL = getattr(settings, 'DEFAULT_FROM_EMAIL', DEFAULT_FROM_EMAIL)