J1.5

Difference between revisions of "Hands-on adding a new article: Joomla! 1.5"

From Joomla! Documentation

 
(79 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{incomplete}}
+
{{version/tutor|1.5}}{{:Getting Started Page Index/1.5}}
{{RightTOC}}
+
The aim of this document is to work through, hands-on,  creating a new article using the Front-end of the Joomla! web site.
This is a 'hands-on' tutorial which shows how to create a new article.
+
=== Who is it written for?===
When a new article is 'published' it can continue to be edited and worked on - see the hands-on tutorials about editing in this Manual.  
+
:*'''Everyone'''
== Introduction==
+
You also need:
:*You need access to a Joomla! site
+
:* access to a Joomla! site
:*As with editing - you need to be logged in with a username with an appropriate level of permission
+
:* to be logged in with a username with an appropriate level of permission
  
In addition:-
+
====Background: Publishing and editing permissions====
:*You need to know where the new Article is to be located
+
 
 +
There are some restrictions on what different groups of people adding content are allowed to do. There are three group (apart from administrators who can do anything with content), called '''Authors, Editors and Publishers'''. Authors can only edit their own material and cannot get their work seen on the site (published) themselves. In summary:-
  
::If you are using an existing site, you need to be told which Section and Category it will be assigned to. This depends on the organisation of the Web site.
+
:* '''Authors, Editors and Publishers''' can create and alter articles
 +
:* '''Authors cannot 'publish' articles''' - which means that they do not display until someone with publish permissions has ticked the right box.
 +
:* '''Editors''' can edit unpublished articles
 +
:* '''Publishers''' can see a tick-box (which shows whether an Article is Published) when they edit or create an article - so they can publish their own, and other peoples', articles.
 +
:* '''Editors and Publishers''' can edit documents that they did not create.
  
<div style="border:thin solid green; margin-left:50px; background: #f5f5f5;  width: 80%;">
+
To get an Article published depends on the way the site is managed. Publishing is often done by the site Adminstrator. If you are an Author you are likely to need to ask for it to be published before you can do more work on it but Editors can continue to edit before it is published.
About Sections and Categories: briefly.
 
  
</div>
+
More about Permissions in Joomla! 1.5 here:- [[How permissions work in Joomla! 1.5 |Permissions in a Joomla! Site]]
  
 
== Starting a new article ==
 
== Starting a new article ==
Line 21: Line 25:
  
 
'''Either:'''<br/>
 
'''Either:'''<br/>
:Many sites have a USER MENU with several options about things users might want to do. (It is not always called a USER MENU  - it depends on the site!). One of the common options is to Submit an Article (Sometimes called Create an Article). If this option is available - use it.
+
:Many sites have a USER MENU with several options about things users might want to do. (It is not always called a USER MENU  - it depends on the site!). One of the common options is to Submit an Article (Sometimes called Create an Article). If this option is available - use it:-
 
 
<div style="border:thin solid red; margin-left:50px;  width: 50%;">
 
screen shot of the user menu from the sample site
 
</div>
 
 
:Find the USER MENU
 
:Find the USER MENU
 +
::Click on Submit an Article
  
::Click on Create an article
+
[[Image:GSusermenu.png|frame|center|'''A User Menu with the option to start a new Article, called here Submit an Article. Sometimes this option is under the Main Menu.''']]
  
 
'''Or:'''<br/>
 
'''Or:'''<br/>
 
:Sometimes the site has been set up to show  a small icon [[Image:new.png]] that looks like a sheet of paper at the bottom of many of the list pages. (This icon does not appear on pages with just one article - it does appear on pages where there is a list of articles.)
 
:Sometimes the site has been set up to show  a small icon [[Image:new.png]] that looks like a sheet of paper at the bottom of many of the list pages. (This icon does not appear on pages with just one article - it does appear on pages where there is a list of articles.)
 
 
::Click on the New Article icon [[Image:new.png]]
 
::Click on the New Article icon [[Image:new.png]]
 
===Adding content===
 
===Adding content===
Line 40: Line 40:
  
 
===Saving your work===
 
===Saving your work===
Before saving a new article for the first time, you need to enter some more information in the Publisher section of the editor.
+
Before saving a new article for the first time, you need to enter some information in the Publishing section of the editor, including whether it is published and where it is to be located.
:*If you have publisher permissions, type a few lines and then go to the Publisher part of the editor before you Save it. You will then be able to continue editing.
+
 
:*If you are an author it is worth typing quite a bit of content at this stage before adding the details in the Publisher part of the editor. This is because you will not be able to return to editing, after it has been saved, until it has been published.
+
====Where will the Article be located?====
Both publishers and authors need to know which Menu the Article will be in after it has been saved.
+
:*You need to know where the new Article is to be located
 +
