update librarian
[wolnelektury.git] / src / catalogue / models / fragment.py
1 # -*- coding: utf-8 -*-
2 # This file is part of Wolnelektury, licensed under GNU Affero GPLv3 or later.
3 # Copyright © Fundacja Nowoczesna Polska. See NOTICE for more information.
4 #
5 from django.conf import settings
6 from django.contrib.contenttypes.fields import GenericRelation
7 from django.core.urlresolvers import reverse
8 from django.db import models
9 from django.utils.translation import ugettext_lazy as _
10 from newtagging import managers
11 from catalogue.models import Tag
12 from ssify import flush_ssi_includes
13
14
15 class Fragment(models.Model):
16     """Represents a themed fragment of a book."""
17     text = models.TextField()
18     short_text = models.TextField(editable=False)
19     anchor = models.CharField(max_length=120)
20     book = models.ForeignKey('Book', related_name='fragments')
21
22     objects = models.Manager()
23     tagged = managers.ModelTaggedItemManager(Tag)
24     tags = managers.TagDescriptor(Tag)
25     tag_relations = GenericRelation(Tag.intermediary_table_model)
26
27     short_html_url_name = 'catalogue_fragment_short'
28
29     class Meta:
30         ordering = ('book', 'anchor',)
31         verbose_name = _('fragment')
32         verbose_name_plural = _('fragments')
33         app_label = 'catalogue'
34
35     def get_absolute_url(self):
36         return '%s#m%s' % (reverse('book_text', args=[self.book.slug]), self.anchor)
37
38     def get_short_text(self):
39         """Returns short version of the fragment."""
40         return self.short_text if self.short_text else self.text
41
42     def flush_includes(self, languages=True):
43         if not languages:
44             return
45         if languages is True:
46             languages = [lc for (lc, _ln) in settings.LANGUAGES]
47         flush_ssi_includes([
48             template % (self.pk, lang)
49             for template in [
50                 '/katalog/f/%d/short.%s.html',
51                 '/api/include/fragment/%d.%s.json',
52                 '/api/include/fragment/%d.%s.xml',
53                 ]
54             for lang in languages
55             ])