+from collections import Counter
+from datetime import date, timedelta
+import decimal
+import io
+import re
+from urllib.request import urlopen
from django.apps import apps
+from django.conf import settings
from django.db import models
+from django.template.loader import render_to_string
from django.urls import reverse
from django.utils.translation import gettext_lazy as _
+from admin_ordering.models import OrderableModel
from wikidata.client import Client
+from librarian import DCNS
+from librarian.cover import make_cover
+from librarian.dcparser import BookInfo, Person
from .constants import WIKIDATA
-from .utils import UnrelatedManager
-from .wikidata import WikidataMixin
+from .wikidata import WikidataModel
+from .wikimedia import WikiMedia
-class Author(WikidataMixin, models.Model):
+class Author(WikidataModel):
slug = models.SlugField(max_length=255, null=True, blank=True, unique=True)
- first_name = models.CharField(max_length=255, blank=True)
- last_name = models.CharField(max_length=255, blank=True)
+ first_name = models.CharField(_("first name"), max_length=255, blank=True)
+ last_name = models.CharField(_("last name"), max_length=255, blank=True)
+ genitive = models.CharField(
+ 'dopełniacz', max_length=255, blank=True,
+ help_text='utwory … (czyje?)'
+ )
+
+ name_de = models.CharField(_("name (de)"), max_length=255, blank=True)
+ name_lt = models.CharField(_("name (lt)"), max_length=255, blank=True)
- name_de = models.CharField(max_length=255, blank=True)
- name_lt = models.CharField(max_length=255, blank=True)
+ gender = models.CharField(_("gender"), max_length=255, blank=True)
+ nationality = models.CharField(_("nationality"), max_length=255, blank=True)
- gender = models.CharField(max_length=255, blank=True)
- nationality = models.CharField(max_length=255, blank=True)
- year_of_death = models.SmallIntegerField(null=True, blank=True)
+ year_of_birth = models.SmallIntegerField(_("year of birth"), null=True, blank=True)
+ year_of_birth_inexact = models.BooleanField(_("inexact"), default=False)
+ year_of_birth_range = models.SmallIntegerField(_("year of birth, range end"), null=True, blank=True)
+ date_of_birth = models.DateField(_("date_of_birth"), null=True, blank=True)
+ century_of_birth = models.SmallIntegerField(
+ _("century of birth"), null=True, blank=True,
+ help_text=_('Set if year unknown. Negative for BC.')
+ )
+ place_of_birth = models.ForeignKey(
+ 'Place', models.PROTECT, null=True, blank=True,
+ verbose_name=_('place of birth'),
+ related_name='authors_born'
+ )
+ year_of_death = models.SmallIntegerField(_("year of death"), null=True, blank=True)
+ year_of_death_inexact = models.BooleanField(_("inexact"), default=False)
+ year_of_death_range = models.SmallIntegerField(_("year of death, range end"), null=True, blank=True)
+ date_of_death = models.DateField(_("date_of_death"), null=True, blank=True)
+ century_of_death = models.SmallIntegerField(
+ _("century of death"), null=True, blank=True,
+ help_text=_('Set if year unknown. Negative for BC.')
+ )
+ place_of_death = models.ForeignKey(
+ 'Place', models.PROTECT, null=True, blank=True,
+ verbose_name=_('place of death'),
+ related_name='authors_died'
+ )
status = models.PositiveSmallIntegerField(
+ _("status"),
null=True,
blank=True,
choices=[
(4, _("Unknown")),
],
)
- notes = models.TextField(blank=True)
- gazeta_link = models.CharField(max_length=255, blank=True)
- culturepl_link = models.CharField(max_length=255, blank=True)
+ notes = models.TextField(_("notes"), blank=True, help_text=_('private'))
- description = models.TextField(blank=True)
- description_de = models.TextField(blank=True)
- description_lt = models.TextField(blank=True)
+ gazeta_link = models.CharField(_("gazeta link"), max_length=255, blank=True)
+ culturepl_link = models.CharField(_("culture.pl link"), max_length=255, blank=True)
+ plwiki = models.CharField(blank=True, max_length=255)
+ photo = models.ImageField(blank=True, null=True, upload_to='catalogue/author/')
+ photo_source = models.CharField(blank=True, max_length=255)
+ photo_attribution = models.CharField(max_length=255, blank=True)
+
+ description = models.TextField(_("description"), blank=True, help_text=_('for publication'))
priority = models.PositiveSmallIntegerField(
+ _("priority"),
default=0, choices=[(0, _("Low")), (1, _("Medium")), (2, _("High"))]
)
- collections = models.ManyToManyField("Collection", blank=True)
+ collections = models.ManyToManyField("Collection", blank=True, verbose_name=_("collections"))
+ woblink = models.IntegerField(null=True, blank=True)
+
class Meta:
verbose_name = _('author')
verbose_name_plural = _('authors')
class Wikidata:
first_name = WIKIDATA.GIVEN_NAME
last_name = WIKIDATA.LAST_NAME
+ date_of_birth = WIKIDATA.DATE_OF_BIRTH
+ year_of_birth = WIKIDATA.DATE_OF_BIRTH
+ place_of_birth = WIKIDATA.PLACE_OF_BIRTH
+ date_of_death = WIKIDATA.DATE_OF_DEATH
year_of_death = WIKIDATA.DATE_OF_DEATH
+ place_of_death = WIKIDATA.PLACE_OF_DEATH
gender = WIKIDATA.GENDER
- notes = "description"
+ notes = WikiMedia.append("description")
+ plwiki = "plwiki"
+ photo = WikiMedia.download(WIKIDATA.IMAGE)
+ photo_source = WikiMedia.descriptionurl(WIKIDATA.IMAGE)
+ photo_attribution = WikiMedia.attribution(WIKIDATA.IMAGE)
+
+ def _supplement(obj):
+ if not obj.first_name and not obj.last_name:
+ yield 'first_name', 'label'
def __str__(self):
- return f"{self.first_name} {self.last_name}"
+ name = f"{self.first_name} {self.last_name}"
+ if self.year_of_death is not None:
+ name += f' (zm. {self.year_of_death})'
+ return name
def get_absolute_url(self):
return reverse("catalogue_author", args=[self.slug])
+ @classmethod
+ def get_by_literal(cls, literal):
+ names = literal.split(',', 1)
+ names = [n.strip() for n in names]
+ if len(names) == 2:
+ return cls.objects.filter(last_name=names[0], first_name=names[1]).first()
+ else:
+ return cls.objects.filter(last_name_pl=names[0], first_name_pl='').first() or \
+ cls.objects.filter(first_name_pl=names[0], last_name_pl='').first() or \
+ cls.objects.filter(first_name_pl=literal, last_name_pl='').first() or \
+ cls.objects.filter(first_name_pl=literal, last_name_pl=None).first()
+
+ @property
+ def name(self):
+ return f"{self.last_name}, {self.first_name}"
+
@property
def pd_year(self):
if self.year_of_death:
else:
return None
+ def generate_description(self):
+ t = render_to_string(
+ 'catalogue/author_description.html',
+ {'obj': self}
+ )
+ return t
+
+ def century_description(self, number):
+ n = abs(number)
+ letters = ''
+ while n > 10:
+ letters += 'X'
+ n -= 10
+ if n == 9:
+ letters += 'IX'
+ n = 0
+ elif n >= 5:
+ letters += 'V'
+ n -= 5
+ if n == 4:
+ letters += 'IV'
+ n = 0
+ letters += 'I' * n
+ letters += ' w.'
+ if number < 0:
+ letters += ' p.n.e.'
+ return letters
+
+ def birth_century_description(self):
+ return self.century_description(self.century_of_birth)
+
+ def death_century_description(self):
+ return self.century_description(self.century_of_death)
+
+ def year_description(self, number):
+ n = abs(number)
+ letters = str(n)
+ letters += ' r.'
+ if number < 0:
+ letters += ' p.n.e.'
+ return letters
+
+ def year_of_birth_description(self):
+ return self.year_description(self.year_of_birth)
+ def year_of_death_description(self):
+ return self.year_description(self.year_of_death)
+
+
+class NotableBook(OrderableModel):
+ author = models.ForeignKey(Author, models.CASCADE)
+ book = models.ForeignKey('Book', models.CASCADE)
+
+ def __str__(self):
+ return self.book.title
+
-class Category(WikidataMixin, models.Model):
- name = models.CharField(max_length=255)
+class Category(WikidataModel):
+ name = models.CharField(_("name"), max_length=255)
slug = models.SlugField(max_length=255, unique=True)
+ description = models.TextField(_("description"), blank=True, help_text=_('for publication'))
class Meta:
abstract = True
+ def __str__(self):
+ return self.name
+
class Epoch(Category):
+ adjective_feminine_singular = models.CharField(
+ 'przymiotnik pojedynczy żeński', max_length=255, blank=True,
+ help_text='twórczość … Adama Mickiewicza'
+ )
+ adjective_nonmasculine_plural = models.CharField(
+ 'przymiotnik mnogi niemęskoosobowy', max_length=255, blank=True,
+ help_text='utwory … Adama Mickiewicza'
+ )
+
class Meta:
verbose_name = _('epoch')
verbose_name_plural = _('epochs')
class Genre(Category):
+ thema = models.CharField(
+ max_length=32, blank=True,
+ help_text='Odpowiadający kwalifikator Thema.'
+ )
+ plural = models.CharField(
+ 'liczba mnoga', max_length=255, blank=True,
+ )
+ is_epoch_specific = models.BooleanField(
+ default=False,
+ help_text='Po wskazaniu tego gatunku, dodanie epoki byłoby nadmiarowe, np. „dramat romantyczny”'
+ )
+
class Meta:
verbose_name = _('genre')
verbose_name_plural = _('genres')
class Kind(Category):
+ collective_noun = models.CharField(
+ 'określenie zbiorowe', max_length=255, blank=True,
+ help_text='np. „Liryka” albo „Twórczość dramatyczna”'
+ )
+
class Meta:
verbose_name = _('kind')
verbose_name_plural = _('kinds')
-class Book(WikidataMixin, models.Model):
+class Book(WikidataModel):
slug = models.SlugField(max_length=255, blank=True, null=True, unique=True)
- authors = models.ManyToManyField(Author, blank=True)
+ parent = models.ForeignKey('self', models.SET_NULL, null=True, blank=True)
+ parent_number = models.IntegerField(null=True, blank=True)
+ authors = models.ManyToManyField(Author, blank=True, verbose_name=_("authors"))
translators = models.ManyToManyField(
Author,
related_name="translated_book_set",
related_query_name="translated_book",
blank=True,
+ verbose_name=_("translators")
)
- epochs = models.ManyToManyField(Epoch, blank=True)
- kinds = models.ManyToManyField(Kind, blank=True)
- genres = models.ManyToManyField(Genre, blank=True)
- title = models.CharField(max_length=255, blank=True)
- language = models.CharField(max_length=255, blank=True)
+ epochs = models.ManyToManyField(Epoch, blank=True, verbose_name=_("epochs"))
+ kinds = models.ManyToManyField(Kind, blank=True, verbose_name=_("kinds"))
+ genres = models.ManyToManyField(Genre, blank=True, verbose_name=_("genres"))
+ title = models.CharField(_("title"), max_length=255, blank=True)
+ language = models.CharField(_("language"), max_length=255, blank=True)
based_on = models.ForeignKey(
- "self", models.PROTECT, related_name="translation", null=True, blank=True
+ "self", models.PROTECT, related_name="translation", null=True, blank=True,
+ verbose_name=_("based on")
)
- scans_source = models.CharField(max_length=255, blank=True)
- text_source = models.CharField(max_length=255, blank=True)
- notes = models.TextField(blank=True)
+ scans_source = models.CharField(_("scans source"), max_length=255, blank=True)
+ text_source = models.CharField(_("text source"), max_length=255, blank=True)
+ notes = models.TextField(_("notes"), blank=True, help_text=_('private'))
priority = models.PositiveSmallIntegerField(
+ _("priority"),
default=0, choices=[(0, _("Low")), (1, _("Medium")), (2, _("High"))]
)
- pd_year = models.IntegerField(null=True, blank=True)
- gazeta_link = models.CharField(max_length=255, blank=True)
- collections = models.ManyToManyField("Collection", blank=True)
+ original_year = models.IntegerField(_('original publication year'), null=True, blank=True)
+ pd_year = models.IntegerField(_('year of entry into PD'), null=True, blank=True)
+ plwiki = models.CharField(blank=True, max_length=255)
+ gazeta_link = models.CharField(_("gazeta link"), max_length=255, blank=True)
+ collections = models.ManyToManyField("Collection", blank=True, verbose_name=_("collections"))
+
+ estimated_chars = models.IntegerField(_("estimated number of characters"), null=True, blank=True)
+ estimated_verses = models.IntegerField(_("estimated number of verses"), null=True, blank=True)
+ estimate_source = models.CharField(_("source of estimates"), max_length=2048, blank=True)
+
+ free_license = models.BooleanField(_('free license'), default=False)
+ polona_missing = models.BooleanField(_('missing on Polona'), default=False)
- objects = UnrelatedManager()
+ cover = models.FileField(blank=True, upload_to='catalogue/cover')
+ monthly_views_reader = models.IntegerField(default=0)
+ monthly_views_page = models.IntegerField(default=0)
+
class Meta:
ordering = ("title",)
verbose_name = _('book')
verbose_name_plural = _('books')
class Wikidata:
+ plwiki = "plwiki"
authors = WIKIDATA.AUTHOR
translators = WIKIDATA.TRANSLATOR
title = WIKIDATA.TITLE
language = WIKIDATA.LANGUAGE
based_on = WIKIDATA.BASED_ON
- notes = "description"
+ original_year = WIKIDATA.PUBLICATION_DATE
+ notes = WikiMedia.append("description")
def __str__(self):
txt = self.title
+ if self.original_year:
+ txt = f"{txt} ({self.original_year})"
astr = self.authors_str()
if astr:
- txt = f"{astr} – {txt}"
+ txt = f"{txt}, {astr}"
tstr = self.translators_str()
if tstr:
- txt = f"{txt} (tłum. {tstr})"
+ txt = f"{txt}, tłum. {tstr}"
return txt
+ def build_cover(self):
+ width, height = 212, 300
+ # TODO: BookInfo shouldn't be required to build a cover.
+ info = BookInfo(rdf_attrs={}, dc_fields={
+ DCNS('creator'): [Person('Mickiewicz', 'Adam')],
+ DCNS('title'): ['Ziutek'],
+ DCNS('date'): ['1900-01-01'],
+ DCNS('publisher'): ['F'],
+ DCNS('language'): ['pol'],
+ DCNS('identifier.url'): ['test'],
+ DCNS('rights'): ['-'],
+ })
+ cover = make_cover(info, width=width, height=height)
+ out = io.BytesIO()
+ ext = cover.ext()
+ cover.save(out)
+ self.cover.save(f'{self.slug}.{ext}', out, save=False)
+ type(self).objects.filter(pk=self.pk).update(cover=self.cover)
+
def get_absolute_url(self):
return reverse("catalogue_book", args=[self.slug])
+
+ def is_text_public(self):
+ return self.free_license or (self.pd_year is not None and self.pd_year <= date.today().year)
+
+ def audio_status(self):
+ return {}
+
+ @property
+ def wluri(self):
+ return f'https://wolnelektury.pl/katalog/lektura/{self.slug}/'
def authors_str(self):
+ if not self.pk:
+ return ''
return ", ".join(str(author) for author in self.authors.all())
+ authors_str.admin_order_field = 'authors__last_name'
+ authors_str.short_description = _('Author')
def translators_str(self):
+ if not self.pk:
+ return ''
return ", ".join(str(author) for author in self.translators.all())
+ translators_str.admin_order_field = 'translators__last_name'
+ translators_str.short_description = _('Translator')
+
+ def authors_first_names(self):
+ return ', '.join(a.first_name for a in self.authors.all())
+
+ def authors_last_names(self):
+ return ', '.join(a.last_name for a in self.authors.all())
- def get_document_books(self):
- DBook = apps.get_model("documents", "Book")
- return DBook.objects.filter(dc_slug=self.slug)
+ def translators_first_names(self):
+ return ', '.join(a.first_name for a in self.translators.all())
+
+ def translators_last_names(self):
+ return ', '.join(a.last_name for a in self.translators.all())
+
+ def document_book__project(self):
+ b = self.document_books.first()
+ if b is None: return ''
+ if b.project is None: return ''
+ return b.project.name
+
+ def audience(self):
+ try:
+ return self.document_books.first().wldocument().book_info.audience or ''
+ except:
+ return ''
+
+ def get_estimated_costs(self):
+ return {
+ work_type: work_type.calculate(self)
+ for work_type in WorkType.objects.all()
+ }
+
+ def scans_galleries(self):
+ return [bs.pk for bs in self.booksource_set.all()]
+
+ def is_published(self):
+ return any(b.is_published() for b in self.document_books.all())
+
+ def update_monthly_stats(self):
+ # Find publication date.
+ # By default, get previous 12 months.
+ this_month = date.today().replace(day=1)
+ cutoff = this_month.replace(year=this_month.year - 1)
+ months = 12
+
+ # If the book was published later,
+ # find out the denominator.
+ pbr = apps.get_model('documents', 'BookPublishRecord').objects.filter(
+ book__catalogue_book=self).order_by('timestamp').first()
+ if pbr is not None and pbr.timestamp.date() > cutoff:
+ months = (this_month - pbr.timestamp.date()).days / 365 * 12
+
+ if not months:
+ return
+
+ stats = self.bookmonthlystats_set.filter(date__gte=cutoff).aggregate(
+ views_page=models.Sum('views_page'),
+ views_reader=models.Sum('views_reader')
+ )
+ self.monthly_views_page = stats['views_page'] / months
+ self.monthly_views_reader = stats['views_reader'] / months
+ self.save(update_fields=['monthly_views_page', 'monthly_views_reader'])
+
+ @property
+ def content_stats(self):
+ if hasattr(self, '_content_stats'):
+ return self._content_stats
+ try:
+ stats = self.document_books.first().wldocument(librarian2=True).get_statistics()['total']
+ except Exception as e:
+ stats = {}
+ self._content_stats = stats
+ return stats
+
+ @property
+ def are_sources_ready(self):
+ if not self.booksource_set.exists():
+ return False
+ for bs in self.booksource_set.all():
+ if not bs.source.has_view_files() or not bs.source.has_ocr_files() or bs.source.modified_at > bs.source.processed_at:
+ return False
+ return True
+
+ chars = lambda self: self.content_stats.get('chars', '')
+ chars_with_fn = lambda self: self.content_stats.get('chars_with_fn', '')
+ words = lambda self: self.content_stats.get('words', '')
+ words_with_fn = lambda self: self.content_stats.get('words_with_fn', '')
+ verses = lambda self: self.content_stats.get('verses', '')
+ verses_with_fn = lambda self: self.content_stats.get('verses_with_fn', '')
+ chars_out_verse = lambda self: self.content_stats.get('chars_out_verse', '')
+ chars_out_verse_with_fn = lambda self: self.content_stats.get('chars_out_verse_with_fn', '')
+
+
+class EditorNote(models.Model):
+ book = models.ForeignKey(Book, models.CASCADE)
+ user = models.ForeignKey(settings.AUTH_USER_MODEL, models.CASCADE)
+ created_at = models.DateTimeField(auto_now_add=True)
+ changed_at = models.DateTimeField(auto_now=True)
+ note = models.TextField(blank=True)
+ rate = models.IntegerField(default=3, choices=[
+ (n, n) for n in range(1, 6)
+ ])
+
+
+class CollectionCategory(models.Model):
+ name = models.CharField(_("name"), max_length=255)
+ parent = models.ForeignKey('self', models.SET_NULL, related_name='children', null=True, blank=True, verbose_name=_("parent"))
+ notes = models.TextField(_("notes"), blank=True, help_text=_('private'))
+
+ class Meta:
+ ordering = ('parent__name', 'name')
+ verbose_name = _('collection category')
+ verbose_name_plural = _('collection categories')
+
+ def __str__(self):
+ if self.parent:
+ return f"{self.parent} / {self.name}"
+ else:
+ return self.name
class Collection(models.Model):
- name = models.CharField(max_length=255)
+ name = models.CharField(_("name"), max_length=255)
slug = models.SlugField(max_length=255, unique=True)
+ category = models.ForeignKey(CollectionCategory, models.SET_NULL, null=True, blank=True, verbose_name=_("category"))
+ notes = models.TextField(_("notes"), blank=True, help_text=_('private'))
+ description = models.TextField(_("description"), blank=True)
class Meta:
+ ordering = ('category', 'name')
verbose_name = _('collection')
verbose_name_plural = _('collections')
+ def __str__(self):
+ if self.category:
+ return f"{self.category} / {self.name}"
+ else:
+ return self.name
+
+ def get_estimated_costs(self):
+ costs = Counter()
+ for book in self.book_set.all():
+ for k, v in book.get_estimated_costs().items():
+ costs[k] += v or 0
+
+ for author in self.author_set.all():
+ for book in author.book_set.all():
+ for k, v in book.get_estimated_costs().items():
+ costs[k] += v or 0
+ for book in author.translated_book_set.all():
+ for k, v in book.get_estimated_costs().items():
+ costs[k] += v or 0
+ return costs
+
+
+class WorkType(models.Model):
+ name = models.CharField(_("name"), max_length=255)
+
+ class Meta:
+ ordering = ('name',)
+ verbose_name = _('work type')
+ verbose_name_plural = _('work types')
+
+ def get_rate_for(self, book):
+ for workrate in self.workrate_set.all():
+ if workrate.matches(book):
+ return workrate
+
+ def calculate(self, book):
+ workrate = self.get_rate_for(book)
+ if workrate is not None:
+ return workrate.calculate(book)
+
+
+
+class WorkRate(models.Model):
+ priority = models.IntegerField(_("priority"), default=1)
+ per_normpage = models.DecimalField(_("per normalized page"), decimal_places=2, max_digits=6, null=True, blank=True)
+ per_verse = models.DecimalField(_("per verse"), decimal_places=2, max_digits=6, null=True, blank=True)
+ work_type = models.ForeignKey(WorkType, models.CASCADE, verbose_name=_("work type"))
+ epochs = models.ManyToManyField(Epoch, blank=True, verbose_name=_("epochs"))
+ kinds = models.ManyToManyField(Kind, blank=True, verbose_name=_("kinds"))
+ genres = models.ManyToManyField(Genre, blank=True, verbose_name=_("genres"))
+ collections = models.ManyToManyField(Collection, blank=True, verbose_name=_("collections"))
+
+ class Meta:
+ ordering = ('priority',)
+ verbose_name = _('work rate')
+ verbose_name_plural = _('work rates')
+
+ def matches(self, book):
+ for category in 'epochs', 'kinds', 'genres', 'collections':
+ oneof = getattr(self, category).all()
+ if oneof:
+ if not set(oneof).intersection(
+ getattr(book, category).all()):
+ return False
+ return True
+
+ def calculate(self, book):
+ if self.per_verse:
+ if book.estimated_verses:
+ return book.estimated_verses * self.per_verse
+ elif self.per_normpage:
+ if book.estimated_chars:
+ return (decimal.Decimal(book.estimated_chars) / 1800 * self.per_normpage).quantize(decimal.Decimal('1.00'), rounding=decimal.ROUND_HALF_UP)
+
+
+class Place(WikidataModel):
+ name = models.CharField(_('name'), max_length=255, blank=True)
+ locative = models.CharField(_('locative'), max_length=255, blank=True, help_text=_('in…'))
+
+ class Meta:
+ verbose_name = _('place')
+ verbose_name_plural = _('places')
+
+ class Wikidata:
+ name = 'label'
+
def __str__(self):
return self.name
+
+class BookMonthlyStats(models.Model):
+ book = models.ForeignKey('catalogue.Book', models.CASCADE)
+ date = models.DateField()
+ views_reader = models.IntegerField(default=0)
+ views_page = models.IntegerField(default=0)
+
+ @classmethod
+ def build_for_month(cls, date):
+ date = date.replace(day=1)
+ period = 'month'
+
+ date = date.isoformat()
+ url = f'{settings.PIWIK_URL}?date={date}&filter_limit=-1&format=CSV&idSite={settings.PIWIK_WL_SITE_ID}&language=pl&method=Actions.getPageUrls&module=API&period={period}&segment=&token_auth={settings.PIWIK_TOKEN}&flat=1'
+ data = urlopen(url).read().decode('utf-16')
+ lines = data.split('\n')[1:]
+ for line in lines:
+ m = re.match('^/katalog/lektura/([^,./]+)\.html,', line)
+ if m is not None:
+ which = 'views_reader'
+ else:
+ m = re.match('^/katalog/lektura/([^,./]+)/,', line)
+ if m is not None:
+ which = 'views_page'
+ if m is not None:
+ slug = m.group(1)
+ _url, _uviews, views, _rest = line.split(',', 3)
+ views = int(views)
+ try:
+ book = Book.objects.get(slug=slug)
+ except Book.DoesNotExist:
+ continue
+ else:
+ cls.objects.update_or_create(
+ book=book, date=date,
+ defaults={which: views}
+ )
+ book.update_monthly_stats()
+
+
+class Thema(models.Model):
+ code = models.CharField(
+ max_length=128, unique=True,
+ help_text='Używamy rozszerzenia <code>.WL-</code> do oznaczania własnych kodów.<br> '
+ 'Przykładowo, w przypadku potrzeby stworzenia nowej kategorii „insurekcja kościuszkowska”, '
+ 'można by ją utworzyć jako 3MLQ‑PL‑A.WL-A, czyli w ramach już istniejącej wyższej kategorii 3MLQ‑PL‑A „rozbiory Polski”.',
+ )
+ name = models.CharField(max_length=1024)
+ slug = models.SlugField(
+ max_length=255, null=True, blank=True, unique=True,
+ help_text='Element adresu na WL, w postaci: /tag/slug/. Można zmieniać.'
+ )
+ plural = models.CharField(
+ 'liczba mnoga', max_length=255, blank=True,
+ )
+ description = models.TextField(blank=True)
+ public_description = models.TextField(blank=True)
+ usable = models.BooleanField()
+ usable_as_main = models.BooleanField(default=False)
+ hidden = models.BooleanField(default=False)
+ woblink_category = models.IntegerField(null=True, blank=True)
+
+ class Meta:
+ ordering = ('code',)
+ verbose_name_plural = 'Thema'
+
+
+class Audience(models.Model):
+ code = models.CharField(
+ max_length=128, unique=True,
+ help_text='Techniczny identifyikator. W miarę możliwości nie należy zmieniać.'
+ )
+ name = models.CharField(
+ max_length=1024,
+ help_text='W formie: „dla … (kogo?)”'
+ )
+ slug = models.SlugField(
+ max_length=255, null=True, blank=True, unique=True,
+ help_text='Element adresu na WL, w postaci: /dla/slug/. Można zmieniać.'
+ )
+ description = models.TextField(blank=True)
+ thema = models.CharField(
+ max_length=32, blank=True,
+ help_text='Odpowiadający kwalifikator Thema.'
+ )
+ woblink = models.IntegerField(null=True, blank=True)
+
+ class Meta:
+ ordering = ('code',)