The Zine Module is an application for creating and managing (e-)Zines. A Zine is simply a collection of articles, and an article is a piece of text with a certain set of attributes, including at the very least, an author and a title. For example:
There are four fundamental classes of article:
In a very general sense, all of these are treated as "articles" at a low level.
Before you can create articles, you must have some zines to place them in. The zine type determines the basic rules of zine behaviour, such as how indexes are displayed, whether you can add comments, and so on.
Managing your zines typically consists of adding articles, deleting or disabling comments, and occasionally adding or reconfiguring your zines. There are two ways to access your zines as an administrator:
Administration functions are described below. Two icons are shown, a simple GIF and a full-colour PNG. Which one you see will depend on system configuration:
Add a new article.
Edit an existing article. This includes changing the article status so that it is not displayed (eg. moderation).
Reconfigure an article. This includes changing some of the special configuration rules noted above.
Delete an article.
Note that you will have these options for every zine, article, and comment in the system. To add a new article to a zine, be sure to click the icon under the zine; if you click the icon under an existing article, you will be creating a new article nested underneath the existing article (ie. a subindex).
You may also see the the public/user-level functions, namely:
Add a comment.
Reply to another comment.
Enter or exit the archives.
Get an RSS feed of this zine.
Users who have recently added a comment may also have the option to edit their comments. The option to edit comments only exists for a few minutes before the comment is frozen; this is so that comments do not get out of sync with their replies.
When creating, editing, and configuring articles, you will be able to enter data for many of the following fields. (Which fields you see will depend on the zine or article type.)
|Author||The author of an article, if different from the owner.|
|Name||A simple browser-friendly version of the article title, used in URLs. This field will be set automatically if it is left blank, but you can set it manually if you want more control.|
|Title||The full, human-friendly title of the zine or article. For comments, this is the subject line.|
|Subtitle||Optional subtitle, for articles that require more complicated title structures.|
|Summary||An optional outline or abstract for the article. A summary will be automatically generated if you do not provide one. (The automatic summary consists of the first 50 words or so of the article.)|
|Article||The full body of the article or comment. For normal articles and zines, it will default to a rich-text HTML editor, but can be switched to a plain-text input box. For comments, it will default to a plain text input box.|
|Content-type||Sets whether to treat the article contents as HTML (no further markup required) or text (will require some extra markup for display in browsers).|
|Footnotes||Optional; displayed at the bottom of the article. Can be used for footnotes, attributions, copyright notices, etc.|
|Sortkey||For sorted indexes, the articles will be sorted based on this sortkey.|
|Picture||An optional image can be uploaded, and will be displayed at the top of the article (float right, if there appears to be room). This is also the primary content of photoblogs and photoforums.|
|Thumbnail||Thumbnailed version of the picture, above. The thumbnail is usually generated automatically.|
|Caption||A caption for the picture.|
|Site||For zines, this sets which site owns (and therefore may display) the zine. If no site is set, it may be displayed by all sites.|
|Owner||This sets which user owns the zine and may access the administration functions. If not set, the site adminsitrator is the owner.|
Note that you will see many of these fields for the zine itself, as well as for the articles that go into the zine. In the case of the zine itself, the values will be used to format a "preamble" for the zine index. For example, you could have an e-zine with the following values:
|Footnotes||All news stories are Â© 2007 by Acme Corp.|
This information would be placed at the head of all indexes into this zine, as if it was an article without any body text. For example:
All news stories are Â© 2007 by Acme Corp.
News Article #1
News Article #2