view web/hgbook/comments/models.py @ 737:9038da8b2d22

Merge with http://hg.serpentine.com/mercurial/book

from django.db import models
import sha

mutable = True

class Element(models.Model):
    class Admin:
        search_fields = ['id', 'chapter']
        list_filter = ['chapter', 'title']

    id = models.CharField('ID attribute', max_length=64, editable=False,
                          primary_key=True)
    chapter = models.CharField('Chapter ID', max_length=64, editable=False,
                               db_index=True)
    title = models.CharField('Section title', max_length=256, editable=False)

    def __unicode__(self):
        return self.id
    
class Comment(models.Model):
    class Admin:
        list_display = ['element', 'submitter_name', 'comment', 'reviewed',
                        'hidden', 'date']
        search_fields = ['comment']
        date_hierarchy = 'date'
        list_filter = ['date', 'submitter_name']
        search_fields = ['title', 'submitter_name', 'submitter_url']
        fields = (
            (None, {'fields': ('submitter_name', 'element', 'comment')}),
            ('Review and presentation state',
             {'fields': ('reviewed', 'hidden')}),
            ('Other info', {'fields': ('date', 'submitter_url', 'ip')}),
            )
            
    element = models.ForeignKey(Element,
        help_text='ID of paragraph that was commented on')
    comment = models.TextField(editable=mutable,
        help_text='Text of submitted comment (please do not modify)')
    submitter_name = models.CharField('Submitter', max_length=64,
        help_text='Self-reported name of submitter (may be bogus)')
    submitter_url = models.URLField('URL', blank=True, editable=mutable,
        help_text='Self-reported URL of submitter (may be empty or bogus)')
    ip = models.IPAddressField('IP address', editable=mutable,
        help_text='IP address from which comment was submitted')
    date = models.DateTimeField('date submitted', auto_now=True,
                                auto_now_add=True)
    reviewed = models.BooleanField(default=False, db_index=True,
        help_text='Has this comment been reviewed by an author?')
    hidden = models.BooleanField(default=False, db_index=True,
        help_text='Has this comment been hidden from public display?')

    def __unicode__(self):
        return self.comment[:32]

    def get_absolute_url(self):
        s = sha.new()
        s.update(repr(self.comment))
        s.update(repr(self.submitter_name))
        s.update(str(self.date))
        return '/read/%s.html#%s?comment=%s&uuid=%s' % (
            self.element.chapter, self.element.id, self.id, s.hexdigest()[:20]
            )