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