Actions

Help15

Difference between revisions of "Screen.content.15"

From Joomla! Documentation

(/* Related Information - add descriptive text)
m (Related Information: category reorganizing)
 
Line 1: Line 1:
 
==How to access==
 
==How to access==
{{review}}
+
Click the Article Manager icon in the [[screen.cpanel.15|Control Panel]], or click 'Article Manager' in the 'Content' menu in the back-end of your Joomla! installation.
Click on the Article Manager icon in the [[screen.cpanel.15|Control Panel]], or click on 'Article Manager' in the 'Content' menu on the back-end of your Joomla! installation.
+
  
 
==Description==
 
==Description==
The Article Manager is the place on the back-end where you add and manage all of the articles for your web site.
+
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==
 
==Screenshot==
[[Image:article_manager.png|frame|center]]
+
[[Image:Article.Manager.png]]
 +
 
 +
''Note: greyed item (# 15) is archived and cannot be edited before unarchived.''
  
 
==Column Headers==
 
==Column Headers==
Line 14: Line 15:
 
{{colheader|Checkbox}}
 
{{colheader|Checkbox}}
 
{{colheader|Title}}
 
{{colheader|Title}}
{{colheader|Published}}
+
{{colheader|Article Published}}
 
{{colheader|Front Page}}
 
{{colheader|Front Page}}
 
{{colheader|Order}}
 
{{colheader|Order}}
Line 27: Line 28:
  
 
==Toolbar==
 
==Toolbar==
At the top right you will see the toolbar:
+
At the top right you will see the following toolbar:
 
[[Image:article_manager_toolbar.png]]
 
[[Image:article_manager_toolbar.png]]
  
Line 88: Line 89:
 
===Filtering Options (HTML)===
 
===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.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.
+
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.  
  
The default filtering is modified by entering in the following fields:
+
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 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 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. <blockquote>''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.''</blockquote>
 
*'''Filter Type.''' Black List (Default), White List, No HTML.  
 
*'''Filter Type.''' Black List (Default), White List, No HTML.  
 
**Black list means allow all HTML tags and attributes ''except'' those listed.  
 
**Black list means allow all HTML tags and attributes ''except'' those listed.  
Line 109: Line 119:
 
:'action', 'background', 'codebase', 'dynsrc', 'lowsrc'
 
:'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.
+
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.
 
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====
+
====Filter Examples====
 
+
For example, to allow people in your Author group to only submit content with basic HTML tags, use the following settings:
+
  
 +
'''Example One:'''
 +
To allow people in your Author group to only submit content with basic HTML tags, use the following settings:[[Image:Screen_content_article_filter_example1_20090126.png|frame|center]]
 
* In the Filter groups box, select Registered and Author.
 
* In the Filter groups box, select Registered and Author.
 
* Select White List as the Filter type
 
* Select White List as the Filter type
* Set the Filter tags to: p, br, a, ul, ol, li
+
* Set the Filter tags to: p, b, i, em, br, a, ul, ol, li, img
* Set the Filter attributes to: href, target
+
* 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:[[Image:Screen_content_article_filter_example2_20090126.png|frame|center]]
 +
* 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:[[Image:Screen_content_article_filter_example3_20090126.png|frame|center]]
 +
* In the Site &rarr; Global Configuration &rarr; 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====
 
====Developers Notes====
Line 131: Line 156:
 
*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.  
 
*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.
+
*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==
 
==Related Information==
* Add or edit Articles: [[screen.content.edit.15|Article Manager - New/Edit]]
+
* To add or edit Articles: [[screen.content.edit.15|Article Manager - New/Edit]]
* Work with Categories: [[screen.categories.15|Category Manager]]
+
* To manage Categories: [[screen.categories.15|Category Manager]]
* Work with Sections: [[screen.sections.15|Section Manager]]
+
* To manage Sections: [[screen.sections.15|Section Manager]]
* Work with Users: [[screen.users.15|User Manager]]
+
* To manage Users: [[screen.users.15|User Manager]]
  
[[Category:DocCamp]]
+
<noinclude>{{cathelp|1.5|Article Manager Help Screens|Content Help Screens}}</noinclude>

Latest revision as of 21:15, 4 August 2012