Refresh Post Plus documentation for current MainWP terminology - #83
Conversation
WalkthroughThis PR rewrites the Post Plus MDX documentation to match newer UI navigation and labels. It updates the intro, addon metadata, draft save/publish/edit/delete instructions, and the random metadata guidance for author, category, and publishing date. ChangesPost Plus documentation updates
Estimated code review effort🎯 2 (Simple) | ⏱️ ~10 minutes Possibly related PRs
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@add-ons/posts-pages/post-plus-extension.mdx`:
- Around line 47-50: The docs copy for the meta box name is inconsistent with
the in-product UI label. Update the “Post Plus Randomizer” / “Post Plus section”
wording in the relevant markdown content to match the existing label used by the
Post Plus feature, and keep the terminology consistent wherever the meta box is
referenced in this page.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: a1fa3efb-981f-4bc9-8eaa-4c543e98ee85
📒 Files selected for processing (1)
add-ons/posts-pages/post-plus-extension.mdx
| ## Post Plus Randomizer | ||
|
|
||
| This great addition to your Add New Post/Page is the all-new MainWP Randomizer meta box. This will allow you to randomize metadata for your content giving the appearance of multiple active bloggers. Simply selecting options to randomize, you can have random Authors for your posts, who can be assigned to random categories and have randomly picked publishing dates. You can also narrow the randomized data to specific User Roles and Date Range. | ||
| This addition to your Add New Post/Page screen is the Post Plus meta box. This will allow you to randomize metadata for your content giving the appearance of multiple active bloggers. Simply selecting options to randomize, you can have random authors for your posts or pages, assign posts to random categories, and have randomly picked publishing dates. You can also narrow the randomized data to specific user roles and a date range. | ||
|
|
There was a problem hiding this comment.
🎯 Functional Correctness | 🟡 Minor
🧩 Analysis chain
🏁 Script executed:
git ls-files | rg 'post-plus-extension\.mdx|post-plus|addon-panel|post.*pages'Repository: mainwp/docs
Length of output: 987
🏁 Script executed:
git ls-files | rg 'post-plus-extension\.mdx|post-plus|addon-panel|post.*pages'Repository: mainwp/docs
Length of output: 987
🏁 Script executed:
sed -n '35,60p' add-ons/posts-pages/post-plus-extension.mdx && printf '\n---\n' && sed -n '215,235p' add-ons/posts-pages/post-plus-extension.mdx && printf '\n---\n' && rg -n "MainWP Randomizer|Post Plus Randomizer|Post Plus section|randomizer" add-ons/posts-pages/post-plus-extension.mdx scripts/addon-panel.jsRepository: mainwp/docs
Length of output: 2649
🏁 Script executed:
sed -n '35,60p' add-ons/posts-pages/post-plus-extension.mdx && printf '\n---\n' && sed -n '215,235p' add-ons/posts-pages/post-plus-extension.mdx && printf '\n---\n' && rg -n "MainWP Randomizer|Post Plus Randomizer|Post Plus section|randomizer" add-ons/posts-pages/post-plus-extension.mdx scripts/addon-panel.jsRepository: mainwp/docs
Length of output: 2649
🏁 Script executed:
rg -n "MainWP Randomizer|Post Plus Randomizer|Post Plus section|random meta|randomizer" -S .Repository: mainwp/docs
Length of output: 765
🏁 Script executed:
rg -n "MainWP Randomizer|Post Plus Randomizer|Post Plus section|random meta|randomizer" -S .Repository: mainwp/docs
Length of output: 765
🌐 Web query:
MainWP Post Plus randomizer MainWP Randomizer meta box site:mainwp.com
💡 Result:
The MainWP Randomizer is a feature included within the MainWP Post Plus extension [1][2]. It appears as a meta box on your MainWP Dashboard when you are creating or editing posts and pages [1][2]. The purpose of the MainWP Randomizer is to allow you to randomize specific metadata for content published across your child sites [1][2]. This functionality helps create the appearance of multiple active bloggers or a more dynamic content strategy by automatically varying the following attributes [1][2]: Authors: You can select specific user roles from your child sites, and the extension will randomly assign an existing user with that role to the post [1][3]. Categories: The extension can automatically assign a random category from the existing categories on the target child site [1]. Publishing Dates: You can opt to randomize the publishing date [1][4]. If you specify a date range, the extension will select a random date from within that period; if left blank, it will select a completely random date [1][4]. To use these features, you simply enable the desired randomization options within the MainWP Randomizer meta box on the Post Plus post/page creation screen [1][3][4]. There are no limits to the number of authors, categories, or dates that can be randomized [2].
Citations:
- 1: https://docs.mainwp.com/add-ons/posts-pages/post-plus-extension
- 2: https://mainwp.com/add-on/post-plus/
- 3: https://mainwp.com/use-random-authors/
- 4: https://mainwp.com/use-publishing-dates/
Keep the UI label as MainWP Randomizer Lines 47 and 227 rename this control to Post Plus Randomizer / Post Plus section, but the product and docs still refer to the meta box as MainWP Randomizer. If the UI label hasn’t changed, align the copy with the in-product wording.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@add-ons/posts-pages/post-plus-extension.mdx` around lines 47 - 50, The docs
copy for the meta box name is inconsistent with the in-product UI label. Update
the “Post Plus Randomizer” / “Post Plus section” wording in the relevant
markdown content to match the existing label used by the Post Plus feature, and
keep the terminology consistent wherever the meta box is referenced in this
page.
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Summary
Testing
Summary by CodeRabbit