User's Manual

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

· For each feed item show. (Intro Text/Full Text) If set to Intro Text, only the intro text of each feed

item will show. If set to Full Text, the whole article will show in the newsfeed.

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:

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

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

o Black list means allow all HTML tags and attributes except those listed.

o White list means allow only the listed tags and attributes.