Actions

Help25

Difference between revisions of "Content Article Manager"

From Joomla! Documentation

(pagination)
m (Related Information: category reorganizing)
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{RightTOC}}
 +
Used for creating new, editing, managing order, publishing, unpublishing and setting global options of articles shown on a Joomla website.
 
==How to access==
 
==How to access==
Click the Article Manager icon in the [[Help25:Site_Control_Panel|Control Panel]], or click 'Article Manager' in the 'Content' menu in the back-end of your Joomla! installation.
+
*Click the Article Manager icon in the [[Help25:Site_Control_Panel|Control Panel]]  
 +
*Select '''Content → Article Manger''' from the drop-down menu of the '''''Joomla! Administrator Panel'''''.
  
 
==Description==
 
==Description==
The Article Manager is used to add and edit articles.
+
The Article Manager is used to add and edit articles. See [[Help25:Content Article Manager#Toolbar|Toolbar]] below for a detailed list of all functions.
  
 
==Screenshot==
 
==Screenshot==
Line 37: Line 40:
 
{{Chunk25:Help_screen_toolbar_icon_Checkin|articles}}
 
{{Chunk25:Help_screen_toolbar_icon_Checkin|articles}}
 
{{Chunk25:Help_screen_toolbar_icon_Trash|articles}}
 
{{Chunk25:Help_screen_toolbar_icon_Trash|articles}}
{{Chunk25:Help_screen_toolbar_icon_Options}}
+
{{Chunk25:Help_screen_toolbar_icon_Options}} See [[Help25:Content_Article_Manager_Options|Article Manager Options]] for more information.
 
{{Chunk25:Help_screen_toolbar_icon_Help}}
 
{{Chunk25:Help_screen_toolbar_icon_Help}}
  
Line 55: Line 58:
  
 
==Options==
 
==Options==
This pop-up screen is shown when the User clicks the 'Options' button on the Toolbar.
+
Clicking on the Options icon in the toolbar opens a modal window where you can set component level options for articles. To see the help screen for Options, click [[Help25:Content_Article_Manager_Options|Article Manager Options]]
 
+
===Screenshots===
+
[[Image:Article-Manager-Articles-Global.png|center]]
+
-----[[Image:Article-Manager-Category-Global.png|center]]
+
-----[[Image:Article-Manager-Categories-Global.png|center]]
+
-----[[Image:Article-Manager-Blog_Featured_Layouts-Global.png|center]]
+
-----[[Image:Article-Manager-List_Layouts-Global.png|center]]
+
-----[[Image:Article-Manager-Integration-Global.png|center]]
+
-----[[Image:Article-Manager-Text_Filters-Global.png|center]]
+
-----[[Image:Article-Manager-Permissions-Global.png|center]]
+
 
+
===Column Headers===
+
 
+
{{colheader|Global Show Unauthorized Links}}
+
{{colheader|Global Show Article Title}}
+
{{colheader|Global Title Linkable}}
+
{{colheader|Global Show Intro Text}}
+
{{colheader|Global Section Name}}
+
{{colheader|Global Section Title Linkable}}
+
{{colheader|Global Category Title}}
+
{{colheader|Global Category Title Linkable}}
+
{{colheader|Global Author Name}}
+
{{colheader|Global Created Date and Time}}
+
{{colheader|Global Modified Date and Time}}
+
{{colheader|Global Show Navigation}}
+
{{colheader|Global Read more... Link}}
+
{{colheader|Global Article Rating/Voting}}
+
{{colheader|Global Icons}}
+
{{colheader|Global PDF Icon}}
+
{{colheader|Global Print Icon}}
+
{{colheader|Global E-mail Icon}}
+
{{colheader|Hits}}
+
{{colheader|Global For each feed item 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. Filtering options 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 in Joomla! version 2.5 is that all users 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, all 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.
+
 
+
To access the filtering settings, click on Options and select 'Text filters'
+
 
+
For each user group on your site you can specify what type of filtering is applied to their edits.
+
 
+
====Filter Types====
+
There are four types of filters: Black List, White List, No HTML and No Filtering.
+
 
+
=====Black List 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.
+
 
+
=====White List Filters=====
+
White list filters allow you to specify that a given group can only use a specific list of HTML tags and attributes. You can 'White List' (allow) tags and attributes by adding to the Filter tags and Filter attributes fields for the desired group, separating each tag or attribute name with a space or comma.
+
 
+
=====No HTML Filters=====
+
No HTML filters are the strictest set of filters you can apply. Groups that are set to No HTML will not have permission to use any HTML.
+
 
+
=====No Filtering=====
+
No filtering is the most permissive set of filters you can apply. Groups that are set to No Filtering will have permission to use any and all tags and attributes, including the default blacklisted tags and attributes.
+
 
+
====Combining Filters====
+
If a user belongs to two different groups that have different filter settings, filters will combine in a permissive way. That is, the set of tags the user will be permitted to use will the combination of the tags that each group allows the user to use. So if the user is a member of one group that white lists a specific set of tags and another group that white lists a different set of tags, the user will be able to use both sets of white listed tags. White lists override blacklists, so if a user belongs to one group that black lists a tag and another group that white lists a tag, the user will be able to use that tag. A user that belongs to a group that has no filtering will be able to use any HTML regardless of filtering settings for other groups the user belongs to.
+
 
+
 
+
====Filter Application====
+
 
+
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 a group to only submit content with basic HTML tags, use the following settings:
+
* 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
+
 
+
'''Example Two:'''
+
To apply the default black-list filtering to a group, use the following settings:
+
* Select Black List as the Filter type.
+
* Leave the Filter Tags and Filter attributes fields empty.
+
 
+
[[Image:Text_filters.png]]
+
 
+
====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==
 
==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.
+
* If Joomla is installed without sample data, one article category called "Uncategorised" is created automatically. If you want to use other categories for articles, you should create them before trying to add articles.
 
+
* To see trashed and archived articles, set the Status filter to All.
*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 change the ordering of articles within a category, click on the Ordering column heading to sort by this column. Also, it is easier to see the ordering if you filter on the desired category.
 
+
*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==
* To add or edit Articles: [[Help25:Content_Article_Manager_Edit|Article Manager - New/Edit]]
+
* To add or edit Articles: [[Help25:Content_Article_Manager_Edit|Article Manager: New/Edit]]
 
* To manage Categories: [[Help25:Components_Content_Categories|Category Manager]]
 
* To manage Categories: [[Help25:Components_Content_Categories|Category Manager]]
* To manage Users: [[screen.users.15|User Manager]]
+
* To manage Featured Articles: [[Help25:Content_Featured_Articles|Article Manager: Featured Articles]]
  
<noinclude>{{cathelp|2.5|Article Manager|Content}}</noinclude>
+
<noinclude>{{cathelp|2.5|Article Manager Help Screens|Content Help Screens}}</noinclude>

Revision as of 17:15, 4 August 2012

Contents

Used for creating new, editing, managing order, publishing, unpublishing and setting global options of articles shown on a Joomla website.

How to access

  • Click the Article Manager icon in the Control Panel
  • Select Content → Article Manger from the drop-down menu of the Joomla! Administrator Panel.

Description

The Article Manager is used to add and edit articles. See Toolbar below for a detailed list of all functions.

Screenshot

Help25-content-article manager-screen.png

Column Headers

Click on the column heading to sort the list by that column's value. The list will be sorted in order by that column and a sort icon will show next to the column name, as shown below.

Help25-chunk-colheader-order-ascending.png

Click a second time to reverse the sort to high-to-low. The sort icon will change to high-to-low, as shown below.

Help25-chunk-colheader-order-descending.png
  • 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 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.
  • Status. (Published/Unpublished/Archived/Trashed) The published status of the item.
  • Featured. Whether or not the Article will show on the Featured Articles Page. You can change an Article's published state by clicking on the icon in the column.
  • Category. The Category this item belongs to.
  • Ordering. The order in which to display items. You can sort the list by order number by clicking on the Ordering label in the column heading. 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 the 'Save Order' icon. This is shown in the screen below.
    Help25-chunk-colheader-order-icons.png
    Note that the ordering is only defined within a single category. For this reason, it is easier to re-order the list if you use the Category filter to select one category.
  • Access. The viewing level access for this item.
  • Created by. Name of the Joomla! User who created this item.
  • Date. The date this Article was created. This date is added automatically by Joomla!, but you may change it in the Publishing Options - Article section of the Content Article Manager Edit.
  • Hits. The number of times an item has been viewed.
  • Language. Item language.
  • ID. This is a unique identification number for this item assigned automatically by Joomla!. It is used to identify the item internally, and you cannot change this number. When creating a new item, this field displays 0 until you save the new entry, at which point a new ID is assigned to it.

Toolbar

At the top right you will see the toolbar:

Help25-Toolbar-New-Edit-Publish-Unpublish-Featured-Archive-Checkin-Trash-Options-Help.png

The functions are:

  • New. Opens the editing screen to create a new article.
  • Edit. Opens the editing screen for the selected article. If more than one article is selected (where applicable), only the first article will be opened. The editing screen can also be opened by clicking on the Title or Name of the article.
  • Publish. Makes the selected articles available to visitors to your website.
  • Unpublish. Makes the selected articles unavailable to visitors to your website.
  • Featured. Marks selected articles as featured. Works with one or multiple articles selected.
  • Archive. Changes the status of the selected articles to indicate that they are archived. Archived articles can be moved back to the published or unpublished state by selecting "Archived" in the Select Status filter and changing the status of the articles to Published or Unpublished as preferred.
  • Check In. Checks-in the selected articles. Works with one or multiple articles selected.
  • Trash. Changes the status of the selected articles to indicate that they are trashed. Trashed articles can still be recovered by selecting "Trashed" in the Select Status filter and changing the status of the articles to Published or Unpublished as preferred. To permanently delete trashed articles, select "Trashed" in the Select Status filter, select the articles to be permanently deleted, then click the Empty Trash toolbar icon.
  • Options. Opens the Options window where settings such as default parameters or permissions can be edited. See Article Manager Options for more information.
  • Help. Opens this help screen.

List Filters

Above the column headers are a series of controls that let you limit what items show in the manager screen. More than one filter may be entered. In this case, only items that meet all of the filter conditions will show on the list.

  • Filter by Partial Title or ID. In the upper left is a filter field and two buttons, as shown below.
    Help25-chunk-colheader-filter-field.png
    • To filter by partial title, enter part of the title and click Search.
    • To filter by ID number, enter "id:xx", where "xx" is the ID number (for example, "id:9").
Click Clear to clear the Filter field and restore the list to its unfiltered state.
  • Filter by Published Status. Lets you show only items with the selected published status.
    Help25-chunk-colheader-select-status.png
    • - Select Status -: Shows items that are Published and Unpublished. Does not show items that are Trashed or Archived.
    • Published: Shows only items that are Published.
    • Unpublished: Shows only items that are Unpublished.
    • Archived: Shows only items that are Archived.
    • Trashed: Shows only items that are Trashed. Important Note: To permanently delete items:
      1. Change the status of the items to Trashed.
      2. Change the Status filter to Trashed. At this point the trashed items will show and an icon called "Empty trash" will show in the toolbar.
      3. Select the desired trashed items and click on "Empty Trash" in the toolbar. The items will be permanently deleted.
    • All: Shows all items regardless of published status.
  • Filter by Category. Lets you show only items assigned to a specific category. The list box will show the categories defined for your site, similar to the example below.
    Help25-chunk-colheader-select-category.png
    • - Select Category -: Show items assigned to any category.
    • <your category>: Show items assigned only to this category.
  • Filter by Max Levels (Category Level). Lets you show only items whose category is at or above the specified level in the category hierarchy.
    Help25-chunk-colheader-select-max-levels.png
    • - Select Max Levels -: Show all items regardless of level of their assigned category.
    • 1: Only show items whose category is at the top level in the category hierarchy (in other words, with categories whose parent category is "- No Parent -".)
    • 2-10: Only show items whose category is in the top 2-10 levels in the category hierarchy.
  • Filter by Viewing Access Level. Lets you show only items that have a specified viewing access level. The list box will show the access levels defined for your site, similar to the example below.
    Help25-chunk-colheader-select-access.png
    • - Select Access -: Show items with any viewing access level.
    • <your access level>: Show items only with this viewing access level.
  • Filter by Author. Lets you show only items that have the specified author. The list box will show the authors for your site, similar to the example below.
    Help25-chunk-colheader-select-author.png
    • - Select Author -: Show all items regardless of their author.
    • <your author>: Only show items with the specified author.
  • Filter by Language. Lets you show only items that have a specific language assigned. The list box will show the languages defined for your site, similar to the example below.
    Help25-chunk-colheader-select-language.png
    • - Select Language - or All: Show items for any language.
    • <your language>: Show items only for this language.
  • Page Controls. When the number of items is more than one page, you will see a page control bar as shown below.
    Help25-chunk-colheader-pagination.png
    • Display #: Select the number of items to show on one page.
    • Start: Click to go to the first page.
    • Prev: Click to go to the previous page.
    • Page numbers: Click to go to the desired page.
    • Next: Click to go to the next page.
    • End: Click to go to the last page.

Batch Process

This section allows you to change settings for a group of selected items. The fields are as shown below.

Help25-chunk-colheader-batch-process.png

You can change one value or all three values at one time. Note that if you copy items to a new category, changes you have selected fro access level and language will be applied to the copies, not the original.

To batch process a group of items:

  1. Select one or more items on the list by checking the desired check boxes.
  2. Set one or more of the following values:
    • To change the access levels, select the desired new access level from the Set Access Level list box.
    • To change the Language, select the desired language from the Set Language list box.
    • To change the Category, select a category. To leave the category unchanged, use the default value of "Select".
      • To copy the items to a different category, select the desired category from the category list box and check the Copy option. In this case, the original items are unchanged and the copies are assigned to the new category and, if selected, the new access level and language.
      • To move the items to a different category, select the desired category from the category list box and check the Move option. In this case, the original items will be moved to a new category and, if selected, be assigned the new access level and language.
  3. When all of the settings are entered, click on Process to perform the changes. A message "Batch process completed successfully." will show.

Note that nothing will happen if you (a) don't have any items selected or (b) have not selected an access level, language, or category.

If you wish to clear your entered selections, click on the Clear button. This will return all of the Batch controls to their default values. Note that this does not uncheck the check boxes for the items.

Options

Clicking on the Options icon in the toolbar opens a modal window where you can set component level options for articles. To see the help screen for Options, click Article Manager Options

Quick Tips

  • If Joomla is installed without sample data, one article category called "Uncategorised" is created automatically. If you want to use other categories for articles, you should create them before trying to add articles.
  • To see trashed and archived articles, set the Status filter to All.
  • To change the ordering of articles within a category, click on the Ordering column heading to sort by this column. Also, it is easier to see the ordering if you filter on the desired category.

Related Information