=== BePlus Support Snapshot ===
Contributors: lenguyendev
Tags: support, diagnostics, site health, change tracking, debug
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate support snapshots, track changes over time, compare reports, and export a diagnostic package for faster WordPress troubleshooting.

== Description ==

BePlus Support Snapshot is a maintenance companion for WordPress. It captures a full snapshot of your site's state, including plugins, themes, versions, environment details, recent updates, error context, and overdue cron signals, so you can understand exactly what changed and when.

It is built for WordPress agencies, support teams, freelancers, and site maintainers running regular upkeep and troubleshooting workflows. Instead of getting stuck with "the site broke and I don't know why," you get a clearer before-and-after view of the site.

Most troubleshooting tools show only the current state of a site. That is useful, but it does not answer the questions support teams ask most often:

* What changed?
* When did it change?
* Could that change be related to the issue?

BePlus Support Snapshot is built for that workflow.

It lets you generate a support snapshot of the site, keep a history of snapshots over time, compare reports, and export a structured `support-report.zip` package that can be reviewed internally or shared with a trusted client, teammate, contractor, or product support team.

Use it to:

* Take a snapshot before a maintenance round, then another after, and compare them to confirm nothing broke
* Pinpoint which plugin or theme update introduced an issue
* Catch stuck or overdue cron jobs behind delayed emails, missed scheduled tasks, or broken automations
* Track version drift across a site over time
* Hand off a clear diagnostic report to a client, teammate, host, or vendor without giving direct admin access

= Why Use BePlus Support Snapshot? =

* Capture a point-in-time snapshot before and after important changes
* Compare snapshots to understand what is different
* Review site health, plugins, themes, updates, errors, and cron signals in one place
* Export a diagnostic package for structured support handoff
* Reduce guesswork when investigating regressions and compatibility issues

= What This Plugin Is =

* A support diagnostics tool
* A troubleshooting assistant
* A change tracking solution
* A support snapshot generator

= What This Plugin Is Not =

* A malware scanner
* A security plugin
* A performance optimization plugin
* A backup plugin

= Key Features =

* Generate support snapshots from the WordPress admin area
* Export a downloadable `support-report.zip` package
* Store snapshot history for later review
* Compare two snapshots to identify changes over time
* Review Site Health and environment information
* Capture plugin inventory and activation state
* Capture theme inventory and active theme context
* Track recent update-related signals
* Detect active error context and recovery mode signals
* Detect overdue or failed cron job signals
* Include a human-readable summary report
* Support diagnostic package sharing with trusted stakeholders

= What The Report Can Help You See =

* Whether a recent plugin or theme change may be related to an issue
* Whether errors appeared between one snapshot and another
* Whether scheduled tasks are overdue or failing
* Whether the environment or stack changed before a regression
* Whether a support case can be escalated with better technical context

= Privacy And Sharing =

Everything runs locally. No data leaves your site by default.

The generated package is intended for trusted troubleshooting workflows. Always review the contents before sharing them, because environment details and logs may include sensitive paths, domains, email addresses, or data exposed by other plugins or hosting tools.

== Installation ==

1. Upload the `beplus-support-snapshot` folder to the `/wp-content/plugins/` directory, or install the plugin through the WordPress Plugins screen.
2. Activate the plugin through the `Plugins` screen in WordPress.
3. Go to `Tools > Support Snapshot`.
4. Open the Generate tab and create your first snapshot.
5. Download the generated `support-report.zip` package when you need to review or share the report.
6. Use the History and Compare views to investigate changes over time.

== Frequently Asked Questions ==

= What is a support snapshot? =

A support snapshot is a point-in-time diagnostic record of your WordPress site. It captures useful support and troubleshooting information so you can review the site later or compare it with another snapshot.

= What information is included in a snapshot? =

A snapshot can include site health information, environment details, plugin inventory, theme inventory, recent update signals, active error context, cron-related signals, and summary data for troubleshooting.

= What is included in support-report.zip? =

