Skip to content

Fix contradictory note about duplicate Stage weights#774

Open
promptless-for-oss wants to merge 2 commits into
mautic:7.2from
Promptless:promptless/stage-weight-unique-7.2
Open

Fix contradictory note about duplicate Stage weights#774
promptless-for-oss wants to merge 2 commits into
mautic:7.2from
Promptless:promptless/stage-weight-unique-7.2

Conversation

@promptless-for-oss

Copy link
Copy Markdown

Open this suggestion in Promptless to view citations and reasoning process

Corrects the "Moving Contacts between Stages" note, which incorrectly stated that multiple Stages across funnels could share the same weight. The unique-weight constraint added in mautic/mautic#15404 (and already documented in the Weight field description) makes each Stage's weight unique across all funnels. Targets the 7.2 user-docs branch.

Trigger Events


Tip: Tag @Promptless in a GitHub issue to turn it into a documentation update 🐙

The Moving Contacts note claimed multiple Stages could share the same
weight across funnels, which contradicts the unique-weight constraint
introduced in mautic/mautic#15404 and documented in the Weight field
description. Correct the note to state each Stage must have a unique
weight across all funnels.
Comment thread docs/stages/stages.rst
.. note::

You can have multiple funnels with different Stages, and multiple Stages across those funnels with the same weight. A Contact can only ever be in one Stage at a time. It's not possible to move a Contact to a Stage which has a lesser weight than their current Stage. For example if they're currently in Stage B which has a weight of 50, you can't move them to Stage A which has a weight of 25.
You can have multiple funnels with different Stages, but each Stage must have a unique weight across all funnels. A Contact can only ever be in one Stage at a time. It's not possible to move a Contact to a Stage which has a lesser weight than their current Stage. For example if they're currently in Stage B which has a weight of 50, you can't move them to Stage A which has a weight of 25.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mautic/mautic#15404 adds a global UniqueEntity constraint on the Stage weight field (mautic.stage.weight.unique = "Another stage with this weight already exists."), so the prior claim that "multiple Stages across those funnels with the same weight" are allowed is now false. Rewrote the note to say each Stage must have a unique weight across all funnels.

Source: mautic/mautic#15404

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants