How to access
Click the Article Manager icon in the Control Panel, or click 'Article Manager' in the 'Content' menu in the Back-end of your Joomla! installation.
Description
The Article Manager is the place in the back-end where you can add and manage all of the articles for your web site.
Screenshot
Column Headers
Click on the column heading to sort the list by that column's value.
-
Checkbox. Check this box to select one or more items. To select all items, check the box in the column heading. After one or more boxes are checked, click a toolbar button to take an action on the selected item or items. Many toolbar actions, such as Publish and Unpublish, can work with multiple items. Others, such as Edit, only work on one item at a time. If multiple items are checked and you press Edit, the first item will be opened for editing.
-
Title. The name of the item. For a Menu Item, the Title will display in the Menu. For an Article, Section, or Category, the Title may optionally be displayed on the web page. This entry is required. You can open the item for editing by clicking on the Title.
-
Published. The Article's Published status. The possible values are shown under the main window, as shown below:
You can toggle the Published state on and off by clicking on the icon
in this column. A status of Pending means that an Article's Start
Publishing Date is in the future. You can hover on the icon to see an
Article's Start and Stop Publishing dates.
-
Front Page. Whether or not the Article will show on the Front Page. You can change an Article's published state by clicking on the icon in the column.
-
Order. The order to display items. If the list is sorted by this column, you can change the order by clicking the arrows or by entering the sequential order and clicking 'Save Order'. Note that the display order on a page is set in the Parameters - Advanced section for each Menu Item. If that order is set to use something other than 'Order' (for example, 'Title - Alphabetical'), then the order value in this screen will be ignored. If the Menu Item Order parameter is set to use 'Order', then the items will display on the page based on the order in this screen.
- You can change an item's Access Level by clicking on the icon in the column.
-
Display #. The number of items to display on one page. If there are more items than this number, you can use the page navigation buttons (Start, Prev, Next, End, and page numbers) to navigate between pages. Note that if you have a large number of items, it may be helpful to use the Filter options, located above the column headings, to limit which items display.
Toolbar
At the top right you will see the following toolbar: 
The functions are:
-
Unarchive. To remove one or more Articles from Archived status, select them and press this button. Archived Articles are retained on the site and are available for viewing on Menu Items with a Type of Archive Layout. Note that when an Article is unarchived, its status is changed to 'Not Published'. Also, if an Article does not have a status of 'Archived', this button has no effect.
-
Move. Select one or more items and click on this button to move them. A new screen will display showing the possible "Move to" locations on the left and the list of item(s) being moved on the right. To complete the move, select the desired "Move to" location and press the Move button. To cancel the operation, press Cancel.
-
Copy. Select one or more items and click this button to copy them. A new screen will display showing the possible "Copy to" locations on the left and the list of item(s) being copied on the right. To complete the copy, select the desired "Copy to" location and press the Copy button. To cancel the operation, press Cancel.
-
New. Click on this button to create a new item. You will enter the New page for this item.
-
Parameters. Click this button to open the Global Configuration window. This window allows you to set default parameters for Articles. This default parameter will take effect if the corresponding Menu Item parameter and Article parameter are both set to 'Use Global'. See Global Configuration below.
List Filters
Filter by Partial Title
You can filter the list of items either by entering in part of the title or the ID number. Or you can select a combination of Section, Category, Author, and Published State.
-
Filter. In the upper left corner just above the column headings is a Filter field and two buttons, as shown below:
If you have a large number of items on the list, you can use this filter to find the desired item(s) quickly. Enter either part of the title or an ID number and press 'Go' to display the matching items. You can enter in whole words or part of a word. For example, "ooml" will match all titles with the word "Joomla!" in them.
Filter by Section, Category, Author, Published State
In the upper right area, above the column headings, are 4 drop-down list boxes as shown below:
The selections may be combined. Only items matching all selections will display in the list.
Global Configuration
This pop-up screen is shown when the User clicks the 'Parameters' button on the Toolbar.
Screenshot
Column Headers
-
Show Unauthorized Links. (No/Yes). Whether or not to show links to Articles that the User is not authorized to access. If set to No, Users will only see links to Articles that they may access. If set to Yes, every User will see all Article links, whether or not they can access them. In this case, a link to the User Login page will display below the Article Title.
-
Show Intro Text. (Hide/Show) Hide or Show an Article's Intro Text when the 'Read more...' link is selected. Intro Text is the part of the Article before a 'Read more...' break. If this parameter is 'Show', when the User selects the 'Read more...' link, the entire article will display, including the Intro Text. If this parameter is 'Hide', when the User selects the 'Read more...' link, only the part of the Article after the 'Read more...' link will display.
-
Icons. (Hide/Show) Whether the PDF, Print, and E-mail buttons for the Article will display as Icons or Text. If set to Hide, these buttons will display as Text ("PDF", "Print", and "E-mail"). If set to Show, they will display as Icons. Note that these buttons only display if the individual options are set to Show.
Filtering Options (HTML)
Web sites can be attacked by users entering in special HTML code.
Filtering is a way to protect your Joomla! web site. Joomla! 1.5 brings
new filtering options to give you more control over the HTML that your
content providers are allowed to submit. You can be as strict or as
liberal as you desire, depending on your site's needs.
It is important to understand that filtering occurs at the time an article is saved, after
it has been written or edited. Depending on your editor and filter
settings, it is possible for a user to add HTML to an article during
the edit session only to have that HTML removed from the article when
it is saved. This can sometimes cause confusion or frustration. If you
have filtering set up on your site, make sure your users understand
what types of HTML are allowed.
The default setting, as of Joomla! version 1.5.9, is that all users except members of the Super Administrator group
will have "black list" filtering on by default. This is designed to
protect against markup commonly associated with web site attacks. So,
if you do not set any filtering options, the Super Administrator will
have no filtering done, and all other users will have "black list"
filtering done using the default list of filtered items. If you create
a filter here, this overrides the default, and the default filter is no
longer in effect. Only one filter option is allowed per site.
There are two steps to setting up filtering:
-
Decide on the user groups that will receive filtering. This will
normally include the highest level group you want to filter and all of
the groups below that level. For example, if you want to filter
Publishers and below, this would include Publisher, Editor, Author, and
Registered.
-
Enter the type and extent of the desired filtering.
For example, if you want filtering only for Author, Registered user,
and guests, select "Author", "Registered", and "Public Front End" for
the Filter Groups and then select the desired type of filtering. This
will apply to members of the Author, Registered and public groups but
not to "higher" groups, such as Editors, Publishers, and so on.
The default filtering is overridden by entering in the following fields:
-
Filter Groups. This sets the user groups that you want
filters applied to. Use Ctrl+Click to select multiple groups. Groups
that are not selected will have no filtering done.
Important Note: There is a bug, as of version 1.5.8, such that
you must specify at least two groups for the filtering to take place.
If you only specify one group, no filtering will happen. This is easy
to work around. Just be sure to always specify at least two groups here.
-
Filter Type. Black List (Default), White List, No HTML.
-
Black list means allow all HTML tags and attributes except those listed.
-
White list means allow only the listed tags and attributes.
-
No HTML means allow no HTML markup at all. All HTML is removed from an Article when it is saved.
-
Filter Tags. The extra tags to exclude in a Black List, or the only tags to allow in a White List.
-
Filter Attributes. The extra tag attributes to exclude in a Black List, or the only tag attributes to allow in a White List.
Default Filters
The default filter method in Joomla! is 'Black List'. The default 'Black List' contains the following tags to exclude:
- 'applet', 'body', 'bgsound', 'base', 'basefont', 'embed', 'frame',
'frameset', 'head', 'html', 'id', 'iframe', 'ilayer', 'layer', 'link',
'meta', 'name', 'object', 'script', 'style', 'title', 'xml'
The default 'Black List' contains the following attributes to exclude:
- 'action', 'background', 'codebase', 'dynsrc', 'lowsrc'
You can 'Black List' (disallow) additional tags and attributes by
adding to the Filter tags and Filter attributes fields, separating each
tag or attribute name with a space or comma. If you select a Filter
Type of "Black List", this list will always be used, plus any
additional tags and attributes you add.
Please note that these settings work regardless of the editor that
you are using. Even if you are using a WYSIWYG editor, the filtering
settings may strip additional tags and attributes prior to saving
information in the database.
Filter Examples
Example One:
To allow people in your Author group to only submit content with basic HTML tags, use the following settings:
-
In the Filter groups box, select Registered and Author.
-
Select White List as the Filter type
-
Set the Filter tags to: p, b, i, em, br, a, ul, ol, li, img
-
Set the Filter attributes to: href, target, src
In this example, no filtering will be done for members of the Editor,
Publisher, Manager, Administrator, and Super Administrator groups.
Example Two:
To apply the default black-list filtering to all groups except for Admin and Super Admin, use the following settings:
-
In the Filter groups box, select all groups except Admin and Super Admin.
-
Select Black List as the Filter type.
-
Leave the Filter Tags and Filter attributes fields empty.
In this example, no filtering will be done for members of the Administrator and Super Administrator groups.
Example Three:
If you allow others you do not know (and therefore have no reason to
trust) to submit articles on your Joomla! Web site, the safest (and
most restrictive) filtering is as follows:
-
In the Site → Global Configuration → System, set "New Registration Type" to "Author".
-
In the Filter groups box, select Registered and Author.
-
In the Filter Type, select "No html".
This will not allow an author to use any HTML inside an article's content.
In this example, no filtering will be done for members of the Editor,
Publisher, Manager, Administrator, and Super Administrator groups.
Developers Notes
The filtering parameters in config.xml have the new parameter menu="hide". This hides the filters from the Menu Item's Component pane as you do not want cascading overrides to occur at the menu item level.
Quick Tips
-
In Joomla! versions prior to 1.5, there were separate processes for creating a Static Content Item and normal Content Items. Both processes are now done just by adding Articles. Normal Content Items are now just called Articles, and Static Content Items are now called Uncategorized Articles.
-
Joomla! 1.5 changes the method you must use to create the 'Read more...' link. When you are adding or editing an article, just press the 'Read more...' button located at the bottom of the screen, next to Image and Pagebreak buttons. This inserts a 'Read more...' break in the Article. The text before the break will display as the Intro Text, and the text after the break will display when the 'Read more...' link is pressed.
Related Information
|
Help Screens 
