The first page of the admin UI for editing or creating a browser is *really confusing*.

None of the 3 plugin types explain what they do.

I can figure out what 'Display plugin' is about by looking at the options: it's how the entity browser widget it displayed in a form.

'Widget selector plugin' I'm less sure of. Is that the style of UI that allows switching between widgets?

'Selection display plugin' I have NO idea.

I would suggest:

- description text on each of the 3 plugin selection form elements, explaining the purpose of the plugin type.
- switching to radios instead of a select element, which would allow showing descriptions on each radio. The description property of each plugin could be output here.

So for example, the display option done as radios, with an overall description (at the bottom) and a description on each radio:

Display plugin:
(*) iFrame
  The entity browser form is shown inside the host form, using an iFrame.
() Modal
   The entity browser opens in a popup.
() Standalone form
   The user is taken to a new page to use the entity browser, and then is returned to the host form when they have finished.
Determines how the entity browser is shown when used within another form.

(Assuming I have guessed correctly what 'Standalone form' means -- I have *no* idea if that's correct!)

Comments

joachim created an issue. See original summary.

slashrsm’s picture

Category: Bug report » Task
Issue tags: +D8Media

I agree. We should provide more useful info there.

I volunteer to explain this concepts to anyone willing to work on a patch.

joachim’s picture

I'm unfortunately not at DrupalCon, but if you post explanations here I can work on the patch :)

I would say that this is a UX bug though -- it makes the module much harder to use than it needs to be, and leads to time wasted on trial and error.

slashrsm’s picture

Do you use IRC? Hop on to #drupal-media and ping me.

slashrsm’s picture

Issue tags: +Novice
joachim’s picture

Issue summary: View changes
ckaotik’s picture

The entity browser session at DrupalCon Dublin included a nice illustration outlining each section of the browser window, and also described all of these plugins.

The session is uploaded, maybe you can draw information from there? :)

marcoscano’s picture

There is some detailed explanation on how to configure this on the handbook:

https://drupal-media.gitbooks.io/drupal8-guide/content/modules/entity_br...

Also, I'm not sure if we shouldn't close this ticket as duplicate of #2764875: Remove ctools dependency by building own admin UI, or at least make it a child of that parent usability-improvement one.

slashrsm’s picture

slashrsm’s picture

This is kind of a duplicate of #2779577: Clarify what is the purpose of "display plugin", "widgets plugin" and "selection plugin display". That issue has a patch already so let's continue there.