docs: Document the list-view filter scope dropdown#832
Draft
promptless-for-oss wants to merge 2 commits into
Draft
docs: Document the list-view filter scope dropdown#832promptless-for-oss wants to merge 2 commits into
promptless-for-oss wants to merge 2 commits into
Conversation
Add a section to the Searching Mautic reference covering the new dropdown next to the filter input on list views (mautic/mautic PR #16479), which makes field-scoped searching discoverable by mapping a chosen field to the existing colon query syntax.
| Filter dropdown on list views | ||
| ============================= | ||
|
|
||
| Most list views, including Contacts, Emails, Companies, and Segments, show a dropdown to the left of the filter input. Use it to scope a search to a single field without knowing the underlying query syntax. |
Contributor
Author
There was a problem hiding this comment.
Documented the new filter scope dropdown from mautic/mautic PR #16479. Selecting a field composes the term into the existing command:value query syntax (e.g. firstname:John), per SearchScopeHelper::compose in app/bundles/CoreBundle/Helper/SearchScopeHelper.php; Standard is the default free-text option.
Source: mautic/mautic#16479
|
|
||
| Choosing a field only changes which field your next term searches. It doesn't change how the search runs. The scoped search still appears in full in the URL, for example ``?search=subject:foo``, so you can bookmark or share a filtered view. | ||
|
|
||
| On many list views, the dropdown also reminds you that you can type a filter directly. Start typing in the filter box to see query suggestions. For example, type ``zip`` to find the ``zipcode:`` filter. This is handy when the field you want isn't listed in the dropdown. |
Contributor
Author
There was a problem hiding this comment.
The inline query-suggestion hint ('Need different filters? Start typing...') comes from the mautic.core.search.scope.hint string in PR #16479 and renders only when a controller passes searchScopeHint, so it appears on most list views (e.g. Contacts) but not all — hence "On many list views" rather than all.
Source: mautic/mautic#16479
Update the list-view filter dropdown section to match the ready-for-review state of mautic/mautic PR #16479: - Correct Email options (Name, not Internal Name; drop Active (Yes/No)) - Broaden Contacts options and note the Custom Fields grouping - Note flag options (is:mine, is:published) apply without a typed term - Scope the query-suggestion hint to the Contacts list only - Drop the '(...) more' affordance not rendered by the finalized code
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Open this suggestion in Promptless to view citations and reasoning process
Documents the new dropdown next to the 'Filter...' input on Mautic list views (Contacts, Emails, etc.), added in mautic/mautic PR #16479. The dropdown makes field-scoped searching discoverable by mapping a chosen field to the existing colon query syntax, and surfaces an inline hint on most lists. Added to the Searching Mautic reference.
Trigger Events
Tip: See how your feedback shapes Promptless in Agent Knowledge Base 🧠