Actions

J1.5

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

From Joomla! Documentation

(The Publishing part of the editor)
 
(47 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{incomplete}}
+
{{version/tutor|1.5}}{{:Getting Started Page Index/1.5}}
<div style="border:thin solid black; background: #f5f5f5;" >
+
The aim of this document is to work through, hands-on,  creating a new article using the Front-end of the Joomla! web site.
{{RightTOC}}
+
</div>
+
 
+
<div  style="border:thin solid black; background: #f5f5f5; left: 50px; width: 50%; ">
+
===Index to the other documents in this series===
+
{{:Page Index}}
+
</div>
+
This shows how to create a new article.
+
When a new article is 'published' it can continue to be edited and worked on.  
+
 
=== Who is it written for?===
 
=== Who is it written for?===
:*Everyone
+
:*'''Everyone'''
 
You also need:
 
You also need:
 
:* access to a Joomla! site
 
:* access to a Joomla! site
 
:* 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
===Where will the Article be located?===
 
:*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.
 
  
<div style="border:thin solid green; margin-left:50px; background: #f5f5f5;  width: 80%;">
+
====Background: Publishing and editing permissions====
About Sections and Categories: briefly: maybe - -
+
  
or do it in a practical way when we get to the publisher part of the editor
+
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:-
  
</div>
+
:* '''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:- [[How permissions work in Joomla! 1.5 |Permissions in a Joomla! Site]]
  
 
== Starting a new article ==
 
== Starting a new article ==
Line 34: Line 29:
 
::Click on Submit an Article
 
::Click on Submit an Article
  
::::[[Image:GSusermenu.png]]
+
[[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/>
Line 45: Line 40:
  
 
===Saving your work===
 
===Saving your work===
<div style="border:thin solid red; margin-left:50px;  width: 70%;">
 
This part is not right but the info has to be given somewhere - probably later - as part of the action of doing it with some asides.
 
 
</div>
 
 
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.
 
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.
<div style="border:thin solid green; margin-left:50px; background: #f5f5f5;  width: 60%;">
 
Publishing: there are differences between Authors and Publishers:-
 
  
:* Authors can create and alter articles
+
====Where will the Article be located?====
:* Authors cannot 'publish' articles - which means that they do not display until someone with publish permissions has ticked the right box.
+
:*You need to know where the new Article is to be located
:* Publishers can see the Published tick-box when they edit or create an article - so they can publish their own articles.
+
::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.
:* Publishers can edit documents that they did not create.
+
::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]]}}
  
To get it published depends on the way the site is managed. Publishing is often done by the site Adminstrator and you are likely to need to ask for it to be published before you can do more work on it.
 
  
More on permissions link
 
</div>
 
 
:*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 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 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.
Both publishers and authors need to know which Menu the Article will be in after it has been saved.
+
:*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===
 
===The Publishing part of the editor===
 
:*Scroll down to the Publishing section.  
 
:*Scroll down to the Publishing section.  
Here you must make a number of choices about where the new Article will be located and who will be able to read it.
+
You must make a number of choices about where the new Article will be located and who will be able to read it.
  
[[Image:GSpublisherpart.png|frame|center]]
+
[[Image:GSpublisherpart.png|frame|center|'''Here the user has Publishing permissions so the choice for Published is displayed.''']]
  
The choice of Section and Category will depend on those available on the site you are using. Getting the Section and Category correct usually means that it will display in the right place. The screen shot is of the Sample data in 'localhost' and shows the Section and Category chosen.  
+
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.
  
[[Image:GSpublisherpart3.png|frame|center]]
+
[[Image:GSpublisherpart3.png|frame|center|''' This is the Sample data in 'localhost' and shows the Section and Category chosen. ''']]
  
::Section: choose from the pull-down list
+
::'''Section:''' choose from the pull-down list
::Category: the choices depend on the Section chosen
+
::'''Category:''' the choices depend on the Section chosen
::Published: Leave this as Yes. This choice is not available if you are an Author  
+
::'''Published:''' Leave this as Yes. This choice is not available if you are an Author  
::Front Page: always leave this as No
+
::'''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:''' choose the appropriate one for your site.
  
<div style="border:thin solid green; margin-left:100px; background: #f5f5f5;  width: 70%;">
+
<div style="border:thin solid green; margin:15px 15% 15px 15%; background: #f5f5f5;  width: 70%; padding:8px;">'''Access Level:'''
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.
+
*'''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>
 
</div>
  
::Save the article
+
:*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 [[Image:edit.png]] icon for a published Article
 +
:**a blue pencil[[Image:edit_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?==
 +
*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.
  
If you are a publisher - you should now be able to find the article in the place you expect!
+
==Further information==
 +
[[Article Management]] is a compendium of short documents about all aspects of Articles, aimed at all levels of expertise.
  
== What next? ==
 
Once an Article is created, it can be altered using the editor.
 
 
----
 
----
--[[User:LornaS|Lorna Scammell]] December 2010
+
--Lorna Scammell December 2010

Latest revision as of 07:21, 6 June 2013

Replacement filing cabinet.png
This Namespace has been archived - Please Do Not Edit or Create Pages in this namespace. Pages contain information for a Joomla! version which is no longer supported. It exists only as a historical reference, will not be improved and its content may be incomplete.

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?

  • 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

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

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

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

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?

  • 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

  • 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?

  • 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

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


--Lorna Scammell December 2010