mautic / mautic

Mautic: Open Source Marketing Automation Software.
https://www.mautic.org
Other
7.37k stars 2.63k forks source link

Use the global search modal for search help #14185

Open escopecz opened 1 month ago

escopecz commented 1 month ago
Q A
Bug fix? (use the a.b branch) πŸ”΄
New feature/enhancement? (use the a.x branch) 🟒
Deprecations? πŸ”΄
BC breaks? (use the c.x branch) πŸ”΄
Automated tests included? πŸ”΄ (mostly JS/UI changes)
Related user documentation PR URL mautic/user-documentation#...
Related developer documentation PR URL mautic/developer-documentation-new#...
Issue(s) addressed Fixes #...

Description

This is a showcase of how to use the global search help button when the local search help button is clicked. It is reaction to https://github.com/mautic/mautic/pull/13950 that is deleting the local search help buttons.

Β ToDo

πŸ“‹ Steps to test this PR:

  1. Open this PR on Gitpod or pull down for testing locally (see docs on testing PRs here)
  2. Go to the contact list view
  3. Click on the help icon in front of the search input
  4. It will input the global search help instead of the old one. It will also open the accordion to show the search commands related to the contact.
andersonjeccel commented 1 month ago

Hm, something here is not working, but I imagine that your change would lead to opening the modal (same target used by the item in the navbar dropdown)

Do you find relevant to scroll to a section when many resources don't have a specific search command? Maybe we could keep it simple, using the button as a shortcut, but it still feels redundant :/

image

escopecz commented 1 month ago

@andersonjeccel apologies. Please retry. Not sure why it didn't error out for me yesterday. Please test now.

The issue I have with removing the help buttons next to the feature that use it is that we are then hiding the help deeper under more clicks. I would go the other way and instead of globalising the help I'd localise it so users can find it when they need it. If it is a big blob of text under some menu item then it can as well be just a link to the documentation on mautic.org.

codecov[bot] commented 1 month ago

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 62.99%. Comparing base (18f6738) to head (194f56d). Report is 2 commits behind head on 5.x.

Additional details and impacted files [![Impacted file tree graph](https://app.codecov.io/gh/mautic/mautic/pull/14185/graphs/tree.svg?width=650&height=150&src=pr&token=JJAV4AZFpm&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=mautic)](https://app.codecov.io/gh/mautic/mautic/pull/14185?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=mautic) ```diff @@ Coverage Diff @@ ## 5.x #14185 +/- ## ========================================= Coverage 62.99% 62.99% - Complexity 34433 34442 +9 ========================================= Files 2266 2266 Lines 103019 103035 +16 ========================================= + Hits 64893 64909 +16 Misses 38126 38126 ``` [see 1 file with indirect coverage changes](https://app.codecov.io/gh/mautic/mautic/pull/14185/indirect-changes?src=pr&el=tree-more&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=mautic)