Joomla! Documentation™

Description

News Feed Options configuration allows setting of parameters used globally for all news feeds.

How to Access

From the administrator area, select Components → News Feeds from the drop-down menu of the Administration screen. Click the Options button on top.

Screenshot

Details

Click the Options button to open the News Feed Manager Options window which lets you configure this component.

News Feed

These settings apply for all News Feeds unless they are changed for a specific menu item or News Feed

• Choose a Layout. Default layout to use for articles.

• Enable Versions. (Yes/No) Whether or not to save version history for this component. If 'No', version history will not be saved for component items or for this component's categories.
• Maximum Versions. The maximum number of versions to store for an item. If an item is saved and the maximum number of versions has been reached, the oldest version will be deleted automatically. If set to '0', then versions will never be deleted automatically. Also, specific versions may be flagged as "Keep Forever" and will not be deleted automatically.
  Note: Versions may be deleted manually using the 'Delete' button in Version History.
• Feed Image. (Show/Hide). Show or hide the feed image.
• Feed Description. (Show/Hide). Show or hide the feed description.
• Feed Content. (Show/Hide). Show or hide the feed content.
• Characters Count. The maximum number of characters to display for each feed. This is a way to limit the size of the feed.
• Feed Display Order. (Most recent first/oldest first). The order in which to show the feeds.
• First Image Float. (Right/Left/None). Where to display the image on the page.
• Second Image Float. (Right/Left/None). Where to display the image on the page.
• Show Tags. (Show/Hide). Show or hide the feed's tags.

Category

Category Options control how feeds will show when you drill down to a Category to view its feeds.

• Choose a Layout. (Default/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. (Show/Hide). Show or hide the title of the category.
• Category Description. (Show/Hide). Show or hide the description for the category.
• Category Image. (Show/Hide). Show or hide 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. (Show/Hide). Show or hide categories that don't contain any items or subcategories.
• Subcategories Descriptions. (Hide/Show). Show or hide the descriptions for subcategories that are shown.
• # Feeds in Category. (Show/Hide). Show or hide the number of news feeds in category.
• Show Tags. (Show/Hide). Show or hide the tags for a single category.

Categories

These settings apply for News Feed Categories Options unless they are changed for a specific menu item.

• Top Level Category Description. (Show/Hide). Show or hide the description of the top-level category.
• Subcategory Levels. (All/1-5). How many levels in the hierarchy to show.
• Empty Categories. (Show/Hide). Show or hide categories that contain no items and no subcategories.
• Subcategories Descriptions. (Hide/Show). Show or hide the description of each subcategory.
• # Feeds in Category. (Show/Hide). Show or hide the number of news feeds in category.

List Layouts

These settings apply for Feed List Options unless they are changed for a specific menu item.

• 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 backend menu item edit) are shown below.

• Display Select. (Show/Hide) Whether to show or hide the Display # control that allows the user to select the number of news feeds to show in the list. An example is shown below.

If there are more news feeds than this number, you can use the page navigation buttons (Start, Prev, Next, End, and page numbers) to navigate between pages. Note that if you have a large number of news feeds, it may be helpful to use the Filter options, located above the column headings, to limit which news feeds display.

• Table Headings. (Hide/Show) Table Headings show a heading above the news feeds list, as shown below.

If set to Show, this heading will show about the list. Otherwise the list will show with no headings.

• # Articles. (Show/Hide). Whether to show or hide the number or articles in each news feed.
• Feed Links. (Show/Hide). Whether to show or hide feed links URL.

• Pagination. Show or hide 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 listed items will not fit on one page.
  • Use Global: Use the default value from the component options screen.
  • 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. (Use Global/Hide/Show) Show or Hide the current page number and total pages (e.g., "Page 1 of 2") at the bottom of each page. Use Global will use the default value from the component options.

Integration

These options control the display of news feeds.

File:Help30-Component-Newsfeed-Manager-Options-integration-options-subscreen- en.png

• URL Routing. (Legacy/Modern) Modern routing enables advanced features but may change your URLs. Legacy routing ensures full comptability for existing sites. This is configured per component.

Permissions

This section shows permissions for News Feeds. The screen shows as follows.

To change the permissions for News Feeds, do the following.

1. Select the Group by clicking its title located on the left.

2. Find the desired Action. Possible Actions are:

• Configure ACL & Options. Users can edit the options and permissions of News Feeds.

• Configure Options Only. Users can edit the options except the permissions of News Feeds.

• Access Administration Interface. Users can access user administration interface of News Feeds.

• Create. Users can create content of News Feeds.

• Delete. Users can delete content of News Feeds.

• Edit. Users can edit content of News Feeds.

• Edit State. Users can change the published state and related information for content of News Feeds.

• Edit Own. Users can edit own created content of News Feeds.

3. Select the desired Permission for the action you wish to change. Possible settings are:

• Inherited: Inherited for users in this Group from the Global Configuration permissions of News Feeds.

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

4. Click Save in Toolbar at top. When the screen refreshes, the Calculated Setting column will show the effective permission for this Group and Action.

Toolbar

At the top left of the News Feed Manager Options window you will see the toolbar.

The functions are:

• Save. Saves the News Feeds options and stays in the current screen.

• Save & Close. Saves the News Feeds options and closes the current screen.

• Cancel. 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

• 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 news feed menu items, 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 news feed level.

Related Information

• To create and edit news feeds and news feed categories: News Feed Manager
• For more information about Joomla's Access Control List system: ACL Tutorial