# Getting started

Once you’ve installed django-recurrence, you’ll generally want to start by using it in one of your models, which can be done like this:

    from recurrence.fields import RecurrenceField

    class Course(models.Model):
        title = models.CharField(max_length=200)
        recurrences = RecurrenceField()

If you use the `Course` model in Django’s administrative interface, or in any forms, it should be rendered with a pretty form field, which makes selecting relatively complex recurrence patterns easy.

Using this form it’s possible to specify relatively complex recurrence rules - such as an event that happens every third Thursday of the month, unless that Thursday happens to be the 21st of the month, and so on.

# Form Usage

    from django import forms
    from .models import Course

    class CourseForm(forms.ModelForm):
       class Meta:
          model = Course
          fields = ('title', 'recurrences',)

Note

Be sure to add `{{ form.media }}` to your template or statically link recurrence.css and recurrence.js.

    <form method="POST" class="post-form">
        {% csrf_token %}
        {{ form.media }}
        {{ form }}
        <button type="submit">Submit</button>
    </form>