Document select field operators in Segment filters#765
Open
promptless-for-oss wants to merge 18 commits into
Open
Document select field operators in Segment filters#765promptless-for-oss wants to merge 18 commits into
promptless-for-oss wants to merge 18 commits into
Conversation
Adds a new section explaining which operators are available for select fields in Segment filters, clarifying that 'including all of' and 'excluding all of' are only available for multiselect fields, not single-select fields like Country, Timezone, Region, and Locale.
- Add Regexp and Not regexp operators to single-select field list - Clarify that Including any of and Excluding any of work for single-select fields - Simplify multiselect section to only list the two exclusive operators - Mention custom select fields in addition to built-in single-select types
Updates operator names in the 'Operators for select fields' section to use the new user-friendly labels introduced in Mautic 7.x. This aligns the documentation with the actual UI text from PR #15027.
Author
There was a problem hiding this comment.
(Line 385)
PR #16012 removes 'including all of' and 'excluding all of' operators from single-select fields (Country, Timezone, Region, Locale) in OperatorListTrait.php. The PR description confirms these operators are "logically impossible for single-select fields" and should only appear for multiselect fields.
Source: mautic/mautic#16012
|
|
||
| Single-select fields like Country, Timezone, Region, Locale, and custom select fields have these operators: | ||
|
|
||
| * **Is equal to** - The Contact's value exactly matches the selected option. |
Author
There was a problem hiding this comment.
Updated operator names to match the user-friendly labels from PR #15027. The new labels are: is equal to, is not equal to, is empty, is not empty, matches pattern, does not match pattern, includes any of, excludes any of, includes all of, excludes all of.
Source: mautic/mautic#15027
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
1 participant
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 which operators are available for select fields in Segment filters, clarifying the distinction between single-select and multiselect fields based on PR #16012. Updated to use the new operator labels from PR #15027.
Changes
docs/segments/manage_segments.rst
Context
PR #16012 fixes a bug where 'includes all of' and 'excludes all of' operators were incorrectly available for single-select fields in Segment filters. These operators only make sense for multiselect fields where a Contact can have multiple values. PR #15027 renamed operators to be more user-friendly, so the documentation now uses the updated operator names.
Trigger Events
Tip: Adjust how proactive or focused Promptless is in Agent Settings ⚙️