django-magazine also has another model which the documentation does not refer to, since it will be removed soon - BookReview. This model was relevant to one particular use case of django-magazine, but is unlikely to be useful to most people.
There are 3 main models in django-magazine: Issue, Article and Author. An Issue is made up of Articles, each of which by at least one Author.
Issues have three main properties: number, date, and whether or not it is published.
|Issue Number:||These are intended to be used as sequential issue numbers, and must be unique.|
|Date:||This is the publication date of the issue - note that an issue
is only considered published if this is on or before the
current date, and the published flag is
|Published:||Used for creating draft issues - you can safely mark an issue with a date in the future as published - it will only be publically accessible once the publication date is reached.|
Sometimes it’s useful to just show teasers of content - perhaps for very recent content, or for old content, perhaps to encourage users to subscribe to a dead-tree version. At present, this functionality isn’t very fleshed out (it just shows teaser content to everyone other than site staff), in future, I’m hoping this will take into account the current user, to allow showing full content if you’re logged in, for example.
There are two settings relevant to this feature:
|Set to a function which takes an
If an issue is embargoed, a teaser will be shown. The teaser is either the article’s description, or the first 50 words of the article.
Articles are the content of magazines. Each article belongs to an issue, and is by one or more authors.
Articles are ordered within an issue, based on the value of
order_in_issue (articles with lower values are shown first).
Article text will be cleaned up automatically with bleach, which
strips out bad HTML that tends to be added by programs like
Microsoft Word. The only allowed tags are those set by