Joomla Performance Optimizer

Payo Speed Pro

Professional Joomla 5/6 performance optimizer focused on safe full-page cache, LCP improvements, image/WebP delivery, JavaScript defer, font improvements, logs, and extension-aware exclusions.

1. Overview

Payo Speed Suite Pro is designed to improve Joomla performance without aggressive CSS/JS merging that can break layouts, carts, menus, or page builders.

Safe CacheGuest-only page cache with dynamic page exclusions.
LCP OptimizationPreload and eager-load the first important image/background candidate.
Images/WebPGenerate WebP copies without overwriting original files.
Safe JS DeferDefer safe scripts while excluding critical shop/form/menu scripts.
CSS ImprovementsHTML minify, duplicate inline style cleanup, optional async CSS.
Extension AwareDetects SP Page Builder, HikaShop, VirtueMart, Helix, YOOtheme and more.

2. Requirements

RequirementRecommended
JoomlaJoomla 5 or Joomla 6+
PHPPHP 8.1 or newer
Image processingGD or Imagick for WebP generation
Writable folders/administrator/cache/, /images/, /media/ where WebP files are generated
Browser testingChrome, Firefox, Edge, mobile browser

3. Installation

  1. Log in to the Joomla Administrator area.
  2. Go to System → Install → Extensions.
  3. Upload pkg_payospeed_1.3.6.zip.
  4. After installation, go to Components → Payo Speed Suite Pro.
  5. Open Plugin Settings and enable System - Payo Speed Suite Pro.
Important: Start with Safe mode first. Do not enable aggressive options on a live shop before testing cart, checkout, login and forms.

4. Quick Start Recommended Setup

Use these settings first on every Joomla website:

Mode: Safe
Smart Guest Page Cache: ON
HTML Minify: ON
Lazy Load Images: ON
Skip First Images: 1
Preload LCP Candidate: ON
Serve WebP Images: ON
Add Image Width/Height: ON
Lazy Iframes: ON
Remove Duplicate Inline CSS: ON
Optimize Google Fonts: ON
Safe JavaScript Defer: ON

Async Non-critical CSS: OFF
Delay Third-party Scripts: OFF
Manual Critical CSS: empty

After confirming that everything works, enable Balanced/Advanced features one by one and test again.

5. Admin Dashboard

The component dashboard is available from Components → Payo Speed Suite Pro. It includes:

  • Dashboard: plugin status, cache files, cache size and current mode.
  • System Check: Joomla/PHP compatibility, writable cache, GD/Imagick/cURL and plugin status.
  • Images: scans large images and can generate WebP copies.
  • Extensions: detects common Joomla builders, shops, templates and form extensions.
  • Logs: records cache hits, stores, exclusions, WebP generation and optimization actions.
  • Docs: quick safety reminders inside Joomla admin.

6. Plugin Settings Explained

Mode

Safe is recommended for the first run. Balanced and Advanced settings should be enabled gradually after frontend testing.

Smart Guest Page Cache

Stores optimized HTML for public guest visitors. Logged-in users and excluded pages are not cached.

HTML Minify

Removes unnecessary whitespace from HTML output. This is safe for most websites.

Lazy Load Images

Adds lazy loading to images below the first screen. The first images can be skipped to protect LCP.

Preload LCP Candidate

Attempts to detect the first important image/background and preload it for faster Largest Contentful Paint.

Serve WebP Images

If .webp copies exist next to JPG/PNG files, the plugin can serve them through safe <picture> fallback markup.

Safe JavaScript Defer

Defers safe scripts while protecting critical Joomla, menu, form, cart and checkout scripts.

Async Non-critical CSS

Optional. Keep it OFF until the site is tested. Some templates/builders depend on blocking CSS order.

Delay Third-party Scripts

Optional. Can delay Analytics, Pixels, Hotjar, TikTok, Clarity or similar third-party scripts. Test tracking and consent tools after enabling.

7. Image and WebP Workflow

  1. Go to Components → Payo Speed Suite Pro → Images.
  2. Review large files from /images and /media.
  3. Click Generate WebP for Large Images.
  4. The tool creates .webp copies next to original JPG/PNG files.
  5. Original images are not overwritten, cropped or resized.
  6. Enable Serve WebP Images in the plugin.
  7. Clear cache and inspect the frontend source.
<picture>
  <source type="image/webp" srcset="/images/example.webp">
  <img src="/images/example.jpg" alt="">
</picture>
Safe behavior: A JPG file can still show as 17 MB in the scanner even when WebP is ready. The original is kept as fallback; the browser receives the smaller WebP when supported.
If WebP is not generated: check GD/Imagick, folder permissions, PHP memory limit and file ownership.

8. Cache Tools

Clear Cache

Deletes generated Payo Speed page cache files. Use it after changing layout, menus, modules, template options or plugin settings.

Warm Up Cache

Requests the homepage and public menu links to create guest cache before real visitors arrive.

Automatic Exclusions

Payo Speed excludes dynamic areas such as cart, checkout, login, profile, administrator, token-based requests and common shop/form actions.

9. Safe Testing Checklist

After installing or changing settings, test:

  • Homepage
  • Article page
  • Category/blog page
  • SP Page Builder/YOOtheme/Quix pages if used
  • HikaShop/VirtueMart product category
  • Product detail page
  • Add to cart
  • Cart page
  • Checkout page
  • Login/register/profile pages
  • Contact and other forms
  • Mobile menu
