Assuming #538660: Move update manager upgrade process into new authorize.php file (and make it actually work) lands, we should revisit how the action links to find the plugin manager update and install pages look and work. They're a bit cryptic at the moment. This issue can also be for cleaning up the help text on various pages that currently point to the available updates report, etc.

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

dww’s picture

Issue tags: +Usability

Tagging for UX folks...

dww’s picture

Assigned: Unassigned » dww
Status: Active » Needs review
FileSize
5.31 KB

I know people will want screenshots of this, but I have to run to a concert right now. However, here's a first-draft of the patch.

dww’s picture

Here are a bunch of screenshots of patch #2 in action. For each page, there is a copy with the Update manager automatic updates enabled, and a version with the killswitch set to disable the automatic upgrade feature. All screenshots are from a test site with core out of date and missing a contrib security update (which is the worst case in terms of how verbose the messages are).

1st is the /admin "Administer" landing page

2nd is the /admin/reports/status "Status report" page

3rd is the admin/config/modules "Configuration and modules" page

In all cases, if the auto-updates are enabled, all the links in the various messages take you to /admin/reports/updates/update where you can directly upgrade your site. If the killswitch is disabling the feature, they link to the /admin/reports/updates report page, just like how Update status works in D6.

The one exception is the help text on admin/config/modules which talks about Update manager:

To help manage the update process, the Update manager module, if enabled, provides information on new versions of modules (and themes) as they are released. Regular review of the available updates page is essential to maintaining a secure and current site.

Both of the links in there bring you to /admin/reports/updates. I think this text needs some help. First of all, it should know if Update manager is enabled or not and be smarter about what it says, instead of using this "if enabled" stuff. Secondly, if the update.module is disabled, it shouldn't print 404 links to non-existent report pages. Thirdly, if the auto-update feature is enabled, the help text could also link to that page and mention it exists (although directly below it are links to those features via the action items, so maybe it's not needed).

dww’s picture

Ok, this fixes system.module's help text at admin/config/modules about Update manager to be context-sensitive. There are 3 cases:

1) module is enabled and the killswitch is off (full functionality available)
2) module is enabled but the killswitch is on (no automatic updates possible)
3) module is disabled entirely

Probably a bit wordy, and I'm still not sure we need all the links about updating and installing in case #1 since we have the action links right below...

dww’s picture

Title: Fix help text and action links to find the plugin manager pages » Fix help text and action links to find the update manager pages
Dries’s picture

This looks good. Committed to CVS HEAD. Thanks.

dww’s picture

Status: Needs review » Fixed

Great, thanks!

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for 2 weeks with no activity.

Bojhan’s picture

Status: Closed (fixed) » Active

I don't get all the other screenshots, but to me the bug is obvious - there can be up to 4 indicators something is wrong with your site. And there is no clear direction where one would find updates or be able to install something other than the messages and the action link.

As previously described, we don't think that action links are the propper model for this. Instead tabs on the module page should be used :

Updates
Install

Given that "Install" might cause some conceptual problems (you can't actually install, you need something first url/file), I'd say our safe bet is at least putting in the Updates tab. By that removing the initial "Update existing modules" action. With this we give a clear signal where one could go, to make use of plugin_manager its abilities to update your site.

dww’s picture

Patch to move "Update" to a tab on all 3 locations: admin/modules, admin/appearance, and admin/reports/updates. Screenshots of "...update-as-action..." for all 3 pages with current HEAD, and "...update-as-tab..." for all 3 pages with the patch attached.

I'll do another patch and set of "after" screenshots for also moving "Install" to be a tab at each location for comparison, but I wanted to get this up based on Bojhan's concerns at the end of #9...

dww’s picture

And here's a patch and set of screenshots with both "Update" and "Install" as tabs on all 3 pages...

dww’s picture

To clarify: regardless of this patch, all these menu items all point to the same two page callbacks. There are 3 ways to find the "update your missing stuff" and "install new stuff" pages. There are still only 2 pages (install and update) and those pages are identical at all 3 locations. That's unchanged here. All that's changed is really exactly what you see in the screenshots -- how you find these same 2 pages...

Bojhan’s picture

This looks alright, we might want to work a bit on the tab titles and order. I am trying to extract what pattern we have there. Referring to #11, however I do wish to discuss this with yoroy for a bit - as install are conceptually actions (although the interface behind(functionality primary), is not sufficient enough to confirm that mental model)

yoroy’s picture

Reviewed this in IRC with bojhan and dww. Bojhans concern with making 'install' an action is that this takes you to a screen that you have to prepare for (know a URL for a module or theme to install). This could break the 'let me do stuff right now' promise we make with this action links.

BUT,

Having 'install' as a tab looks like an even bigger mis-match to me. 'Update' is fine as a tab, it takes you to a page with information to *review* (not directly act on). 'Install' strongly suggests 'lets go *do* stuff', so for me this should be an action link (even if it may stop me in my tracks a bit by asking a difficult question I didn't know I had to prepare for).

Which makes #10 the preferred solution for now.

dww’s picture

Status: Needs review » Reviewed & tested by the community

Ok, both Bojhan (in his original suggestion in #9) and yoroy in #14 are in favor of "Update" as a tab, "Install" as an action. That's what http://drupal.org/files/issues/602490-10.update-as-tab.patch from #10 does, which passes the bot (obviously, it's a trivial patch). Calling that RTBC. Thanks for the reviews, folks!

webchick’s picture

Status: Reviewed & tested by the community » Fixed

This is somewhat odd, in that I view install/update as a pair, so the fact that one is a tab and the other is a link is rather weird. However, I understand the rationale.

Committed #10 to HEAD. Thanks!

Status: Fixed » Closed (fixed)
Issue tags: -Usability, -Update manager

Automatically closed -- issue fixed for 2 weeks with no activity.