=== Cloud S3 Storage ===
Contributors: matteoenna,vhosting
Tags: media storage, S3, object storage, cloud storage, media management
License URI: http://www.gnu.org/licenses/gpl.html
Requires at least: 5.0
Requires PHP: 7.2.5
Tested up to: 6.9
Stable tag: 1.4.6
License: GPLv2 or later

Manage your WordPress media files with ease using S3-compatible object storage services.

== Description ==

The **Cloud S3 Storage** plugin enables seamless integration of your WordPress media library with S3-compatible cloud storage solutions. Free up server space, improve scalability, and optimize your site's performance by offloading media files to the cloud.

This plugin uses the AWS SDK for PHP, which is bundled with the plugin, to interact with S3-compatible storage services, such as AWS S3, Wasabi, or DigitalOcean Spaces.

### Key Features

- **S3-Compatible Integration:** Works with any S3-compatible object storage service, such as AWS S3, Wasabi, or DigitalOcean Spaces.
- **Media Library Sync:** Automatically sync your WordPress media files to the configured S3 storage bucket.
- **Custom Cron Jobs:** Schedule automated tasks for reindexing and clearing media files from your S3 storage.
- **Hybrid Mode:** Optionally keep files stored locally and on the cloud for redundancy.
- **Customizable Settings:** Easily configure bucket details, upload preferences, and cron job timings from the admin interface.
- **Efficient File Management:** Automatically delete unused or orphaned media files from your storage.
- **Fallback Mechanism:** Ensures smooth functioning even during connectivity issues with the S3 service.

== Installation ==

1. Upload the **Cloud S3 Storage** plugin to your WordPress site.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to **Settings > Cloud S3 Storage** to configure your storage settings.
4. The AWS SDK for PHP is bundled with this plugin, so there is no need for separate installation or configuration of the SDK. 

== Usage ==

1. Enter your S3-compatible service credentials, bucket name, and region.
2. Set the cron job timing to automate syncing and cleanup tasks.
3. Use the media library as usual—uploads will automatically sync with S3 storage.
4. Monitor synced files and manage unused media from the plugin dashboard.

== FAQs ==

### **Q: Which S3-compatible services does this plugin support?**
A: Any service that supports the S3 API, including AWS S3, Wasabi, DigitalOcean Spaces, and others.

### **Q: Do I need to install the AWS SDK separately?**
A: No, the AWS SDK for PHP is already bundled with this plugin. You don't need to install it separately.

### **Q: Can I revert my media library back to local storage?**
A: Yes, you can disable the plugin and move the media files back to your server if needed.

### **Q: Does this plugin support large media files?**
A: Yes, the plugin handles chunked uploads for larger files to ensure compatibility with cloud storage.

== Changelog ==

### 1.0
- Initial release:
  - Basic S3 integration for WordPress media library.
  - Support for automated sync and cleanup tasks via cron jobs.
  - Hybrid mode for local and cloud storage redundancy.

Simplify your WordPress media management and harness the power of cloud storage today with **Cloud S3 Storage**!
