History: ArticleDoc

Articles and submissions are one of the central features of the TikiWiki CMS. With articles you can build the foundation for a site like those constructed using CMSs systems like PHPNuke or Postnuke with the added advantages of Tiki. There are three structural components for the Articles sub-system: Topics, Articles and Submissions.

• Topics - Each item belongs to one, and only one, topic. You can also assign multiple categories to each item.
• Article - The actual content item that gets displayed, commented on, etc.
• Submission - This is an article that hasn't been approved yet by an authorized admin.

There are currently 3 different article types:

• Article - Normal type, only displays in "Article Home" after the publication date.
• Review - Articles with reader-added ratings. Only displays in "Article Home" after the publication date.
• Event - Used for showing upcoming events or to automatically remove content from your site. Events display until the "Publication/Event Date". Switching the type between article and event should cause it to appear and disappear from the Article Home page. (Note: Events are a v1.8 feature)

Articles and submissions are classified in topics. You can edit topics from the admin topics screen. Note: You must create a topic before anyone can submit an article!

In the admin topics screen you can add and remove topics or you can activate / deactivate topics without removing them. You also can click the perms link to assign permissions to the topic.

The permissions for topic works as follows:

• If no permission is assigned to the topic then everybody can read articles or reviews in this topic.
• If the tiki_p_read_topic permission is assigned for the topic only the groups with the permission can view the topic and other users won t see content in the topic (Articles, reviews,etc). This can be used to manage private topics that only users in some groups can read.

As a user this is a simple menu. You can visit the Articles Home, see a list of articles, view Rankings, send a submission or view active submissions. Of course, what you can or can't do and what you see in this menu is configurable.

If you are admin click the Edit article link in the admin menu to enter a new article.

This is the screen where you can edit and existing article or create a new article, we ll examine each field in detail:

• Title - The article title
• Author Name - The name of the author as it will appear in the article (you can use any name here).
• Topic - The topic to which the article is assigned. If you don't see options in the select box for topics then you must first create a topic. Use the admin topics link in the admin menu to create a topic and then go back to the edit article screen.
• Type is the type of article to use.
• Rating - This only shows up for Review articles. Assign a numerical rating to whatever you are reviewing.
• Own Image - Articles can have an associated image. If you want your article to have an associated image you can upload an image using the Own Image field.
• Use own image - By default the article will display the topic image (each topic has an image), if you want the article to display its own image instead of the topic image, check the Use own image checkbox.
• Float text around image - Well, do you want the text to float around the image?
• Own image size x and Own image size y - Allows you to adjust the display size of the article image.
• Apply template - To use this, you must have the "Use templates" box checked in the CMS admin page. Any templates created in the Content template section with the "use in cms:" box checked will show up in this drop down list.
• Categorize - Assign categories for this article.
• Heading and Body - The heading and the body are self explanatory. Use the Wiki Tag System here as if you were editing a Wiki Page. If you want to use HTML in the article make sure that the AllowHTML option is checked at the bottom.
• Publish/Event Date - Set the publishing date for the article. This affects when the article is visible on the Articles Home page.
• Allow HTML - Check this box to allow HTML content in the Heading or Body.

The Articles Home displays the last 'n' articles of the CMS system. 'N' can be configured from the admin menu. This page can be set up as the Tiki Home Page from the admin screen if you want to use Tiki as if it were a normal CMS system.

insert graphic

You will see each article displayed showing the heading and a link to read more where you can read the whole article:

insert graphic

You can also filter the list of articles shown here by:

• type (article, review)
• topic (numeric id)
• find (a string to search for in the title, heading or body)

[tiki-view_articles.php?type=review]

or, only articles with the word "Tiki" in them with:

[tiki-view_articles.php?type=article&find=Tiki]

You can also change the sort order from the default (newest to oldest) with the "sort_mode" option. For example, to list upcoming events in order of occurrance, use:

tiki-view_articles.php?sort_mode=publishDate_asc&type=Event

The list articles section shows a list of articles.

insert graphic

You can sort the list by any column, you can filter articles containing some word and if you have the permissions you will se options to edit, read or remove the article. This screen is useful for administrators as well as regular users.

insert graphic

In the Rankings page you will access to rankings for the CMS system such as Top Articles, Top Authors, etc. You have to select the ranking to display and the number of records to display and click the view button to see the ranking.

insert graphic

Submitting and article is the same as editing an article with the difference that the result will be stored as a submission and not published inmediately as an article. The process to edit and send a submission is the same as editing and article so you should read about editing articles if you haven t to find out.

insert graphic

You will a list of submissions and if you have the permissions yoy may see links to edit, remove or approve a submission. Once a submission is approved it becomes an article.

The following permissions can be configured for articles and submissions:

insert graphic (or table)

The tiki_p_admin_cms permission is a master permission that automatically includes the other 7 permissions in this listing. You can use it to have a group of users that can admin the whole articles/.submissions system without the need of assigning each permission to the group.

View Articles

Dennis Heltzel

ArticleDev
ArticleAdmin
Topic
ToDelete_TopicDoc
TopicDev
TopicAdmin
Type
ToDelete_TypeDoc
TypeDev
TypeAdmin