cleanup comments
[wolnelektury.git] / src / catalogue / views.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 collections import OrderedDict
6 import re
7 import random
8
9 from django.conf import settings
10 from django.template import RequestContext
11 from django.template.loader import render_to_string
12 from django.shortcuts import render_to_response, get_object_or_404, render, redirect
13 from django.http import HttpResponse, HttpResponseRedirect, Http404, HttpResponsePermanentRedirect, JsonResponse
14 from django.core.urlresolvers import reverse
15 from django.db.models import Q
16 from django.contrib.auth.decorators import login_required, user_passes_test
17 from django.utils.http import urlquote_plus
18 from django.utils import translation
19 from django.utils.translation import ugettext as _, ugettext_lazy
20
21 from ajaxable.utils import AjaxableFormView
22 from pdcounter.models import BookStub, Author
23 from pdcounter import views as pdcounter_views
24 from picture.models import Picture, PictureArea
25 from ssify import ssi_included, ssi_expect, SsiVariable as Var
26 from suggest.forms import PublishingSuggestForm
27 from catalogue import constants
28 from catalogue import forms
29 from catalogue.helpers import get_top_level_related_tags
30 from catalogue.models import Book, Collection, Tag, Fragment
31 from catalogue.utils import split_tags
32
33 staff_required = user_passes_test(lambda user: user.is_staff)
34
35
36 def catalogue(request):
37     return render(request, 'catalogue/catalogue.html', {
38         'books': Book.objects.filter(parent=None),
39         'pictures': Picture.objects.all(),
40         'collections': Collection.objects.all(),
41         'active_menu_item': 'all_works',
42     })
43
44
45 def book_list(request, filters=None, template_name='catalogue/book_list.html',
46               nav_template_name='catalogue/snippets/book_list_nav.html',
47               list_template_name='catalogue/snippets/book_list.html'):
48     """ generates a listing of all books, optionally filtered """
49     books_by_author, orphans, books_by_parent = Book.book_list(filters)
50     books_nav = OrderedDict()
51     for tag in books_by_author:
52         if books_by_author[tag]:
53             books_nav.setdefault(tag.sort_key[0], []).append(tag)
54     # WTF: dlaczego nie include?
55     return render_to_response(template_name, {
56         'rendered_nav': render_to_string(nav_template_name, {'books_nav': books_nav}),
57         'rendered_book_list': render_to_string(list_template_name, {
58             'books_by_author': books_by_author,
59             'orphans': orphans,
60             'books_by_parent': books_by_parent,
61         })
62     }, context_instance=RequestContext(request))
63
64
65 def daisy_list(request):
66     return book_list(request, Q(media__type='daisy'), template_name='catalogue/daisy_list.html')
67
68
69 def collection(request, slug):
70     coll = get_object_or_404(Collection, slug=slug)
71     return render(request, 'catalogue/collection.html', {'collection': coll})
72
73
74 def differentiate_tags(request, tags, ambiguous_slugs):
75     beginning = '/'.join(tag.url_chunk for tag in tags)
76     unparsed = '/'.join(ambiguous_slugs[1:])
77     options = []
78     for tag in Tag.objects.filter(slug=ambiguous_slugs[0]):
79         options.append({
80             'url_args': '/'.join((beginning, tag.url_chunk, unparsed)).strip('/'),
81             'tags': [tag]
82         })
83     return render_to_response(
84         'catalogue/differentiate_tags.html', {'tags': tags, 'options': options, 'unparsed': ambiguous_slugs[1:]},
85         context_instance=RequestContext(request))
86
87
88 def object_list(request, objects, fragments=None, related_tags=None, tags=None, list_type='books', extra=None):
89     if not tags:
90         tags = []
91     tag_ids = [tag.pk for tag in tags]
92
93     related_tag_lists = []
94     if related_tags:
95         related_tag_lists.append(related_tags)
96     else:
97         related_tag_lists.append(
98             Tag.objects.usage_for_queryset(objects, counts=True).exclude(category='set').exclude(pk__in=tag_ids))
99     if not (extra and extra.get('theme_is_set')):
100         if fragments is None:
101             if list_type == 'gallery':
102                 fragments = PictureArea.objects.filter(picture__in=objects)
103             else:
104                 fragments = Fragment.objects.filter(book__in=objects)
105         related_tag_lists.append(
106             Tag.objects.usage_for_queryset(fragments, counts=True).filter(category='theme').exclude(pk__in=tag_ids))
107
108     categories = split_tags(*related_tag_lists)
109
110     objects = list(objects)
111     if len(objects) > 3:
112         best = random.sample(objects, 3)
113     else:
114         best = objects
115
116     result = {
117         'object_list': objects,
118         'categories': categories,
119         'list_type': list_type,
120         'tags': tags,
121
122         'formats_form': forms.DownloadFormatsForm(),
123         'best': best,
124         'active_menu_item': list_type,
125     }
126     if extra:
127         result.update(extra)
128     return render_to_response(
129         'catalogue/tagged_object_list.html', result,
130         context_instance=RequestContext(request))
131
132
133 def literature(request):
134     books = Book.objects.filter(parent=None)
135
136     last_published = Book.objects.exclude(cover_thumb='').filter(parent=None).order_by('-created_at')[:20]
137     most_popular = Book.objects.exclude(cover_thumb='')\
138                        .order_by('-popularity__count', 'sort_key_author', 'sort_key')[:20]
139     return object_list(request, books, related_tags=get_top_level_related_tags([]), extra={
140         'last_published': last_published,
141         'most_popular': most_popular,
142     })
143
144
145 def gallery(request):
146     return object_list(request, Picture.objects.all(), list_type='gallery')
147
148
149 def audiobooks(request):
150     audiobooks = Book.objects.filter(media__type__in=('mp3', 'ogg')).distinct()
151     return object_list(request, audiobooks, list_type='audiobooks', extra={
152         'daisy': Book.objects.filter(media__type='daisy').distinct(),
153     })
154
155
156 class ResponseInstead(Exception):
157     def __init__(self, response):
158         super(ResponseInstead, self).__init__()
159         self.response = response
160
161
162 def analyse_tags(request, tag_str):
163     try:
164         tags = Tag.get_tag_list(tag_str)
165     except Tag.DoesNotExist:
166         # Perhaps the user is asking about an author in Public Domain
167         # counter (they are not represented in tags)
168         chunks = tag_str.split('/')
169         if len(chunks) == 2 and chunks[0] == 'autor':
170             raise ResponseInstead(pdcounter_views.author_detail(request, chunks[1]))
171         else:
172             raise Http404
173     except Tag.MultipleObjectsReturned, e:
174         # Ask the user to disambiguate
175         raise ResponseInstead(differentiate_tags(request, e.tags, e.ambiguous_slugs))
176     except Tag.UrlDeprecationWarning, e:
177         raise ResponseInstead(HttpResponsePermanentRedirect(
178             reverse('tagged_object_list', args=['/'.join(tag.url_chunk for tag in e.tags)])))
179
180     try:
181         if len(tags) > settings.MAX_TAG_LIST:
182             raise Http404
183     except AttributeError:
184         pass
185
186     return tags
187
188
189 def theme_list(request, tags, list_type):
190     shelf_tags = [tag for tag in tags if tag.category == 'set']
191     fragment_tags = [tag for tag in tags if tag.category != 'set']
192     if list_type == 'gallery':
193         fragments = PictureArea.tagged.with_all(fragment_tags)
194     else:
195         fragments = Fragment.tagged.with_all(fragment_tags)
196
197     if shelf_tags:
198         # TODO: Pictures on shelves not supported yet.
199         books = Book.tagged.with_all(shelf_tags).order_by()
200         fragments = fragments.filter(Q(book__in=books) | Q(book__ancestor__in=books))
201
202     if not fragments and len(tags) == 1:
203         tag = tags[0]
204         if tag.category == 'theme' and (
205                 PictureArea.tagged.with_any([tag]).exists() or
206                 Picture.tagged.with_any([tag]).exists()):
207             return redirect('tagged_object_list_gallery', '/'.join(tag.url_chunk for tag in tags))
208
209     return object_list(request, fragments, tags=tags, list_type=list_type, extra={
210         'theme_is_set': True,
211         'active_menu_item': 'theme',
212     })
213
214
215 def tagged_object_list(request, tags, list_type):
216     try:
217         tags = analyse_tags(request, tags)
218     except ResponseInstead as e:
219         return e.response
220
221     if list_type == 'gallery' and any(tag.category == 'set' for tag in tags):
222         raise Http404
223
224     if any(tag.category == 'theme' for tag in tags):
225         return theme_list(request, tags, list_type=list_type)
226
227     if list_type == 'books':
228         books = Book.tagged.with_all(tags)
229
230         if any(tag.category == 'set' for tag in tags):
231             params = {'objects': books}
232         else:
233             params = {
234                 'objects': Book.tagged_top_level(tags),
235                 'fragments': Fragment.objects.filter(book__in=books),
236                 'related_tags': get_top_level_related_tags(tags),
237             }
238     elif list_type == 'gallery':
239         params = {'objects': Picture.tagged.with_all(tags)}
240     elif list_type == 'audiobooks':
241         audiobooks = Book.objects.filter(media__type__in=('mp3', 'ogg')).distinct()
242         params = {
243             'objects': Book.tagged.with_all(tags, audiobooks),
244             'extra': {
245                 'daisy': Book.tagged.with_all(tags, audiobooks.filter(media__type='daisy').distinct()),
246             }
247         }
248     else:
249         raise Http404
250
251     return object_list(request, tags=tags, list_type=list_type, **params)
252
253
254 def book_fragments(request, slug, theme_slug):
255     book = get_object_or_404(Book, slug=slug)
256     theme = get_object_or_404(Tag, slug=theme_slug, category='theme')
257     fragments = Fragment.tagged.with_all([theme]).filter(
258         Q(book=book) | Q(book__ancestor=book))
259
260     return render_to_response('catalogue/book_fragments.html', {
261         'book': book,
262         'theme': theme,
263         'fragments': fragments,
264     }, context_instance=RequestContext(request))
265
266
267 def book_detail(request, slug):
268     try:
269         book = Book.objects.get(slug=slug)
270     except Book.DoesNotExist:
271         return pdcounter_views.book_stub_detail(request, slug)
272
273     return render_to_response('catalogue/book_detail.html', {
274         'book': book,
275         'tags': book.tags.exclude(category__in=('set', 'theme')),
276         'book_children': book.children.all().order_by('parent_number', 'sort_key'),
277     }, context_instance=RequestContext(request))
278
279
280 def get_audiobooks(book):
281     ogg_files = {}
282     for m in book.media.filter(type='ogg').order_by().iterator():
283         ogg_files[m.name] = m
284
285     audiobooks = []
286     have_oggs = True
287     projects = set()
288     for mp3 in book.media.filter(type='mp3').iterator():
289         # ogg files are always from the same project
290         meta = mp3.extra_info
291         project = meta.get('project')
292         if not project:
293             # temporary fallback
294             project = u'CzytamySłuchając'
295
296         projects.add((project, meta.get('funded_by', '')))
297
298         media = {'mp3': mp3}
299
300         ogg = ogg_files.get(mp3.name)
301         if ogg:
302             media['ogg'] = ogg
303         else:
304             have_oggs = False
305         audiobooks.append(media)
306
307     projects = sorted(projects)
308     return audiobooks, projects, have_oggs
309
310
311 # używane w publicznym interfejsie
312 def player(request, slug):
313     book = get_object_or_404(Book, slug=slug)
314     if not book.has_media('mp3'):
315         raise Http404
316
317     audiobooks, projects, have_oggs = get_audiobooks(book)
318
319     return render_to_response('catalogue/player.html', {
320         'book': book,
321         'audiobook': '',
322         'audiobooks': audiobooks,
323         'projects': projects,
324     }, context_instance=RequestContext(request))
325
326
327 def book_text(request, slug):
328     book = get_object_or_404(Book, slug=slug)
329
330     if not book.has_html_file():
331         raise Http404
332     return render_to_response('catalogue/book_text.html', {'book': book,}, context_instance=RequestContext(request))
333
334
335 # ==========
336 # = Search =
337 # ==========
338
339 def _no_diacritics_regexp(query):
340     """ returns a regexp for searching for a query without diacritics
341
342     should be locale-aware """
343     names = {
344         u'a': u'aąĄ', u'c': u'cćĆ', u'e': u'eęĘ', u'l': u'lłŁ', u'n': u'nńŃ', u'o': u'oóÓ', u's': u'sśŚ',
345         u'z': u'zźżŹŻ',
346         u'ą': u'ąĄ', u'ć': u'ćĆ', u'ę': u'ęĘ', u'ł': u'łŁ', u'ń': u'ńŃ', u'ó': u'óÓ', u'ś': u'śŚ', u'ź': u'źŹ',
347         u'ż': u'żŻ'
348         }
349
350     def repl(m):
351         l = m.group()
352         return u"(%s)" % '|'.join(names[l])
353
354     return re.sub(u'[%s]' % (u''.join(names.keys())), repl, query)
355
356
357 def unicode_re_escape(query):
358     """ Unicode-friendly version of re.escape """
359     return re.sub(r'(?u)(\W)', r'\\\1', query)
360
361
362 def _word_starts_with(name, prefix):
363     """returns a Q object getting models having `name` contain a word
364     starting with `prefix`
365
366     We define word characters as alphanumeric and underscore, like in JS.
367
368     Works for MySQL, PostgreSQL, Oracle.
369     For SQLite, _sqlite* version is substituted for this.
370     """
371     kwargs = {}
372
373     prefix = _no_diacritics_regexp(unicode_re_escape(prefix))
374     # can't use [[:<:]] (word start),
375     # but we want both `xy` and `(xy` to catch `(xyz)`
376     kwargs['%s__iregex' % name] = u"(^|[^[:alnum:]_])%s" % prefix
377
378     return Q(**kwargs)
379
380
381 def _word_starts_with_regexp(prefix):
382     prefix = _no_diacritics_regexp(unicode_re_escape(prefix))
383     return ur"(^|(?<=[^\wąćęłńóśźżĄĆĘŁŃÓŚŹŻ]))%s" % prefix
384
385
386 def _sqlite_word_starts_with(name, prefix):
387     """ version of _word_starts_with for SQLite
388
389     SQLite in Django uses Python re module
390     """
391     kwargs = {'%s__iregex' % name: _word_starts_with_regexp(prefix)}
392     return Q(**kwargs)
393
394
395 if hasattr(settings, 'DATABASES'):
396     if settings.DATABASES['default']['ENGINE'] == 'django.db.backends.sqlite3':
397         _word_starts_with = _sqlite_word_starts_with
398 elif settings.DATABASE_ENGINE == 'sqlite3':
399     _word_starts_with = _sqlite_word_starts_with
400
401
402 class App:
403     def __init__(self, name, view):
404         self.name = name
405         self._view = view
406         self.lower = name.lower()
407         self.category = 'application'
408
409     def view(self):
410         return reverse(*self._view)
411
412 _apps = (
413     App(u'Leśmianator', (u'lesmianator', )),
414     )
415
416
417 def _tags_starting_with(prefix, user=None):
418     prefix = prefix.lower()
419     # PD counter
420     book_stubs = BookStub.objects.filter(_word_starts_with('title', prefix))
421     authors = Author.objects.filter(_word_starts_with('name', prefix))
422
423     books = Book.objects.filter(_word_starts_with('title', prefix))
424     tags = Tag.objects.filter(_word_starts_with('name', prefix))
425     if user and user.is_authenticated():
426         tags = tags.filter(~Q(category='set') | Q(user=user))
427     else:
428         tags = tags.exclude(category='set')
429
430     prefix_regexp = re.compile(_word_starts_with_regexp(prefix))
431     return list(books) + list(tags) + [app for app in _apps if prefix_regexp.search(app.lower)] + list(book_stubs) + \
432         list(authors)
433
434
435 def _get_result_link(match, tag_list):
436     if isinstance(match, Tag):
437         return reverse('catalogue.views.tagged_object_list',
438                        kwargs={'tags': '/'.join(tag.url_chunk for tag in tag_list + [match])})
439     elif isinstance(match, App):
440         return match.view()
441     else:
442         return match.get_absolute_url()
443
444
445 def _get_result_type(match):
446     if isinstance(match, Book) or isinstance(match, BookStub):
447         match_type = 'book'
448     else:
449         match_type = match.category
450     return match_type
451
452
453 def books_starting_with(prefix):
454     prefix = prefix.lower()
455     return Book.objects.filter(_word_starts_with('title', prefix))
456
457
458 def find_best_matches(query, user=None):
459     """ Finds a Book, Tag, BookStub or Author best matching a query.
460
461     Returns a with:
462       - zero elements when nothing is found,
463       - one element when a best result is found,
464       - more then one element on multiple exact matches
465
466     Raises a ValueError on too short a query.
467     """
468
469     query = query.lower()
470     if len(query) < 2:
471         raise ValueError("query must have at least two characters")
472
473     result = tuple(_tags_starting_with(query, user))
474     # remove pdcounter stuff
475     book_titles = set(match.pretty_title().lower() for match in result
476                       if isinstance(match, Book))
477     authors = set(match.name.lower() for match in result
478                   if isinstance(match, Tag) and match.category == 'author')
479     result = tuple(res for res in result if not (
480                  (isinstance(res, BookStub) and res.pretty_title().lower() in book_titles) or
481                  (isinstance(res, Author) and res.name.lower() in authors)
482              ))
483
484     exact_matches = tuple(res for res in result if res.name.lower() == query)
485     if exact_matches:
486         return exact_matches
487     else:
488         return tuple(result)[:1]
489
490
491 def search(request):
492     tags = request.GET.get('tags', '')
493     prefix = request.GET.get('q', '')
494
495     try:
496         tag_list = Tag.get_tag_list(tags)
497     except (Tag.DoesNotExist, Tag.MultipleObjectsReturned, Tag.UrlDeprecationWarning):
498         tag_list = []
499
500     try:
501         result = find_best_matches(prefix, request.user)
502     except ValueError:
503         return render_to_response(
504             'catalogue/search_too_short.html', {'tags': tag_list, 'prefix': prefix},
505             context_instance=RequestContext(request))
506
507     if len(result) == 1:
508         return HttpResponseRedirect(_get_result_link(result[0], tag_list))
509     elif len(result) > 1:
510         return render_to_response(
511             'catalogue/search_multiple_hits.html',
512             {
513                 'tags': tag_list, 'prefix': prefix,
514                 'results': ((x, _get_result_link(x, tag_list), _get_result_type(x)) for x in result)
515             },
516             context_instance=RequestContext(request))
517     else:
518         form = PublishingSuggestForm(initial={"books": prefix + ", "})
519         return render_to_response(
520             'catalogue/search_no_hits.html',
521             {'tags': tag_list, 'prefix': prefix, "pubsuggest_form": form},
522             context_instance=RequestContext(request))
523
524
525 def tags_starting_with(request):
526     prefix = request.GET.get('q', '')
527     # Prefix must have at least 2 characters
528     if len(prefix) < 2:
529         return HttpResponse('')
530     tags_list = []
531     result = ""
532     for tag in _tags_starting_with(prefix, request.user):
533         if tag.name not in tags_list:
534             result += "\n" + tag.name
535             tags_list.append(tag.name)
536     return HttpResponse(result)
537
538
539 def json_tags_starting_with(request, callback=None):
540     # Callback for JSONP
541     prefix = request.GET.get('q', '')
542     callback = request.GET.get('callback', '')
543     # Prefix must have at least 2 characters
544     if len(prefix) < 2:
545         return HttpResponse('')
546     tags_list = []
547     for tag in _tags_starting_with(prefix, request.user):
548         if tag.name not in tags_list:
549             tags_list.append(tag.name)
550     if request.GET.get('mozhint', ''):
551         result = [prefix, tags_list]
552     else:
553         result = {"matches": tags_list}
554     response = JsonResponse(result, safe=False)
555     if callback:
556         response.content = callback + "(" + response.content + ");"
557     return response
558
559
560 # =========
561 # = Admin =
562 # =========
563 @login_required
564 @staff_required
565 def import_book(request):
566     """docstring for import_book"""
567     book_import_form = forms.BookImportForm(request.POST, request.FILES)
568     if book_import_form.is_valid():
569         try:
570             book_import_form.save()
571         except:
572             import sys
573             import pprint
574             import traceback
575             info = sys.exc_info()
576             exception = pprint.pformat(info[1])
577             tb = '\n'.join(traceback.format_tb(info[2]))
578             return HttpResponse(
579                     _("An error occurred: %(exception)s\n\n%(tb)s") % {'exception': exception, 'tb': tb},
580                     mimetype='text/plain')
581         return HttpResponse(_("Book imported successfully"))
582     else:
583         return HttpResponse(_("Error importing file: %r") % book_import_form.errors)
584
585
586 # info views for API
587
588 def book_info(request, book_id, lang='pl'):
589     book = get_object_or_404(Book, id=book_id)
590     # set language by hand
591     translation.activate(lang)
592     return render_to_response('catalogue/book_info.html', {'book': book}, context_instance=RequestContext(request))
593
594
595 def tag_info(request, tag_id):
596     tag = get_object_or_404(Tag, id=tag_id)
597     return HttpResponse(tag.description)
598
599
600 def download_zip(request, format, slug=None):
601     if format in Book.ebook_formats:
602         url = Book.zip_format(format)
603     elif format in ('mp3', 'ogg') and slug is not None:
604         book = get_object_or_404(Book, slug=slug)
605         url = book.zip_audiobooks(format)
606     else:
607         raise Http404('No format specified for zip package')
608     return HttpResponseRedirect(urlquote_plus(settings.MEDIA_URL + url, safe='/?='))
609
610
611 class CustomPDFFormView(AjaxableFormView):
612     form_class = forms.CustomPDFForm
613     title = ugettext_lazy('Download custom PDF')
614     submit = ugettext_lazy('Download')
615     honeypot = True
616
617     def __call__(self, *args, **kwargs):
618         if settings.NO_CUSTOM_PDF:
619             raise Http404('Custom PDF is disabled')
620         return super(CustomPDFFormView, self).__call__(*args, **kwargs)
621
622     def form_args(self, request, obj):
623         """Override to parse view args and give additional args to the form."""
624         return (obj,), {}
625
626     def get_object(self, request, slug, *args, **kwargs):
627         return get_object_or_404(Book, slug=slug)
628
629     def context_description(self, request, obj):
630         return obj.pretty_title()
631
632
633 ####
634 # Includes
635 ####
636
637
638 @ssi_included
639 def book_mini(request, pk, with_link=True):
640     book = get_object_or_404(Book, pk=pk)
641     author_str = ", ".join(tag.name for tag in book.tags.filter(category='author'))
642     return render(request, 'catalogue/book_mini_box.html', {
643         'book': book,
644         'author_str': author_str,
645         'with_link': with_link,
646         'show_lang': book.language_code() != settings.LANGUAGE_CODE,
647     })
648
649
650 @ssi_included(get_ssi_vars=lambda pk: (lambda ipk: (
651         ('ssify.get_csrf_token',),
652         ('social_tags.likes_book', (ipk,)),
653         ('social_tags.book_shelf_tags', (ipk,)),
654     ))(ssi_expect(pk, int)))
655 def book_short(request, pk):
656     book = get_object_or_404(Book, pk=pk)
657     stage_note, stage_note_url = book.stage_note()
658     audiobooks, projects, have_oggs = get_audiobooks(book)
659
660     return render(request, 'catalogue/book_short.html', {
661         'book': book,
662         'has_audio': book.has_media('mp3'),
663         'main_link': book.get_absolute_url(),
664         'parents': book.parents(),
665         'tags': split_tags(book.tags.exclude(category__in=('set', 'theme'))),
666         'show_lang': book.language_code() != settings.LANGUAGE_CODE,
667         'stage_note': stage_note,
668         'stage_note_url': stage_note_url,
669         'audiobooks': audiobooks,
670         'have_oggs': have_oggs,
671     })
672
673
674 @ssi_included(
675     get_ssi_vars=lambda pk: book_short.get_ssi_vars(pk) +
676     (lambda ipk: (
677         ('social_tags.choose_cite', [ipk]),
678         ('catalogue_tags.choose_fragment', [ipk], {
679             'unless': Var('social_tags.choose_cite', [ipk])}),
680     ))(ssi_expect(pk, int)))
681 def book_wide(request, pk):
682     book = get_object_or_404(Book, pk=pk)
683     stage_note, stage_note_url = book.stage_note()
684     extra_info = book.extra_info
685     audiobooks, projects, have_oggs = get_audiobooks(book)
686
687     return render(request, 'catalogue/book_wide.html', {
688         'book': book,
689         'has_audio': book.has_media('mp3'),
690         'parents': book.parents(),
691         'tags': split_tags(book.tags.exclude(category__in=('set', 'theme'))),
692         'show_lang': book.language_code() != settings.LANGUAGE_CODE,
693         'stage_note': stage_note,
694         'stage_note_url': stage_note_url,
695
696         'main_link': reverse('book_text', args=[book.slug]) if book.html_file else None,
697         'extra_info': extra_info,
698         'hide_about': extra_info.get('about', '').startswith('http://wiki.wolnepodreczniki.pl'),
699         'audiobooks': audiobooks,
700         'have_oggs': have_oggs,
701     })
702
703
704 @ssi_included
705 def fragment_short(request, pk):
706     fragment = get_object_or_404(Fragment, pk=pk)
707     return render(request, 'catalogue/fragment_short.html', {'fragment': fragment})
708
709
710 @ssi_included
711 def fragment_promo(request, pk):
712     fragment = get_object_or_404(Fragment, pk=pk)
713     return render(request, 'catalogue/fragment_promo.html', {'fragment': fragment})
714
715
716 @ssi_included
717 def tag_box(request, pk):
718     tag = get_object_or_404(Tag, pk=pk)
719     assert tag.category != 'set'
720
721     return render(request, 'catalogue/tag_box.html', {
722         'tag': tag,
723     })
724
725
726 @ssi_included
727 def collection_box(request, pk):
728     obj = get_object_or_404(Collection, pk=pk)
729
730     return render(request, 'catalogue/collection_box.html', {
731         'obj': obj,
732     })
733
734
735 def tag_catalogue(request, category):
736     if category == 'theme':
737         tags = Tag.objects.usage_for_model(
738             Fragment, counts=True).filter(category='theme')
739     else:
740         tags = list(get_top_level_related_tags((), categories=(category,)))
741
742     described_tags = [tag for tag in tags if tag.description]
743
744     if len(described_tags) > 4:
745         best = random.sample(described_tags, 4)
746     else:
747         best = described_tags
748
749     return render(request, 'catalogue/tag_catalogue.html', {
750         'tags': tags,
751         'best': best,
752         'title': constants.CATEGORIES_NAME_PLURAL[category],
753         'whole_category': constants.WHOLE_CATEGORY[category],
754         'active_menu_item': 'theme' if category == 'theme' else None,
755     })
756
757
758 def collections(request):
759     objects = Collection.objects.all()
760
761     if len(objects) > 3:
762         best = random.sample(objects, 3)
763     else:
764         best = objects
765
766     return render(request, 'catalogue/collections.html', {
767         'objects': objects,
768         'best': best,
769     })