mirror of
https://github.com/django/django.git
synced 2024-12-25 18:46:22 +00:00
10e3faf191
It contained models, forms and admin objects causing undesirable import side effects. Refs #16368. Thanks to Ramiro, Carl and Loïc for the review.
92 lines
2.7 KiB
Plaintext
92 lines
2.7 KiB
Plaintext
===========================
|
|
The built-in comment models
|
|
===========================
|
|
|
|
.. module:: django.contrib.comments.models
|
|
:synopsis: The built-in comment models
|
|
|
|
.. warning::
|
|
|
|
Django's comment framework has been deprecated and is no longer supported.
|
|
Most users will be better served with a custom solution, or a hosted
|
|
product like Disqus__.
|
|
|
|
The code formerly known as ``django.contrib.comments`` is `still available
|
|
in an external repository`__.
|
|
|
|
__ https://disqus.com/
|
|
__ https://github.com/django/django-contrib-comments
|
|
|
|
.. class:: Comment
|
|
|
|
Django's built-in comment model. Has the following fields:
|
|
|
|
.. attribute:: content_object
|
|
|
|
A :class:`~django.contrib.contenttypes.fields.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.contenttypes.fields.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.
|