One of our customer sites requires two menus. We use a Wix dropdown menu along the top populated with all visible folders and links from the editor's Pages menu and a repeater to display the links from just one folder vertically along the side of most pages.
As far as I can tell it's not possible to discern programmatically what folder a page belongs to, and so we've had to make a duplicate of this information inside a collection. However if the customer rearranges the pages this can easily fall out of sync.
The documentation for the SiteStructure object seems to explicitly mention this exact information [folder] is not returned. How come? It'd be very useful. We'd also greatly appreciate getSiteStructure() to tell us whether pages are hidden and also to have external links returned. It seems quite necessary if we're to build our own menus.