Joomla! Documentation™

Description

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

How to Access

• Select Components → News Feeds from the dropdown menu of the Administrator Panel

• Click the Options button in the toolbar.

Screenshot

Form Fields

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) This lets you select the default layout to show when you click on a news feed link. If you create an alternative layout, you may select that as the default.

• Enable Versions. (Yes/No) Whether or not to save version history for news feeds and categories.
• Maximum Versions. The maximum number of versions to store.
  • If a news feed or category 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 text.

• 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. '0' will show all the text.

• Feed Display Order. (Most Recent First/Oldest First) The order in which to show the feeds.

• First Image Float. (Right/Left/None) Controls placement of the image.

• Second Image Float. (Right/Left/None) Controls placement of the image.

• Show Tags. (Show/Hide) Show or hide the tags for a news feed.

Category

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

• Choose a Layout. (Default) This lets you select the default layout to show when you click on a Category link. If you create an alternative layout, you may select that as the default.

• Category Title. (Show/Hide) If Show, the Category Title will show as a subheading on the page. The subheading is usually displayed inside the H2 tag.

• Category Description. (Show/Hide) Show or hide the description of the category.

• Category Image. (Show/Hide) Show or hide the image of the category.

• Subcategory Levels. (None/All/1-5) The number of subcategory levels to display. Select 'All' to show all levels in the subcategory hierarchy.

• Empty Categories. (Show/Hide) Show or hide categories that contain no news feeds and no subcategories.

• Subcategories Descriptions. (Show/Hide) Show or hide the subcategories descriptions.

• # Feeds in Category. (Show/Hide) Show or hide the number of news feeds in each category.

• Show Tags. (Show/Hide) Show or hide the tags for the 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 description of the top level category or alternatively replace with the text from the description field found in the menu item. If using Root as a top level category, the description field has to be filled.

• Subcategory Levels. (None/All/1-5) The number of subcategory levels to display. Select 'All' to show all levels in the subcategory hierarchy.

• Empty Categories. (Show/Hide) Show or hide categories that contain no news feeds and no subcategories.

• Subcategories Descriptions. (Show/Hide) Show or hide the subcategories descriptions.

• # Feeds in Category. (Show/Hide) Show or hide the number of news feeds in each category.

List Layouts

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

• Filter Field. (Show/Hide) The Filter Field creates a text field where a user can enter a field to be used to filter the news feeds shown in the list.

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

• Table Headings. (Show/Hide) If set to Show, this heading will show above the list. If set to Hide, the list will show with no headings.

• # Articles. (Show/Hide) Show or hide the number of articles in each news feed.

• Feed Links. (Show/Hide) Show or hide the feed links URLs.

• 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 news feeds will not fit on one page.
  • 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. (Show/Hide) Show or hide the current page number and total pages (e.g., "Page 1 of 2") at the bottom of each page.

Integration

These options control the display of news feeds.

• URL Routing. This is configured for the News Feeds component.
  • Legacy: Ensures full comptability for existing sites.
  • Modern: Enables advanced features but may change your URLs.

Permissions

Manage the permission settings for user groups.

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 this site.

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

• For more information about Joomla's Access Control List system: ACL Tutorial

Help Screens

Component	Description
News Feeds	Provides an overview of the News Feeds from other sites available on a Joomla site. The screen is used to find, add, edit and delete News Feeds from other sites.
News Feeds Edit	This is where you can Add a new News Feed. Edit an existing News Feed.
Categories	Provides an overview of the News Feeds Categories available on a Joomla site. The screen is used to find, add, edit and delete News Feeds Categories.
Categories Edit	This is where you can Add a new News Feed Category. Edit an existing News Feed Category.
Options (this screen)	News Feed Options configuration allows setting of parameters used globally for all news feeds.

Menu Items	Description
Categories	Used to show a list of all News Feed Categories. Categories are shown in a hierarchical list.
Category	Used to show all News Feeds belonging to a specific Category in a list layout.
Single News Feed	Used to show one News Feed in the Frontend of the site.