News Feed: Options
From Joomla! Documentation
Description[edit]
News Feed Options configuration allows setting of parameters used globally for all news feeds.
How to Access[edit]
- Select Components → News Feeds → Feeds from the Administrator menu. Or...
- Select Components → News Feeds → Categories from the Administrator menu. Then...
- Click the Options button on the Toolbar.
Screenshot[edit]
Form Fields[edit]
News Feed Tab[edit]
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 that versions may be deleted manually using the Delete button in the Version History screen.
- 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 Tab[edit]
Category Options control how feeds will show when you drill down to a Category to view its feeds.
- 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. (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 Tab[edit]
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 Tab[edit]
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 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.
- Display Select. (Show/Hide) Whether to show or hide the Display # control that allows the user to select the number of items to show in the list. An example is shown below.
- If there are more items 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 items, it may be helpful to use the Filter options, located above the column headings, to limit which items display.
- Table Headings. (Hide/Show) Table Headings show a heading above the article 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 feed.
- Feed Links. (Show/Hide). Whether to show or hide the feed links URL.
- 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 listed items will not fit on one page. An example is shown below.
-
- 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. Hide or Show 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 Tab[edit]
These options control the display of news feeds.
- Remove IDs from URLs. (Yes or No) Whether or not to show the database id of a newsfeed in a link.
Permissions Tab[edit]
This section shows permissions for feeds. The screen shows as follows.
To change the permissions for this extension, do the following.
- Select the Group by clicking its title located on the left.
- Find the desired Action. Possible Actions are:
- Configure ACL & Optons. Users can edit the options and persimissions of this extension.
- Configure Optons Only. Users can edit the options exept the persimissions of this extension.
- Access Administration Interface. Users can access user administration interface of this extension.
- Create: Users can create content of this extension.
- Delete: Users can delete content of this extension.
- Edit: Users can edit content of this extension.
- Edit State: User can change the published state and related information for content of this extension.
- Edit Own: Users can edit own created content of this extension.
- 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 extension.
- 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 in Toolbar at top. When the screen refreshes, the Calculated Setting column will show the effective permission for this Group and Action.
Toolbar[edit]
At the top of the page you will see the toolbar shown in the Screenshot above. The functions are:
- Save. Saves the item and stays in the current screen.
- Save & Close. Saves the item and closes the current screen.
- Close. Closes the current screen and returns to the previous screen without saving any modifications you may have made. This toolbar icon is not shown if you are creating a new item.
- Help. Opens this help screen.
Quick Tips[edit]
- 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[edit]
- To create and edit news feeds and news feed categories: News Feed Manager
- For more information about Joomla's ACL system: Joomla 3 ACL Tutorial