The ZIP package contains structured diagnostic files and a human-readable summary to help agencies, developers, or support teams review the site state without needing to inspect everything manually in wp-admin first.

= Does the plugin send data externally? =

No. BePlus Support Snapshot is designed to generate reports locally on your WordPress site. It does not send snapshot data to a remote service by default.

= Are reports stored locally? =

Yes. Snapshots and generated reports are stored locally on the site unless you choose to download and share them.

= Does the plugin modify website data? =

The plugin is intended for diagnostics and reporting. It generates snapshot records and report files, but it is not designed to modify your posts, pages, or normal site content as part of report generation.

= Can reports be compared? =

Yes. Snapshot comparison is a core feature. You can compare two snapshots to review changes and investigate whether those changes may be related to a support issue.

= Can snapshots help identify recent changes? =

Yes. This is one of the main reasons to use the plugin. Snapshot history and comparison help you understand what changed, when it changed, and what may be connected to the issue.

= Can it help troubleshoot plugin conflicts? =

Yes. Comparing snapshots, reviewing plugin inventory, and checking errors and recent updates can help narrow down whether a plugin conflict or compatibility issue may be involved.

= Does it support multisite? =

The plugin can be used in WordPress environments that run multisite, but data visibility and support workflows may vary depending on the network setup. If multisite reporting is critical for your workflow, test it in a staging environment first.

= Can reports be shared with clients? =

Yes, but only after review. The export package is suitable for trusted support workflows, but you should review the contents before sending it because logs and environment details may contain sensitive information.

= Are snapshots useful for agency workflows? =

Yes. Agencies can use snapshots to document baseline states, investigate regressions after changes, and send structured reports to clients, hosting providers, or plugin vendors.

= Is it safe to use on production websites? =

Yes, for normal support and diagnostic use. It is designed for real troubleshooting workflows, but you should still review the generated reports before sharing them outside your organization.

= What if the ZIP file cannot be generated? =

The plugin requires ZIP support on the server. If `ZipArchive` is unavailable, the plugin will show an admin notice so you can ask your host to enable the PHP ZIP extension.

= Why does the plugin report overdue cron jobs instead of confirmed failures? =

WordPress core does not maintain a universal, reliable failure history for all scheduled tasks. Overdue cron events are still a useful support signal because they often point to stuck or delayed automation.

= Who should use BePlus Support Snapshot? =

It is intended for WordPress agencies, support teams, freelance developers, and site maintainers who need clearer diagnostic context when troubleshooting issues.

== Screenshots ==

1. The snapshot generation screen in `Tools > Support Snapshot`, showing the main action to generate a new support snapshot.
2. The snapshot history screen, listing saved snapshots with dates, health indicators, and download actions.
3. The snapshot comparison view, showing two selected snapshots and the differences detected between them.
4. The summary report view, highlighting readable diagnostic findings and support-relevant context.
5. The support package export workflow, showing the generated `support-report.zip` file ready for download and sharing.

== Changelog ==

= 1.1.0 =
* Added maintenance checks for mail availability, cURL availability, directory browsing protection signals, and WordPress cron configuration.
* Added a snapshot note field on the Generate tab so notes can be saved at creation time.
* Added a Settings tab with configurable snapshot retention.
* Updated automatic snapshot cleanup to use the saved retention setting instead of a fixed 30-day limit.
* Added maintenance check data to exported reports, summaries, and snapshot comparisons.

= 1.0.0 =
* Initial public release.
* Added support snapshot generation.
* Added exportable `support-report.zip` package.
* Added snapshot history tracking.
* Added snapshot comparison tools.
* Added Site Health and environment reporting.
* Added plugin and theme inventory reporting.
* Added recent update tracking.
* Added active error detection.
* Added failed cron job detection.
* Added human-readable summary reporting.

== Upgrade Notice ==

= 1.1.0 =
Adds maintenance checks, note-at-generation, and configurable retention settings for stored snapshots.

= 1.0.0 =
Initial release. Create an early baseline snapshot so future comparisons are more useful during troubleshooting.
