Problem/Motivation
There is a UI that lets you turn a module/theme on/off. Turning it on adds configuration and often database tables. Turning it off removes content, configuration, and/or database tables. The UI for this should consistently use the verbs "Install" and "Uninstall". Currently it mostly does use these verbs, but it says "Enable" in a few places.
Proposed resolution
The UI for this should consistently use the verbs "Install" and "Uninstall" for turning a module/theme on/off.
Comments and variables.
Fix hook_update_projects_alter() and update.report.inc (and possibly other places) still have references to disabled extensions.
Will mean a lot of data structures passed to/returned from hooks will change, but might just have to be a CR for that - we can check if those hooks are actually implemented in contrib or not.
Remaining tasks
UI changes
Comment changes
Variable changes
User interface changes
More consistent wording.
API changes
N/A
Data model changes
N/A
Release notes snippet
N/A
People to credit
Duplicate issue #2856038: Confusing instructions when installing a theme in D8: Please credit dbjpanda , yogeshmpawar, gaurav.kapoor, cilefen, joelpittet
| Comment | File | Size | Author |
|---|---|---|---|
| #20 | 651.diff | 20.21 KB | quietone |
| #3 | 2891294-2.patch | 915 bytes | gaurav.kapoor |
| #3 | Screen Shot 2017-08-29 at 5.24.07 PM.png | 21.04 KB | gaurav.kapoor |
Comments
Comment #3
gaurav.kapoor commentedI installed Xmlsitemap module and got message 'XMLSitemap has been enabled'. Added a corrective patch.
Comment #10
jhodgdonFYI -- on the parent issue #2888657: [meta] Less confusing and more consistent wording needed in module/theme add/install/update the Usability team is discussing the UI text for this and about 10 other issues. Until decisions are made, making another patch here would probably be premature.
Comment #12
jhodgdonWe discussed several related UI text issues at the Usability meeting today -- see #2888657-23: [meta] Less confusing and more consistent wording needed in module/theme add/install/update for a summary.
I'm adopting this issue to cover item 2 from that plan:
Updating title and summary accordingly.
Comment #13
jhodgdonAdding list of people to credit from #2856038: Confusing instructions when installing a theme in D8 which is now a duplicate.
And forgot to update title.
Comment #14
jhodgdonThis patch will conflict with #2577407: Action of uploading module/theme files should consistently be called "Add", not "Install", so postponing until that one is done.
Comment #15
jhodgdon#2577407: Action of uploading module/theme files should consistently be called "Add", not "Install" has been fixed, so we are no longer using the verb "Install" for the action of adding files for a module/theme to the site. So we can un-postpone this now. The previous patches will not apply any more.
I started looked through the entire core codebase for "enabl" and "disabl" (so that I'd make sure I found "enabling" as well as "enable" "enabled" "enables") and I found a number of spots in the codebase that need to be looked at and/or fixed. Adding them to the issue summary. There are more....
Comment #16
jhodgdonThis will be a big patch and it will conflict with #3182405: Do not use verb "Install" for things other than turning on modules/themes, so I think we should postpone this issue after all.
Comment #20
quietone commentedClosed #2532652: Make the install and uninstall message the same as a duplicate. Posting the latest MR from there as a patch here. Credit to Manjit.Singh, Spokje, quietone.
Comment #25
quietone commentedThis is now active.
In #16 it is said that this will be a big patch and reading the IS I tend to agree. This needs to be split into smaller manageable child issue.
Comment #26
quietone commentedConverting this to a Meta. I've deliberately trimmed down the IS to make it easier to see the child issues and how they have been scoped. The list of changes in the IS was helpful but I would up doing my own searches anyway when making the changes.
Comment #27
ressaShould we create a dedicated issue for Documentation as well? For example the pages under https://www.drupal.org/docs/extending-drupal needs updating as well. I have already updated these two pages:
... but there are most likely many more instances of "enable" which should be "install".
Comment #28
longwaveWe have some methods that need renaming too:
Comment #29
quietone commentedComment #30
quietone commentedComment #31
quietone commentedMore instances to change were found in #3379495-21: Convert enable/disable to install/uninstall in hook_help(). 2 in language_tour_tips_alter and one in system.install. These may need individual issue or a better scope. For example, the tour one might be for all hook_tour_tips_alter. I have added them to the remaining tasks.
Comment #32
quietone commentedlongwave found an instance in a test module and I have added that to the list in the issue summary, #3379496-20: Convert enable/disable to install/uninstall in UI not in hook_help.
Comment #33
quietone commentedComment #34
quietone commentedComment #39
quietone commentedThis meta was for tracking changes to the UI. All the child issues are now closed. If any more instances are found someone can make a new issue.
The points in #27 and #29 are addressed in the 2 referenced instances. #2888654: URLs for module/theme actions are inconsistent with UI text #3182408: [meta] API function names in module/theme install/uninstall space should match UI
Added created per the Issue Summary and closing as fixed.
Comment #41
ressaJust a tip that a discussion of wording for the install command in the new
drtool is taking place in #3594334: Add a module and theme install command, for those who are interested.Comment #42
mstrelan commentedFWIW the
/admin/moduleslists dependent modules that are not installed with the "disabled" suffix. This doesn't bother me at all, but if we want to be consistent it should probably say "not installed".In
\Drupal\system\Form\ModulesListForm::buildRow:Comment #43
ressaThanks for the tip @mstrelan, I think we should be consistent. So I created #3611590: Use Installed and Uninstalled on Available updates page which updates it to "uninstalled". I first went for "not installed", but then saw that the Themes ("Appearances") header is "Uninstalled themes", so maybe it's best to use that as well for modules?
About consistency in the
drissue #3594334: Add a module and theme install command, it seems undecided ... so feel free to weigh in.Comment #44
quietone commentedComment #45
ressaAh yes sorry, I added the wrong issue, here's the one I intended to add.