Do not sell or deploy with aggressive settings enabled by default. ThemeForest/customer-safe behavior requires conservative defaults and clear exclusions.

10. Troubleshooting

The layout looks broken

  1. Disable Async Non-critical CSS.
  2. Disable Delay Third-party Scripts.
  3. Clear Payo Speed cache and Joomla cache.
  4. Test again in incognito.

Cart or checkout behaves incorrectly

  1. Make sure shop/cart/checkout URLs are excluded.
  2. Disable page cache temporarily.
  3. Clear cache and test again.

WebP files are not created

  1. Check GD/Imagick in System Check.
  2. Verify /images and /media permissions.
  3. Increase PHP memory limit for very large images.

Admin dashboard style does not update

  1. Install the latest package over the old one.
  2. Clear Joomla cache.
  3. Hard refresh the browser using Ctrl+F5.

11. Commercial Release Notes

  • All visible admin text should remain translatable through language files.
  • Do not hide credits or add tracking code without user consent.
  • Keep default settings conservative.
  • Always escape output and sanitize user input.
  • Document all risky options clearly.

Recommended first public version profile: Safe cache, WebP delivery, lazy images, LCP preload, safe JS defer and logs. Keep async CSS and third-party delay optional.

Version 1.4.0 Features

Manual LCP Image URL

Use this field when PageSpeed Insights shows a specific hero image as the Largest Contentful Paint element. Copy the image URL and paste it into the plugin setting. Payo Speed will preload that image and, when possible, prefer the optimized WebP copy.

Background Image Preload

Many Joomla page builders use CSS background images for hero sections. The option Preload First Background Image detects the first inline background image and adds a preload hint for it.

Optimized Resized WebP Copies

The Images screen includes Generate Resized WebP Copies. This creates safe optimized copies next to the original image using the suffix -payo-1600.webp. Original JPG/PNG files are never overwritten, cropped or deleted.

Recommended Image Workflow

  1. Open Components > Payo Speed Suite Pro > Images.
  2. Click Generate WebP for Large Images.
  3. Click Generate Resized WebP Copies.
  4. Open plugin settings and keep Serve WebP Images and Prefer Optimized WebP Copies enabled.
  5. Clear cache and test the frontend.

Lazy Background Images

This is an advanced setting. Enable it only after testing because hero background images should usually be preloaded, not lazy loaded.

Safe Inline CSS Extractor

Version 1.4.2 can move large known-safe inline CSS blocks generated by SP Page Builder and supported carousel modules into generated CSS files under /media/com_payospeed/generated/. The safe defaults keep the first style block inline, extract only recognized builder/carousel CSS, and keep async loading disabled to avoid visual layout changes.

Version 1.4.3 Image Optimizer Improvements

Version 1.4.3 adds smarter optimized image status reporting. If a normal WebP file is already small enough, the admin dashboard marks the optimized copy as Not needed instead of Missing. HikaShop product images can use smaller optimized copies such as -payo-800.webp and -payo-500.webp, while large hero/background images can continue using larger generated WebP copies.

Version 1.4.6 Scanner Fixes

Version 1.4.6 cleans the image scanner queue. It scans only original JPG, JPEG and PNG images, ignores existing WebP/AVIF/SVG/GIF files and generated -payo-*.webp copies, detects normal WebP pairs more accurately, and prefers smaller HikaShop optimized product images when available.

Version 1.4.7 - Image Status Cleanup

This version improves the Images dashboard so small or non-priority images are not shown as problematic missing WebP items. Heavy images still show Missing only when no usable WebP or optimized WebP variant exists.

HikaShop Thumbnail WebP

HikaShop can display product images from /images/com_hikashop/upload/thumbnails/. Version 1.4.9 includes those thumbnail JPG/PNG files in the WebP generation queue so product carousels and listing thumbnails can be served through WebP picture fallbacks.

Safe WebP Queue

Version 1.5.0 adds one-click safe queue buttons for all pending WebP files and optimized resized copies. The process runs in repeated safe batches, so keep the browser tab open until completion.

Lazy HikaShop Carousel Init

Version 1.5.1 keeps HikaShop product carousel HTML visible as a static fallback and delays only the carousel JavaScript initialization for lower carousel sections. This reduces mobile main-thread work without showing empty areas.

Payo Helix Optimizer Compatibility

Version 1.5.5 adds a compatibility option named Respect Payo Helix Optimizer. When the separate Payo Helix Optimizer system plugin is enabled, Payo Speed bypasses its early guest HTML cache so it cannot serve stale HTML generated before Helix-specific optimizations were applied.

Image/WebP delivery, LCP preload, lazy loading and other safe output optimizations continue to run. For best compatibility, place Payo Speed Suite Pro before Payo Helix Optimizer in System Plugins, place Payo Helix Optimizer last, and clear both Payo Speed and Joomla cache after changing either plugin.

License Activation

Version 1.5.7 adds a product-specific license tab in the administrator component. Payo Speed sends product=payospeed to the PayoThemes license endpoint and stores the result in the system plugin parameters.

A key created for another product, for example payoseo, must not activate this extension. If the server response returns a different product slug or no product slug, Payo Speed marks the license as invalid.

Admin Button Click Area Fix

The decorative hero pseudo-element now uses pointer-events:none and safe z-index layering, so the Clear Cache and Warm Up Cache buttons are clickable across their full visible area.