Help15

Screen.content.15

From Joomla! Documentation

Documentation all together tranparent small.png
Under Construction

This article or section is in the process of an expansion or major restructuring. You are welcome to assist in its construction by editing it as well. If this article or section has not been edited in several days, please remove this template.
This article was last edited by Dextercowley (talk| contribs) 15 years ago. (Purge)

How to access[edit]

Click on the Article Manager icon in the Control Panel, or click on 'Article Manager' in the 'Content' menu on the back-end of your Joomla! installation.

Description[edit]

The Article Manager is the place on the back-end where you add and manage all of the articles for your web site.

Screenshot[edit]

Column Headers[edit]

  • 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. Whether the item has been published or not. You can change the Published state by clicking on the icon in this column.
  • 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'.
  • Access Level. Who has access to this item. Current options are:
    • Public: Everyone has access
    • Registered: Only registered users have access
    • Special: Only users with author status or higher have access
You can change an item's Access Level by clicking on the icon in the column.
  • Section. The Section this item belongs to. Clicking on the Section Title opens the Section for editing. See Section Manager - Edit.
  • Category. The Category this item belongs to. Clicking on the Category title opens the Category for editing. See Category Manager - Edit.
  • Author. Name of the Joomla! User who created this item. Clicking on the Author opens the User for editing. See User Manager - Edit.
  • Date. The date this Article was created. This date is added automatically by Joomla!, but you may change it in the Parameters - Article section of the Article Manager - New/Edit.
  • Hits. The number of hits for an Article. A hit is the number of times a page has been viewed. Hits can be reset to 0 in the Article Manager - New/Edit screen.
  • ID. The ID number. This is a unique identification number for this item assigned automatically by Joomla!. It is used to identify the item internally, for example in internal links. You can not change this number.

Toolbar[edit]

At the top right you will see the toolbar:

Article manager toolbar.png

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.
  • Archive. To change one or more Articles to 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. They can not be published to other pages while set to Archived status. Note that Articles assigned to the "Uncategorized" Section will not show on the Archived Article List layout.
  • Publish. To publish one or more items, select them and click on this button.
  • Unpublish. To unpublish one or more items, select them and click on this button.
  • 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 "Save" 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.
  • Trash. Select one or more Articles and click on this button to move them to the Trash Manager. Note that Articles can be restored from the Trash Manager as long as they are not permanently deleted. See Trash Manager for more information.
  • Edit. Select one item and click on this button to open it in edit mode. If you have more than one item selected (where applicable), the first item will be opened. You can also open an item for editing by clicking on its Title or Name.
  • 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.
  • Help. Opens this Help Screen.

List Filters[edit]

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:
    Article manager filter1.png
    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 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. You can also search for a specific item id by entering "id:" followed by the id number. For example, "id:123" will find the item with an id of '123'.

In the upper right area, above the column headings, are 4 drop-down list boxes as shown below:

Article manager filter2.png

The selections may be combined. Only items matching all selections will display in the list.

  • Select Section. Use the drop-down list box to select the desired Section. Only items in this Section will display. You may also select 'Uncategorized'.
  • Select Category. Use the drop-down list box to select the desired Category. Only items in this Category will display.
  • Select Author. Use the drop-down list box to select the desired Author. Only Articles with this Author will display.
  • Select Status. Use the drop-down list box to select the published state: Published, Unpublished, Trashed, or All. For Articles, you may also select Archived. Important: With the default setting of -Select Status-, the screen only shows Published and Unpublished items. If you have the filter set to -Select Status- and you change items to Trashed, the Trashed items will disappear from the screen. However, they have not been permanently deleted. To do that you need to:
  1. Change the filter to Trashed. The Delete icon will now show in the toolbar.
  2. Select the items you want to permanently delete.
  3. Click on the Delete icon.
You can see all items, regardless of their published state, by selecting All for this filter. You can also re-publish Trashed items by selecting them and clicking on the Publish icon in the toolbar.

Global Configuration[edit]

This pop-up screen is shown when the User clicks the 'Parameters' button on the Toolbar.

Screenshot[edit]

Articles global1.png
Articles global2.png

Column Headers[edit]

  • 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 Article Title. (No/Yes) Whether or not to show the title of the article.
  • Title Linkable. (No/Yes) Whether or not the Title of the Article will be a hyperlink to the Article.
  • 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.
  • Section Name. (Hide/Show) Whether or not the Section Name will display.
  • Section Title Linkable. (No/Yes) Whether or not the Title of the Section will be a hyperlink to the Section page.
  • Category Title. (Hide/Show) Whether or not the Category Title will display.
  • Category Title Linkable. (No/Yes) Whether or not the Title of the Category will be a hyperlink to the Category page.
  • Author Name. (Hide/Show) Whether or not to display the Author Name.
  • Created Date and Time. (Hide/Show) Whether or not to display the date and time the Article was created.
  • Modified Date and Time. (Hide/Show) Whether or not to display the date and time the Article was last modified.
  • Show Navigation. (Hide/Show) Whether or not to show a navigation link (e.g., Next, Previous) between Articles.
  • Read More... Link. (Hide/Show) Whether or not to show the "Read More..." link to link from the part of the Article before the "Read More..." break to the rest of the Article.
  • Article Rating/Voting. (Hide/Show) Whether or not to display the Article Rating/Voting module.
  • 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.
  • PDF Icon. (Hide/Show) Whether or not to display a button to allow the Article to be rendered in a new window in PDF format. This allows the User to view, print, or save the Article as a PDF file.
  • Print Icon. (Hide/Show) Whether or not to display a button to allow the Article to be printed. This allows the User to print the current Article in a printer-friendly format.
  • E-mail Icon. (Hide/Show) Whether or not to display a button to allow a link to the Article to be e-mailed. This displays a form that allows the user to send an e-mail with a link to the current Article.
  • Hits. (Hide/Show) Whether or not to display the number of hits for an Article.
  • For each feed item show. (Intro Text/Full Text) If set to Intro Text, only the intro text of each article will show. If set to Full Text, the whole article will show in the newsfeed.

Filtering Options[edit]

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.2 brings new filtering options to give you more control over the HTML that your content providers submit. You can be as strict or as liberal as you require to suit your site's needs. The filtering is opt-in. If you don't do anything, the default settings afford good protection against markup commonly associated with web site attacks. You can define which user groups are to receive additional filtering, and then control the type and extent of that filtering.

The default filtering is modified by entering in the following fields:

  • Filter Groups. This sets the user groups that you want additional filters applied to. Other groups will have no additional filtering done. By default, all groups have filtering to protect against markup commonly associated with web site attacks.
  • 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[edit]

The default filter method in Joomla! is 'Black List'. The default black list contains the following tags (which will be excluded):

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

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 Example[edit]

For example, 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, br, a, ul, ol, li
  • Set the Filter attributes to: href, target

Developers Notes[edit]

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[edit]

  • 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.
  • To create a static content item, create a new Article in the same way as for normal content and assign it to the 'Uncategorized' Section and Category. You can then use the Menu Item Type called Article Layout to show the Article in a page.
  • The way a 'Read more...' is created is new for version 1.5. 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[edit]