This DAMageTip is all about taming the Cumulus Desktop Client Menus. They’re a beast. There’s a ton of options and commands. Some, you — or your users — will use often, some hardly at all. Power users who love keyboard shortcuts can become frustrated by the lack of shortcuts for common functions.
Let’s get to work. To edit the menus you’ll need a text editor. An editor that can do syntax highlighting (such as TextWrangler on OS X) is helpful but not required.
Understanding the Menu XML files
All of the Menu files are in the App.lproj folder. On OS X that would be typically be:
On Windows they’re typically found in:
C:\Program Files (x86)\Canto\Cumulus Client\App.lproj\
Structure and Localization
Each menu consists of a pair of files, one for the structure and one for the localization strings. The structural XML files is in the main App.lproj folder and the localizations strings are stored by language sub-folder with a suffix of .Strings added to the file name. I’m primality concerned with just the english localization so all my .Strings xml files are in the en folder.
For example, the Metadata menu will have “Menu Metadata.xml” in App.lproj and a “Menu Metadata.Strings.xml” in the en sub-folder directory is the structural setup.
Removing Menu Items
Removing Menu Items is as simple as commenting out what you’d like to remove in the structural menu xml file. Let’s say you want to remove the IPTC Information Window item in the Metadata Menu. Find the menuitem tag for IPTC Information, then comment it out as in the example below.
<?xml version="1.0" encoding="UTF-8"? <!DOCTYPE menu> <menu> <title>&Metadata</title> <menuitem cmd="90" ctrl="true" key="I">&Information</menuitem> <!--<menuitem cmd="2008" shift="true" ctrl="true" key="I" keepEJP="true">xxx IPTC Information</menuitem> --> <menuitem cmd="2038">Bulk Edit</menuitem>
Renaming Menus and Menu Items
To rename the menu or any of the menu items, we’ll work with the localized strings for that menu. The first string tag is the menu name. In the example below, I’ve renamed the Menu Title and the “Information” item.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE strings> <strings> <string id="-1">&My Awesome Metadata Menu</string> <string id="90">&Awesome Asset Information</string>
Adding your own keyboard shortcuts
Canto provides Cumulus with a lot of keyboard shortcuts. In fact, there’s an entire
appendix in the back of the Cumulus User Guide just for the Keyboard Shortcuts in Cumulus. But, IMHO, not every feature that should have a shortcut does. Fortunately it’s fairly easy to take care of that situation.
To add or change the shortcuts, we’re going to work with the Menu structure xml file. But first, let’s explore the attributes of the menuitem tag.
|Attribute||What it does||Notes|
|cmd||Internal command Cumulus executes||Only items that have a cmd
can be a shortcut
|ctrl||Ctrl on Windows, Command on OS X|
|alt||Alt on Windows, Option on OS X|
|key||The keyboard key used with the Modifier keys defined above|
<menuitem cmd="2042" shift="true" ctrl="true" key=";">Update Formular Fields...</menuitem>
<menuitem cmd="375" shift="true" ctrl="true" key="1">Assign Variants...</menuitem>
<menuitem cmd="108" shift="true" ctrl="true" key="J">New Rela&ted Category...</menuitem>
Putting it in Action!
Alright, you’ve tweaked, hacked and customized your way to Cumulus Desktop Client menu perfection. Fabulous! Now it’s time to put it all into action.
Remember, it’s important to maintain backup copies of the original files you’ve tweaked, at the same time copies of the customized files. And here’s why: Your changes will be overwritten if you run the Canto-provided Installer program in upgrade mode.
Armed with this information you too can tame the Cumulus Menus and make them bend to your will! Go forth, have fun and make those menus yours!