Skip to content

Refresh Post Plus documentation for current MainWP terminology - #83

Merged
bkatusic merged 1 commit into
mainfrom
docs-review/post-plus-extension
Jun 26, 2026
Merged

bkatusic merged 1 commit into
mainfrom
docs-review/post-plus-extension

Conversation

@bkatusic

@bkatusic bkatusic commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Correct Post Plus copy, metadata, and URLs
  • Update step-by-step instructions to match current MainWP Dashboard navigation and action labels
  • Clarify randomizer behavior and supported options for posts and pages

Testing

  • Not run (not requested)
  • Reviewed the MDX diff for wording, navigation, and frontmatter consistency

Summary by CodeRabbit

  • Documentation
    • Updated the Post Plus help page to match the latest interface and navigation flow.
    • Refreshed step-by-step instructions for saving, publishing, editing, and deleting drafts.
    • Added guidance for using the randomizer options, including random author, category, metadata, and publishing date settings.
    • Improved wording and screenshots/navigation references to better reflect the current UI.

@coderabbitai

coderabbitai Bot commented Jun 26, 2026

Copy link
Copy Markdown

Review Change Stack

Walkthrough

This 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.

Changes

Post Plus documentation updates

Layer / File(s) Summary
Intro and addon metadata
add-ons/posts-pages/post-plus-extension.mdx
Updates the opening copy, learning bullet, and hidden addon-data metadata block.
Draft workflow instructions
add-ons/posts-pages/post-plus-extension.mdx
Rewrites save, publish, edit, and delete draft steps with updated Sites > Content Operations navigation and action labels.
Random metadata options
add-ons/posts-pages/post-plus-extension.mdx
Revises the random author, category, and publishing date instructions and the date-selection explanation.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • mainwp/docs#81: Updates a similar add-on MDX page with revised addon-data metadata and newer MainWP UI navigation/button wording.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the documentation refresh to match current MainWP terminology.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs-review/post-plus-extension

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

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

📥 Commits

Reviewing files that changed from the base of the PR and between 4f99447 and 9ed1e2d.

📒 Files selected for processing (1)
  • add-ons/posts-pages/post-plus-extension.mdx

Comment on lines +47 to 50
## 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.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 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.js

Repository: 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.js

Repository: 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:


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.

@bkatusic
bkatusic merged commit 08a1221 into main Jun 26, 2026
3 checks passed
@bkatusic
bkatusic deleted the docs-review/post-plus-extension branch June 26, 2026 14:56
@mintlify

mintlify Bot commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mainwp 🔴 Failed Jun 26, 2026, 3:00 PM

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.

1 participant