Plugin Directory

Changeset 3403649


Ignore:
Timestamp:
11/26/2025 08:45:03 PM (4 months ago)
Author:
imgpro
Message:

Update readme and screenshots

Location:
bandwidth-saver
Files:
4 edited

Legend:

Unmodified
Added
Removed
  • bandwidth-saver/trunk/readme.txt

    r3403645 r3403649  
    99License URI: http://www.gnu.org/licenses/gpl-2.0.html
    1010
    11 Faster images without touching DNS. No Cloudflare account needed in managed mode. Install, activate, done.
     11Faster images without touching DNS. No Cloudflare account needed in Managed mode. Install, activate, done.
    1212
    1313== Description ==
    1414
    15 WordPress images often load slowly, especially on shared hosting. Large sites with thousands of images can grind to a halt without a CDN. But setting up Cloudflare usually means editing DNS records, configuring caching rules, and navigating technical steps that many site owners prefer to avoid.
    16 
    17 **Bandwidth Saver** solves this by delivering your existing WordPress images through Cloudflare's global edge network. No DNS changes. No Cloudflare account needed in managed mode. No configuration. Just activate and go.
    18 
    19 Safe to try on any site. Does not touch your database or existing files. You can disable it at any time and your site instantly returns to normal. If Cloudflare ever has an issue, WordPress automatically loads your original images.
     15WordPress images often load slowly, especially on shared hosting. Large sites with thousands of images can feel sluggish without a CDN. But setting up Cloudflare normally requires changing DNS, configuring caching rules, and navigating technical steps that many site owners avoid.
     16
     17**Bandwidth Saver** delivers your existing WordPress images through Cloudflare's global edge network without requiring DNS changes or a Cloudflare account in Managed mode. There is nothing to configure. Just activate the plugin and your images begin loading from Cloudflare.
     18
     19Safe to try on any site. The plugin does not modify your Media Library, files, or database. If you disable it, your site immediately returns to normal. If Cloudflare ever has an issue, WordPress automatically loads your original images.
    2020
    2121= How It Works =
    2222
    23 1. You upload images to WordPress as usual
    24 2. The plugin rewrites image URLs on your frontend pages
    25 3. When a visitor requests an image, a Cloudflare Worker fetches it from your site and stores it in R2
    26 4. Future requests serve the cached image from Cloudflare's edge
    27 
    28 **Your original images stay on your server.** WordPress keeps full control. The plugin only changes how images are delivered to visitors.
     231. You upload images to WordPress normally 
     242. The plugin rewrites image URLs on your frontend pages 
     253. When an image is requested for the first time, a Cloudflare Worker fetches it from your server and stores it in R2 
     264. Future requests serve the cached copy from Cloudflare's edge
     27
     28Your original images stay on your server. WordPress remains the system of record. The plugin only changes how images are delivered to visitors.
    2929
    3030Image URLs are rewritten on the frontend only. Your Media Library URLs stay exactly the same.
    3131
    32 The first request to each image comes from your server while Cloudflare caches it. Future requests are delivered from Cloudflare's edge.
     32The first request to each image comes from your server while Cloudflare caches it. After that, visitors receive the image from the nearest Cloudflare edge location.
    3333
    3434= What This Plugin Does =
    3535
    36 * Rewrites image URLs on your frontend pages (your Media Library URLs stay exactly the same)
     36* Rewrites image URLs on your frontend pages (Media Library URLs stay unchanged)
    3737* Delivers cached images from Cloudflare's global edge network
    3838* Falls back to your original images automatically if Cloudflare is unavailable
    3939* Works with lazy loading, responsive image sizes, and srcset
    40 * Works with virtually all themes and page builders without modifying templates or file structures
    41 * Designed to handle large, image-heavy websites with ease
    42 
    43 The plugin simply delivers whatever WordPress outputs, including images processed by optimization plugins.
     40* Compatible with virtually all themes and page builders
     41* Designed to handle large, image-heavy websites reliably
     42
     43The plugin delivers whatever WordPress outputs, including images processed by optimization plugins.
    4444
    4545= What This Plugin Does NOT Do =
     
    5050* Does not cache HTML, CSS, or JavaScript
    5151* Does not require DNS changes or Cloudflare proxy
    52 * Does not touch your database
     52* Does not modify your database
    5353
    5454Only images are delivered through Cloudflare. Videos, PDFs, and other non-image files are not cached or rewritten.
    5555
    56 Keep using your favorite image optimization plugin. Bandwidth Saver handles the delivery layer only.
    57 
    5856= Who This Is For =
    5957
    60 This plugin is for WordPress users who want faster image delivery without DNS changes, regardless of site size.
    61 
    62 It works great for:
    63 
    64 * Blogs and content sites
    65 * Recipe sites
    66 * Photography and portfolio sites
    67 * WooCommerce stores with thousands of product images
    68 * Online magazines
    69 * Travel and lifestyle sites
    70 * Large content libraries
    71 * Sites with heavy visitor traffic
    72 
    73 It is also a good fit if you:
    74 
    75 * Cannot or do not want to move your DNS to Cloudflare
    76 * Want faster image loading without configuring caching rules
    77 * Want Cloudflare-level speed without the Cloudflare learning curve
     58Bandwidth Saver is for WordPress users who want faster image delivery without DNS changes, regardless of site size.
     59
     60Great for:
     61
     62* Blogs and content sites 
     63* Recipe sites 
     64* Photography and portfolio sites 
     65* WooCommerce stores with many product images 
     66* Online magazines 
     67* Travel and lifestyle sites 
     68* Large content libraries 
     69* High traffic environments
     70
     71It is a good fit if you:
     72
     73* Cannot or do not want to move your DNS to Cloudflare 
     74* Want Cloudflare-level speed without configuration 
     75* Want faster image delivery without touching hosting settings 
    7876
    7977= Who This Is NOT For =
    8078
    81 This plugin may not be right if you:
    82 
    83 * Already use Cloudflare DNS with caching rules (you may not need this)
    84 * Need to fully offload media files from your server
    85 * Need caching for HTML, CSS, or JavaScript
    86 * Want fine-grained control over Cloudflare features
     79This plugin may not be the right fit if you:
     80
     81* Already use Cloudflare DNS with proper caching rules 
     82* Need to fully offload media files to external storage 
     83* Need caching for HTML, CSS, or JavaScript 
     84* Want advanced or custom Cloudflare configurations 
    8785
    8886= Why Try It =
    8987
    90 * **Safe to try on any site.** Does not touch your database or existing files.
    91 * **No DNS changes required.** Works with any hosting setup.
    92 * **No Cloudflare account needed for Managed mode.**
    93 * **Nothing to configure.** Install, activate, done.
    94 * **Safe to disable.** Your site instantly returns to normal.
    95 * **Works with virtually all themes and page builders.** Does not modify templates or file structures.
    96 * **Works with image optimization plugins.** ShortPixel, Imagify, Smush, EWWW, and others.
    97 * **Supports all image formats.** JPG, PNG, GIF, WebP, AVIF, SVG.
    98 * **Handles large sites with ease.** Designed for everything from small blogs to high-traffic, image-rich websites.
     88* Safe to try on any site 
     89* No DNS changes required 
     90* No Cloudflare account needed in Managed mode 
     91* Nothing to configure 
     92* Disable and your site returns to normal instantly 
     93* Works with virtually all themes and page builders 
     94* Compatible with image optimization plugins 
     95* Supports JPG, PNG, GIF, WebP, AVIF, and SVG 
     96* Handles large websites and high traffic effortlessly 
    9997
    10098= Two Ways to Use =
    10199
    102 **Managed (Recommended for most users)**
    103 One click setup. We handle the Cloudflare Worker and R2 storage. No Cloudflare account needed for Managed mode. In Managed mode, images are cached and delivered through Cloudflare infrastructure operated by ImgPro.
    104 
    105 The Managed plan costs $9.99 per month and includes up to 500 GB of cached image storage and up to 5 TB of monthly bandwidth as soft limits. Storage refers to the total weight of images cached in R2. It does not include HTML, CSS, JavaScript, PDFs, videos, or other asset types. Storage is cumulative, not monthly traffic. This comfortably supports everything from small blogs to large, image-heavy WordPress installations.
    106 
    107 **Self-Hosted (Free)**
    108 For technical users who prefer running Cloudflare on their own account. You control the infrastructure and pay Cloudflare directly (usually $0/month on their free tier).
     100**Managed (Recommended for most users)** 
     101One click setup. We operate the Cloudflare Worker and R2 storage. No Cloudflare account required for Managed mode. Images are cached and delivered through Cloudflare infrastructure operated by ImgPro.
     102
     103The Managed plan costs $9.99 per month and includes up to 500 GB of cached image storage and 5 TB of monthly bandwidth as soft limits. Storage refers only to the total weight of cached images in R2. It does not include HTML, CSS, JavaScript, PDFs, videos, or other file types. Storage is cumulative, not monthly traffic.
     104
     105This comfortably supports everything from small blogs to large, image-heavy WordPress installations.
     106
     107**Self-Hosted (Free)** 
     108For technical users who prefer running Cloudflare on their own account. You control all infrastructure and pay Cloudflare directly (often $0 per month on the free tier).
    109109
    110110Requires: Cloudflare account, R2 bucket, Worker deployment, custom domain setup.
     
    112112= Open Source =
    113113
    114 The Cloudflare Worker that powers this plugin is [fully open source](https://github.com/img-pro/bandwidth-saver-worker). Inspect the code, fork it, or contribute improvements.
     114The Cloudflare Worker is fully open source: 
     115https://github.com/img-pro/bandwidth-saver-worker
    115116
    116117== Installation ==
     
    118119= Managed Setup (Under 1 Minute) =
    119120
    120 1. Install and activate the plugin
    121 2. Go to **Settings > Bandwidth Saver**
    122 3. Click the **Managed** tab
    123 4. Click **Activate Now** and complete checkout
    124 5. Done. Images now load from Cloudflare.
    125 
    126 No Cloudflare account. No DNS changes. No configuration.
     1211. Install and activate the plugin 
     1222. Go to **Settings > Bandwidth Saver** 
     1233. Select **Managed** 
     1244. Click **Activate Now** and complete checkout 
     1255. Done. Images now load from Cloudflare 
     126
     127No DNS changes. No Cloudflare account. No configuration.
    127128
    128129= Self-Hosted Setup (About 20 Minutes) =
    129130
    130 For technical users who prefer running Cloudflare on their own account:
    131 
    132 1. Create a free [Cloudflare account](https://cloudflare.com) if you do not have one
    133 2. Deploy the worker from [our GitHub repository](https://github.com/img-pro/bandwidth-saver-worker)
    134 3. Create an R2 bucket and configure a custom domain
     1311. Create a free Cloudflare account 
     1322. Deploy the worker from GitHub 
     1333. Create an R2 bucket and configure a custom domain 
    1351344. Enter your CDN and Worker domains in **Settings > Bandwidth Saver > Self-Host**
    136135
    137 Detailed guide: [github.com/img-pro/bandwidth-saver-worker](https://github.com/img-pro/bandwidth-saver-worker#setup)
     136Full guide: 
     137https://github.com/img-pro/bandwidth-saver-worker#setup
    138138
    139139== Frequently Asked Questions ==
     
    141141= How long does setup take? =
    142142
    143 **Managed:** Under a minute. Install, activate, subscribe, done.
    144 
    145 **Self-Hosted:** About 20 minutes if you are familiar with Cloudflare.
     143Managed: Under a minute. 
     144Self-Hosted: About 20 minutes if familiar with Cloudflare.
    146145
    147146= How much does it cost? =
    148147
    149 **Managed:** $9.99 per month. Includes up to 500 GB of storage (images cached in R2, cumulative) and 5 TB of monthly bandwidth.
    150 
    151 **Self-Hosted:** Free. You pay Cloudflare directly, usually $0/month on their free tier.
     148Managed: $9.99 per month for up to 500 GB storage and 5 TB monthly bandwidth. 
     149Self-Hosted: Free. You pay Cloudflare directly.
    152150
    153151= How much faster will my images load? =
    154152
    155 Most sites see significantly faster image delivery after the first request is cached. Cloudflare serves images from the nearest edge location, often reducing image load times to just a few milliseconds. Actual performance varies depending on hosting environment and visitor location.
     153Most sites see significantly faster delivery after the first request is cached. Cloudflare serves images from the closest edge location, reducing load times to a few milliseconds. Actual performance varies by hosting and visitor location.
    156154
    157155= Will this break my site? =
    158156
    159 No. The plugin only rewrites image URLs on your frontend. Your original images stay on your server. If anything goes wrong, disable the plugin and your site instantly returns to normal.
     157No. Your original images stay on your server. The plugin only rewrites URLs on your frontend. If you disable the plugin, your site returns to normal instantly.
    160158
    161159= Do I need a Cloudflare account? =
    162160
    163 **For Managed:** No. We handle everything.
    164 
    165 **For Self-Hosted:** Yes, but the free tier is enough for most sites.
    166 
    167 = Do I need to change my DNS? =
    168 
    169 No. This plugin works without DNS changes. That is the main benefit for users who cannot or do not want to proxy their site through Cloudflare.
     161Managed: No. 
     162Self-Hosted: Yes.
     163
     164= Do I need to change DNS? =
     165
     166No. This plugin works without DNS changes. That is one of its main benefits.
    170167
    171168= Does this change my Media Library URLs? =
    172169
    173 No. Image URLs are rewritten on the frontend only. Your Media Library URLs stay exactly the same.
    174 
    175 = What about image optimization (compression, WebP)? =
    176 
    177 Bandwidth Saver delivers images. It does not optimize them. Keep using your favorite optimization plugin (ShortPixel, Imagify, Smush, etc.) to compress and convert images. Bandwidth Saver delivers whatever WordPress generates.
    178 
    179 = Does it support WebP and AVIF? =
    180 
    181 Yes. Whatever format WordPress serves, Bandwidth Saver delivers.
     170No. Media Library URLs stay the same. Only frontend output is rewritten.
     171
     172= Does this handle WebP and AVIF? =
     173
     174Yes. The plugin delivers whatever format WordPress generates.
    182175
    183176= Does it work with lazy loading and srcset? =
    184177
    185 Yes. Works with lazy loading, responsive image sizes, and srcset. The plugin simply delivers whatever WordPress outputs.
    186 
    187 = Are the first requests slower? =
    188 
    189 Yes. The first request for each image comes from your server while Cloudflare caches it. After that, all requests are served from the nearest Cloudflare edge and are much faster.
     178Yes. Fully compatible.
     179
     180= Are first requests slower? =
     181
     182Yes. The first request for each image comes from your server while Cloudflare caches it. After that, delivery is very fast.
    190183
    191184= What happens if Cloudflare is down? =
    192185
    193 Images fall back to your server automatically. Your site keeps working.
    194 
    195 = Can I use this on multisite? =
    196 
    197 Yes. Each site in your network needs its own configuration.
    198 
    199 = What happens when I deactivate the plugin? =
    200 
    201 Images load from your server again. No cleanup needed. Your original files are never modified. Cached copies stored on Cloudflare are automatically cleaned up over time.
    202 
    203 = Will this work with my theme or page builder? =
    204 
    205 Yes. Bandwidth Saver works at the URL level and is compatible with virtually any WordPress setup. It does not modify templates or file structures. Tested with Elementor, Beaver Builder, Divi, Bricks, Gutenberg, and more.
     186Your site falls back to your original images automatically.
     187
     188= What happens if I deactivate the plugin? =
     189
     190Everything returns to normal immediately. Cached copies in Cloudflare are cleaned up automatically over time.
    206191
    207192= Is this an offloading plugin? =
    208193
    209 No. Your images stay on your WordPress server. The plugin only rewrites URLs so visitors receive cached copies from Cloudflare.
    210 
    211 = Is this a full CDN replacement? =
    212 
    213 No. This plugin only handles images. It does not cache HTML, CSS, JavaScript, or other assets.
     194No. Images stay on your WordPress server.
     195
     196= Does this replace a full CDN? =
     197
     198No. It only handles images.
    214199
    215200= Can this handle large sites? =
    216201
    217 Yes. The Managed plan includes 500 GB of storage (images cached in R2, cumulative) and 5 TB of monthly bandwidth, which comfortably supports large WooCommerce stores, photography sites, and content-heavy properties. If your site grows beyond these limits, we recommend switching to the Self-Hosted option for full control.
     202Yes. Managed mode supports up to 500 GB cached image storage and 5 TB monthly bandwidth. Larger installations can use Self-Hosted mode for full control.
    218203
    219204== Screenshots ==
    220205
    221 1. **One-Click Setup** - Enable Cloudflare image delivery in one click
    222 2. **Clear Status** - Clear status indicators for Managed or Self-Hosted mode
    223 3. **Works Everywhere** - Works with virtually all themes and page builders, no configuration required
     2061. One click enablement 
     2072. Clear status indicators 
     2083. Works with virtually all themes and builders 
    224209
    225210== Privacy ==
     
    227212= What the plugin collects =
    228213
    229 The plugin itself does not add cookies, tracking scripts, or analytics to your site.
    230 
    231 = What Cloudflare logs =
    232 
    233 When images are delivered through Cloudflare, standard CDN request metadata is logged by Cloudflare (IP addresses, timestamps, request headers, etc.). This is standard for any CDN service.
    234 
    235 **For Managed users:** Images are cached on Cloudflare infrastructure managed by ImgPro. Your site URL and admin email are stored for account management. Review Cloudflare's [privacy policy](https://www.cloudflare.com/privacypolicy/).
    236 
    237 **For Self-Hosted users:** Images are stored in your own Cloudflare account. You have full control over your data and logs.
    238 
    239 = Recommendation =
    240 
    241 If you have strict privacy requirements, consider the Self-Hosted option for complete control, or review Cloudflare's data processing terms before using the Managed service.
     214The plugin does not add cookies, tracking, or analytics.
     215
     216= Cloudflare logs =
     217
     218Cloudflare logs standard CDN metadata (IP, timestamps, headers). This is normal for any CDN.
     219
     220For Managed mode, images are cached on Cloudflare infrastructure operated by ImgPro. Review Cloudflare’s privacy policy for details.
     221
     222Self-Hosted users store data in their own Cloudflare account.
    242223
    243224== External Services ==
    244225
    245 This plugin connects to external services to deliver images:
    246 
    247 = Cloudflare R2 and Workers =
    248 
    249 * **Purpose:** Stores and serves cached images from 300+ global edge locations
    250 * **Provider:** Cloudflare, Inc.
    251 * **When used:** Every time a visitor loads an image on your site
    252 * **Terms:** [cloudflare.com/terms](https://www.cloudflare.com/terms/)
    253 * **Privacy:** [cloudflare.com/privacypolicy](https://www.cloudflare.com/privacypolicy/)
    254 
    255 In Managed mode, images are cached and delivered through Cloudflare infrastructure operated by ImgPro.
    256 
    257 = ImgPro Cloud API (Managed mode only) =
    258 
    259 * **Purpose:** Subscription management and CDN configuration
    260 * **Provider:** ImgPro
    261 * **When used:** During checkout, subscription management, and account recovery
    262 * **Data sent:** Site URL, admin email
    263 * **Data stored:** Subscription status, API key
     226Cloudflare R2 and Workers: 
     227Purpose: Image storage and edge delivery 
     228Terms: https://www.cloudflare.com/terms/ 
     229Privacy: https://www.cloudflare.com/privacypolicy/
     230
     231ImgPro Cloud API (Managed mode): 
     232Purpose: Subscription and configuration 
     233Data: Site URL, admin email 
     234Stored: Subscription status, API key 
    264235
    265236== Fair Use Policy ==
    266237
    267 The Managed plan costs $9.99 per month and includes up to 500 GB of storage and up to 5 TB of monthly bandwidth as soft limits. Storage refers to the total weight of images cached in R2. It does not include HTML, CSS, JavaScript, PDFs, videos, or other asset types. Storage is cumulative, not monthly traffic. This comfortably supports everything from small blogs to large, image-heavy WordPress installations.
    268 
    269 **If your usage grows beyond these limits:**
    270 
    271 We will reach out to discuss your options. In most cases, we recommend switching to the Self-Hosted option, which gives you full control over your own Cloudflare account with no restrictions from us.
    272 
    273 **What may require self-hosting:**
    274 
    275 * Sites that exceed the soft limits consistently
    276 * Sites serving very large files repeatedly
    277 * Patterns that suggest automated or abusive access
    278 
    279 We want you to succeed. If your site outgrows the Managed plan, the Self-Hosted option is a natural next step that puts you in full control.
     238Managed mode includes up to 500 GB of cached image storage and 5 TB monthly bandwidth as soft limits. Storage refers to total cached image weight in R2 and does not include non-image assets. Storage is cumulative, not monthly traffic.
     239
     240If your usage regularly exceeds the limits, we will contact you. In many cases, the Self-Hosted option is recommended for full control and unlimited growth.
    280241
    281242== Content Responsibility ==
    282243
    283 You are responsible for the images you upload. Illegal or abusive content may lead to account review. High-volume or high-risk sites should use the Self-Hosted option for full control.
    284 
    285 * Do not use this service to distribute illegal, harmful, or abusive content
    286 * Do not use this service to circumvent copyright protections
    287 * Accounts serving prohibited content may be suspended without notice
     244You are responsible for the images you upload. Illegal or abusive content may lead to account review. High risk or high volume sites should use the Self-Hosted option.
    288245
    289246== Changelog ==
Note: See TracChangeset for help on using the changeset viewer.