Hands-on adding a new article

From Joomla! Documentation

Revision as of 15:01, 3 March 2012 by LindaLaFianza (Talk | contribs)

Info non-talk.png
General Information

Most content is of relevant to both versions. Originally written for Joomla! version Joomla 1.5. In process of being updated:

  • screen shots showing version Joomla 2.5
  • with commentary appropriate for versions  Joomla 2.5

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

Who is it written for?

  • Everyone

You also need:

  • access to a Joomla! 2.5 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 groups (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 Administrator. 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.6 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 your use is set up.

Log in either:

By logging in to the website


By logging in to the Administration Panel (back end) of the website.

By logging in to the website

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

By logging in to the Administration Panel (back end) of the website

Navigate to the Article Manager via Site/Control Panel/Add New Article or Content/Article Manager/Add New Article.

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

  • If you are an Author note that you will not be able to return to this page after it is saved. To prevent loss of work during composition, it is recommended that you compose your work in an offline word processor and cut and past it into the editing box.

Two pieces of information are required to save a new article, a Title and some Content.

  • 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 Editor, you can continue to edit the article after it has been saved, even when it is not published.

Where will the Article be located?

  • The location of an Article is determined by its Category.
The default Category is the first one in the Category hierarchy.
The Category assignment determines the article's location in a website's structure and/or menu.
If you are using an existing site, you need to be told which Category to select.

Cross Reference: There is detail about Sections and Categories in this series of documents - Background: CategoriesDesign the content: Categories in Joomla! 1.6

Publishing the Article

  • The selections are above the Article Text Content Editor.

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 This is a compendium of short documents about all aspects of Articles, aimed at all levels of expertise.

Index to other documents in this series


--Lorna Scammell March 2011