List Item Administration

In Catalog, you often have the need to define specific lists.  List Items allows you to create entries in the lists you created in List Names.

List Items List

Selecting List Items from the Linkbar will present you with a list of the list items defined in Catalog.

Toolbar

In conjuction with selecting one or more checkboxes in the list, the Toolbar provides the following functions:

• Publish the selected item(s).
• Unpublish the selected item(s).
• Edit a selected item.
• Add a new item
• Delete the selected item(s).  Please note that deleting items without thinking may have unpredictable results if their usage was widespread in the catalog.

Filters

You can filter the list by the following:

• Part of a string in the title of a list item title.
• The published state of the items.
• The type of list the items belong to.

List Interaction

You can interact with the list of list items in the following ways:

• Click the linked column headers to change the sort order of the list and to reverse the sort direction.
• In the Title column, click the first link to edit the list item.
• In the Published column, click the icons to toggle between published and unpublished states.
• In the Order column, click the up and down arrow icons to weight the ordering in different directions.
• Use the list pagination features as you would for any other component.

Batch Update

You are able to batch change the List Type that items belong to.  Select any number of items from the list, then select the new List Type that you want them to belong to, then click Process.

Quick Add

The quick add feature allows you to generate many list items in one operation.

First select the List Type in the filters above the table.  This is the type of list that the items will be created in.

Then type as many list names in the text box, each list name on a new line.  Click Add Items and the lists will be created automatically for you.

Adding or Editing a List Item

Toolbar

The Toolbar provides the following functions:

• Save the current item but as a new copy of the original item (Save To Copy).  Any change made are saved with the new item, not the original.
• Save the current item and then returns you to add another (Save & New).
• Save the current item and return to the list.
• Apply the changes made to the current item and return to the same page to continue edits.
• Cancel the edits without saving and return to the list.

Main Page

The add/edit page is divided into two main areas: a Title Block and a tabbed section.

The Title Block allows you to manage the following fields:

• Title - the title of the list item.

General Tab

This tab allows you to manage the following fields:

• Description - An optional description for the item.
• Type - The List Name that the item belongs to.
• Taxon Value - An optional and arbitrary "value" to assign to the item.
• Factor - An optional and arbitrary "factor" to assign to the item.
• Icon - An option path to an icon to assign for the item.
• Color - An optional hex-code color to assign for the item.
• Published - allows you to set the item to a published or unpublished state.
  
• Order - the weighted order for the item.  Negative numbers rise to the top of lists, and positive numbers sink to the bottom.  The order values do not need to be sequential.

Additional Comments

The Taxon Value, Factor, Icon and Color are not supported "out-of-the-box", however, can be accessed through the use of Layout Overrides.

For example:

• The Taxon Value could be used to define an email address that is used by a custom plugin to email someone on when an item is saved or modified.
• The Factor could be used to indicate a price modifier.  If the item represented different RAM capacities in a computer, then the Factor could represent the price difference.  This would be most relevant when using Optional Attributes.