feat: Add cancel volunteering option (#206)

* feat: Add cancel volunteering option
* test: Add tests for cancel volunteering feature
* fix: lint issues
* Cleanup and adjust based on latest changes in the portal.

Use markdown template
Still show cancelled volunteers in the profile list
Adjust tests

---------

Co-authored-by: mariatta <mariatta.wijaya@gmail.com>

Author: Mr-Sunglasses

common/mixins.py

@@ -1,5 +1,7 @@
 from django.contrib.auth.mixins import UserPassesTestMixin
 
+from volunteer.models import VolunteerProfile
+
 
 class AdminRequiredMixin(UserPassesTestMixin):
     """Mixin for views that require administrative permission.
@@ -10,3 +12,20 @@ class AdminRequiredMixin(UserPassesTestMixin):
 
     def test_func(self):
         return self.request.user.is_superuser or self.request.user.is_staff
+
+
+class VolunteerOrAdminRequiredMixin(UserPassesTestMixin):
+    """Mixin for views that require the user to be the owner of the object or an admin.
+
+    This is useful for views where users can only access their own data unless they have
+    administrative privileges.
+    """
+
+    def test_func(self):
+        pk = self.kwargs.get("pk")
+        instance = VolunteerProfile.objects.filter(pk=pk).first()
+        is_owner = False
+        if instance and instance.user == self.request.user:
+            is_owner = True
+        is_admin = self.request.user.is_superuser or self.request.user.is_staff
+        return is_owner or is_admin

templates/emails/volunteer/team_lead_cancellation_notification.md

@@ -0,0 +1,39 @@
+{% extends "emails/base_email.md" %}
+{% load i18n %}
+{% block content %}
+
+Dear Team Lead,
+
+This email is to inform you that a member of your team has been canceled from volunteering.
+
+Please review the following details,
+and take the necessary steps to offboard the volunteer from your team and revoke their access to any resources they may have had.
+
+## Volunteer Information
+
+- **Name**: {{ profile.user.first_name }} {{ profile.user.last_name }}
+- **Username**: {{ profile.user.username }}
+- **Email**: {{ profile.user.email }}
+- **Team**: {{ team.short_name }}
+{% if profile.discord_username %}- **Discord**: {{ profile.discord_username }}{% endif %}
+{% if profile.discord_username %}- **GitHub**: {{ profile.discord_username }}{% endif %}
+
+
+## Action Items
+
+As the team lead, you are responsible for completing the following offboarding tasks:
+
+- **Remove the Volunteer role on Discord.** Their Discord username is: **{{ profile.discord_username }}**.
+- **Remove access to PyLadiesCon GDrive** (if applicable).
+- **Remove access to Jelly** (if applicable).
+- **Remove access to the PyLadiesCon Regular Meeting Calendar** (if applicable).
+- **Remove access to the PyLadiesCon 1Password account** (if applicable).
+- **Remove access to GitHub repositories** (if applicable).
+
+**Please complete the above tasks within 24 hours.** 
+
+If you have any questions or need assistance with the offboarding process, please reach out to the admin team.
+
+Best regards.
+
+{% endblock content %}

templates/emails/volunteer/volunteer_cancellation_confirmation.md

@@ -0,0 +1,43 @@
+{% extends "emails/base_email.md" %}
+{% load i18n %}
+{% block content %}
+
+Dear {{ profile.user.first_name|default:profile.user.username }},
+
+This email confirms that your Volunteer application for PyLadiesCon has been cancelled.
+
+## Changes Made
+
+Your Volunteer Profile status has been set to **"Cancelled"**
+
+{% if teams_removed %}
+You have been removed from the following teams:
+
+{% for team in teams_removed %}- {{ team.short_name }} {% endfor %}
+
+{% endif %}
+
+{% if roles_removed %}
+You have been removed from the following roles:
+
+{% for role in roles_removed %}- {{ role.short_name }} {% endfor %}
+
+{% endif %}
+
+Team leads have been notified of your departure.
+
+Your access to volunteer resources will be revoked within the next 24 hours.
+
+We understand that circumstances can change, and we appreciate the time you were willing to dedicate to PyLadiesCon.
+
+If you change your mind in the future and would like to volunteer again,
+you're welcome to submit a new volunteer application through our portal.
+
+If this was a mistake, or you do not wish to cancel your application, please contact us so that we
+can rectify the situation.
+
+Thank you for your interest in PyLadiesCon, and we hope to see you as a participant or volunteer in future events!
+
+Best regards.
+
+{% endblock content %}

templates/volunteer/volunteerprofile_detail.html

@@ -217,10 +217,87 @@ <h5 class="card-title mb-0">
         {% if user.is_superuser and user.username != object.user.username %}
             <a class="btn btn-secondary"
                href="{% url 'volunteer:volunteers_list' %}">Back to Manage Volunteers</a>
+            {% if object.application_status != "Cancelled" %}
+                <button type="button"
+                        class="btn btn-danger ms-2"
+                        data-bs-toggle="modal"
+                        data-bs-target="#cancelVolunteeringModal">
+                    Cancel Volunteering
+                </button>
+            {% endif %}
         {% else %}
-            <a class="btn btn-primary"
-               href="{% url 'volunteer:volunteer_profile_edit' object.pk %}">Edit Profile</a>
+            {% if object.application_status != "Cancelled" %}
+                <a class="btn btn-primary"
+                   href="{% url 'volunteer:volunteer_profile_edit' object.pk %}">Edit Profile</a>
+                <button type="button"
+                        class="btn btn-danger ms-2"
+                        data-bs-toggle="modal"
+                        data-bs-target="#cancelVolunteeringModal">
+                    Cancel My Volunteering
+                </button>
+            {% endif %}
             <a class="btn btn-secondary" href="{% url 'volunteer:index' %}">Back to Volunteer Dashboard</a>
         {% endif %}
     </div>
+    <!-- Cancel Volunteering Modal -->
+    {% if object.application_status != "Cancelled" %}
+        <div class="modal fade"
+             id="cancelVolunteeringModal"
+             tabindex="-1"
+             aria-labelledby="cancelVolunteeringModalLabel"
+             aria-hidden="true">
+            <div class="modal-dialog">
+                <div class="modal-content">
+                    <div class="modal-header">
+                        <h5 class="modal-title" id="cancelVolunteeringModalLabel">
+                            Cancel Volunteering
+                        </h5>
+                        <button type="button"
+                                class="btn-close"
+                                data-bs-dismiss="modal"
+                                aria-label="Close">
+                        </button>
+                    </div>
+                    <div class="modal-body">
+                        <p>
+                            <strong>Are you sure you want to cancel your volunteer application?</strong>
+                        </p>
+                        <p>
+                            This action will:
+                        </p>
+                        <ul>
+                            <li>
+                                Set your application status to "Cancelled"
+                            </li>
+                            <li>
+                                Remove you from all assigned teams and roles
+                            </li>
+                            <li>
+                                Send a confirmation email to you
+                            </li>
+                            <li>
+                                Notify team leads about your departure
+                            </li>
+                        </ul>
+                        <p class="text-danger">
+                            <strong>This action cannot be undone.</strong> If you change your mind, you'll need to submit a new volunteer application.
+                        </p>
+                    </div>
+                    <div class="modal-footer">
+                        <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">
+                            Keep Volunteering
+                        </button>
+                        <form method="post"
+                              action="{% url 'volunteer:cancel_volunteering' object.pk %}"
+                              class="d-inline">
+                            {% csrf_token %}
+                            <button type="submit" class="btn btn-danger">
+                                Yes, Cancel My Volunteering
+                            </button>
+                        </form>
+                    </div>
+                </div>
+            </div>
+        </div>
+    {% endif %}
 {% endblock content %}

tests/sponsorship/test_views.py

@@ -9,7 +9,7 @@
 )
 from sponsorship.views import SponsorshipProfileFilter, SponsorshipProfileTable
 from volunteer.constants import ApplicationStatus
-from volunteer.models import LANGUAGES, VolunteerProfile
+from volunteer.models import VolunteerProfile
 
 
 @pytest.mark.django_db
@@ -23,7 +23,6 @@ def test_sponsors_list_view_forbidden_if_not_approved_volunteer(
 
         # create the volunteer profile but is not approved
         profile = VolunteerProfile(user=portal_user)
-        profile.languages_spoken = [LANGUAGES[0]]
         profile.save()
 
         response = client.get(reverse("sponsorship:sponsorship_list"))
@@ -40,7 +39,6 @@ def test_sponsors_list_view_is_approved_volunteer(self, client, portal_user):
         profile = VolunteerProfile(
             user=portal_user, application_status=ApplicationStatus.APPROVED
         )
-        profile.languages_spoken = [LANGUAGES[0]]
         profile.save()
 
         client.force_login(portal_user)
@@ -116,7 +114,6 @@ def test_sponsors_table_render_progress_status_for_approved_volunteer(
         profile = VolunteerProfile(
             user=portal_user, application_status=ApplicationStatus.APPROVED
         )
-        profile.languages_spoken = [LANGUAGES[0]]
         profile.save()
 
         client.force_login(portal_user)