Content Article Manager Options
From Joomla! Documentation
Revision as of 14:54, 25 June 2012 by Dextercowley
- 1 How To Access
- 2 Description
- 3 Screenshot
- 4 Column Headers
- 5 Toolbar
- 6 Quick Tips
- 7 Related Information
How To Access
In the back end of your site, navigate to Article Manager and click on the Options button in the toolbar. Doing so opens this modal window.
This screen is where you can set global defaults for menu items that display articles. These default values will be used when you select "Use Global" for an option in an Articles menu item. For example, if you normally want to show the Create Date for an article in your Articles menu items, then set that option to "Show" here and it will be the default value. You do not need to set any of these options. Your Joomla site will work with the default settings.
Article options are divided into nine groups as follows. Each controls the appearance of the listed type of layout.
- Articles: Articles in Single Article or blog layouts.
- Editing Layout: Front-end article add/edit layout.
- Category: Single Category layouts -- for example, when you click on a category to view the articles it contains.
- Categories: Articles Categories layout.
- Blog/Featured Layouts: Featured and Category Blog Layout.
- List Layouts: Category List Layout.
- Shared Options: Shared options for list, blog, and featured layouts.
- Integration: Feed Link and Read More options.
- Permissions: ALC permissions for actions on articles.
Article Options control how an article will show in a Single Article menu item or, in some cases, in a Blog menu item.
- Choose a layout. If you have defined any alternative layouts for articles, you may choose one of them from the list to be the default value for Single Article menu items.
- Show Title. (Hide/Show). Hide or Show the article title.
- Linked Titles. (No/Yes). Whether or not the article title will be a link to a Single Article menu item for 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. (Hide/Show). Hide or Show the article's category title.
- Link Category. (No/Yes). If the category title is shown, whether or not to show it as a link to a Single Category menu item for the category. Note that you can set this to be either a blog or list layout with the "Choose a layout" option in the Category Options.
- Show Parent. (Hide/Show). Hide or Show the title of the parent category of the article's category. This is provided for backward compatibility to the role of Sections in Joomla version 1.5.
- Link Parent. (No/Yes). If the parent category is shown, whether or not to show it as a link to a Single Category menu item for the category. Note that you can set this to be either a blog or list layout with the "Choose a layout" option in the Category Options.
- Show Author. (Hide/Show). Hide or Show the article's author.
- Link Author. (No/Yes). If the author is shown, whether or not to show it as a link to the Joomla user. Note that this will only show as a link if there is a Contact associated with this user. Also, a link will not show if there is an Author Alias value for the article.
- Show Create Date. (Hide/Show). Hide or show the article's create date.
- Show Modify Date. (Hide/Show). Hide or show the date the article was last modified.
- Show Publish Date. (Hide/Show). Hide or show the article's published date.
- Show Navigation. (Hide/Show). Hide or Show a navigation link (e.g., Next, Previous) between articles.
- Show Voting. (Hide/Show). Hide or Show a voting button for the article. This allows users to vote for an article.
- Show "Read More". (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.
- Show Title with Read More. (Hide/Show) Whether or not to show the article title as part of the Read More link. If set to Show, the Read More link will be in the format "Read More: <article title>". If set to Hide, the Read More link will be "Read more...".
- Read More Limit. If the title is included with the Read More text, the maximum number of characters from the title to include. This can prevent the Read More text to become excessively long if the article has a very long title.
- Show Icons. (Hide/Show). Hide or Show icons for the print and email buttons. If Show, and if the print or email icons are set to show, these will show as icons instead of text links.
- Show Print Icon. (Hide/Show). Hide or Show a button or link to allow printing the article.
- Show Email Icon. (Hide/Show). Hide or Show a button or link to allow emailing the article.
- Show Hits. (Hide/Show). Hide or Show the number of times the article has been viewed (called hits).
- Show Unauthorised Links. (Hide/Show). If set to Show, 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. If set to Hide, articles that the user is not authorised to view (based on the viewing access level for the article) will not show.
- Positioning of the Links. (Above/Below). If there are links associated with this article, whether to show them above or below the article.
Editing Layout Options
Category Options control how articles will show when you drill down to a Category to view its articles.
- Choose a layout. (Blog/List/user defined). This lets you select the default layout to show when you click on a Category link. If you create an alternative layout for a category layout, you may select that as the default.
- Category Title. (Hide/Show) Hide or Show the title of the category.
- Category Description. (Hide/Show) Hide or Show the description for the category.
- Category Image. (Hide/Show) Hide or Show the category image.
- Subcategory Levels. (None/All/1-5). Categories in Joomla can be created in a hierarchy. This lets you control how many levels of subcategories to show when showing a category view.
- Empty Categories. (Hide/Show) Hide or Show categories that don't contain any articles or subcategories.
- No Articles Message. (Hide/Show) If Show, and if Empty Categories is Show, a message "There are no articles in this category" will show if a category contains no articles.
- Subcategories Descriptions. (Hide/Show) Hide or Show the descriptions for subcategories that are shown.
- # Articles in Category. (Hide/Show) Hide or Show a count of the total number of articles in each category.
Categories Options control the display of the List All Categories menu item.
- Top Level Category Description. (Hide/Show). Hide or Show the description of the top-level category.
- Subcategory Levels. (All/1-5). How many levels in the hierarchy to show.
- Empty Categories. (Hide/Show). Hide or Show categories that contain no articles and no subcategories.
- Subcategories Descriptions. (Hide/Show). Hide or Show the description of each subcategory.
- # Articles in Category. (Hide/Show). Hide or Show a count of the total number of articles in each category.
Blog / Featured Layout Options
These options control the layout of the Category Blog and Featured Articles layouts.
- # Leading Articles. Number of Articles to show using the full width of the main display area. "0" means that no Articles will show when using the full width. If an Article has a "Read more..." break, only the part of the text before the break (the Intro text) will display.
- # Intro Articles. Determines the number of Articles to display after the leading Article. These Articles will display in the number of columns set in the Columns parameter below. If an Article has a "Read more..." break, only the text before the break (Intro text) will display, followed by a "Read more..." link. The order order in which to display the articles is determined by the Category Order and Article Order parameters below.
- # Columns. The number of columns to use in the Intro Text area. This is normally between 1 and 3 (depending on the template you are using). If 1 is used, the Into Text Articles will display using the full width of the display area, just like the Leading Articles.
- # Links. The number of Links to display in the 'Links' area of the page. These links allow a User to link to additional Articles, if there are more Articles than can fit on the first page of the Blog Layout.
- Multi Column Order. In multi-column blog layouts, whether to order articles Down the columns or Across the columns.
- Down: Order articles going down the first column and then over to the next column, for example:
article 1 1 (continued) article 2 article 4 article 3 article 5
- Across: Order articles going across the columns and then back to the first column, for example:
article 1 1 (continued) article 2 article 3 article 4 article 5
- Include Subcategories. (None/All/1-5). If None, only articles from the current category will show. If 1-5, all articles from the current category and subcategories up to and including that level will show. If All, all articles from the current category and all subcategories will show.
List Layout Options
These options control the appearance of the Category List layout.
- Display Select. (Hide/Show) Whether to hide or show the Display # control that allows the user to select the number of items to show in the list. An example is shown below.
- Filter Field. The Filter Field creates a text field where a user can enter a field to be used to filter the articles shown in the list. An example of how this looks in the front-end layout is shown below.
- The possible options for this (in the back-end menu item edit) are shown below.
- Hide: Don't show a filter field.
- Title: Filter on article title.
- Author: Filter on the author's name.
- Hits: Filter on the number of article hits.
- Table Headings. (Hide/Show) Table Headings show a heading above the article list, as shown below.
- Show Date. This option allows you to show a date in the list. The options are as follows.
- Hide: Don't show any date.
- Created: Show the created date.
- Modified: Show the date of the last modification.
- Created: Show the start publishing date.
- Date Format. Optional format string to control the format of the date (if shown). If left blank, the date will use the DATE_FORMAT_LC1 format from the language file (for example, "D M Y" for "31 December 2012" or "m-d-y" for "12-31-12"). See PHP Date Documentation for more information.
- Show Hits in List. (Hide/Show) Whether to hide or show the number of hits for this item.
- Show Author in List. (Hide/Show) Whether to hide or show the name of the author.
These options are shared by a number of the articles menu item types.
- Category Order. Order of Categories in this Layout. The following options are available.
- No Order: Articles are ordered only by the Article Order, without regard to Category.
- Title Alphabetical: Categories are displayed in alphabetical order (A to Z)
- Title Reverse Alphabetical: Categories are displayed in reverse alphabetical order (Z to A)
- Category Manager Order: Categories are ordered according to the Order column entered in the Category Manager.
- Article Order. Order of articles in this Layout. The following options are available.
- Most recent first: Articles are displayed starting with the most recent and ending with the oldest.
- Oldest first: Articles are displayed starting with the oldest and ending with the most recent.
- Title Alphabetical: Articles are displayed by Title in alphabetical order (A to Z)
- Title Reverse Alphabetical: Articles are displayed by Title in reverse alphabetical order (Z to A)
- Author Alphabetical: Articles are displayed by Author in alphabetical order (A to Z)
- Author Reverse Alphabetical: Articles are displayed by Author in reverse alphabetical order (Z to A)
- Most Hits: Articles are displayed by the number of hits, starting with the one with the most hits and ending with the one with the least hits
- Least Hits: Articles are displayed by the number of hits, starting with the one with the least hits and ending with the one with the most hits
- Ordering: Articles are ordered according to the Order column entered in the Article Manager.
- Date for Ordering. The date used when articles are sorted by date. The following options are available.
- Created: Use the article created date.
- Modified: Use the article modified date.
- Published: Use the article start publishing date.
- Pagination. Hide or Show Pagination support. Pagination provides page links at the bottom of the page that allow the User to navigate to additional pages. These are needed if the Articles will not fit on one page. An example is shown below.
- Auto: Pagination links shown if needed.
- Show: Pagination links shown if needed.
- Hide: Pagination links not shown. Note: In this case, Users will not be able to navigate to additional pages.
- Pagination Results. Hide or Show the current page number and total pages (e.g., "Page 1 of 2") at the bottom of each page.
These options control the display of news feeds.
- Show Feed Link. (Hide/Show) Whether to Hide or Show a link to a news feed (RSS Feed). If set to Show, a Feed Link will show up as a feed icon in the address bar of most modern browsers).
- For each feed item show. (Intro Text/Full Text) If Intro Text, only the article's intro text will show in the feed. Otherwise, the entire text of the article will show.
- Show "Read More". (Hide/Show) Hide or Show a "Read more" link in the newsfeed.
This section lets you set up the default ACL permissions for all articles in all categories. These permissions may be overridden for specific categories and for specific articles.
To change the permissions, do the following.
- Select the Group by clicking its title.
- Find the desired Action. Possible Actions are:
- Configure. Users can access this screen (Article Manager→Options).
- Access Administrative Interface. Users can access the Article Manager.
- Create. Users can create new articles.
- Delete. Users can delete articles.
- Edit. Users can edit the contents of articles.
- Edit State. User can change the published state and related information for articles.
- Edit Own. User can edit the content or published state for articles that this user created.
- Select the desired permission for the action you wish to change. Possible settings are:
- Inherited. Inherited for users in this Group from Global Configuration.
- Allowed. Allowed for users in this Group. Note that, if this action is Denied at one of the higher levels, the Allowed permission here will not take effect. A Denied setting cannot be overridden.
- Denied. Denied for users in this Group.
- Click Save. When the screen refreshes, the Calculated Setting column will show the effective permission for this Group and Action.
At the top right of the Options modal window you will see the toolbar.
The functions are:
- Save. Saves any changed options and keeps the window open. Use this, for example, to see the effect of Permissions changes you have made.
- Save & Close. Saves any changed options and closes the modal window.
- Cancel. Closes the modal window without saving any changes.
- If you are a beginning user, you can just keep the default values here until you learn more about using global options.
- If you are an advanced user, you can save time by creating good default values here. When you set up menu items and create articles, you will be able to accept the default values for most options.
- All values set here can be overridden at the menu item, category, or article level.