Help25

Difference between revisions of "Components Weblinks Links"

From Joomla! Documentation

Line 25: Line 25:
 
===Filter by Partial Title===
 
===Filter by Partial Title===
  
You can filter the list of items by typing in part of the Title or the ID number.
+
You can filter the list of items by typing part of the weblinks name or the ID number of the weblink.
 
+
[[Image:help25-banners-manage-filter-name.png]]
{{Chunk25:listfiltering|Filter}}
 
  
 
===Filter by State, Category, Access and Language===
 
===Filter by State, Category, Access and Language===
Line 36: Line 35:
  
 
The selections may be combined. Only items matching all selections will be displayed in the list.
 
The selections may be combined. Only items matching all selections will be displayed in the list.
{{Chunk25:listfiltering|Select State}}
+
{{Chunk25:colheader|Select Status}}
{{Chunk25:listfiltering|Select Category}}
+
{{Chunk25:colheader|Select Category}}
{{Chunk25:listfiltering|Select Access}}
+
{{Chunk25:colheader|Select Access}}
{{Chunk25:listfiltering|Select Language}}
+
{{Chunk25:colheader|Select Language}}
  
 
===Number of Items to Display===
 
===Number of Items to Display===
 
 
Below the list you'll find:
 
Below the list you'll find:
 
+
{{Chunk25:colheader|Manager Pagination}}
{{Chunk25:Help_screen_list_Display_Count}}
 
  
 
==Toolbar==
 
==Toolbar==

Revision as of 20:12, 17 March 2013

The Web Links Manager allows you to manage links to other web sites and organize them into categories.

How to Access[edit]

Select Components → Weblinks → Links from the drop-down menu of the Joomla! Administrator Panel, or select the "Links" link on the Web Links Category Manager screen.

Description[edit]

The Web Links Manager allows you to add, edit and remove links to other web sites on your Joomla! web site, and organize them into categories. You can then display these links on your site, and optionally let visitors add new links.

Screenshot[edit]

Help25-components-weblinks-links-screen.png

Column Headers[edit]

  • Checkbox. Check this box to select one or more items. To select all items, check the box in the column heading. After one or more boxes are checked, click a toolbar button to take an action on the selected item or items. Many toolbar actions, such as Publish and Unpublish, can work with multiple items. Others, such as Edit, only work on one item at a time. If multiple items are checked and you press Edit, the first item will be opened for editing.
  • Title. The name of the item. For a Menu Item, the Title will display in the Menu. For an Article or Category, the Title may optionally be displayed on the web page. This entry is required. You can open the item for editing by clicking on the Title.
  • Status. (Published/Unpublished/Archived/Trashed) The published status of the item.
  • Ordering. The order in which to display items. You can sort the list by order number by clicking on the Ordering label in the column heading. If the list is sorted by this column, you can change the order by clicking the arrows or by entering the sequential order and clicking the 'Save Order' icon. This is shown in the screen below.
    Help25-chunk-colheader-order-icons.png
    Note that the ordering is only defined within a single category. For this reason, it is easier to re-order the list if you use the Category filter to select one category.
  • Access. The viewing level access for this item.
  • Hits. The number of times an item has been viewed.
  • Language. Item language.
  • ID. This is a unique identification number for this item assigned automatically by Joomla!. It is used to identify the item internally, and you cannot change this number. When creating a new item, this field displays 0 until you save the new entry, at which point a new ID is assigned to it.

List Filters[edit]

Filter by Partial Title[edit]

You can filter the list of items by typing part of the weblinks name or the ID number of the weblink. Help25-banners-manage-filter-name.png

Filter by State, Category, Access and Language[edit]

In the upper right area, above the column headings, are 4 drop-down list boxes as shown below:

Help25-components-weblinks-links-list options.png

The selections may be combined. Only items matching all selections will be displayed in the list.

  • Filter by Published Status. Lets you show only items with the selected published status.
    Help25-chunk-colheader-select-status.png
    • - Select Status -: Shows items that are Published and Unpublished. Does not show items that are Trashed or Archived.
    • Published: Shows only items that are Published.
    • Unpublished: Shows only items that are Unpublished.
    • Archived: Shows only items that are Archived.
    • Trashed: Shows only items that are Trashed. Important Note: To permanently delete items:
      1. Change the status of the items to Trashed.
      2. Change the Status filter to Trashed. At this point the trashed items will show and an icon called "Empty trash" will show in the toolbar.
      3. Select the desired trashed items and click on "Empty Trash" in the toolbar. The items will be permanently deleted.
    • All: Shows all items regardless of published status.
  • Filter by Category. Lets you show only items assigned to a specific category. The list box will show the categories defined for your site, similar to the example below.
    Help25-chunk-colheader-select-category.png
    • - Select Category -: Show items assigned to any category.
    • <your category>: Show items assigned only to this category.
  • Filter by Viewing Access Level. Lets you show only items that have a specified viewing access level. The list box will show the access levels defined for your site, similar to the example below.
    Help25-chunk-colheader-select-access.png
    • - Select Access -: Show items with any viewing access level.
    • <your access level>: Show items only with this viewing access level.
  • Filter by Language. Lets you show only items that have a specific language assigned. The list box will show the languages defined for your site, similar to the example below.
    Help25-chunk-colheader-select-language.png
    • - Select Language - or All: Show items for any language.
    • <your language>: Show items only for this language.

