Spun Web Archive Pro, End User Documentation

Overview

Spun Web Archive Pro submits your WordPress URLs to the Internet Archive (Wayback Machine). It can auto submit new posts when you publish, and it can bulk submit your back catalog. It tracks status, retries failures, and shows logs and history in wp-admin.

Highlights

  • Automatic submission on publish, optional delay
  • Bulk submission with progress tracking
  • Direct Archive.org S3 API integration
  • Submission history, statuses, and logs in admin
  • Status in the post editor and in Posts or Pages list
  • Works with posts, pages, and custom post types
  • Background processing with WordPress cron
  • CSV export for reports and audits
  • Hooks and filters for developers

Requirements

  • WordPress 5.0 or higher
  • PHP 8.1 or higher (compatible with PHP 8.2)
  • MySQL 5.6 or higher
  • Archive.org account with S3 API keys
  • cURL enabled on the server

Tested up to WordPress 6.7.1.

Install

  1. Download the plugin.
  2. Upload the folder to /wp-content/plugins/.
  3. Activate in Plugins.
  4. Open Tools → Spun Web Archive Pro to configure.

Connect Archive.org

  1. Create or sign in to your Archive.org account.
  2. Generate S3 API keys in your Archive.org account.
  3. In WordPress, go to Tools → Spun Web Archive Pro → API Settings.
  4. Paste Key and Secret, then click Test Connection.

Tip: keep keys private and restrict settings access to admins.

Configure behavior

Automatic submission

  • Enable Auto Submission: on or off
  • Submission Delay: minutes to wait after publish
  • Post Types: which content to auto submit
  • Retry Settings: attempts and delay between attempts

The plugin queues, submits, and retries in the background.

Bulk submission

  • Batch Size: how many posts per cycle
  • Processing Delay: pause between batches to respect rate limits
  • Post Status Filter: pick which statuses to include

You get a progress bar and live updates.

Background jobs

Processing runs with WordPress cron. Keep it enabled on your host.

Daily use

Auto mode, set and forget

  1. Publish as usual.
  2. The plugin queues the URL.
  3. It submits after your chosen delay.
  4. It retries on failure.
  5. See status in the Posts or Pages list and inside the editor.

Bulk mode, back catalog

  1. Go to Tools → Spun Web Archive Pro → Bulk Submission.
  2. Choose a post type and click Load Posts.
  3. Select items, or Select All.
  4. Click Submit Selected to Archive.
  5. Watch progress, then export results to CSV if needed.

Monitoring and history

  • Posts list column: quick status glance
  • Editor meta box: last result and history
  • Submission History tab: records with timestamps, URLs, and archive links
  • Color states: Success, Failed, Pending

What you will see in admin

  • A tabbed dashboard under Tools → Spun Web Archive Pro
  • API settings, auto settings, bulk tools, submission history
  • Progress bars and real-time logs while bulk runs
  • Counts of total, successful, failed, and pending submissions

Data and storage

  • Creates one table: wp_swap_submissions to track attempts and states.
  • Uninstall can remove all plugin data (tables, options, post meta, user meta, cached data), with validation and permission checks.

Security notes

Nonces, AJAX handling, and permission checks have been improved. Keep WordPress, PHP, and the plugin current. Limit settings access to trusted admins.

Developer hooks

Actions

  • swap_before_submission
  • swap_after_submission
  • swap_submission_success
  • swap_submission_failed

Filters

  • swap_submission_url
  • swap_submission_data
  • swap_retry_attempts
  • swap_batch_size

Troubleshooting

API connection failed

Check Archive.org Key and Secret. Confirm cURL and outbound HTTPS are allowed by the host.

Nothing is processing

Confirm WordPress cron is running. Re-save plugin settings. Check the plugin’s logs and the Submission History tab.

Bulk feels slow

Lower batch size. Increase delay between batches. Verify server resources.

Detailed errors

Add to wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

Version info

Current version: 0.2.2

  • Adds full uninstall cleanup and improved PHP 8.2 compatibility while keeping 8.1 support.
  • Fixes duplicate AJAX function, improves error handling and code organization.

Planned: more integrations, reporting, scheduling improvements, advanced filtering.

License and credits

Quick checklist

  • Plugin installed and activated
  • Archive.org S3 keys saved and connection test passed
  • Auto submission configured, or bulk plan ready
  • WP cron enabled on your host
  • Status column visible in Posts or Pages
  • Optional: CSV export verified after a bulk run

Appendix A: README.md (verbatim)

Show / Hide README.md 
# Spun Web Archive Pro (README excerpt appears here if collapsed is opened)

Appendix B: CHANGELOG.md (verbatim)

Show / Hide CHANGELOG.md 
# CHANGELOG (excerpt appears here if collapsed is opened)