Help36:Components Banners Banners Edit

How to Access

To 'add' a new Banner or 'edit' an existing Banner, navigate to the Banner Manager:

• Select Components → Banners

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

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

Description

Used to add or edit banners which can be displayed on your Joomla! website. Remember to create at least one Banner Client and one Banner Category before creating any Banners.

Screenshot

Details

Details Sidebar

• Status. (Published/Unpublished/Trashed) The published status of the item.

• Pinned. (Yes or No) Whether or not the Banner is "pinned". If one or more Banners in a Category are designated "sticky," they will take priority over Banners that are not sticky.

For example, if two Banners in a Category are pinned and a third Banner is not pinned, the third Banner will not display if the Banner display module setting is "Pinned, Randomise" or "Pinned, Ordering." Only the two pinned Banners will display. If the pinned banners have a fixed number of impressions, once those impressions are used up, the pinned banners will no longer display, and the non-pinned banners will begin displaying automatically.

• Language. Item language.

• Version Note. Optional field to identify this version of the item in the item's Version History window.

Details Tab

• Name. The name of the Banner. This is the name that will display in the Name column of the Banner Manager.

• 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").
• Type. The type of banner to display. Options are an image file or custom HTML code.
• Image. (Only used for banner type Image). Image file to display for the banner. Click the Select button to browse and select the image file to use. Use the Media Manager to upload Banner image files to your site. Images for Banners have to be in the https://docs.joomla.org/images/banners/ directory.
• Width. (Only used for banner type Image) The fixed width to resize the banner image to. Leave this blank if you want to use the actual width of the banner image file.
• Height. (Only used for banner type Image) The fixed height to resize the banner image to. Leave this blank if you want to use the actual height of the banner image file.
• Alternative Text. (Only used for banner type Image). Text to display in place of the banner image in the event the image cannot be displayed.
• Alternative Text. Alternative text for the Banner's image.
• Click URL. The URL to navigate to when the User clicks on the Banner.

• Description. Enter a description for the Banner.

Banner's Details Tab

• Max. Impressions. The number of Impressions purchased for this Banner. Impressions are the number of times a Banner will be displayed on a page. Check the 'Unlimited' checkbox if an unlimited number of Impressions is allowed.
• Total Impressions. The number of times this Banner has been displayed on a web page to a user. No entry is allowed. You can reset this number to 0 by pressing the 'Reset impressions' button.
• Total Clicks. The number of times this Banner has been clicked. No entry is allowed. You can reset this number to 0 by pressing the 'Reset clicks' button.

• Client. The Client for this Banner. Clients are entered using the Banner Client Manager. Select one from the drop-down list box of existing Clients.

• Purchase Type: The purchase type of the banner. This is used to indicate how the banner client purchased the display time for the banner.

The following options are: (-Use Client Default-, Unlimited, Yearly, Monthly, Weekly, Daily).

• Track Impressions. Whether or not to track the number of times the banner is displayed to web site visitors.
• Track Clicks. Whether or not to track the number of times the banner is clicked by web site visitors.

Publishing Tab

• Start Publishing. Date the Banner will publish and be available for website.

Enter the date (time optional) in format year-month-date hrs:min:sec as '2013-01-07 14:10:00' or alternatively, use the modal 'pop up' window and select a date from the calendar.

• Finish Publishing. Date the Banner will stop being published and will no longer be available for website.

Enter the date (time optional) in format year-month-date hrs:min:sec as '2013-01-07 14:10:00' or alternatively, use the modal 'pop up' window and select a date from the calendar.

• Created Date. Date the item(Article, Category, Weblink, etc.) was created.

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

• Created By Alias. This optional field allows you to enter in an alias for this Author for this Article. This allows you to display a different Author name for this Article.

• Modified Date: (Informative only) Date of last modification.

• Modified By: (Informative only) Username who performed the last modification.

• Revision. (Informative only) Number of revisions to this item.

• 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:
  • To help Search Engines and other systems classify the content of the Article.
  • 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:
    • Add the keywords 'dog' and 'cat' to the appropriate Articles.
    • Add the Tags 'dog' and 'cat' to the appropriate Banners in the Banner Manager New/Edit screen.
    • Set the Banner module Parameter 'Search By Tags' to 'Yes' in the Banner Module Edit screen.
  • 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.

• Use Own Prefix. Whether or not to use the banner's prefix or that of the client. Select No if you want to use the prefix of the banner client.

• Meta Keyword Prefix: When matching meta keywords, only search for meta keywords with these optional prefixes. This improves performance.

Toolbar

At the top you will see the toolbar:

Banners: New:

The functions are:

• Save: Saves the banner and stays in the current screen.

• Save & Close. Saves the banner and closes the current screen.

• Save & New. Saves the banner and keeps the editing screen open and ready to create another banner.

• Cancel. Closes the current screen and returns to the previous screen without saving any modifications you may have made.

• Help. Opens this help screen.

Banners: Edit:

The functions are:

• Save: Saves the banner and stays in the current screen.

• Save & Close. Saves the banner and closes the current screen.

• Save & New. Saves the banner and keeps the editing screen open and ready to create another banner.

• Save as Copy. Saves your changes to a copy of the current banner. Does not affect the current banner. This toolbar icon is not shown if you are creating a new banner.

• Versions: Opens the Item Version History window to show any prior versions of this item. This allows you to view older versions of this item and, if desired, restore from an older version. See Version History for more information.

• 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

• Banners are placed on specific pages by adding Modules of type 'Banners' using the Module Manager.
• If you have a series of Banners that you would like to display on one or more pages in random order:
  1. Create the Banners you wish to include, making sure they have the same Client and Category.
  2. Create a Banner Module for this Client and Category, and in the Menu Assignment pick the Menu Selections for the module to display on.
  3. In the Banner Module, set the 'Randomise' value to 'Sticky, Randomise'.

With these settings, the different Banners for that Client and Category will display on the selected pages in random order.

Related Information

More Component Banner Help:

To place Banners on Pages: