Adobe-CEP / CEP-Resources

Tools and documentation for building Creative Cloud app extensions with CEP
https://www.adobe.io/apis/creativecloud/cep.html
1.61k stars 824 forks source link

How to find what is a valid menu placement #422

Open SamuelCharpentier opened 2 years ago

SamuelCharpentier commented 2 years ago

I can't find the documentation on how to build a placement attribute value for a menu element.

Any help is welcome!

ErinFinnegan commented 2 years ago

Hi @SamuelCharpentier ! Are you asking about Photoshop, another app, or is this a cross-application use case?

SamuelCharpentier commented 2 years ago

Hi @ErinFinnegan, I’m asking about any documentation that would help me figure out how to create such attribute in any supported application as I’m working on a universal CEP Manifest builder (for any app supporting it) that’s a little more advanced than the one offered in the CEP bundle core project. I want to be able to help the user create this attribute with easy access to hints, integrated validation and links to official documentation. The issue is that there seems to be no official documentation on the matter.

Do you think you could help me find such documentation?

ErinFinnegan commented 2 years ago

Ah! OK, I'm asking because Photoshop is slowly removing CEP support, so I wanted to clarify your use case.

All of the CEP documentation is in the Cookbook. For your project you might find these other, similar projects helpful:

Additionally, if you're not already in the Adobedevs Slack, DM me, I'll invite you.

SamuelCharpentier commented 2 years ago

Yes I've seen the new UXP announced. I'm hoping I could eventually port some of what I've developed over to it when the time comes. As of now, I'm still just learning software development as a hobby.

I've seen most of these resources and there still seems to be a missing piece to the documentation. In the CookBook, more specifically in the section related to the menu tag, it says:

You can customize the extension menu by editing <menu/> item in manifest. Here is an example. In this example, the Adobe Add-ons extension is displayed under Windows main menu, rather than extensions menu under Windows. You can customize the location of extension to somewhere else by changing the value of attribute Placement in <menu/> item.

And then follows an example with <Menu Placement="'Main:&amp;Window',600.0,'KBSCE Window menu'">Adobe Add-ons</Menu> in it. The issue is that there is no explanation of what "'Main:&amp;Window',600.0,'KBSCE Window menu'" means, where it came from or how to edit it or make it different.