Actions

Help25

Menus Menu Item Article Categories

From Joomla! Documentation

Revision as of 19:14, 15 April 2012 by Dextercowley (Talk | contribs)

Contents

How To Access

To create a new List All Categories Menu Item:

  • Select Menus → [name of the menu] from the drop-down menu on the back-end of your Joomla! installation (for example, Menus → Main Menu).
  • Click New to create a new menu item.
  • Click the Menu Item Type Select button and then click the List All Categories link under Articles.

To edit an existing List All Categories Menu Item, click its Title in Menu Manager: Menu Items.

Description

Used to show a list of Categories. Categories are shown in a hierarchical list, as shown below.

Help25-article-categories-front-end.png

Depending on the selected options for this layout, you can click on a category Title to show the articles in that category.

Screenshot

Help25-chunk-menu-item-categories.png

Column Headers

Common Options

See Menu Item Manager: New Menu Item for help on fields common to all Menu Item types, including Details, Link Type Options, Page Display Options, Metadata Options, and Module Assignments for this Menu Item.

Required Settings

This layout requires that you select a starting top-level category. This is done in the list box shown below.

Help25-article-categories-required-settings.png

To include all article categories, select Root. Otherwise, select the desired top-level category. All child categories of the selected category will show in the layout.

Categories Options

The Categories Options allow you to control various aspects of this layout, as shown below. If you select Use Global for any option, the value from the Article Manager Options will be used.

Help25-article-categories-categories-options.png
  • Top Level Category Description. (Use Global/Hide/Show) Whether to hide or show the description of the top-level category. Note that this description can be overridden for this layout by entering a Top Level Description below.
  • Top Level Category Description Override. Enter an optional description to override the category description for this layout. If the Top Level Description option is set to Show, this entered description will show instead of the normal category description.
  • Subcategory Levels. (Use Global/All/1-5) The number of levels of subcategories to show in the layout. Select All to show all levels in the subcategory hierarchy.
  • Empty Subcategories. (Use Global/Hide/Show) Whether to hide or show categories that contain no items.
  • Subcategories Descriptions. (Use Global/Hide/Show) Whether to hide or show the category description of subcategories.
  • # Articles in Category. (Use Global/Hide/Show) Whether to hide or show the count of articles in each category.

Category Options

Help25-article-categories-category-options.png

Blog Layout Options

Help25-article-categories-blog-layout-options.png

List Layout Options

Help25-article-categories-list-layout-options.png

Article Options

The List All Categories Layout has the following Article Options, as shown below.

Help25-article-categories-article-options.png

The List All Categories Layout has the following Article Options, as shown below. In addition to Yes/No or Hide/Show, these options allow the "Use Global" setting. This uses the default value from Article Manager Options.

The Article Options are as follows.

  • Show Title. (Use Global/Hide/Show). Whether or not to show the Article's Title.
  • Linked Titles. (Use Global/No/Yes). If the Article's Title is shown, whether to show it as a link 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.
  • Show Category. (Use Global/Hide/Show). Whether or not to show the Article's Category.
  • Link Category. (Use Global/No/Yes). If the Article's Category is shown, whether to show it as a link to a Category layout (list or blog) for that Category.
  • Show Parent. (Use Global/Hide/Show). Whether or not to show the Article's Parent Category.
  • Link Parent. (Use Global/No/Yes). If the Article's Parent Category is shown, whether to show it as a link to a Category layout (list or blog) for that Category.
  • Show Author. (Use Global/Hide/Show) Whether to show the author of the Article.
  • Link Author. (Use Global/No/Yes). If the Article's author is shown, whether to show it as a link to a Contact layout for that author. Note that the author must be set up as a Contact in Contact Manager: Edit.
  • Show Create Date. (Use Global/Hide/Show). Whether or not to show the Article's create date.
  • Show Modify Date. (Use Global/Hide/Show). Whether or not to show the Article's modify date.
  • Show Publish Date. (Use Global/Hide/Show). Whether or not to show the Article's start publishing date.
  • Show Navigation. (Use Global/Hide/Show). Whether or not to show a navigation link (for example, Next or Previous article) when you drill down to the article.
  • Show Voting. (Use Global/Hide/Show). Whether or not to show the a voting icon for the article.
  • Show Read More. (Use Global/Hide/Show). Whether or not to show a "Read More" link to allow a drill down to the entire article.
  • Show Title with Read More. (Use Global/Hide/Show). If set to Show, the Article's title will show in the "Read More" button.
  • Show Icons. (Use Global/Hide/Show). If set to Show, Print and Email will use icons instead of text.
  • Show Print Icon. (Use Global/Hide/Show). Show or Hide the Print Article button.
  • Show Email Icon. (Use Global/Hide/Show). Show or Hide the Email Article button.
  • Show Hits. (Use Global/Hide/Show). Show or Hide the number of times the article has been hit (displayed by a user).
  • Show Unauthorised Links. (Use Global/No/Yes). If Yes, the Intro Text for restricted articles will show. Clicking on the "Read More" link will require users to log in to view the full article content.

Integration Options

The List All Categories layout has the following Integration Options.

Help25-chunk-integration-options.png

These determine whether a news feed will be available for the page and what information it will show.

Toolbar

At the top right you will see the toolbar:

Help25-chunk-menu-item-toolbar.png

The functions are:

  • Save. Saves the menu item and stays in the current screen.
  • Save & Close. Saves the menu item and closes the current screen.
  • Save & New. Saves the menu item and keeps the editing screen open and ready to create another menu item.
  • Save as Copy. Saves your changes to a copy of the current menu item. Does not affect the current menu item. This toolbar icon is not shown if you are creating a new menu item.
  • Cancel/Close. Closes the current screen and returns to the previous screen without saving any modifications you may have made.
  • Help. Opens this help screen.

Quick Tips

  • To see an example of the featured layout, install Joomla with the sample data and select the Home page.

Related Information