====== Connectors > Menu Connector ======

A page that presents a list of links (displayed as buttons) to other pages in the Xerte project, or to external webpages.  Links can be autogenerated for sequences of pages in the Xerte project, or created manually.

===== Example demo =====

''{{url>https://xot.xerte.org.uk/xapi_launch.php?template_id=116&group=xertepagetypes#menuconnector}}''

or view at [[https://xot.xerte.org.uk/xapi_launch.php?template_id=116&group=xertepagetypes#menuconnector|Xerte Page Types > Connectors: Multiple Choice Connector]] (opens in new tab).

===== Editor Interface =====

{{:xerte-connect-menu-editor.jpg?600|:playground:xerte-connect-menu-editor.jpg}}\\ \\

==== Top Level: Core Properties ====

^ **Property** ^ **Description** ^ **Type** ^ **Additional information** ^
| Page Title | Text that appears in header of published page | Text | \\ \\ |

==== Top Level: Optional Properties ====

=== Page specific ===

^ **Property** ^ **Description** ^ **Type** ^ **Additional information** ^
| Button width | Sets the width of the buttons, expressed as a percentage of the page width | Number |   |
| First Entry | Include links from this page in the project onwards  | Drop-down |   |
| Last Entry | Include links up to and including this page in the project  | Drop-down |   |
| Number of columns | Presents the buttons in a specific number of columns | Number | Use when you have a long list of links. Note that if you select this property, the Button Width property is overridden, and the buttons fill the width of each column. |
| Page Text | Text or other content that is displayed above the list of buttons. | Text+ (Toolbar) | Use this to give the context or instructions for the task. Other content (e.g. images, audio, video) can be embedded here. |
| Tick When Viewed | Adds a tick when the learner has viewed the Destination Page (see **Item: Core Properties** below). | Tick box |   |
| Vertical Spacing | Adjusts the spacing between menu items | Number | Default - '5' |

=== General ===

Refer to the [[:optional_properties|General Optional Properties]] page.

There are **Language Options** for this page type.

Click on **New item **to start adding buttons to the menu.

{{ :xerte-connect-menu-newitem.jpg?300 }}

==== Item: Core Properties ====

^ **Property** ^ **Description** ^ **Type** ^ **Additional information** ^
| Title | By default, the text on the button is the __title of the destination page__. If you want this to be different, enter text here, and check the **Use Title on Button** option (see below) | Text | Whether or not you choose for this Title to appear  on the button, it will appear in the project structure. |
| Use Title on Button | See above. | Tick box |   |
| Destination page | Choose the page to which this button will take the learner. You have a choice of first or last page in the project, the next page, previous page, or any other specific page in the project. | Drop-down | By default, a tick will appear next to the item in the menu if the Destination page has been visited.  You can change this ticking behaviour using the **Check if Visited Page** Optional Property (see below). |


==== New Item: Optional Properties ====

^ **Property** ^ **Description** ^ **Type** ^ **Additional information** ^
| Check if Visited Page | See **Destination Page** above - this property lets you specify a __different__ page which needs to have been visited for the tick to appear. For example, this button might link to the first page in a 'chapter' so you could use this option to select the last page in that chapter and say it shouldn't be ticked until that page has been viewed. | Drop- down |   |
| External URL | Add the URL here if you want to link to an external webpage, instead of a another page in the project. | URL |   |
| External URL: Open In | {**This Window**/New Window/Lightbox} | Drop-down | Choose **New Window **if you want the learner to be able to see the Xerte project and the external webpage side by side, e.g. if using dual monitors. |

{{tag>pagetype connector}}