In this article
Pop-up Types
Pop-up Types are used to specify settings that are used when displaying pop-up panels for the following types of pop-ups:
| Pop-up | Handler |
|---|---|
| Infocode, Infocode Group | Infocode Handler |
| Item Modifier, Item Modifier Group | Infocode Handler |
| Time Modifier, Text Modifier | Infocode Handler |
| Cross-selling, Cross-selling group | Infocode Handler |
| Variant (single dimension) | Variant Handler |
| Variant Embedded (variant pop-up within pop-up) | Variant Embedded Handler |
| Deal Modifier | Deal Handler |
| Bom (Excluding ingredient) | Bom Handler |
|
Post Code |
Post Code Handler |
| Country/Region Handler | Country/Region Handler |
Note: Pop-up types are used with POS Pop-up Version Enhanced.
To set up pop-up types
Note: The PackagePOPUP_HANDLING_25 configuration package includes pop-up types for infocodes and variants. Import this package to get the basic pop-up types with the necessary panels. The package also includes new POS commands.
- Click the
icon, enter Pop-up Types, and select the relevant link. - Click New to create a new pop-up type. The Pop-up Type Card appears.
- Select the desired Pop-up Main Handler. The handler controls which fields are editable in the page. It selects the default settings for certain fields and selects an appropriate default panel.
- If necessary, select the ID of the desired interface profile. This is only necessary if you need to restrict the number of buttons or pick a different option grouping for a specific POS terminal (a mobile POS for example that has very little screen space).
- In the ID field, enter an ID for the pop-up type.
- In the Description field, enter a description of the pop-up type.
- For Infocode Handler and Deal Handler you are able to change the Pop-up Group Selection Handler to Standard Handler and select a specific Option Grouping. The Infocode Handler and Deal Handler select the appropriate default panel for the selected Option Grouping.
Creating default and specific pop-up types
For infocodes, modifiers, cross-selling, and deals, you can have default pop-up types:
- You can mark pop-up types as Default for Option for Option GroupingNo. The pop-up type is then used as default for the pop-up type's main handler, interface profile, and option grouping number.
- You can mark the pop-up types as Default for Group for Option GroupingYes (closed and open groups). The pop-up type is then used as default for the pop-up type's main handler, interface profile, and option grouping Yes (closed and open groups).
You can have entitiy specific pop-up types by:
- Assigning them directly to an infocode, a modifier or cross-selling. You can do the same for groups.
For example, if there are certain item modifiers that have a lot of options, you can assign a pop-up type to them directly that restricts how many buttons are shown. For those item modifiers with not that many options, the default pop-up type is used.
For infocodes, modifiers, and cross-selling, you can:
- Create pop-up types that are default for Cross-selling, item modifiers and text and time modifiers in general, by specifying Usage Category and Sub-Category for the pop-up type. In this way you can for example have the multi-buttons pop-up only for item modifiers and cross-selling, while text and time modifiers have the one button per option look.
Handlers
The Pop-up functionality is split into sections. Each section represents an interface. The pop-up type specifies which handler handles each section. The functionality can be extended by implementing new handlers.
Note: On the Action banner of the Pop-up Types page, you need to select Insert Default Pop-up Types. These are any pop-up types added after version 25 and are not included in the PackagePOPUP_Handling_25.0 package when first changing to the Enhanced version.
The sections are:
| Section | Description | Handlers |
|---|---|---|
| Main |
Retrieves the active pop-up type and the data to show in the pop-up panel. The panel selection is processed when it is closed. On validation, the handler selects the appropriate handlers when inserting its Pop-up Type. |
Infocode Handler - needs three pop-up types, for options, groups and open groups (included in the package). Variant Handler - needs one pop-up type, options (included in package). Variant Embedded Handler- needs one pop-up type, options (included in package). Deal Handler - needs three pop-up types, for options, groups and open groups (part of Insert Default Pop-up Types). Bom Handler - needs one pop-up type, options (part of Insert Default Pop-up Types). Post Code Handler - needs one pop-up type, options (part of Insert Default Pop-up Types). Country/Region Handler - needs one pop-up type, options (part of Insert Default Pop-up Types). |
| Group Selection | Processes the selection of a group button in the panel. | Standard |
| Texts |
Updates the glyph texts on option and group buttons, texts that are shown for the whole panel and for group selection. Multi Buttons updates the plus and minus buttons and hides the caption if the action is going to result in an error. |
Infocode Infocode Multi Buttons Deal Deal Multi Buttons BOM Exclusion |
| Restrictions | Checks whether an action is allowed, based on the current selection and the minimum and maximum selection settings. |
Infocode Deal |
| Message | Decides how to display a message based on the Pop-up Message Type. These message typically explain to the user why a certain action cannot be performed. | Display Message Box Display Banner Skip Display |
| Option Selection |
Processes the selection of an option in the panel. Single Selection panel only has a Cancel button and closes when an option is selected. Multi Selection panel has OK and Cancel buttons, may allow selection of multiple options and each option is reprented by one menu button. Multi Buttons panel has OK and Cancel, may allow selection of multiple options and each option is represented by multiple buttons (can include item image, plus and minus buttons and a selected quantity button). |
Single Selection Multi Selection Multi Buttons |
Option grouping
There are three options for how options are grouped in the pop-up panel:
| Option Grouping | Description |
|---|---|
| No | There is no visible group, the options are ordered in the way they are inserted by the main handler. |
| Yes - One Option Group Visible | The options are grouped in at least two groups. Only one group and its options are visible at a time. Group selection buttons are used to jump between groups. |
| Yes - All Options Visible | The options are grouped in at least two groups. All the groups and options are visible (no scrolling applied). Each group section starts with a button showing the name of the group (no command is behind the button). A group spans one or more rows. The rows show the group options. Note: If there are lot of options or groups, this option may not be feasible. |
Infocode handler Pop-up Type selection for groups
For an infocode group, item modifier group or cross-selling group, the infocode handler selects the pop-up type as follows:
For the active interface profile
- It selects the pop-up type assigned directly to the group.
- If no pop-up type is assigned to the group, it selects the first pop-up type with option grouping Yes - One Option Group Visible marked as Default for Group.
- If not found, it selects the first pop-up type with option grouping Yes -All Options Visible marked as Default for Group.
- If not found, it selects the first pop-up type with option grouping Yes - One Option Group Visible.
- If not found, it selects the first pop-up type with option grouping Yes -All Options Visible.
For interface profile not specified
If no pop-up type was found for the active interface profile, it goes through steps 1 to 5 with a blank interface profile.
Tip: If you want to use the Yes - All Options Visible option for all your groups, you must mark the corresponding pop-up type as Default for Group. If you do not want certain POS terminals to show groups with all options visible, you need to include a pop-up type with option grouping Yes - One Option Group Visible with the interface profile of the POS terminals. See also How to: Display Open Groups in Pop-up Panels.
Infocode handler Pop-up Type selection for non-groups
For an infocode, item, text and time modifier, and cross-selling, the infocode handler selects the pop-up type as follows:
For the active interface profile
- It selects the pop-up type assigned directly to the entity.
- If no pop-up type is assigned to the entity, it selects the first pop-up type with option grouping No marked as Default for Option.
- If not found, it selects the first pop-up type with option grouping No.
For interface profile not specified
If no pop-up type was found for the active interface profile, it goes through steps 1 to 3 with a blank interface profile.
Panel Settings
Pop-up panels are used to display extra input needed during a transaction in a panel that appears on top of the current POS layout. When the pop-up panel closes, the current POS layout appears again. The Pop-up panels in the LS Central Demo Database are a part of the Interface Profile ##DEFAULT, but as with other panels, these can be copied to other Interface Profiles if you want to change their layouts.
Each pop-up type is assigned a POS panel that is designed to show the options. The panel needs to handle the option grouping selected for the pop-up type.
In the LS Central Demo Database the following panels are designed to display the different Pop-up types:
| Pop-up Panel | Description |
|---|---|
| #PPOP-GROUPS |
|
| #PPOP-GROUPS-OPEN |
|
| #PPOP-GRP-MULTIBTNS |
|
| #PPOP-OPT-MULTISEL |
|
| #PPOP-OPT-SINGLESEL |
|
| #PPOP-OPT-MULTIBTNS |
|
| #PPOP-OPT-VARIANTEMB |
|
Panel Layout - Controlling the number of option buttons, rows, and columns
For Multi Buttons panels
You need to restrict how many rows and columns are displayed for options to ensure that the images and text appear the same regardless of the number of options shown.Remember that for this panel type, that behind an option "button" are actually multiple menu buttons.
For other panels
You do not need to restrict how options appear. The system creates a button for each option and decides on a default number of rows and columns. If an option is unavailable (item is blocked or current availability is none), the option button appears as disabled.
However, if there are a lot of options to show, the buttons will become very small. In that case, you can restrict how many buttons are shown, and how many rows and columns for each pop-up type.
Controlling the number of option buttons shown:
| Field | Description |
|---|---|
| No. of Option Button Columns | Specifies how many columns of option buttons appear in the pop-up. If not set, there will be as many as needed to display all the selectable options, based on a default row/column ratio. Option grouping Yes - All Options Visible: If this field is filled out, the system displays the maximum number of rows per group necessary to show all the options. The number of columns is equal to one (the group column) plus however many columns necessary to display the options, the maximum being the number in this field. If this field is not filled, each group spans one row and the number of columns is equal to one (the group column) plus the maximum number of options shown for the groups. Example 1: Example 2: |
| No. of Option Button Rows | Specifies how many rows of option buttons appear in the pop-up. If not set, there will be as many as needed to display all the selectable options, based on a default row/column ratio. Note: Does not apply to option grouping Yes - All Options Visible. |
| Max. Option Buttons Shown | Specifies the maximum number of option buttons shown in the pop-up panel. If set and the number of selectable options exceeds this number, page scrolling is applied. Note: Does not apply to option grouping Yes - All Options Visible. |
Controlling the number of group buttons shown
One field controls how many group buttons are shown.
Max. Group Buttons Shown
Specifies the maximum number of group buttons shown in the pop-up panel. If not set, there will be as many as needed to display all the groups. If set, page scrolling is applied. Group buttons have either one row or one column. The paging orientation of the Base Group POS Menu in the panel controls this.
Note: Does not apply to option grouping No or Yes - All Options Visible.
Controlling the size and position of the panels
The size and position of the Pop-up panels is defined with the panel’s Width, Height, and Position fields. If you want to have these properties different for a certain interface profile, you must copy the ##DEFAULT panel to a new panel with the same Control ID for the interface profile and change the properties for this new panel.
Note: A panel with zero value for the XPos and YPos fields appears in the center of the POS window.