===========================

The built-in comment models

===========================

.. module:: django.contrib.comments.models

   :synopsis: The built-in comment models

.. class:: Comment

    Django's built-in comment model. Has the following fields:

    .. attribute:: content_object

        A :class:`~django.contrib.contettypes.generic.GenericForeignKey`

        attribute pointing to the object the comment is attached to. You can use

        this to get at the related object (i.e. ``my_comment.content_object``).

        Since this field is a

        :class:`~django.contrib.contettypes.generic.GenericForeignKey`, it's

        actually syntactic sugar on top of two underlying attributes, described

        below.

    .. attribute:: content_type

        A :class:`~django.db.models.ForeignKey` to

        :class:`~django.contrib.contenttypes.models.ContentType`; this is the

        type of the object the comment is attached to.

    .. attribute:: object_pk

        A :class:`~django.db.models.TextField` containing the primary

        key of the object the comment is attached to.

    .. attribute:: site

        A :class:`~django.db.models.ForeignKey` to the

        :class:`~django.contrib.sites.models.Site` on which the comment was

        posted.

    .. attribute:: user

        A :class:`~django.db.models.ForeignKey` to the

        :class:`~django.contrib.auth.models.User` who posted the comment.

        May be blank if the comment was posted by an unauthenticated user.

    .. attribute:: user_name

        The name of the user who posted the comment.

    .. attribute:: user_email

        The email of the user who posted the comment.

    .. attribute:: user_url

        The URL entered by the person who posted the comment.

    .. attribute:: comment

        The actual content of the comment itself.

    .. attribute:: submit_date

        The date the comment was submitted.

    .. attribute:: ip_address

        The IP address of the user posting the comment.

    .. attribute:: is_public

        ``False`` if the comment is in moderation (see

        :doc:`/ref/contrib/comments/moderation`); If ``True``, the comment will

        be displayed on the site.

    .. attribute:: is_removed

        ``True`` if the comment was removed. Used to keep track of removed

        comments instead of just deleting them.