=== Noshi-Kanamer – WordPress Pre-Launch Checklist & Client Handoff Toolkit ===
Contributors: nokazehayato
Tags: developer-tools, pre-launch, checklist, toolkit, vibe-coding
Requires at least: 6.2
Tested up to: 7.0
Stable tag: 0.5.11
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WordPress pre-launch checklist & client handoff toolkit. Catches what AI (or you) leave behind: WP_DEBUG, noindex, admin username. Proof included.

== Description ==

**Prove your site is clean before the client ever sees it.**
Noshi-Kanamer is a WordPress pre-launch checklist & client handoff toolkit built for freelancers and agencies, whether you hand-code, use a page builder, or build with AI. It auto-detects the things that are easy to leave behind: WP_DEBUG, noindex, test content, and the default admin username, then generates a shareable report summarizing your pre-launch checks.

![The Pre-Launch tab with every check cleared and the proof report ready](https://nokazehayato.github.io/noshi-launch-checklist/assets/noshi-kanamer-prelaunch-complete.png)

**Develop → Check → Fix → Prove → Handoff!!**
Noshi-Kanamer is more than a pre-launch checklist. Hide Blocks, Block Showcase, Test Posts, Media Manager, and Site Check support you while you build. Then Pre-Launch takes over. It checks the technical loose ends that are easy to miss before handoff, including WP_DEBUG, noindex, and debug.log. Unlike a manual checklist, it detects problems instead of just listing them, then summarizes the completed checks in a copyable handoff report.

= Block Showcase =

Ever want to check how your available editor blocks look, all in one place? Insert the Block Showcase block and click "Generate Showcase": supported blocks you haven't hidden line up together so you can check appearance and consistency at a glance. This gives you a shareable page for client review.

= Hide Blocks =

Hide blocks your client will not need, such as social links or YouTube embeds, from the editor in one click. The setting applies globally to all users. Generate a `functions.php` snippet during your handoff checklist and add it to your theme to keep the block visibility settings after Noshi-Kanamer is removed.

= Test Posts =

Generate flagged test posts in one click to fill carousels or list blocks without creating sample content by hand. Each test post is marked internally, so you can delete all generated test posts before launch without touching unflagged posts.

= WordPress Pre-Launch Checklist =

A checklist that actually does the work. Run a consistent pre-launch routine across your client sites from one screen:

* **Delete all test posts** — every flagged test post, instantly
* **Move Block Showcase pages to trash**
* **Flush rewrite rules** — helps prevent rewrite-related 404 errors after migration
* **Search engine indexing** — detects noindex, with a direct link to fix it
* **Admin email address** — shown with a direct link to update it
* **WP_DEBUG status** — alerts if debug mode is still on, with a copy-paste fix
* **File editor, XML-RPC, debug.log, and the default 'admin' username** — four security loose ends, each with an action, copy-paste snippet, direct link, or clear guidance
* **Persist block visibility** — keeps your Hide Blocks settings via a `functions.php` snippet

Too many checks to track at once? The sticky Next Action card always points to the one thing to do next, so the finish line stays in sight. Once everything is done, your pre-launch check is clear. Click **"Generate Report"** for a copyable summary of your pre-launch checks, ready to include in your handoff documentation or client update.

= Other Useful Tools =

Two additional tools support the work around the core pre-launch flow: Site Check helps at the start of a client project, and Media Manager helps with cleanup before handoff.

= Site Check =

Taking over an existing site? The Site Check tab scans every installed plugin (active and inactive) against WordPress.org and flags plugins whose WordPress.org listings have not been updated in 6+ months or 1+ year, bringing potentially unmaintained plugins to the top before you start working on a client's site.

= Media Manager =

Keep your media library clean while you build. Every image is scanned automatically:

* **"Unused" badge** — flags images not used in post content, featured images, or supported ACF image and gallery fields
* **"Used In" field** — shows which posts or pages reference an attachment
* **Bulk delete** — remove images with no detected references in one go, handy for a final sweep before client handoff

= Built However You Build It =

Whether you hand-code it, build it with a page builder, or prompt an AI to do it, the finish line looks the same: WP_DEBUG left on, noindex still set, test posts left behind. AI can build what you ask for, but it cannot sign off on the launch. That final check is still yours. Noshi-Kanamer helps you catch what any build method can leave behind before handoff.

== Installation ==

= Automatic Installation =

1. Go to **Plugins > Add New** in your WordPress admin dashboard
2. Search for "Noshi-Kanamer"
3. Click **Install Now**, then **Activate**
4. Go to **Tools > Noshi-Kanamer**

= Manual Installation =

1. Upload the plugin folder to `/wp-content/plugins/noshi-kanamer`
2. Activate through the Plugins screen in WordPress
3. Go to **Tools > Noshi-Kanamer**

== Frequently Asked Questions ==

= I just installed Noshi-Kanamer. Where do I start? =

Look for **Noshi-Kanamer** in your WordPress admin sidebar. It opens with a quick welcome guide pointing you to the right tab to start with.

= Can I use Noshi-Kanamer as a final check for an AI-built WordPress site? =

Yes. AI site builders and vibe-coding sessions are great at generating pages, but they do not automatically know which technical loose ends must be cleared before launch. Noshi-Kanamer runs the launch checks that are easy to omit from an AI-assisted build brief, including WP_DEBUG, noindex, debug.log, and test content, then generates a shareable report summarizing your pre-launch checks.

= Will deleting test posts affect my real content? =

No. Noshi-Kanamer marks each test post with a hidden flag. Only posts carrying that flag are selected for deletion; unflagged posts are excluded.

= Does Hide Blocks affect all users or just me? =

It applies globally to all users on the site, using the `allowed_block_types_all` filter.

= What happens to my Hide Blocks settings when I deactivate or remove the plugin? =

Use the Pre-Launch tab to generate a `functions.php` snippet beforehand. Paste it into your theme and your block visibility settings remain permanent, even without the plugin active.

= What does the Pre-Launch progress card actually show? =

The Pre-Launch tab displays a live progress card (X of Y complete) and a sticky Next Action card that surfaces the next unresolved item, with a direct link to the fix for settings-based checks and clear next-step guidance for the rest.

= How does code-level noindex detection work? =

Beyond the standard WordPress Reading Settings check, Noshi-Kanamer also inspects the `wp_robots` filter output and, on hosts that support server-to-server loopback requests, the actual rendered HTML `<meta name="robots">` tag. This can catch noindex directives injected by your theme or an SEO plugin that a Reading Settings check alone may miss.

= Why are some blocks missing from the Block Showcase? =

Blocks exclusive to Full Site Editing (FSE), such as `core/template-part` and query pagination blocks, cannot be rendered on standard pages or posts. Blocks you've hidden with Hide Blocks, or that require a specific parent block, are also excluded. Other supported blocks in the standard block editor are included.

= Does Block Showcase work with Elementor? =

Block Showcase requires the Gutenberg block editor and is not compatible with Elementor. When Elementor is active, pages are managed through the Elementor editor, which does not support Gutenberg blocks. The other tools remain available alongside Elementor, though Hide Blocks applies to Gutenberg blocks rather than Elementor widgets.

= Is this a developer tool or a client-facing plugin? =

It is a developer tool for freelancers and agencies working on client WordPress sites, from project setup through handoff. It is not intended for clients. We recommend deactivating or removing it before handing off the site.

= Can I use this on every client project? =

For most WordPress setups, yes. Pre-Launch Cleanup, Hide Blocks, and Test Posts work across standard and FSE themes. Note that Block Showcase requires the Gutenberg block editor and is not compatible with Elementor-powered pages. The other tools remain available, though Hide Blocks applies to Gutenberg blocks rather than Elementor widgets.

= What should I check before handing off a WordPress site to a client? =

Noshi-Kanamer brings key WordPress handoff checks and cleanup tasks together across the Pre-Launch and Media Manager tabs. The Pre-Launch tab handles test content, rewrite rules, search engine indexing (noindex), WP_DEBUG, the admin email address, and four security loose ends (file editor, XML-RPC, debug.log, the default admin username), all in one screen. The Media Manager tab finds and removes images with no detected references before client delivery. When the **"All pre-launch checks are complete!"** banner appears, every item in the Pre-Launch tab has been cleared. You can then include the report in your handoff documentation.

= When should I deactivate Noshi-Kanamer? =

We recommend deactivating or removing it just before handoff to keep the client's dashboard clean. That said, you can always reactivate it later for maintenance, post-launch adjustments, or follow-up work.

= Is there a plugin that checks if WP_DEBUG is left on before I launch? =

Yes. The Pre-Launch tab automatically detects whether `WP_DEBUG` is still enabled and provides a copy-paste fix for `wp-config.php`, alongside a check for a leftover `debug.log` file (with one-click deletion).

= How do I find and delete unused media before client handoff? =

The Media Manager tab scans your media library and flags images with no detected references in post content, featured images, or supported ACF image and gallery fields, then lets you bulk-delete them in one pass.

== Source Code ==

The compiled JavaScript in the `build/` directory is generated from the JSX source files in `src/` using Vite. The full source code is included in the plugin package under `src/`.

== Screenshots ==

1. The goal — every check cleared before you hand off the site.
2. Step 0 — Taking over an existing site? Start here: Site Check flags potentially unmaintained plugins before you touch anything.
3. Step 1 — Keep the editor clean: hide blocks your client won't need.
4. Step 2 — Show your work: render supported editor blocks in a shareable catalog for client review.
5. Step 3 — Build with confidence: generate flagged test posts, wipe them safely before launch.
6. Step 4 — Clean up unused media before delivery.
7. Step 5 — Track what's left: the progress card and Next Action card keep you oriented until every check clears.

== Upgrade Notice ==

= 0.5.8 =
Every tab now has a Guide button — a quick how-it-works explainer, right where you need it.

= 0.5.7 =
Bundles the finalized Japanese translation set (100% coverage on WordPress.org) and gives the activation notice a friendlier welcome that nudges you straight to the Pre-Launch tab.

= 0.5.6 =
The Pre-Launch tab now shows a progress card and a sticky Next Action card so you always know what to do next. Code-level noindex (theme or SEO plugin) is now detected in addition to the Reading setting — no more silent launches that fail to appear in Google.

= 0.5.5 =
Each tab now opens with a one-line orientation message, and the Pre-Launch tab has a brand-color top border to mark your handoff milestone.

= 0.5.4 =
First-time tool-page visitors now get a welcome modal pointing to Pre-Launch; returning users see Hide Blocks as the default tab again.

= 0.5.3 =
The "All checks passed" modal now appears every time all checks pass. Review prompt is shown once per day only.

= 0.5.1 =
Better first-time experience: sidebar menu, Pre-Launch tab opens by default, and items show what's already clean — no need to click every button.

= 0.5.0 =
New: Site Check tab scans installed plugins and flags ones not updated in 6+ months or 1+ year on WP.org.

= 0.4.0 =
New: Pre-Launch adds 4 security checks — file editor lock, XML-RPC, debug.log, and 'admin' username — plus one-click debug.log cleanup.

= 0.3.0 =
New: Pre-Launch tab now generates a copyable summary report of your cleanup checks — handy for client handoff.

= 0.2.4 =
A small "Leave a review" link now appears in the footer of every Noshi-Kanamer admin tab.

= 0.2.3 =
The review prompt now also appears for returning users (7+ days, 3+ visits to the Noshi-Kanamer screen), even before pre-launch is complete.

= 0.2.2 =
Japanese admin UI is now available. Displays automatically when WordPress is set to Japanese. No configuration needed.

= 0.2.1 =
Improved review prompt copy — clearer message after pre-launch completion.

= 0.2.0 =
New: Media Manager tab — find and delete unused images before client handoff. Also adds usage info to the media modal and Unused badges in the media library.

= 0.1.2 =
Confirmed compatibility with WordPress 7.0. Screenshots updated to reflect the new admin UI. No code changes.

= 0.1.1 =
Pre-Launch now shows a review nudge once a day — not pushy, just a small ask.
Your feedback genuinely helps us improve.

== Changelog ==

= 0.5.11 =
* Changed: Minor wording tweaks to remaining error messages, warnings, and helper text for consistency.

= 0.5.10 =
* Changed: Minor wording tweaks to several tab headings and helper text for consistency.

= 0.5.9 =
* Changed: Minor wording tweaks to the Pre-Launch Report output for clarity.

= 0.5.8 =
* Added: Every tab now has a "Guide" button that opens a short how-it-works modal — see how each tool fits into your Develop → Deliver workflow without leaving the tab.
* Added: The Pre-Launch guide walks through Checks, Actions, Code Generator, and Report as separate pages, so first-time and returning users alike can skim exactly the section they need.

= 0.5.7 =
* Improved: Activation notice now gives new users a warmer welcome and a nudge to check the Pre-Launch tab — even a test environment that looks clean can have something left to resolve.
* Improved: Description now describes the live progress card, sticky Next Action card, and code-level noindex detection.
* Improved: Bundled Japanese translations are now 100% complete on WordPress.org (v0.5.5 + v0.5.6 additions submitted and approved).

= 0.5.6 =
* Added: Pre-Launch tab now shows a progress card with `N/10 complete` and a sticky Next Action card (bottom-right) so you can see exactly what's left and how to do it — no more guessing why "All checks complete" isn't appearing.
* Added: Each pending step in the Next Action card includes a hint sentence and (where applicable) a one-click link to the relevant settings screen.
* Added: Code-level noindex detection — Pre-Launch now also checks the `wp_robots` filter output and inspects the rendered HTML for `<meta name="robots" content="noindex">`, so theme/SEO-plugin-driven noindex directives are no longer silently missed even when the Reading setting says "indexed".
* Improved: When all checks pass, the Pre-Launch tab background turns a soft green and the progress card is replaced by a green completion banner with a Generate Report button — the handoff-ready moment is more obvious.
* Improved: Progress card shows red while items are pending, gray while the check is still loading.

= 0.5.5 =
* Improved: Pre-Launch tab now has a distinctive brand-color border accent so it stands out as the handoff milestone in the tab bar.
* Improved: Each tab now shows a heading that names the tool and its purpose (e.g. "Hide Blocks — Hide blocks your clients won't need"), so users can orient themselves at a glance.
* Improved: Each tool tab now opens with a one-line orientation sentence ("Develop —" or "Deliver —") so new users immediately understand where they are in the build-to-handoff flow.
* Improved: All tabs now have icons, the active tab gets a brand-color top border, and a persistent "Check first" badge on Pre-Launch signals it as the handoff milestone.
* Improved: Pre-Launch sections are now ordered Checks → Actions → Code Generator → Report, matching the natural "review then act" flow.

= 0.5.4 =
* Improved: A welcome modal now greets you on your first visit to the tools page, pointing you to the Pre-Launch check — your suggested starting point.
* Improved: Default tab returns to Hide Blocks so returning users no longer have to navigate away from Pre-Launch every visit.
* Improved: The activation notice now highlights auto-detection of debug mode, noindex and test data, and the proof report for client handoff.
* Fixed: Bundled translations now correctly apply when WordPress.org pulls older translation files, so new UI strings are no longer shown in English on translated sites.

= 0.5.3 =
* Improved: The "All checks passed" modal was only shown on the very first completion; it now appears every time all checks pass, so returning users always see the handoff-ready moment.
* Improved: The review prompt is shown once per day — if you've already seen it today, only the "Generate Report" reminder appears, so it never interrupts your flow on repeat visits.
* Improved: Engaged modal body text is now line-broken for readability.

= 0.5.2 =
* Fixed: Pre-Launch tab now re-checks status every time you switch back to it, so it no longer shows stale "not used" results after generating or removing content in other tabs.

= 0.5.1 =
* Improved: Noshi-Kanamer now appears in the sidebar (in addition to Tools), Pre-Launch tab is the default view, plugin description clarifies the Pre-Launch / Handoff focus, an activation notice guides you to the Pre-Launch tab, and Pre-Launch items show "not used" when no cleanup is required.

= 0.5.0 =
* Added: New "Site Check" tab scans all installed plugins (active and inactive) and flags ones not updated on WordPress.org in 6+ months (warning) or 1+ year (critical), with results sorted so plugins needing attention appear first. Batch scanning keeps things responsive on sites with many plugins.
* Added: A link to the Site Check tab now appears on the Plugins screen (wp-admin/plugins.php).
* Added: The Pre-Launch summary report now includes an outdated plugins count and flags inactive plugins that are also outdated, based on the Site Check scan.

= 0.4.0 =
* Added: Pre-Launch tab now checks 4 more items: DISALLOW_FILE_EDIT (file editor lock), XML-RPC, debug.log, and the default 'admin' username — each with a one-click fix or guidance to resolve it.
* Added: A one-click "Delete debug.log file" action on the Pre-Launch tab.

= 0.3.0 =
* Added: A new "Report" section on the Pre-Launch tab generates a plain-text summary of your cleanup checks (test posts, catalog pages, rewrite rules, indexing, WP_DEBUG, hidden blocks) that you can copy for client handoff.

= 0.2.4 =
* Added: A small "Leave a review" link now appears in the footer of every Noshi-Kanamer admin tab, alongside the existing review prompts.

= 0.2.3 =
* Added: The review prompt now also appears for returning users — after 7 days since activation and 3+ visits to the Noshi-Kanamer screen — even if pre-launch isn't complete yet.
* Improved: The returning-user review prompt now respects a 60-day cooldown, so it never reappears day after day.
* Fixed: Japanese translation for the returning-user review prompt (it previously showed in English even on Japanese sites).

= 0.2.2 =
* Added: Japanese (ja) localization for all admin UI — all tabs and dialogs now display in Japanese when WordPress is set to Japanese.

= 0.2.1 =
* Improved: Review prompt copy — rewritten to emphasize achievement and community value over personal ask

= 0.2.0 =
* Added: Media Manager tab (Tools > Noshi-Kanamer) — browse unused images, select, and permanently delete them before handoff
* Added: "Used In" field in the media attachment modal — shows which posts/pages reference the image, or "Unused" if none
* Added: "Unused" badge on images in the media library grid and list views
* Note: detection covers post_content, core post_meta (featured image), and ACF image/gallery fields.

= 0.1.2 =
* Confirmed compatibility with WordPress 7.0
* Updated screenshots to reflect the WordPress 7.0 admin UI

= 0.1.1 =
* Added: After completing Pre-Launch, a gentle review nudge appears once per
  day. We'd love to hear how it's working for you — even a quick note helps
  a lot!

= 0.1.0 =
* Initial release