Number of Items to Display[edit]

Below the list you'll find:

  • Page Controls. When the number of items is more than one page, you will see a page control bar as shown below.
    Help25-chunk-colheader-pagination.png
    • Display #: Select the number of items to show on one page.
    • Start: Click to go to the first page.
    • Prev: Click to go to the previous page.
    • Page numbers: Click to go to the desired page.
    • Next: Click to go to the next page.
    • End: Click to go to the last page.

Toolbar[edit]

At the top right you will see the toolbar:

Help25-Toolbar-New-Edit-Publish-Unpublish-Archive-Checkin-Trash-Options-Help.png

The functions are:

  • New. Opens the editing screen to create a new web link.
  • Edit. Opens the editing screen for the selected web link. If more than one web link is selected (where applicable), only the first web link will be opened. The editing screen can also be opened by clicking on the Title or Name of the web link.
  • Publish. Makes the selected web link available to visitors to your website.
  • Unpublish. Makes the selected web links unavailable to visitors to your website.
  • Archive. Changes the status of the selected web links to indicate that they are archived. Archived web links can be moved back to the published or unpublished state by selecting "Archived" in the Select Status filter and changing the status of the web links to Published or Unpublished as preferred.
  • Check In. Checks-in the selected web links. Works with one or multiple web links selected.
  • Trash. Changes the status of the selected web links to indicate that they are trashed. Trashed web links can still be recovered by selecting "Trashed" in the Select Status filter and changing the status of the web links to Published or Unpublished as preferred. To permanently delete trashed web links, select "Trashed" in the Select Status filter, select the web links to be permanently deleted, then click the Empty Trash toolbar icon.
  • Options. Opens the Options window where settings such as default parameters or permissions can be edited.
  • Help. Opens this help screen.

"Web Links" / "Categories" Links[edit]

At the top left, above the Filter, you will see two links as shown below:

  • Web Links. This link is disabled, since we are already in the Web Links page.
  • Categories. Click this link to go to the Web Links Category Manager page.

Options[edit]

Click the Options button to open the Web Links Manager Options window which lets you configure this component.

Note: Many of the options specified here can be overridden for each List All Web Link Categories and List Web Links in a Category menu items or in each individual Web Link item.

Save / Cancel[edit]

Chunk25:Buttons Chunk25:Buttons

Weblink Tab[edit]

The first tab, shown below, contains display options for Weblinks in front-end pages that are displayed by Web Links menu items:

Help25-components-weblinks-links-options-weblink.png

Chunk25:Help screen weblinks target

  • Count Clicks. (Yes/No) Whether to count how many times the weblink has been clicked on.
  • Icon. The Icon to be displayed to the left of the Web Links URL. Select an image file from the drop-down list box. The images are listed from the 'images/M_images' folder.

Category Tab[edit]

These settings apply to menu items of type List All Web Link Categories and List Web Links in a Category, unless they are overridden in the menu item's Category options.

Help25-components-weblinks-links-options-category.png

Chunk25:Help screen component options Category Chunk25:Help screen component options Category Chunk25:Help screen component options Category Chunk25:Help screen component options Category Chunk25:Help screen component options Category Chunk25:Help screen component options Category

  • # Web links. Hide or Show the number of Web Links in each category.

Categories Tab[edit]

These settings apply to menu items of type List All Web Link Categories, unless they are overridden in the menu item's Categories options.

Help25-components-weblinks-links-options-categories.png

Chunk25:Help screen component options Categories Chunk25:Help screen component options Categories Chunk25:Help screen component options Categories Chunk25:Help screen component options Categories

  • # Web links. Hide or Show the number of Web Links in each category.

List Layouts Tab[edit]

Help25-components-weblinks-links-options-list layouts.png

Chunk25:Help screen component options ListLayouts Chunk25:Help screen component options ListLayouts

  • Links description. Hide or Show the Link Description for each Web Link.
  • Hits. Hide or Show the number of hits for each Web Link.

Chunk25:Help screen component options ListLayouts Chunk25:Help screen component options ListLayouts

Integration Tab[edit]

Help25-components-weblinks-links-options-integration.png

Chunk25:Help screen component options Integration Chunk25:Help screen component options Integration

Permissions Tab[edit]

Chunk25:Help screen component options permissions all with image

Displaying Links on your Site[edit]

One way of displaying links on your site is to use the Weblinks module to list links from a specific category. Another method is to create a menu item of type Weblinks - List All Web Link Categories or Weblinks - List Web Links in a Category to have a page display all Web Links categories, or all links within one Web Links category.

Letting Visitors Submit Links[edit]

You might also wish to let visitors submit new Web Links. To do so, simply add a Submit a Web Link menu item to one of your menus.

Quick Tips[edit]

  • You need to add at least one Category for Web Links before you can add your first Web Link. Categories are added using the Web Link Category Manager.

Related Information[edit]