Help15

Screen.banners.15

From Joomla! Documentation

Revision as of 08:30, 2 June 2008 by CirTap (talk | contribs) (moved content of Quick Tips to Description: it's not a "tip", it's an essential step)

How to Access[edit]

Select Components → Banner → Banners from the drop-down menu in the back-end of your Joomla! installation. You can also select the 'Banners' link from the Banner Client Manager or the Banner Categories Manager.

Description[edit]

The Banner Manager is where you can edit existing Banners and create new ones. You can also navigate to the Banner Client Manager and the Banner Category Manager. You must add at least one Banner Client and Banner Category before you can add a Banner.

Screenshot[edit]

Banner manager banners.png

Column Headers[edit]

Click on the column heading to sort the list by that column's value.

  • #. An indexing number automatically assigned by Joomla! for ease of reference.
  • 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.
  • Name. The name of the Banner. You can click on the name to open the Banner for editing.
  • Client. The Client for this Banner. Clients are entered using the Banner Client Manager.
  • Category. The Category this item belongs to. Clicking on the Category title opens the Category for editing. See Category Manager - Edit.
  • Published. Whether the item has been published or not. You can change the Published state by clicking on the icon in this column.
  • Order. The order to display items. You can change the order by entering the sequential order and clicking the 'Save Order' icon in the column heading.
  • Sticky. Whether or not the Banner is "sticky". 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 sticky and a third Banner is not sticky, the third Banner will not display if the Banner display module setting is "Sticky, Randomize" or "Sticky, Order." Only the two sticky Banners will display. If the sticky banners have a fixed number of impressions, once those impressions are used up, the sticky banners will no longer display, and the non-sticky banners will begin displaying automatically.
  • Impressions. The Impression count is the number of times the Banner has been displayed on a page. The first number in this column is the actual number of Impressions so far, and the second number is how many Impressions were purchased by the client.
  • Clicks. The first number is the total number of clicks that have been made on the Banner since the counter was reset. The second number is what percentage of the time user clicked on the banner when it was displayed.
  • Tags. Optional Tags to be used for displaying specific Banners based on the content of the Article being viewed. If the Banner module Parameter 'Search By Tag' is set to 'Yes', Banners whose Tags match the Keywords entered for each Article will display when that Article is being viewed.
  • ID. The ID number. This is a unique identification number for this item assigned automatically by Joomla!. It is used to identify the item internally, for example in internal links. You can not change this number.
  • Display #. The number of items to display on one page. 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 (where applicable).

Toolbar[edit]

At the top right you will see the toolbar:

Banner manager banners toolbar.png

  • Publish. To publish one or more items, select them and click on this button.
  • Unpublish. To unpublish one or more items, select them and click on this button.
  • Copy. Select one or more items and click this button to copy them. A new screen will display showing the possible "Copy to" locations on the left and the list of item(s) being copied on the right. To complete the copy, select the desired "Copy to" location and press the Copy button. To cancel the operation, press Cancel.
  • Delete. To delete one or more items, select them and click this button. The selected items will be deleted. Note: only empty items can be deleted.
  • Edit. Select one item and click on this button to open it in edit mode. If you have more than one item selected (where applicable), the first item will be opened. You can also open an item for editing by clicking on its Title or Name.
  • New. Click on this button to create a new item. You will enter the New page for this item.
  • Parameters. Click this button to open the Banners Global Configuration window. This window allows you to set default parameters for Banners, as shown below.
Banner manager banners parameters.png
  • Save. Saves your settings.
  • Cancel. Cancels your changes.
  • Track Banner Impression Times. Whether or not to count how many times a Banner is displayed.
  • Track Banner Click Times. Whether or not to count how many times a Banner is clicked.
  • Tag Prefix. When matching Tags (for matching Banners to Articles based on Keywords), only search for Tags with this prefix. This can improve performance.
  • Help. Opens this Help Screen.

Clients and Categories Links

At the top left, above the Filter, you will see the following three links:

Banner manager banners other.png

List Filters[edit]

Filter by Partial Title

You can filter the list of items by typing part of the title or the ID number. You can also select a combination of Category and Published State.

  • Filter. In the upper left corner just above the column headings is a Filter field and two buttons, as shown below:
    Article manager filter1.png
    If you have a large number of items on the list, you can use this filter to find the desired item(s) quickly. Enter either part of the title and press 'Go' to display the matching items. You can enter in whole words or part of a word. For example, "ooml" will match all titles with the word "Joomla!" in them. You can also search for a specific item id by entering "id:" followed by the id number. For example, "id:123" will find the item with an id of '123'.

Filter by Category and Published State

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

Banner filter.png

The selections may be combined. Only items matching both selections will display in the list.

  • Select Category. Use the drop-down list box to select the desired Category. Only items in this Category will display.
  • Select State. Use the drop-down list box to select the published state: Published or Unpublished.

Related Information[edit]