History: Article User

            !Using Articles


!!The Articles menu
~tc~^{img src=img/wiki_up//ArticlesUser1-menu.png align=center}^~/tc~
For the site user, a simple menu is available. You can visit the Articles Home, see a list of articles, view Rankings, send a submission or view active submissions. Of course, what the registered user can or can't do and  see in the menu is configurable.
 
A site administator can click the "New article" link in admin menu to create a new article. 

!!Editing or Submitting Articles
~tc~This is the screen where you can edit an existing article or create a new article, we'll examine each field in detail: 

^{img src=img/wiki_up//ArticlesUser6-submit-edit.png desc="Note: Screenshot is out of date and doesn't show all of the items listed below."}^
~/tc~
* __Topline__ - A kind of "teaser" line above the article title (small text size)
* __Title__ - The article title
* __Subtitle__ - Extra title information
* __Source (url)__ - If appropriate or useful, a reference link can be specified. This displays at the end of the article.
* __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 create (i.e., article, review, etc.).
* __Rating__ - This only shows up for review-type articles. A numerical rating can be assigned to whatever is being reviewed.
* __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. If the article has no image but the topic has an image the article will be displayed with the topic image
* __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__ - Select this to have text wrap around the image.  The image will be on the left side with text starting to the right of it if there is room.  If this is not selected the text will begin under the image. In the example below, the first image is floated, the second is not. The same behavior applies in view mode or list mode.
::{img fileId="298" thumb="y" alt="" rel="box[g]" styleimage=border} ::
* __Own image size x__ and __Own image size y__ - Allows you to adjust the display size of the article image.  Specifying only an "x" size will scale the image with a similar vertical/horizontal ratio. 
* __ List mode image width__ - allows you to display the image in a different scale when viewing a list of articles in a smaller scale  and when viewing the article. (tiki>=6.0)
* __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__ - The heading isn't a heading in a typographical sense, but rather is the opening paragraph(s) of text. On the main articles page and when articles are displayed with the Articles plugin, the article heading text displays and is followed by the "Read more" link if the article also has a body section.
*__Body__ - This is the main section of text that becomes available when the "Read more" link is followed (and also when the URL is for the article itself). In both the article heading and body, you can use the wiki syntax, plugins, etc. the same as when 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.
* __Folksonomy Tags__ - Also known as Freetags or Tags, one or more of these can be entered for free-from categorization.

Finally, use the __preview__ function as many times as you want to preview and edit the article.  Make sure you click save before navigating away from the page.

!!Articles Home
The Articles Home displays the articles most recently added to the Tiki.  system. The number of articles displayed on Articles Home can be configured from the ((General Admin)) CMS admin page. Articles Home can be set up as the Tiki Home Page from the admin screen if you want to use Tiki as a CMS system.

^{img src=img/wiki_up//ArticlesUser2-home.png}^

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

^{picture file=img/wiki_up//ArticlesUser3-readmore.png}^

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)

For example, you could make a Wiki link to a page showing only "reviews" with this:
{CODE()}[tiki-view_articles.php?type=review]{CODE}
or, only articles with the word "Tiki" in them with:
{CODE()}[tiki-view_articles.php?type=article&find=Tiki]{CODE}
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

!!List Articles 
The list articles section shows a list of articles.

^{img src=img/wiki_up//ArticlesUser4-list.png}^

This list can be sorted by any column.  Articles can be filtered by keyword. If you have the proper permissions you will see options to edit, read or remove articles in the actions column.

!!Rankings
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. 

^{img src=img/wiki_up//ArticlesUser5-rankings.png}^

!!Submit Article
Submitting an 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 above articles if you haven't to find out. 

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

^{img src=img/wiki_up//ArticlesUser7-submission-ed.png}^

In the __Action__ column, holding your mouse over the icons will indicate which action they will perform.