Skip to content

docs: Document mautic:email:sendwinner command for A/B test automation#294

Open
promptless-for-oss wants to merge 4 commits into
mautic:5.xfrom
Promptless:promptless/pr-15897-ab-testing-sendwinner-command
Open

docs: Document mautic:email:sendwinner command for A/B test automation#294
promptless-for-oss wants to merge 4 commits into
mautic:5.xfrom
Promptless:promptless/pr-15897-ab-testing-sendwinner-command

Conversation

@promptless-for-oss

Copy link
Copy Markdown
Contributor

Open this suggestion in Promptless to view citations and reasoning process

Documents the new mautic:email:sendwinner CLI command introduced for A/B testing segment emails. This command sends the winning A/B test variant to remaining contacts after the test period ends. The documentation includes command usage, options, cron setup instructions, and describes what the command does.

Trigger Events

mautic/mautic PR #15897: feat: A/B testing for segment emails (migrated from Automation53)

Promptless Research (1 GitHub PR)

Agent Response

I've completed my review of PR #15897 and created a documentation suggestion.

Summary

PR #15897 introduces A/B testing for segment emails to Mautic 7, migrated from Automation53. After analyzing the changes, I identified one key developer-facing component that needs documentation:

Documentation Created

New section: "A/B test automation command" added to docs/plugin_extensions/emails.rst

This documents the new mautic:email:sendwinner CLI command, which:

  • Sends the winning A/B test variant to remaining contacts after the test period ends
  • Can process all pending A/B tests or a specific email via the --id option
  • Should be added to cron for automated A/B test completion

The documentation includes command usage examples, cron setup instructions, and explains what the command does step-by-step.

What I didn't document

  • Internal services (AbTestSettingsService, AbTestResultService, etc.) - These are internal implementation details, not developer-facing extension points
  • The existing A/B testing extension points - The current documentation for custom winner criteria (addAbTestWinnerCriteria(), DetermineWinnerEvent) remains accurate and unchanged by this PR
  • variant_entities.rst - This page is marked as needing a major update, but this PR doesn't provide enough new public APIs to justify filling it in

The suggestion is ready for your review when you're ready to look at the documentation changes.


Tip: Tell your friends working on non-commercial open-source projects to apply for free Promptless access at promptless.ai/oss ❤️

Signed-off-by: promptless-for-oss <promptless-for-oss@users.noreply.github.com>
Comment thread docs/plugin_extensions/emails.rst Outdated

.. vale on

The ``mautic:email:sendwinner`` command sends the winning A/B test variant to remaining Contacts in a Segment after the test period ends.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Citation: New mautic:email:sendwinner command introduced in app/bundles/EmailBundle/Command/SendWinnerEmailCommand.php. Command processes A/B test emails after the test delay period ends, determining winner and sending to remaining contacts.
View source

Signed-off-by: promptless-for-oss <promptless-for-oss@users.noreply.github.com>
@promptless-for-oss

Copy link
Copy Markdown
Contributor Author

I've added new changes to address this change request from the dashboard in commit 383c779

@adiati98 adiati98 added this to the 7.2 milestone May 18, 2026
@adiati98 adiati98 marked this pull request as ready for review June 1, 2026 12:32
@adiati98

adiati98 commented Jun 1, 2026

Copy link
Copy Markdown
Contributor

@promptless-for-oss please rebase to 7.2 branch

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants