Royal Speed Documentation

Getting Started

Royal Speed is a comprehensive WordPress optimization plugin that combines 18 premium features into one lightweight solution. It helps you achieve faster page loads, better Core Web Vitals scores, and improved SEO rankings.

Key Features

Requirements

• WordPress 5.8 or higher
• PHP 7.4 or higher
• Write access to wp-content folder (for cache files)

Before You Begin

Optimization plugins are powerful tools, but incorrect settings can break your site. Follow these critical guidelines to ensure a safe setup.

The Golden Rule: One Setting at a Time

Never enable all optimization settings at once. This is the #1 cause of broken sites with cache plugins. Instead:

1. Enable one feature (e.g., Page Caching)
2. Clear all caches and test your site thoroughly
3. Browse multiple pages in a private/incognito window
4. Check interactive elements (forms, menus, sliders, carousels)
5. If everything works, enable the next feature
6. If something breaks, disable that feature and check exclusion options

Recommended Enable Order

For the safest setup, enable features in this order:

Installation

From Your Account (Premium)

License activation page in Royal Speed settings

Quick Start

Get up and running in minutes with these essential settings:

Main cache settings dashboard

Page Caching

Page caching creates static HTML versions of your pages, serving them directly without executing PHP code. This dramatically reduces server load and response times.

How It Works

1. A visitor requests a page for the first time
2. WordPress generates the page normally
3. Royal Speed saves a static HTML copy
4. Subsequent visitors receive the cached HTML instantly

Settings

Page caching configuration options

CSS & JavaScript Minification

Minification removes unnecessary characters (whitespace, comments, line breaks) from CSS and JavaScript files, reducing their size without affecting functionality.

CSS Optimization

• Minify CSS - Remove whitespace and comments
• Combine CSS - Merge multiple files into one (reduces HTTP requests)
• Inline Critical CSS - Embed above-the-fold styles for faster rendering

JavaScript Optimization

• Minify JavaScript - Compress JS files
• Defer JavaScript - Load JS after page content
• Delay JavaScript - Wait for user interaction before loading

CSS and JavaScript optimization settings

Image Optimization

Optimize images automatically to reduce page weight without visible quality loss.

Features

• WebP Conversion - Convert JPEG/PNG to WebP format (30-50% smaller)
• Compression - Reduce file size while maintaining quality
• Resize Large Images - Prevent oversized uploads

Settings

Image optimization and media settings

Lazy Loading

Lazy loading defers the loading of images and iframes until they're about to enter the viewport. This improves initial page load time and reduces bandwidth usage.

What Gets Lazy Loaded

• Images (including background images)
• Iframes (YouTube, Vimeo, Google Maps)
• Videos

Exclusions

You can exclude specific images from lazy loading:

• Add no-lazy class to the image
• Add image filename to exclusion list in settings
• Above-the-fold images are automatically excluded

Lazy loading is configured in the Media settings tab

CDN Integration

Connect your Content Delivery Network to serve static assets from edge locations around the world.

Setup

Supported CDN Providers

• Cloudflare
• BunnyCDN
• KeyCDN
• StackPath
• Any pull-zone CDN

CDN configuration in Advanced settings

Database Optimization

Clean up your WordPress database to improve performance and reduce storage.

Cleanup Options

• Post Revisions - Remove old post revisions
• Auto Drafts - Delete unused auto-drafts
• Trashed Posts - Empty the trash
• Spam Comments - Remove spam comments
• Transients - Clear expired transients
• Optimize Tables - Defragment database tables

Database cleanup and optimization tools

Browser Caching

Set cache headers to instruct browsers to store static assets locally, reducing repeat page load times.

Default Expiry Times

Browser caching is configured in Advanced settings

WooCommerce Optimization

Royal Speed includes special optimizations for WooCommerce stores, including automatic exclusions, cart fragment optimization, and performance enhancements that can save hundreds of kilobytes on checkout pages.

Automatic Exclusions

The following pages are automatically excluded from caching:

• Cart page
• Checkout page
• My Account pages
• Pages with WooCommerce shortcodes

Cart Fragments

WooCommerce uses AJAX to update cart fragments. Royal Speed can optimize this:

• Disable Cart Fragments - Removes AJAX calls on non-shop pages
• Optimize Cart Fragments - Reduces fragment update frequency

Checkout Optimization

Royal Speed automatically optimizes your checkout page:

• Password Strength Meter - Disabled on checkout pages, saving ~400KB by not loading the zxcvbn.js library. This script is only needed on registration pages, not during checkout.

Session Optimization

WooCommerce sessions can slow down page loads for all visitors. Royal Speed intelligently defers session initialization:

• Guest Session Deferral - Sessions for guest visitors are deferred until they visit cart/checkout pages, reducing overhead on product and shop pages.

Security

• Generator Tag Removal - Removes the WooCommerce version meta tag from your site's HTML, preventing version disclosure that could be exploited.

WooCommerce optimization options in Advanced settings

Page Builder Compatibility

Royal Speed works with all major page builders, but CSS/JS optimization features may require specific exclusions to prevent conflicts. This section covers the most common page builders and their known compatibility considerations.

Elementor

Elementor is generally compatible with Royal Speed, but there are some important considerations:

Recommended Settings

• Use Elementor's built-in optimization first - Go to Elementor > Settings > Experiments and enable "Improved CSS Loading" and "Inline Font Icons"
• Don't combine Elementor CSS files - Elementor generates CSS per-page; combining can cause style conflicts
• Exclude Elementor scripts from deferring if animations or sliders break

Common Scripts to Exclude

elementor-frontend
elementor-pro-frontend
elementor-waypoints
swiper

Known Issues

• CSS regeneration - Elementor regenerates CSS files periodically. If styles break after cache clear, regenerate CSS in Elementor > Tools > Regenerate CSS
• Popup/Modal issues - If popups don't appear, exclude elementor-pro-frontend from JavaScript deferring
• Slider issues - Exclude swiper from JS combining if carousels break

Divi

Divi has its own performance features that can conflict with external optimization.

Recommended Settings

• Use Divi's built-in performance features - Go to Divi > Theme Options > Performance and enable their Critical CSS and Defer JS options
• Choose one optimization source - Either use Divi's built-in options OR Royal Speed's, not both
• If using Royal Speed - Disable Divi's performance features and use Royal Speed instead

Common Scripts to Exclude

et-core
et-builder
divi-custom-script
jquery-migrate

Known Issues

• Visual Builder broken - Always exclude admin/editor pages from caching
• Animations not working - Exclude divi-custom-script from deferring
• Parallax effects broken - Exclude Divi's core scripts from combining

WPBakery (Visual Composer)

Common Scripts to Exclude

js_composer_front
vc_waypoints
vc_accordion
vc_tabs

Beaver Builder

Common Scripts to Exclude

fl-builder
fl-builder-layout
jquery-magnificpopup

Oxygen Builder

Oxygen generates very clean code and typically has fewer conflicts.

Common Scripts to Exclude (if needed)

oxygen-frontend
oxy-aos-init

Bricks Builder

Bricks is performance-focused and usually compatible out of the box.

Common Scripts to Exclude (if needed)

bricks-scripts
bricks-splide

General Exclusion Guidelines

When troubleshooting page builder issues, look for these patterns:

Troubleshooting

Site layout is broken after enabling optimization

This is the most common issue and usually caused by CSS or JavaScript optimization conflicts. Follow these steps in order:

1. First, disable JavaScript Combining - This is the most common cause
2. If still broken, disable JavaScript Deferring
3. If still broken, disable CSS Combining
4. If still broken, disable CSS Minification
5. If fixed at any step, re-enable that feature and use exclusions instead

How to Use Exclusions

Rather than disabling optimization entirely, exclude specific problematic scripts:

1. Open your browser's Developer Tools (F12)
2. Go to the Console tab and look for JavaScript errors
3. The error usually mentions which script is failing
4. Add that script handle to the exclusion list in Royal Speed settings

Common Scripts That Need Exclusion

# jQuery (exclude if mobile menus break)
jquery
jquery-core
jquery-migrate

# Sliders (exclude if carousels break)
swiper
slick
owl-carousel
flexslider

# Lightboxes (exclude if popups break)
magnificpopup
fancybox
lightbox

# Page Builders (see Page Builders section for more)
elementor-frontend
et-builder
js_composer_front

Cache not clearing

• Click "Purge All Cache" in the admin bar
• Check that wp-content/cache/royal-speed is writable
• Clear any additional caches (hosting, CDN, browser)
• If using Cloudflare, purge cache there too

Changes not appearing on the site

Multiple cache layers can cause this. Clear them all:

1. Royal Speed cache - Purge All Cache in admin bar
2. Browser cache - Hard refresh (Ctrl+Shift+R) or use incognito
3. Hosting cache - Purge from hosting dashboard (if applicable)
4. CDN cache - Purge from Cloudflare/BunnyCDN/etc.
5. Object cache - If using Redis/Memcached, flush it

CSS styles look wrong or broken

• If using Elementor: Go to Elementor > Tools > Regenerate CSS
• If using Divi: Go to Divi > Theme Options > Builder > Advanced > Static CSS File Generation and click regenerate
• Check for CSS combining conflicts: Disable CSS combining and test
• Check for minification issues: Some CSS syntax doesn't minify well—try disabling CSS minify

Slow admin dashboard

• Royal Speed does not optimize admin pages
• This is likely caused by another plugin or hosting issue
• Try disabling other plugins one by one to find the culprit

WooCommerce cart/checkout issues

• These pages should be auto-excluded from caching
• If not, manually add them to the URL exclusion list:

/cart/*
/checkout/*
/my-account/*

Contact form not submitting

• Form plugins (WPForms, Contact Form 7, Gravity Forms) need their JS intact
• Add these to JS exclusions:

wpforms
contact-form-7
gform_
forminator

Frequently Asked Questions

Will Royal Speed work with my theme?

Royal Speed is compatible with virtually all WordPress themes. If you encounter issues, use the exclusion settings to resolve conflicts.

Does this plugin replace my hosting cache?

Royal Speed can work alongside or replace your hosting cache. If your host has built-in caching, you may want to disable the page cache feature and use only the optimization features.

How do I know if caching is working?

View your page source. Cached pages show a comment at the bottom: <!-- Royal Speed Cache -->. You can also check the response headers for cache hit indicators.

Can I use this with other caching plugins?

We recommend using only one page caching solution. However, you can disable Royal Speed's page cache and use only the optimization features alongside other cache plugins.

Does caching work for logged-in users?

By default, logged-in users see uncached pages to ensure personalized content displays correctly. This can be customized in settings.