menus - Decko

Card menus are the primary interface for editing and configuring cards. They are designed to be minimally intrusive when casually reading but convenient and powerful when engaging more actively.

Example

The default Decko menu icon (and the icon used on decko.org) is a little gear that looks like this:

view (menu link) not supported for menus+example

This same gear appears in the upper right corner of this page, where it represents an active menu. To open up the dropdown, just mouse over the icon (or tap on it if you're on a mobile device).

How To

Navigate

The following items can appear on the menu, though few cards will have all of them:

edit - only appears if user has update permission. submenus:
- content
- name
- type
- structure (on cards with *structure rule)
- delete (where permitted)
view - always appears. submenus:
- refresh (reloads without reloading page)
- page (loads card's page)
- type (loads type card's page)
- history
- structure (on cards with *structure rule)
discuss - appears when users is permitted to read or comment on +*discussion card
advanced - always appears. this is the most important menu item for configuration (wagneering). It has many submenus and sub-submenus. (to be discussed)
follow - appears when user is logged in and card is not new
account - appears when card is "accounted" (represents a Wagn account). submenus:
- details (email, password, roles, etc)
- created (all cards created by this account)
- edited (all cards edited by this account)

Include

At present, only cards in "open" and "labeled" view display the menu by default. For example, here is the card named "Apple". Note the menu at the upper right, on rollover:

help
edit 
space_dashboard 


You can count how many seeds are in an apple, but you can't count how many apples are in a seed.
You can count how many seeds are in an apple, but you can't count how many apples are in a seed.

However, any view with a card header can also display the menu using the "show" directive (see Nest Syntax).

Apple
help
edit 
space_dashboard 

You can count how many seeds are in an apple, but you can't count how many apples are in a seed.
Apple

You can count how many seeds are in an apple, but you can't count how many apples are in a seed.

Though it's not frequently used on its own, "menu" itself is a view and can be used anywhere on a card. Note that the following generates a functional menu for this card ( menus+howto):

help
edit 
space_dashboard  

Tips

In almost all cases, clicking on an item that has submenus is equivalent to clicking on the first item in the submenu. Eg, clicking "edit" is the same as clicking "edit > content".
Every item on the menu has its own url. You can use standard mouse/keyboard shortcuts to open any link in a menu in a new tab (eg control-click or command-click).
Similarly, you can use standard shortcuts to copy the url (eg right click).

Discussion

Tickets relevant to menus