| 1 |
=== Media Cloud Sync === |
| 2 |
Author: Dudlewebs |
| 3 |
Author URI: https://dudlewebs.com |
| 4 |
Contributors: dudlewebs |
| 5 |
Donate link: https://dudlewebs.com/donate |
| 6 |
Tags: sync, cloud, offload, media, aws |
| 7 |
License: GPLv2 or later |
| 8 |
Requires PHP: 8.1 |
| 9 |
Requires at least: 5.9 |
| 10 |
Tested up to: 7.0 |
| 11 |
Stable tag: 1.3.11 |
| 12 |
|
| 13 |
Offload media to cloud storage (S3, DigitalOcean, Google Cloud, Cloudflare R2, S3 compatible Services) and rewrite URLs for seamless file delivery. |
| 14 |
|
| 15 |
== Description == |
| 16 |
Media Cloud Sync is an innovative plugin for WordPress that dramatically transforms how you interact with media and increases your website's performance. This plugin allows you to transfer your files, media, and images from a WordPress server to online cloud storage, such as Amazon S3, DigitalOcean Spaces, Google Cloud Storage, Cloudflare R2 and S3 Compatible Services. It also rewrites URLs to serve files from the same storage provider or another CDN provider. |
| 17 |
|
| 18 |
You can sync both new media files as well as existing media from your WordPress Media Library to your configured cloud storage, making it easy to sync older medias to cloud storage. |
| 19 |
|
| 20 |
== Installation == |
| 21 |
Installation of "Media Cloud Sync" can be done either by searching for "Media Cloud Sync" via the "Plugins > Add New" screen in your WordPress dashboard or by using the following steps: |
| 22 |
|
| 23 |
1. Download the plugin via WordPress.org. |
| 24 |
2. Upload the ZIP file through the ‘Plugins > Add New > Upload’ screen in your WordPress dashboard. |
| 25 |
3. Activate the plugin through the ‘Plugins’ menu in WordPress. |
| 26 |
|
| 27 |
== How to Manage Settings == |
| 28 |
To manage settings in the Media Cloud Sync plugin, follow these steps: |
| 29 |
|
| 30 |
1. **Access the Plugin Menu**: |
| 31 |
- In your WordPress admin dashboard, look for the **Media Cloud Sync** menu item in the left menu bar. This menu provides access to all the settings and features of the plugin. |
| 32 |
|
| 33 |
2. **Manage Settings**: |
| 34 |
- Click on the **Media Cloud Sync** menu to enter the settings area. |
| 35 |
- You will see two main sections: **Configure** and **Settings**. |
| 36 |
|
| 37 |
**a. Configure**: |
| 38 |
- In this section, you can set up the basic configurations for the plugin, including connecting your cloud storage account (e.g., Amazon S3, Google Cloud Storage, DigitalOcean Spaces, Cloudflare R2, S3 Compatible Services) and defining the default options for media offloading. |
| 39 |
- Follow the prompts to authenticate your cloud account and grant the necessary permissions. |
| 40 |
|
| 41 |
**b. Settings**: |
| 42 |
- The **Settings** section allows for more advanced customization options. Here, you can adjust how media files are uploaded and served from the cloud. |
| 43 |
- Make sure to save your changes after adjusting the settings to ensure they take effect. |
| 44 |
|
| 45 |
3. **Review and Test**: |
| 46 |
- After configuring the settings, it’s advisable to test the plugin to ensure that your media files are being uploaded and served correctly from the cloud storage. |
| 47 |
- Upload a new media file and check if it appears in your cloud storage as expected. |
| 48 |
|
| 49 |
== Basic Features == |
| 50 |
The Media Cloud Sync plugin significantly enhances your website's speed by offloading media to cloud servers. This approach allows your site to load more efficiently, as it reduces the number of server requests, ultimately resulting in faster page load times. Once media files—such as images, videos, PDFs, and ZIP files—are uploaded to the cloud, your server no longer needs to handle these files, freeing up resources. |
| 51 |
|
| 52 |
Here are the key features of the Media Cloud Sync plugin: |
| 53 |
|
| 54 |
🔹 Seamlessly sync your media to popular cloud storage solutions like Amazon S3, Google Cloud Storage, DigitalOcean Spaces, Cloudflare R2, or S3 Compatible Services. |
| 55 |
🔹 **Sync existing media** from your WordPress Media Library to the cloud with a simple migration tool. |
| 56 |
🔹 Automatically delete files from the server after they are uploaded to the cloud, optimizing storage use. |
| 57 |
🔹 Customize the base path for server storage to suit your organizational needs. |
| 58 |
🔹 Tailor the URL structure for your media files to enhance your site's SEO and user experience. |
| 59 |
🔹 Enable object versioning to prevent invalidations of your media files. |
| 60 |
🔹 Utilize a custom CDN for serving your media URLs, improving loading speeds and reliability. |
| 61 |
🔹 Generate pre-signed URLs for secure access to your media files. |
| 62 |
🔹 Enjoy built-in support for WooCommerce, ensuring smooth integration with your online store. |
| 63 |
🔹 Leverage compatibility with Advanced Custom Fields for enhanced flexibility. |
| 64 |
🔹 Benefit from RTL (Right to Left) support for multilingual websites. |
| 65 |
🔹 Access WPML string translation support for seamless multilingual content management. |
| 66 |
🔹 Enjoy seamless compatibility across multisite networks for centralized management and consistent performance. |
| 67 |
|
| 68 |
== Other Useful Links == |
| 69 |
🔹 [Official website](https://dudlewebs.com) |
| 70 |
🔹 [Documentation](https://dudlewebs.com/support) |
| 71 |
🔹 [Pro version coming soon](https://dudlewebs.com) |
| 72 |
🔹 [Donate Now!! Get PRO version license discounts](https://dudlewebs.com/donate) |
| 73 |
|
| 74 |
== Screenshots == |
| 75 |
1. Plugin dashboard page, showcasing the main options for configuring the Media Cloud Sync settings. |
| 76 |
2. Configure wizard welcome screen. |
| 77 |
3. Choosing the appropriate service (e.g., Amazon S3, Google Cloud Storage, DigitalOcean Spaces, Cloudflare R2, and S3 Compatible Services) to use. |
| 78 |
4. Configuration settings according to the chosen service. |
| 79 |
5. Choose your bucket to store the media; if the bucket is not created, create one. |
| 80 |
6. Validating the bucket and permissions. |
| 81 |
7. Enable additional security configurations. |
| 82 |
8. Configuration verified successfully; save the settings. |
| 83 |
9. Choose the appropriate media provider (CDN or native service URL). |
| 84 |
10. Main settings page. |
| 85 |
11. Plugin dashboard page after configuring the service. |
| 86 |
12. Media properties after uploading the media. |
| 87 |
|
| 88 |
== Frequently Asked Questions == |
| 89 |
|
| 90 |
= How do I install the plugin? = |
| 91 |
You can install the plugin from the WordPress plugin store or upload it manually. |
| 92 |
|
| 93 |
= Is there a limit on the number of files I can sync? = |
| 94 |
No, you can sync as many files as you need. Both newly uploaded media and existing media in your library can be synced. |
| 95 |
|
| 96 |
= How do I sync my media files to the cloud? = |
| 97 |
After activating the plugin, go to the configure page and follow the prompts to connect your cloud account. Then, navigate to settings and configure them according to your needs. Upload a media file in the Media Library, and you will see that the URL has been replaced by the cloud server URL. |
| 98 |
If you already have media files in your library, use the **Sync Media To Cloud** option to migrate them to the cloud. |
| 99 |
|
| 100 |
= What is Existing Media Sync? = |
| 101 |
Existing Media Sync is a feature that lets you migrate files that were uploaded to your WordPress Media Library before installing or configuring the plugin. |
| 102 |
Instead of manually re-uploading older files, you can run the Sync Media To Cloud tool from the plugin dashboard, and it will automatically upload them to your connected cloud storage. |
| 103 |
|
| 104 |
= What cloud providers are supported? = |
| 105 |
Currently, the plugin supports major cloud providers such as AWS S3, Google Cloud Storage, DigitalOcean Spaces, Cloudflare R2 and All S3 Compatible Services. |
| 106 |
|
| 107 |
= Is WPML supported? = |
| 108 |
Yes, the Media Cloud Sync plugin is fully compatible with WPML. |
| 109 |
|
| 110 |
= Is Multisite supported? = |
| 111 |
Yes, the Media Cloud Sync plugin is compatible with Multisite and it will works as an individual plugin for all the sites under multisite. |
| 112 |
|
| 113 |
= Can I use S3-compatible services? = |
| 114 |
Yes, the Media Cloud Sync plugin supports S3-compatible services. You simply need to provide the correct configuration details. Should you encounter any issues, please contact us via our official website. We will investigate the matter and provide an appropriate resolution. |
| 115 |
|
| 116 |
== External Services == |
| 117 |
This plugin integrates with third-party services to enhance its functionality. Below is an overview of the external services utilized, the data transmitted, and relevant legal documentation for your reference. |
| 118 |
|
| 119 |
* **Google Cloud Storage** |
| 120 |
- **Description**: Connects to manage media files, allowing upload, download, and delete operations. |
| 121 |
- **Data Sent**: User authentication data, file metadata (name, size, MIME type), user location data (if explicitly provided). |
| 122 |
- **Legal Links**: [Terms of Service](https://policies.google.com/terms), [Privacy Policy](https://policies.google.com/privacy) |
| 123 |
|
| 124 |
* **Amazon S3** |
| 125 |
- **Description**: Facilitates media file management, enabling seamless upload, download, and delete actions. |
| 126 |
- **Data Sent**: User authentication data, file metadata (name, size, MIME type). |
| 127 |
- **Legal Links**: [Terms of Service](https://aws.amazon.com/service-terms/), [Privacy Policy](https://aws.amazon.com/privacy/) |
| 128 |
|
| 129 |
* **DigitalOcean Spaces** |
| 130 |
- **Description**: Manages media files efficiently, allowing file storage, retrieval, and deletion. |
| 131 |
- **Data Sent**: User authentication data, file metadata (name, size, MIME type). |
| 132 |
- **Legal Links**: [Terms of Service](https://www.digitalocean.com/legal/terms-of-service/), [Privacy Policy](https://www.digitalocean.com/legal/privacy-policy/) |
| 133 |
|
| 134 |
* **Cloudflare R2** |
| 135 |
- **Description**: Provides efficient, low-cost object storage with S3-compatible APIs, enabling seamless upload, retrieval, and deletion of media files. |
| 136 |
- **Data Sent**: User authentication data, file metadata (name, size, MIME type). |
| 137 |
- **Legal Links**: [Terms of Service](https://www.cloudflare.com/terms/), [Privacy Policy](https://www.cloudflare.com/privacypolicy/) |
| 138 |
|
| 139 |
* **S3 Compatible Services** |
| 140 |
- **Description**: Manages media files efficiently, allowing file storage, retrieval, and deletion. |
| 141 |
- **Data Sent**: User authentication data, file metadata (name, size, MIME type). |
| 142 |
|
| 143 |
== Changelog == |
| 144 |
= 1.3.11 = |
| 145 |
* Feature: wp-config.php credentials support (WPMCS_CONFIG). |
| 146 |
* Feature: Connection status checks for storage and CDN. |
| 147 |
* Bug Fix: Redis Object Cache and object cache compatibility. |
| 148 |
* Bug Fix: Settings page and wp-config credential handling. |
| 149 |
* Compatibility: WordPress 5.9+ and PHP 8.1+. |
| 150 |
= 1.3.10 = |
| 151 |
* Bug Fix: Version not supported issue on google SDK. |
| 152 |
* Tweek: PHP compatibility restriction updated. |
| 153 |
* Optimization: Lazy Loaded SDK. |
| 154 |
* Compatibility: WordPress Version 7.0 |
| 155 |
= 1.3.9 = |
| 156 |
* Compatibility: Updated AWS SDK. |
| 157 |
* Compatibility: Updated Google Cloud SDK. |
| 158 |
* Compatibility: Pro Version Licensing support. |
| 159 |
= 1.3.8 = |
| 160 |
* Bug Fix: Critical error when file type not supported. |
| 161 |
* Bug Fix: Removed file type check from media library. |
| 162 |
* Tweek: New filters to skip image size upload and skip a specific sizes |
| 163 |
= 1.3.7 = |
| 164 |
* Bug Fix: WooCommerce updation of thumbnail size not updating in frontend from customizer. |
| 165 |
* Bug Fix: Source set Generate function has original even if there is no original file in source set. |
| 166 |
= 1.3.6 = |
| 167 |
* Compatibility: Imagify compatbility added. |
| 168 |
* Bug Fix: Updated background runner. |
| 169 |
* Bug Fix: Optimized database structure. |
| 170 |
* Bug Fix: Optimized code base. |
| 171 |
* Bug Fix: Added database fetching optimization. |
| 172 |
* Bug Fix: Too many file open issue fixed. |
| 173 |
= 1.3.5 = |
| 174 |
* Feature: New service Cloudflare R2 |
| 175 |
* Bug Fix: Background Runner Error warning fixed. |
| 176 |
* Bug Fix: Removed Unwanted files from plugin |
| 177 |
* Bug Fix: Removed warning from content.php |
| 178 |
* Bug Fix: Limit Background Runner to maximum 20 media per CRON run |
| 179 |
* Tweek: New filter for get media |
| 180 |
* Compatibility: WordPress Version 6.9 |
| 181 |
= 1.3.4 = |
| 182 |
* Bug Fix: Caching plugins compatbility fixed. |
| 183 |
* Bug Fix: Minor Bug Fixes |
| 184 |
* Tweek: PRO version compatibility classes |
| 185 |
* Tweek: Updated Logos and Banners |
| 186 |
= 1.3.3 = |
| 187 |
* Bug Fix: Sync Media To Cloud Page not working |
| 188 |
= 1.3.2 = |
| 189 |
* Bug Fix: Log file exist check added to avoid warning |
| 190 |
* Bug Fix: Sync disabled when CRON is disabled |
| 191 |
* Bug Fix: Edited Image files are now removed from server |
| 192 |
* Bug Fix: Fixed Customizer fatal error |
| 193 |
* Bug Fix: Background runner in consistency fixed |
| 194 |
* Bug Fix: UI Breakage issues resolved |
| 195 |
* Bug Fix: Fixed previous sttus checked date clearing issue |
| 196 |
= 1.3.1 = |
| 197 |
* Bug Fix: Plugin specific folder is not creating and avoid adding htaccess in uploads folder |
| 198 |
= 1.3.0 = |
| 199 |
* Feature: Existing Media Sync is added |
| 200 |
* Feature: UI is updated for better UX |
| 201 |
* Bug Fix: S3 Compatible Console link Updated |
| 202 |
* Bug Fix: Customizer is breaking while plugin is active |
| 203 |
= 1.2.13 = |
| 204 |
* Bug Fix: Fixed Delete Error |
| 205 |
* Bug Fix: Fixed S3 Compatible, Issue when no region is mentioned |
| 206 |
* Bug Fix: S3 SDK Update |
| 207 |
* Tweek: Code Structure Updated |
| 208 |
* Tweek: Removed use of hook wp_generate_attachment_metadata |
| 209 |
* Tweek: Avoided creating plugin additional folder. Since it is not required for newer versions |
| 210 |
* Compatibility: Force Regenerate Thumbnails Added |
| 211 |
= 1.2.12 = |
| 212 |
* Tweek: Plugin Structure Updation |
| 213 |
* Compatibility: ACF Added |
| 214 |
* Compatibility: Regenerate Thumbnails Added |
| 215 |
= 1.2.11 = |
| 216 |
* Tweek: Google Cloud Config file saved as file before, and Currently avoided to used db itself |
| 217 |
* Bug Fix: Minor UI bugs fixed |
| 218 |
= 1.2.10 = |
| 219 |
* Bug Fix: image URL replacement |
| 220 |
= 1.2.9 = |
| 221 |
* Bug Fix: Removed validation of CDN url |
| 222 |
= 1.2.8 = |
| 223 |
* Bug Fix: DigitalOcean configuration stuck on permission screen |
| 224 |
= 1.2.7 = |
| 225 |
* Bug Fix: Major Security Update. |
| 226 |
* Bug Fix: Create bucket disabled in S3 Compatible service. |
| 227 |
= 1.2.6 = |
| 228 |
* Bug Fix: Label updation for S3 compatible services. |
| 229 |
* Bug Fix: Verification issue fix for S3 compatible devices. |
| 230 |
= 1.2.5 = |
| 231 |
* Feature: New status check interface for read permissions |
| 232 |
* Bug Fix: Configuration screen got stuck while no permissions |
| 233 |
* Bug Fix: Google Cloud Bucket permission issue |
| 234 |
* Bug Fix: Change security settings api fix |
| 235 |
= 1.2.4 = |
| 236 |
* Compatibility: Multisite Compatibility Added |
| 237 |
* Bug Fix: Minor Bug Fixes on new UI |
| 238 |
= 1.2.3 = |
| 239 |
* Bug Fix: Minor Bug Fixes on new UI |
| 240 |
= 1.2.2 = |
| 241 |
* Bug Fix: Minor Bug Fixes on new UI |
| 242 |
* Bug Fix: Existing issues fixing |
| 243 |
* Bug Fix: global variable update |
| 244 |
= 1.2.1 = |
| 245 |
* Bug Fix: Error on creating digitalocean bucket |
| 246 |
= 1.2.0 = |
| 247 |
* Feature: Updated UI |
| 248 |
* Feature: Compatibility for S3 compatible services |
| 249 |
* Bug Fix: Bug fixes (Minor, Major) |
| 250 |
= 1.1.1 = |
| 251 |
* Compatibility: WordPress Version 6.8 |
| 252 |
= 1.1.0 = |
| 253 |
* Feature: New Dashboard UI/UX |
| 254 |
* Bug Fix: Minor bug fixes |
| 255 |
= 1.0.3 = |
| 256 |
* Tweeks: Digital ocean configuration issue |
| 257 |
= 1.0.2 = |
| 258 |
* Tweeks: Digital ocean configuration issue |
| 259 |
= 1.0.1 = |
| 260 |
* Compatibility: WordPress Version 6.7 |
| 261 |
* Tweeks: Feedback form added. |
| 262 |
* Donation Link Added |
| 263 |
= 1.0.0 = |
| 264 |
* Initial release. |
