blog

from django.utils import translation

from django.template.defaultfilters import slugify

from django.db import models

import datetime

import os

def post_title_directory(instance, filename):

    """ Files will be uploaded to MEDIA_ROOT/blog/<year of publishing>/<blog

    title>

    The blog title is determined by the text before the first period (".") in

    the filename. So if the file has the name "Trains are bæ.en.md", the file

    will be stored in "blog/<this year>/Trains are bæ". Name your files

    properly!

    It should also be noted that all files are stored in the same folder if they

    belong to the same blogpost, regardless of language. The titles that are

    displayed to the user however, should be the titles of the files themselves,

    which should be in the native language. So if a blog post is titled

    "Universities of Belgium", its Dutch counterpart should be titled

    "Universiteiten van België", so the correct title can be derived from the

    filename.

    Recommended way to name the uploaded file: "<name of blog post in language

    it's written>.org". This removes the maximum amount of redundancy (e.g. the

    language of the file can be derived from the title, no ".fr.org" or something

    like that necessary), and can directly be used for the end user (the title

    is what should be displayed).

    """

    english_file_name = os.path.basename(instance.english_file.name) # TODO: Test if this returns the file name!

    english_title = english_file_name.rpartition(".")[0]

    year = datetime.date.today().year

    return "blog/{0}/{1}/{2}".format(year, english_title, filename)

class Post(models.Model):

    """ Represents a blog post. The title of the blog post is determnined by the name

    of the files.

    A blog post can be in 5 different languages: German, Spanish, English, French,

    and Dutch. For all these languages, a seperate field exists. Thus, a

    translated blog post has a seperate file for each translation, and is

    seperated from Django's internationalization/localization system.

    Only the English field is mandatory. The others may contain a value if a

    translated version exists, which will be displayed accordingly.

    """

    published = models.DateTimeField(auto_now_add=True)

    english_file = models.FileField(upload_to=post_title_directory, unique=True, blank=False)

    dutch_file = models.FileField(upload_to=post_title_directory, blank=True)

    french_file = models.FileField(upload_to=post_title_directory, blank=True)

    german_file = models.FileField(upload_to=post_title_directory, blank=True)

    spanish_file = models.FileField(upload_to=post_title_directory, blank=True)

    # Only the English file can be unique, because apparantly, there can't be

    # two blank fields in a unique column. Okay then.

    def __str__(self):

        return self.slug("en")

    def slug(self, language_code=translation.get_language()):

        """ Returns a slug of the requested language, or None if no version exists in that language. """

        possibilities = {

            "en" : self.english_file,

            "de" : self.german_file,

            "nl" : self.dutch_file,

            "fr" : self.french_file,

            "es" : self.spanish_file,

            }

        if possibilities[language_code]:

            return slugify(os.path.basename(possibilities[language_code].name).rpartition(".")[0])

        else:

            return None

class Comment(models.Model):

    """ Represents a comment on a blog post.

    Comments are not linked to an account or anything, I'm trusting the

    commenter that he is honest with his credentials. That being said:

    XXX: Remember to put up a notification that comments are not checked for

    identity, and, unless verified by a trustworthy source, cannot be seen as

    being an actual statement from the commenter.

    Comments are linked to a blogpost, and are not filtered by language. (So a

    comment made by someone reading the article in Dutch, that's written in

    Dutch, will show up (unedited) for somebody whom's reading the Spanish

    version.

    XXX: Remember to notify (tiny footnote or something) that comments showing

    up in a foreign language is by design, and not a bug.

    """

    date = models.DateTimeField(auto_now_add=True)

    name = models.CharField(max_length=64)

    text = models.TextField(max_length=1000)  # Should be more than enough.

    post = models.ForeignKey(

        Post,

        on_delete=Models.CASCADE,

        )

    class meta:

        ordering = ['date']  # When printed, prints the oldest comment first.