Help25

Components Weblinks Links Edit

From Joomla! Documentation

This screen lets you create new Web Links and edit existing ones.

How to Access[edit]

To 'add' a new Weblink or 'edit' an existing Weblink, navigate to the Web Links Manager:

  • Select Components  Weblinks  Links

Click the 'New' button to create a new Weblink.

To 'Edit' an existing Weblink, in Weblink Manager click on an Weblink's Title or click the Weblink's check box and then click the Edit button in the Toolbar.

Description[edit]

This is where you add a new Web Link or edit an existing one. Note that you need to create at least one Web Links Category before you can create your first Web Link.

Screenshot[edit]

Help25-components-weblinks-links-new edit-screen.png

Details and Options[edit]

Edit Web Link[edit]

This is where you enter or edit basic link information.

  • Title. The Title of the Web Link. This field is required.
  • Alias. The internal name of the item, also used in the URL when SEF is activated. Normally, you can leave this blank and Joomla! will fill in a default value. The default value is the Title or Name in lower case and with dashes instead of spaces. You may enter the Alias manually. The Alias should consist of lowercase letters and hyphens (-). No blank spaces or underscores are allowed. Non-Latin characters can be allowed in the alias if you set the Unicode Aliases option to Yes in Global Configuration. If this option is set to No and the title includes non-Latin characters, the Alias will default to the current date and time (for example "2012-12-31-17-54-38").
  • URL. The URL of the Web Link.
  • State: State of the item. Possible values are:
    • Published: The item is published. This is the only state that will allow regular website users to view this item.
    • Unpublished: The item is unpublished.
    • Archived: The item has been archived.
    • Trashed: The item has been sent to the Trash.
  • Category. Category for this Web Link. Select from the drop-down list box of Web Links Categories. Note that Web Links Categories are separate from other Categories, such as those for Articles, Contacts, Banners, and News Feeds.
  • Ordering. Indicates the order of this Web Link in the Web Link Manager. The default Order is to add the item to the end of the list. To select a different position, use the drop-down list box. This item will be moved to the position just after the item selected from the drop-down list. Note that the Order in which the Web Links are displayed can also be changed in the Web Links Manager.
  • Access. The viewing level access for this item.
  • Language. Item language.
  • ID. The unique ID number automatically assigned to this item by Joomla!. This number cannot be changed.
  • Description. Enter an optional description to display below the Web Link.

Publishing Options[edit]

Help25-weblinks-manager-edit-publishing-options-tab.png

  • Created by. Name of the Joomla! User who created this item. This will default to the currently logged-in user. If you want to change this to a different user, click the Select User button to select a different user.
  • Alias. The internal name of the item, also used in the URL when SEF is activated. Normally, you can leave this blank and Joomla! will fill in a default value. The default value is the Title or Name in lower case and with dashes instead of spaces. You may enter the Alias manually. The Alias should consist of lowercase letters and hyphens (-). No blank spaces or underscores are allowed. Non-Latin characters can be allowed in the alias if you set the Unicode Aliases option to Yes in Global Configuration. If this option is set to No and the title includes non-Latin characters, the Alias will default to the current date and time (for example "2012-12-31-17-54-38").
  • Created Date. This field defaults to the current time when the Article was created. You can enter in a different date and time or click on the calendar icon to find the desired date.
  • Start Publishing. Date and time to start publishing. Use this field if you want to enter content ahead of time and then have it published automatically at a future time.
  • Finish Publishing. Date and time to finish publishing. Use this field if you want to have content automatically changed to Unpublished state at a future time (for example, when it is no longer applicable).

Basic Options[edit]

Help25-components-weblinks-links-edit-basic-options.png

  • Target. (Use Global/Open in Parent Window/Open in New Window/Open in Popup/Modal) The target browser to open the link in when it is clicked
  • Width. Width of the popup/modal window when the weblink is clicked on
  • Height. Height of the popup/modal window when the weblink is clicked on
  • Count Clicks. (Yes/No) If yes Joomla will count the number of times the weblink has been clicked on.

Metadata Options[edit]

Help25-weblinks-manager-edit-contact-metadata-options.png


  • Meta Description. An optional paragraph to be used as the description of the page in the HTML output. This will generally display in the results of search engines. If entered, this creates an HTML meta element with a name attribute of "description" and a content attribute equal to the entered text.
  • Meta Keywords. Optional entry for keywords. Must be entered separated by commas (for example, "cats, dogs, pets") and may be entered in upper or lower case. (For example, "CATS" will match "cats" or "Cats"). Keywords can be used in several ways:
  1. To help Search Engines and other systems classify the content of the Article.
  2. In combination with Banner tags, to display specific Banners based on the Article content. For example, say you have one Banner with an ad for dog products and another Banner for cat products. You can have your dog Banner display when a User is viewing a dog-related Article and your cat Banner display for a cat-related Article. To do this, you would:
    1. Add the keywords 'dog' and 'cat' to the appropriate Articles.
    2. Add the Tags 'dog' and 'cat' to the appropriate Banners in the Banner Manager New/Edit screen.
    3. Set the Banner module Parameter 'Search By Tags' to 'Yes in the Banner Module Edit screen.
  3. For articles only, in combination with the Related Articles module, to display Articles that share at least one keyword in common. For example, if the current Article displayed has the keywords "cats, dogs, monkeys", any other Articles with at least one of these keywords will show in the Related Articles module.
  • External Reference. An optional reference used to link to external data sources. If entered, this creates an HTML meta element with a name attribute of "xreference" and a content attribute equal to the entered text.
  • Robots. The instructions for web "robots" that browse to this page.
    • Use Global: Use the value set in the Component→Options for this component.
    • Index, Follow: Index this page and follow the links on this page.
    • No index, Follow: Do not index this page, but still follow the links on the page. For example, you might do this for a site map page where you want the links to be indexed but you don't want this page to show in search engines.
    • Index, No follow: Index this page, but do not follow any links on the page. For example, you might want to do this for an events calendar, where you want the page to show in search engines but you do not want to index each event.
    • No index, no follow: Do not index this page or follow any links on the page.
  • Rights. The publication rights for the item.
  • Content Rights. Optional metadata field to describe legal rights for the content. Creates an HTML meta element with two attributes: name equals "rights" and content equals the entered text.

Toolbar[edit]

At the top right you will see the toolbar:

Help25-Toolbar-Save-SaveClose-SaveNew-Cancel-Help.png

The functions are:

  • Save. Saves the web link and stays in the current screen.
  • Save & Close. Saves the web link and closes the current screen.
  • Save & New. Saves the web link and keeps the editing screen open and ready to create another web link.
  • Cancel/Close. 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[edit]

  • At least one Web Link Category must be added before any Web Links can be created.

Related Information[edit]