# You must use a tab-size of 4 spaces to edit this file.
---
zenario_menu:
    title: Creating a menu node
    key:
        sectionId: ""
        languageId: ""
        parentMenuID: ""
        suggestedName: ""
        id: ""
        cID: ""
        cType: ""
        mode: ""
        id_is_parent_menu_node_id: ""
        feature_image_id: ''
    identifier: 
        css_class: menu_node
        label: Menu node ID
        value: ""
    tabs:
        text:
            label: Menu node
            edit_mode:
                enabled: ""
            show_errors_after_field: description
            fields:
                warning:
                    ord: 0
                    snippet:
                        html:
                
                description:
                    ord: 0.5
                    snippet:
                        html: "Use this screen to set this menu node's text."
                multilingual_description:
                    ord: 1
                    same_row: true
                    snippet:
                        html: ""
                menu_title:
                    ord: 3
                    label: 'Menu text:'
                    type: text
                    maxlength: 250
                    #Please note: if there is more than 1 language enabled,
                    #this onkeyup event will be ignored and a new one will be created
                    #in the PHP class for each enabled language.
                    onkeyup: |
                        $(zenarioAB.get('span__path_of__' + this.id)).text(this.value);
                path_of__menu_title:
                    ord: 1003
                    label: 'Menu path preview:'
                    type: text
                    show_as_a_span: true
                    css_class: zenario_textbox_noborder zfab_menuPathPreviewNode zfab_menuPathPreviewUpdatingNode
                target_loc:
                    ord: 1005
                    label: 'Type of link:'
                    type: select
                    value: none
                    values:
                        none:
                            ord: 1
                            label: "No link"
                            side_note: Use this for a menu node that has child nodes.
                        int:
                            ord: 2
                            label: "Link to a content item"
                        doc:
                            ord: 3
                            label: "Link to a document"
                            side_note:
                        ext:
                            ord: 4
                            label: "Link to an external URL"
                            side_note: Link to a URL on another site.
                        exts:
                            ord: 5
                            label: Link by language
                            side_note: Link to a different external URL in each language.
                    format_onchange: true
                
                #On multi-language sites, this will always link to the translation in the visitor's language.
                #On single-language sites, this will always link to a content item in the only enabled language.
                hyperlink_target__specific:
                    ord: 1005.1
                    hidden: true
                    pick_items: &hyperlink_target__specific__pick_items
                        path: zenario__content/panels/content/refiners/filter_by_lang////
                        min_path: zenario__content/panels/content
                        max_path: zenario__content/panels/content
                        target_path: zenario__content/panels/content
                        select_phrase: Select a content item...
                        hide_remove_button: true
                    validation: &hyperlink_target__specific__validation
                        required_if_not_hidden: Please select a content item.
                hyperlink_target__translation:
                    ord: 1005.2
                    hidden: true
                    pick_items:
                        path: zenario__content/panels/translation_chains
                        min_path: zenario__content/panels/translation_chains
                        max_path: zenario__content/panels/translation_chains
                        target_path: zenario__content/panels/translation_chains
                        select_phrase: Select a translation chain...
                        hide_remove_button: true
                    validation:
                        required_if_not_hidden: Please select a translation chain.
                
                #On multi-language sites, this will always link to the translation in the visitor's language.
                #On single-language sites, this will always link to a content item in the only enabled language.
                use_translation:
                    ord: 1005.3
                    indent: 1
                    plugin_setting:
                        name: use_translation
                    type: radios
                    value: 0
                    values:
                        0:
                            ord: 1
                            label: 'Link to a content item in a specific language:'
                        1:
                            ord: 0
                            label: "Link to a translation in the visitor's language (recommended):"
                    format_onchange: true
                hyperlink_target:
                    ord: 1006
                    indent: 1
                    label: 'Content item:'
                    pick_items: *hyperlink_target__specific__pick_items
                    validation: *hyperlink_target__specific__validation
                    format_onchange: true
                use_download_page:
                    ord: 1007
                    indent: 2
                    label: Use a download page
                    type: checkbox
                    value: ""
                    side_note: |
                        Link to the file's download page, rather than a direct link to the file.
                        This option only applies to Document content items.
                    hidden: true
                hide_private_item:
                    indent: 1
                    ord: 1008
                    label: 'Link privacy:'
                    format_onchange: true
                    type: select
                    values:
                        - 
                            ord: 0
                            label: Show to visitors and extranet users, even if the target content item is private
                        - 
                            ord: 1
                            label: Obey the privacy setting of the content item
                        - 
                            ord: 2
                            label: Show to visitors, hide from extranet users
                        - 
                            ord: 3
                            label: Only show to extranet users
                    side_note: >
                        If the linked-to content item is private, you can control
                        when the menu node is displayed.
                document_id:
                    indent: 1
                    ord: 1009
                    format_onchange: true
                    visible_if: |
                        zenarioAB.value('target_loc') == 'doc'
                    pick_items:
                        path: zenario__library/panels/documents/refiners/public_documents_only////
                        min_path: zenario__library/panels/documents
                        max_path: zenario__library/panels/documents
                        target_path: zenario__library/panels/documents
                        disallow_refiners_looping_on_min_path: true
                        select_phrase: Select a document...
                        disabled_if_for_all_selected_items: |
                            item && item.type == 'folder'
                    validation:
                        required_if_not_hidden: "You've set the destination to be to a document, please select a document."
                document_privacy_error:
                    indent: 1
                    ord: 1010
                    pre_field_html: '<div class="zenario_fbWarning">'
                    snippet:
                        html: 'This menu node will not display as it links to a non-public document.'
                    post_field_html: '</div>'
                    hidden: true
                privacy_warning:
                    ord: 1011
                    #note_below: Controlled in module_code.php
                    indent: 1
                    same_row: true
                    visible_if: zenarioAB.value('target_loc') == 'doc'
                menu_node_will_appear_to_unauthorised_visitors_or_users:
                    indent: 1
                    ord: 1012
                    hidden: true
                    snippet:
                        html: |
                            <div class="zenario_fbWarning">
                                This menu node WILL appear to unauthorised visitors or users, because there are menu nodes below it in the menu tree which are public. Either change the permissions on the lower content items, or restructure the menu tree, in order to make it only appear to authorised users.
                            </div>
                ext_url:
                    indent: 1
                    ord: 1013
                    label: 'External URL:'
                    type: url
                    maxlength: 255
                    validation:
                        required_if_not_hidden: Please enter a URL
                open_in_new_window:
                    indent: 1
                    ord: 1014
                    label: 'Open in a new window'
                    type: checkbox
                
                link_to_anchor:
                    ord: 3001
                    indent: 1
                    label: Link to anchor
                    type: checkbox
                    redraw_onchange: true
                hyperlink_anchor:
                    indent: 2
                    ord: 3002
                    label: 'Anchor name:'
                    type: text
                    maxlength: 255
                    visible_if: |
                        zenarioAB.value('link_to_anchor')
                    validation:
                        required_if_not_hidden: Please enter an anchor name.
                    side_note: >
                        If you have an anchor on the page, you can specify it here and you'll be
                        taken to its location on navigation.
                #This grouping is empty by default and populated when the Menu Milticolumn module is running.
                menu_multicolumn_top_of_column_grouping:
                    type: grouping
                    ord: 5000
        feature_image:
            label: 'Images'
            edit_mode:
                enabled: true
            fields:
                promo__feature_image_checkbox:
                    label: 'Show promotional image'
                    ord: 1.01
                    type: checkbox
                    format_onchange: true
                    note_below: "A promotional image can appear in the drop-down area when a user hovers over this menu node. Only supported by Menu with Promo Images plugin (zenario_promo_menu)."
                promo__feature_image:
                    indent: 1
                    ord: 1.02
                    foreign_key_to: file
                    label: 'Promotional image:'
                    pick_items:
                        path: zenario__library/panels/image_library
                        min_path: zenario__library/panels/image_library
                        max_path: zenario__library/panels/image_library
                        target_path: zenario__library/panels/image_library
                        select_phrase: Select image...
                    upload:
                        multi: false
                        accept: 'image/png, image/jpeg, image/gif, image/svg+xml, image/webp'
                        extensions:
                            - .gif
                            - .jpg
                            - .jpeg
                            - .png
                            - .svg
                            - .webp
                        drag_and_drop: false
                        reorder_items: false
                    value: ""
                    format_onchange: true
                    validation:
                        required_if_not_hidden: Please select an image.
                
                promo__use_rollover:
                    indent: 1
                    ord: 1.08
                    label: 'Use a rollover image'
                    type: checkbox
                    value: ""
                    format_onchange: Yes
                promo__rollover_image:
                    indent: 2
                    ord: 1.09
                    foreign_key_to: file
                    label: 'Change image on rollover:'
                    pick_items:
                        path: zenario__library/panels/image_library
                        min_path: zenario__library/panels/image_library
                        max_path: zenario__library/panels/image_library
                        target_path: zenario__library/panels/image_library
                        select_phrase: Select image...
                    upload:
                        multi: false
                        accept: 'image/png, image/jpeg, image/gif'
                        extensions:
                            - .gif
                            - .jpg
                            - .jpeg
                            - .png
                        drag_and_drop: false
                        reorder_items: false
                    value: ""
                    note_below: "Please note if the menu node is selected, the rollover image will always show."
                    format_onchange: true
                
                
                promo__overwrite_alt_tag:
                    indent: 1
                    ord: 1.10
                    multiple_edit:
                        original_value: ""
                    label: 'Overwrite image alt-tag:'
                    type: text
                    maxlength: "255"
                    value: ""
                
                
                promo__title:
                    indent: 1
                    ord: 1.11
                    label: 'Title for promotional image:'
                    type: text
                    width: "150"
                    maxlength: "255"
                    value: ""
                promo__text:
                    indent: 1
                    ord: 1.12
                    label: 'Description (HTML) for promotional image:'
                    type: editor
                    dont_trim: true
                    editor_type: phrase_editor
                    value: ""
                    editor_options:
                        height: 200px
                
                
                
                promo__link_type:
                    indent: 1
                    ord: 1.13
                    label: 'Optional link from promotional image:'
                    note_below: |
                        Set this if you want the image to have a different link destination from the menu node itself.
                    type: radios
                    values:
                        no_link:
                            ord: 1
                            label: No link
                        content_item:
                            ord: 2
                            label: Link to a content item
                        external_url:
                            ord: 3
                            label: Link to an external URL
                    value: no_link
                    format_onchange: Yes
                promo__hyperlink_target:
                    indent: 2
                    ord: 1.14
                    label: 'Content item:'
                    pick_items:
                        path: zenario__content/panels/content/refiners/filter_by_lang////
                        min_path: zenario__content/panels/content
                        max_path: zenario__content/panels/content
                        target_path: zenario__content/panels/content
                        disallow_refiners_looping_on_min_path: true
                        select_phrase: Select a content item...
                        hide_remove_button: true
                    validation:
                        required_if_not_hidden: Please select a content item to link to.
                    format_onchange: Yes
                promo__hide_private_item:
                    indent: 2
                    ord: 1.15
                    label: 'Privacy:'
                    type: select
                    value: always_show
                    values:
                        always_show:
                            ord: 1
                            label: Show to visitors and extranet users, even if the target content item is private
                        private:
                            ord: 2
                            label: Obey the privacy setting of the content item
                        logged_out:
                            ord: 3
                            label: Show to visitors, hide from extranet users
                        logged_in:
                            ord: 4
                            label: Only show to extranet users
                promo__url:
                    indent: 2
                    ord: 1.16
                    label: 'External URL:'
                    type: url
                    maxlength: "255"
                    value: ""
                promo__target_blank:
                    indent: 2
                    ord: 1.17
                    label: 'Open in a new window'
                    type: checkbox
                    value: ""
                
                show_image:
                    ord: 2.1
                    label: 'Show thumbnail image beside menu node text'
                    type: checkbox
                    format_onchange: true
                    side_note: "A small image can appear beside the text of a menu node. Check here to enable this feature and select an image."
                image_id:
                    visible_if: "zenarioAB.value('show_image')"
                    ord: 2.2
                    label: 'Thumbnail image:'
                    indent: 1
                    upload:
                        multi: false
                        accept: 'image/png, image/jpeg, image/gif, image/svg+xml, image/webp'
                        extensions:
                            - .gif
                            - .jpg
                            - .jpeg
                            - .png
                            - .svg
                            - .webp
                        drag_and_drop: false
                        reorder_items: false
                    pick_items:
                        path: zenario__library/panels/image_library
                        min_path: zenario__library/panels/image_library
                        max_path: zenario__library/panels/image_library
                        target_path: zenario__library/panels/image_library
                        select_phrase: Select image...
                    validation:
                        required_if_not_hidden: Please select an image.
                use_rollover_image:
                    ord: 3.1
                    indent: 1
                    label: 'Show a rollover image effect'
                    type: checkbox
                    format_onchange: true
                    side_note: "An image will show up on mouse over and It will disappear on mouse out."
                rollover_image_id:
                    ord: 3.2
                    indent: 2
                    label: 'Rollover image:'
                    visible_if: "zenarioAB.value('use_rollover_image')"
                    upload:
                        multi: false
                        accept: 'image/png, image/jpeg, image/gif'
                        extensions:
                            - .gif
                            - .jpg
                            - .jpeg
                            - .png
                        drag_and_drop: false
                        reorder_items: false
                    pick_items:
                        path: zenario__library/panels/image_library
                        min_path: zenario__library/panels/image_library
                        max_path: zenario__library/panels/image_library
                        target_path: zenario__library/panels/image_library
                        select_phrase: Select image...
        advanced:
            label: Additional settings
            edit_mode:
                enabled: ""
            fields:
                
                #This grouping is empty by default and populated when the Pro Features module is running.
                promo_menu_description_grouping:
                    type: grouping
                    snippet:
                        label: Additional text for menu node
                        label_class: subheading
                
                #This grouping is empty by default and populated when the Pro Features module is running.
                promo_menu_descriptive_text_grouping:
                    type: grouping

                description_css_grouping:
                    type: grouping
                    snippet:
                        label: CSS and SEO
                        label_class: subheading
                        
                description_css:
                    grouping: description_css_grouping
                    snippet:
                        html: |
                            You can add custom CSS rel-tags here for this menu node.

                css_class:
                    grouping: description_css_grouping
                    label: 'CSS class names:'
                    type: text
                    maxlength: 100
                    pre_field_html: >
                        <span class="zenario_css_class_label">
                            zenario_menu_node
                        </span>
                    side_note: |
                        This menu node will appear within a &lt;li&gt; tag, and with whatever CSS class names are defined here.
                
                rel_tag:
                    grouping: description_css_grouping
                    label: 'Rel-Tag:'
                    type: text
                    maxlength: 100

                description_other_advanced_grouping:
                    type: grouping
                    snippet:
                        label: Other advanced options
                        label_class: subheading
                
                add_registered_get_requests:
                    grouping: description_other_advanced_grouping
                    visible_if: |
                        zenarioAB.value('target_loc', 'text') == 'int'
                    label: |
                        Keep GET requests from plugins when linking to the current content item
                    type: checkbox
                    value: ''
                    side_note: |
                        When linking to the current content item,
                        keep variables like <code>mode</code> or <code>page</code> in the URL.
                
                add_custom_get_requests:
                    grouping: description_other_advanced_grouping
                    label: |
                        Add custom GET requests
                    type: checkbox
                    value: 0
                    redraw_onchange: true
                    side_note: "Only works for links to content items"

                custom_get_requests:
                    grouping: description_other_advanced_grouping
                    label: |
                        Custom GET requests:
                    visible_if: |
                        zenarioAB.value('add_custom_get_requests')
                    indent: 1
                    values: {}
                    pick_items:
                        multiple_select: true
                        nothing_selected_phrase: Menu node has no custom GET requests
                        enable_type_ahead_search: false
                        allow_typing_anything: true
                        hide_select_button: true
                    side_note: "Only works for links to content items"
                
                call_static_method:
                    grouping: description_other_advanced_grouping
                    label: |
                        Call a module's static method to customise this menu node
                    type: checkbox
                    format_onchange: true
                menu__module_class_name:
                    grouping: description_other_advanced_grouping
                    indent: 1
                    hidden: true
                    label: 'Module class name:'
                    type: text
                    maxlength: 200
                menu__method_name:
                    grouping: description_other_advanced_grouping
                    indent: 1
                    hidden: true
                    label: 'Static method name:'
                    type: text
                    maxlength: 127
                menu__param_1:
                    grouping: description_other_advanced_grouping
                    indent: 1
                    hidden: true
                    label: 'Parameter 1:'
                    type: text
                    maxlength: 255
                menu__param_2:
                    grouping: description_other_advanced_grouping
                    indent: 1
                    hidden: true
                    label: 'Parameter 2:'
                    type: text
                    maxlength: 255
                    note_below: |
                        The static method can return:
                        <ul>
                            <li><code>false</code> to hide the menu node</li>
                            <li><code>true</code> to show the menu node</li>
                            <li>An <code>array()</code> to show the menu node, and set/overwrite its properties.</li>
                        </ul>
        content_item_preference:
            label: Content type preference
            edit_mode:
                enabled: ""
            fields:
                content_restriction_desc_grouping:
                    type: grouping
                
                content_restriction_desc:
                    grouping: content_restriction_desc_grouping
                    snippet:
                        html: |
                          <p>You can keep content types of this site ([[content_types]]) tidy by only
                          allowing them to be created under specific menu nodes.</p>

                          <p>This can be enforced, or just suggested, depending on the options in
                          the <a href="[[link]]" target="blank">Settings for content types</a> panel.</p>

                restrict_child_content_types:
                    grouping: content_restriction_desc_grouping
                    type: select
                    values: {}
                    empty_value: ''
                    format_onchange: true
                restriction_note:
                    grouping: content_restriction_desc_grouping
                    snippet:
                        html: ''