::This depends on the organisation of the Web site. If you are using an existing site, you need to be told which Section and Category it will be assigned to. Or it may be uncategorised, but you need to know that this is the case.
 +
::You will also need to know which menu it will be located under. Again this information varies with the way the Menus are set up and the layout of the Site.
 +
 
 +
{{ref|There is detail about Sections and Categories in this series of documents - [[Design the content: Sections and Categories: Joomla! 1.5|Background:  Sections and Categories]]}}
  
  
 +
:*If you are a Publisher, type a few lines and then go to the Publishing part of the editor and Save it. You will then be able to continue editing.
 +
:*If you are an Author it is worth typing quite a bit of content at this stage before adding the details in the Publishing part of the editor. This is because you will not be able to return to editing until it has been published.
 +
:*If you are an Editor, you can continue to edit the article after it has been saved, even when it is not published.
  
===The Publishing section of the editor===
+
===The Publishing part of the editor===
This is an important part of Submit an Article because it is here that vasrious options are set - including the location of the Article and an option to publish it.
+
:*Scroll down to the Publishing section.
 +
You must make a number of choices about where the new Article will be located and who will be able to read it.
  
<div style="border:thin solid red; margin-left:50px;  width: 50%;">
+
[[Image:GSpublisherpart.png|frame|center|'''Here the user has Publishing permissions so the choice for Published is displayed.''']]
screen shot of the Publishing section
 
  
</div>
+
Getting the Section and Category correct usually means that it will display in the right place. The choice of Section and Category will depend on those available on the site you are using.
  
The Publishing section is below the editing screen. Here you must make a number of choices about where the new Article will be located and who will be able to read it:-
+
[[Image:GSpublisherpart3.png|frame|center|''' This is the Sample data in 'localhost' and shows the Section and Category chosen. ''']]
  
:*Choose a Section for the article -  
+
::'''Section:''' choose from the pull-down list
:*Choose a Category -
+
::'''Category:''' the choices depend on the Section chosen
:*Choose Yes to make sure it is Published
+
::'''Published:''' Leave this as Yes. This choice is not available if you are an Author
:*Choose the right Access level (Registered means that it can be seen by people who have logged in but do not have any write access.)
+
::'''Front Page:''' leave this as No. The exception would be if you are writing an Article for the Front page which is in 'Blog' layout format.
 +
::'''Access Level:''' choose the appropriate one for your site.
  
If the article is going to be displayed in one of the pages that lists content - getting the Section and Category correct means that it will display in the right place without further effort on your part.
+
<div style="border:thin solid green; margin:15px 15% 15px 15%; background: #f5f5f5;  width: 70%; padding:8px;">'''Access Level:'''
 +
*'''Public''' means that anyone visiting the Web site can read it.
 +
*'''Registered''' means that people who have logged in but do not have any write access can read it.
 +
*'''Special''' means that Authors, Publishers and Administrators can view and edit it.
 +
</div>
  
::Save the article
+
:*Save the article
 +
::Click on the Save icon
  
If you are a publisher - you should now find the article in the place you expect!
+
This saves the Article in Joomla! and returns you to where you started (not to the editor).
  
<div style="border:thin solid green; margin-left:50px; background: #f5f5f5;  width: 80%;">
+
If you are an Editor or a Publisher - you should now be able to find the article in the place you expect!
Whether you can publish an Article depends on whether you have publisher permissions. There are differences between authors and publishers:-
 
  
:* Authors can create and alter articles
+
:*Continue to alter it or add to it -
:* Authors cannot 'publish' articles - which means that they do not display until someone with publish permissions has ticked the right box.
+
:**an  orange pencil [[Image:edit.png]] icon for a published Article
:* Publishers can see the Publish tick-box when they edit or create an article - so they can publish their own articles.
+
:**a blue pencil[[Image:edit_unpublished.png]]  for one that has not been published.
:* Publishers can edit documents that they did not create.
 
  
To get it published depends on the way the site is managed. Publishing is often done by the site Adminstrator or someone with publish permissions. You are likely to need to ask for it to be published before you can do more work on it.
+
:*Next time you save it, you will not have to fill out the Publisher part of the editor again.
  
More on permissions link
+
==Where Next?==
</div>
+
*If you want to do more editing and learn how to manage Articles using just the Front-end of the Site - then look at the documents under '''More hands-on altering and manipulating Articles''' in the Index to other documents below.
 +
*For setting up a site yourself, look at the documents under '''Hands-on setting up a Joomla! site''' in the Index to other documents below.
  
== What next? ==
+
==Further information==
Back to editing
+
[[Article Management]] is a compendium of short documents about all aspects of Articles, aimed at all levels of expertise.
  
 
----
 
----
--[[User:LornaS|Lorna Scammell]] December 2010
+
--Lorna Scammell December 2010

Latest revision as of 07:21, 6 June 2013

The "J1.5" namespace is an archived namespace. This page contains information for a Joomla! version which is no longer supported. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.

The aim of this document is to work through, hands-on, creating a new article using the Front-end of the Joomla! web site.

Who is it written for?[edit]

  • Everyone

You also need:

  • access to a Joomla! site
  • to be logged in with a username with an appropriate level of permission

Background: Publishing and editing permissions[edit]

There are some restrictions on what different groups of people adding content are allowed to do. There are three group (apart from administrators who can do anything with content), called Authors, Editors and Publishers. Authors can only edit their own material and cannot get their work seen on the site (published) themselves. In summary:-

  • Authors, Editors and Publishers can create and alter articles
  • Authors cannot 'publish' articles - which means that they do not display until someone with publish permissions has ticked the right box.
  • Editors can edit unpublished articles
  • Publishers can see a tick-box (which shows whether an Article is Published) when they edit or create an article - so they can publish their own, and other peoples', articles.
  • Editors and Publishers can edit documents that they did not create.

To get an Article published depends on the way the site is managed. Publishing is often done by the site Adminstrator. If you are an Author you are likely to need to ask for it to be published before you can do more work on it but Editors can continue to edit before it is published.

More about Permissions in Joomla! 1.5 here:- Permissions in a Joomla! Site

Starting a new article[edit]

You can easily start a new article for yourself although exactly how you do this depends on how the Web site you use is set up.

Either:

Many sites have a USER MENU with several options about things users might want to do. (It is not always called a USER MENU - it depends on the site!). One of the common options is to Submit an Article (Sometimes called Create an Article). If this option is available - use it:-
Find the USER MENU
Click on Submit an Article
A User Menu with the option to start a new Article, called here Submit an Article. Sometimes this option is under the Main Menu.

Or:

Sometimes the site has been set up to show a small icon New.png that looks like a sheet of paper at the bottom of many of the list pages. (This icon does not appear on pages with just one article - it does appear on pages where there is a list of articles.)
Click on the New Article icon New.png

Adding content[edit]

The editing screen (called Submit an Article) is loaded. This is the same editor as used for editing Articles, except that it has no content and no title.

  • Type in a title in the title box
  • Type in some text - or copy text from another document

Saving your work[edit]

Before saving a new article for the first time, you need to enter some information in the Publishing section of the editor, including whether it is published and where it is to be located.

Where will the Article be located?[edit]

  • You need to know where the new Article is to be located
This depends on the organisation of the Web site. If you are using an existing site, you need to be told which Section and Category it will be assigned to. Or it may be uncategorised, but you need to know that this is the case.
You will also need to know which menu it will be located under. Again this information varies with the way the Menus are set up and the layout of the Site.
Cross Reference: There is detail about Sections and Categories in this series of documents - Background: Sections and Categories


  • If you are a Publisher, type a few lines and then go to the Publishing part of the editor and Save it. You will then be able to continue editing.
  • If you are an Author it is worth typing quite a bit of content at this stage before adding the details in the Publishing part of the editor. This is because you will not be able to return to editing until it has been published.
  • If you are an Editor, you can continue to edit the article after it has been saved, even when it is not published.

The Publishing part of the editor[edit]

  • Scroll down to the Publishing section.

You must make a number of choices about where the new Article will be located and who will be able to read it.

Here the user has Publishing permissions so the choice for Published is displayed.

Getting the Section and Category correct usually means that it will display in the right place. The choice of Section and Category will depend on those available on the site you are using.

This is the Sample data in 'localhost' and shows the Section and Category chosen.
Section: choose from the pull-down list
Category: the choices depend on the Section chosen
Published: Leave this as Yes. This choice is not available if you are an Author
Front Page: leave this as No. The exception would be if you are writing an Article for the Front page which is in 'Blog' layout format.
Access Level: choose the appropriate one for your site.
Access Level:
  • Public means that anyone visiting the Web site can read it.
  • Registered means that people who have logged in but do not have any write access can read it.
  • Special means that Authors, Publishers and Administrators can view and edit it.
  • Save the article
Click on the Save icon

This saves the Article in Joomla! and returns you to where you started (not to the editor).

If you are an Editor or a Publisher - you should now be able to find the article in the place you expect!

  • Continue to alter it or add to it -
    • an orange pencil Edit.png icon for a published Article
    • a blue pencilEdit unpublished.png for one that has not been published.
  • Next time you save it, you will not have to fill out the Publisher part of the editor again.

Where Next?[edit]

  • If you want to do more editing and learn how to manage Articles using just the Front-end of the Site - then look at the documents under More hands-on altering and manipulating Articles in the Index to other documents below.
  • For setting up a site yourself, look at the documents under Hands-on setting up a Joomla! site in the Index to other documents below.

Further information[edit]

Article Management is a compendium of short documents about all aspects of Articles, aimed at all levels of expertise.


--Lorna Scammell December 2010