Skip to content

Document Marketplace ratings and reviews, and campaign sharing to the Marketplace - #934

Closed
promptless-for-oss wants to merge 120 commits into
mautic:7.2from
Promptless:promptless/marketplace-reviews-ratings
Closed

Document Marketplace ratings and reviews, and campaign sharing to the Marketplace#934
promptless-for-oss wants to merge 120 commits into
mautic:7.2from
Promptless:promptless/marketplace-reviews-ratings

Conversation

@promptless-for-oss

Copy link
Copy Markdown
Contributor

What this documents

Documents the user-facing Marketplace changes from mautic/mautic PR #15904 ("New Marketplace API, review, rating (public-marketplace)"), merged to 7.x.

docs/marketplace/marketplace.rst

  • New Ratings and reviews section: the list view shows each Plugin's community rating (a number) and review count; the Plugin detail page shows a Reviews panel of individual reviews (star rating, review text, reviewer username).
  • Rate & Review now redirects to the public Mautic Marketplace website (marketplace.mautic.org), where reviews are managed — the in-app rating form was removed.
  • Adds a caution that community ratings/reviews reflect user opinion, not a Mautic-verified compatibility or security check.

docs/campaigns/exporting_campaigns.rst

  • Corrects the "Using Mautic instance" export step: the Export action now opens a Share form (reachable from the Campaign detail page and the Campaign list row) instead of downloading the ZIP directly. The form offers Download ZIP (local export, now including a package manifest and any images added in the form) and Publish (shares the Campaign to the public Mautic Marketplace as a resource package).

docs/links/marketplace_mautic_org.py

  • New xref registry entry for the Mautic Marketplace website.

Notes for reviewers

  • Targets the 7.2 docs branch per the source PR's 7.x base.
  • The publish/share flow depends on the public marketplace backend (marketplace.mautic.org), which may not be fully live yet, so the docs describe the Mautic UI behavior and keep Publish coverage brief.
  • Vale passes on the changed lines (pre-existing findings elsewhere in the files are unrelated to this change).

Generated by Promptless.

kuzmany and others added 30 commits May 4, 2025 23:04
* feat: rename files by appending word mautic for clarity
fix: Broken links to the outdated developer docs URL branch `7.0`
Docs: Add contributing guidelines to branch 7.0
Docs: Change Roles page link and fix a broken link in branch 7.0
promptless Bot and others added 19 commits April 1, 2026 08:55
…place

Documents the user-facing changes from mautic/mautic PR #15904:
- marketplace.rst: community ratings/reviews display (list view rating +
  review count; detail page individual reviews) and the Rate & Review
  redirect to the public Mautic Marketplace website; adds a caution that
  ratings are community opinion, not a Mautic-verified compatibility check.
- exporting_campaigns.rst: the campaign Export action now opens a Share
  form (Download ZIP / Publish to the public Marketplace) instead of
  downloading directly.
- Adds a docs/links xref entry for marketplace.mautic.org.

* Issue tracker opens a new window with the issue tracker for the Plugin. It shows only if the Plugin has this information available. Use this option to search for issues with the Plugin and to report new issues to the maintainers.

Ratings and reviews

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.

New Marketplace API with review and rating functionality. Changes include: removed in-app RateController and Auth0 integration, added redirect to public marketplace website, new Review DTO and ReviewCollection classes, updated API URLs to marketplace-api.mautic.org. Files: MarketplaceBundle/DTO/Review.php, MarketplaceBundle/Collection/ReviewCollection.php, MarketplaceBundle/Controller/Package/DetailController.php

Source: mautic/mautic#15904

#. Click the three-dot icon next to the Campaign's name that you want to export to open the options.
#. Select the **Export** option from the dropdown menu. It automatically downloads the ZIP file.
#. Open the options for the Campaign you want to export. These are available from the three-dot icon on the Campaign list row and from the Campaign detail page.
#. Select the **Export** option. Instead of downloading immediately, Mautic opens a **Share** form.

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.

Campaign Export action (from both the Campaign list row three-dot menu and the Campaign detail page) now routes to a Share form instead of downloading a ZIP directly. Evidence: CampaignBundle/EventListener/ButtonSubscriber.php addListRowExportButton (list row -> objectAction 'share'), Resources/views/Campaign/details.html.twig Export button (objectAction 'share'), Controller/CampaignController.php shareAction/handleShareSubmission (Publish vs Download ZIP submit buttons), Form/Type/CampaignShareType.php (title/vendorName/version/description required, price field present but disabled), Service/CampaignShareService.php (buildShareZip/buildComposerJson - Publish shares campaign as a mautic-resource package; Download ZIP reuses the same archive builder, so it also includes composer.json and any banner/gallery images, not identical to the pre-PR plain export ZIP).

Source: mautic/mautic#15904

@adiati98

adiati98 commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

@promptless-for-oss why there are many unrelated commits here? Please rebase.

@adiati98 adiati98 added this to the Mautic 7.2 milestone Sep 1, 2026
@promptless-for-oss

Copy link
Copy Markdown
Contributor Author

Thanks, @adiati98 — good catch. We'll rebase this branch onto 7.2 and drop the unrelated commits so the PR shows only the Marketplace ratings/reviews and campaign-sharing changes. We'll follow up here once it's cleaned up.

@promptless-for-oss

Copy link
Copy Markdown
Contributor Author

Thanks for flagging this, @adiati98. To explain what you were seeing: this PR's actual file changes were already limited to the three intended files, but the branch's commit history had picked up ~100 unrelated commits from repeated base-branch sync merges — that's the noise in the commits list.

Our publishing setup doesn't allow force-pushing (rewriting a branch's history), so rather than rewrite this branch we rebuilt the exact same change as a single clean commit on the current 7.2 tip and opened a fresh PR: #939. Its file diff is byte-for-byte identical to this one (same 3 files, +37/-3), just with a clean single-commit history.

We're closing this PR in favor of #939 — please continue the review there. Sorry for the extra hop!

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.