Add a "Tag" model for event classification (Issue #161).

ACM_General/events/forms.py

@@ -4,17 +4,18 @@
 
 # Django
 from django.forms import ModelForm
-from django.forms.widgets import DateTimeInput, Textarea, TextInput
+from django.forms.widgets import DateTimeInput, Textarea, TextInput, CheckboxSelectMultiple
 
 # local Django
-from .models import Event
+from .models import Event, Tag
 
 
 class EventForm(ModelForm):
     """
     This class is used for combining the Event Class model with a form
     (ModelForm).
     """
+
     class Meta:
         model = Event
         exclude = ('id', 'creator', 'date_created')
@@ -23,5 +24,6 @@ class Meta:
             'date_expire': DateTimeInput(attrs={'id': 'calendar'}),
             'title': Textarea(attrs={'rows': 3}),
             'description': Textarea(attrs={'rows': 3}),
-            'link': TextInput(),
+            'link': TextInput(), 
+            'tags': CheckboxSelectMultiple(),
         }

ACM_General/events/models.py

@@ -47,6 +47,46 @@ def get_path_for_flier(instance, filename):
     )
 
 
+class Tag(models.Model):
+    """
+    Class used for adding classification tags on events.
+    """
+
+    #: The name of the tag that is displayed on the event creation form; represented
+    #: as a CharField.
+    display_name = models.CharField(
+        verbose_name=_('Event Tag'),
+        help_text=_('Different categories for the event.'),
+        max_length=256,
+    )
+
+    #: Unique id of the tag; represented as an IntegerField.
+    id = models.IntegerField(
+        verbose_name=_('ID'),
+        help_text=_('Unique ID of the tag.'),
+        primary_key=True,
+    )
+
+    #: If the tag should be diplayed on the event creation form; represented as a
+    #: BooleanField.
+    display = models.BooleanField(
+        verbose_name=_('Display'),
+        help_text=_('Whether or not the tag is to be displayed on the event creation form.'),
+        default = True,
+    )
+
+
+    def __str__(self):
+        """
+        Changes what is displayed for each tag on the event creation
+        form (without this it shows 'Tag object (id)').
+
+        :return: String containing the name of the tag.
+        :rtype: string.
+        """
+        return self.display_name
+
+
 class Event(models.Model):
     """
     Class used to define what is needed when creating new events.
@@ -154,6 +194,13 @@ class Event(models.Model):
         blank=True,
     )
 
+    #: Tags available to attach to events; represented as a ManyToManyField.
+    tags = models.ManyToManyField(
+        Tag,
+        verbose_name=_('Event Tags'),
+        help_text=_('Different categories for classifying the event.'),
+    )
+
     @property
     def is_active(self):
         """

ACM_General/events/views.py

@@ -48,8 +48,9 @@ def create_event(request):
         - If the user is submitting a GET request, it will send them to the
           blank create event page.
         - If the user is submitting a POST request:
-            - If the form is valid, it will save the event to the database and
-              redirect the user to the homepage.
+            - If the form is valid, it will save the event as well as the 
+              ManyToMany relation to the database and redirect the user to the 
+              homepage.
             - If the form is invalid, the user will be redirected back to the
               same create event page with same information that they filled
               out, but also with information that now explains the errors that
@@ -74,6 +75,7 @@ def create_event(request):
             event = form.save(commit=False)
             event.creator = request.user
             event.save()
+            form.save_m2m()
             return HttpResponseRedirect("/")
 
         return render(request, 'events/create-event.html', {'form': form})