Smart Prefetch Documentation

What is Smart Prefetch?

Smart Prefetch is a high-performance Joomla plugin that dramatically improves website navigation speed by intelligently prefetching pages before users click on them. By preloading critical resources and adjacent pages in the background, your site feels instant and responsive.

How It Works

Smart Prefetch uses three powerful techniques to accelerate your Joomla site:

1. Adjacent Page Prefetching

The plugin automatically detects navigation patterns and prefetches the most likely next pages:

  • Previous/Next articles in blog layouts
  • Pagination links (next/previous page)
  • Related content links
  • Category navigation (adjacent categories)

2. Critical Resource Preloading

Preloads essential assets before they're needed:

  • CSS stylesheets for faster rendering
  • JavaScript files for instant interactivity
  • Images for immediate display

3. Intelligent Hovering

When users hover over links, Smart Prefetch:

  • Detects the intent to navigate
  • Prefetches the target page instantly
  • Makes the next page feel instantaneous

Key Features

  • Zero Configuration - Works perfectly out of the box
  • Smart Detection - Automatically finds adjacent pages
  • Bandwidth Efficient - Only prefetches high-probability pages
  • Mobile Optimized - Respects data-saver preferences
  • SEO Friendly - Uses proper browser hints (no crawling issues)
  • Performance Focused - Idle-time prefetching (won't slow down current page)
  • Developer Friendly - Clean code, well-documented

Performance Benefits

Before Smart Prefetch:

User clicks link → Browser requests page → Server processes → Content loads

Total time: 500-2000ms

After Smart Prefetch:

User hovers → Page prefetched → User clicks → Instant display

Total time: 50-100ms (feels instant!)

Real-World Results:

  • 60-80% faster perceived navigation speed
  • Dramatically reduced bounce rate (faster = more engagement)
  • Improved SEO rankings (Core Web Vitals improvement)
  • Better user experience (instant feel = professional site)

Installation

Step 1: Purchase & Download

  1. Purchase Smart Prefetch from joomlaprefetch.com
  2. You'll receive:

Step 2: Install the Plugin

  1. Login to Downloads Portal
  2. Download the Plugin
    • Click "Download Smart Prefetch Plugin"
    • Save smartprefetch.zip to your computer
  3. Install in Joomla
    • Go to: Extensions → Manage → Install
    • Click Upload Package File
    • Select smartprefetch.zip
    • Click Upload & Install

Step 3: Configure Plugin

  1. Go to Plugin Settings
    • Navigate to: Extensions → Plugins
    • Search for: "Smart Prefetch"
    • Click on the plugin name
    • Configure settings
    • Set Status to Enabled
    • Click Save & Close

That's it! Smart Prefetch is now active on your site.

Configuration Options

Basic Settings

Status: Enabled/Disabled

  • Turn the plugin on or off globally

Advanced Settings

Debug Mode: Yes/No (Default: No)

  • Shows console logs of prefetch activity
  • Use for troubleshooting only

How Prefetching Works (Technical)

The Prefetch Process

  1. Page Load
    • Plugin scans the current page
    • Identifies navigation elements (prev/next, pagination, etc.)
    • Finds adjacent article/category links
  2. Link Detection 
    // Plugin looks for these patterns:
- .pagination .page-link (pagination)
- .blog-item a (blog article links)
- .item-page a (article links)
- [rel="next"], [rel="prev"] (adjacent pages)
  3. Prefetch Injection 
    <!-- Plugin adds this to <head> -->
<link rel="prefetch" href="/next-page.html">
<link rel="preload" href="/style.css" as="style">
  4. Browser Action
    • Browser fetches resources in idle time
    • Stores in cache
    • When user clicks, loads instantly from cache

What Gets Prefetched?

  • Next/previous article in sequence
  • Next/previous page in pagination
  • Adjacent category in list
  • Related articles
  • Popular links on page
  • Category landing pages
  • Menu items
  • Footer links

Resource Preloading

CSS Files:

<link rel="preload" href="/templates/mytemplate/css/template.css" as="style">

JavaScript Files:

<link rel="preload" href="/media/jui/js/jquery.min.js" as="script">

Images:

<link rel="preload" href="/images/mygallery/coolpic.webp" as="script">

Browser Compatibility

Smart Prefetch works on all modern browsers:

  • Chrome 58+ - Full support
  • Firefox 56+ - Full support
  • Safari 13+ - Full support
  • Edge 79+ - Full support
  • Opera 45+ - Full support

Mobile Browsers:

  • Chrome Mobile, Firefox Mobile, Safari iOS 13+

Graceful Degradation:

  • Older browsers simply ignore prefetch hints
  • Site works normally, just without speed boost
  • No errors or broken functionality

SEO Considerations

Does Prefetching Hurt SEO?

No! Smart Prefetch is 100% SEO-safe because:

  1. Uses Standard Browser Hints
    • <link rel="prefetch"> is a W3C standard
    • Search engines understand and respect it
    • No duplicate content issues
  2. Doesn't Trigger Analytics
    • Prefetched pages don't fire analytics
    • Only actual page views are counted
    • Accurate statistics maintained
  3. Improves Core Web Vitals
    • Faster page loads = better LCP (Largest Contentful Paint)
    • Reduced CLS (Cumulative Layout Shift)
    • Better FID (First Input Delay)
    • Better SEO rankings!
  4. No Crawl Budget Impact
    • Prefetch happens client-side
    • Doesn't create extra server requests for bots
    • Googlebot ignores prefetch hints

SEO Benefits

  • Faster page speed = higher rankings
  • Lower bounce rate = better engagement signals
  • More pages per session = deeper crawling
  • Improved mobile performance = mobile-first indexing bonus

Troubleshooting

Plugin Not Working

Check These First:

  1. Is the plugin enabled?
    • Extensions → Plugins → Smart Prefetch
    • Status should be "Enabled" with green checkmark
  2. Clear Joomla cache:
    • System → Clear Cache
    • Select all, click "Delete"
  3. Clear browser cache:
    • Hard refresh: Ctrl+Shift+R (PC) or Cmd+Shift+R (Mac)

No Speed Improvement

Possible Causes:

  1. Browser doesn't support prefetch
    • Update to latest browser version
    • Test in Chrome for best results
  2. Pages already cached
    • First visit won't show improvement
    • Speed boost appears on subsequent navigation
  3. Server is slow
    • Prefetch can't fix slow server response
    • Consider upgrading hosting
  4. Caching disabled
    • Joomla cache should be enabled
    • Browser cache should be enabled

Conflicts with Other Extensions

Known Compatible Extensions:

  • JCH Optimize
  • Hikashop
  • Cache Cleaner
  • Regular Labs extensions
  • JL Sitemap
  • Most SEO extensions

Potential Conflicts:

  • Other prefetch/preload plugins (disable them)
  • Aggressive caching that strips link tags
  • Security plugins that block resource hints

Solution: Disable conflicting extensions one by one to identify the issue.

Debug Mode

Enabling Debug

  1. Plugin Settings → Debug Mode: Yes
  2. Save
  3. Open browser console (F12)
  4. Navigate your site

What You'll See

Smart Prefetch: Detected adjacent pages
Smart Prefetch: Prefetching /blog/next-article
Smart Prefetch: Preloading /css/template.css
Smart Prefetch: Link hovered: /contact
Smart Prefetch: Prefetch complete: /blog/next-article (234ms)

Understanding Debug Output

  • "Detected adjacent pages" - Plugin found navigation links
  • "Prefetching [URL]" - Started loading page
  • "Prefetch complete (Xms)" - Page loaded and cached
  • "Link hovered" - User hovering triggered prefetch
  • "Skipping (data saver)" - Respecting user preference

FAQ

Is Smart Prefetch free?

No, Smart Prefetch is a premium plugin available for $29.99 USD. This one-time purchase includes:

  • Lifetime license for one site
  • Free updates for one year
  • Email support
  • Download access for one year

How many sites can I use it on?

Each license is valid for one Joomla installation. For multiple sites, purchase additional licenses.

Will this work on Joomla 5 and 6?

Yes! Smart Prefetch is compatible with:

  • Joomla 5.x (all versions)

Does it slow down my server?

No! Prefetching happens:

  • During browser idle time
  • After current page fully loads
  • Using normal page requests (just earlier)

Your server handles the same requests, just distributed over time instead of all at once.

Will it work with my template?

Yes! Smart Prefetch works with any Joomla template. It uses standard Joomla APIs and doesn't require template-specific code.

Can I see it working?

Yes! Enable Debug Mode and open your browser console (F12). You'll see exactly what's being prefetched and when.

What about privacy?

Smart Prefetch:

  • Respects user privacy settings
  • Honors Do Not Track
  • Respects data-saver mode
  • No external connections
  • No data collection
  • GDPR compliant

Does it work on mobile?

Yes! Smart Prefetch is fully optimized for mobile:

  • Respects limited data plans
  • Honors data-saver mode
  • Works on all mobile browsers
  • Improves mobile Core Web Vitals

Can I get a refund?

Yes! We offer a 30-day money-back guarantee. If you're not satisfied for any reason, contact us for a full refund.

How do I update the plugin?

  1. Download latest version from your portal
  2. Install as update (same process as initial install)
  3. Your settings are preserved

Do I need to renew my license?

No! Your license never expires. You can use Smart Prefetch forever. Updates and support are included for one year, after which you can optionally renew for continued updates.

Technical Specifications

System Requirements

Joomla Version:

  • Joomla 5.x recommended
  • Joomla 6.x recommended

PHP Version:

  • PHP 8.2 or higher

Server Requirements:

  • No special requirements
  • Works on any hosting (shared, VPS, dedicated)
  • Compatible with all web servers (Apache, Nginx, LiteSpeed)

Browser Requirements (User Side):

  • Modern browser with prefetch support
  • Gracefully degrades on older browsers

Database Tables

Smart Prefetch does not create any database tables. It's completely stateless and operates client-side for maximum performance.

Resource Usage

  • Memory: < 1MB
  • CPU: Negligible
  • Disk: < 100KB
  • Bandwidth: Minimal (prefetches only high-probability pages)

Support

Getting Help

Documentation:

  • This guide covers most scenarios
  • Check FAQ section first

Email Support:

  • This email address is being protected from spambots. You need JavaScript enabled to view it.
  • Response within 24-48 hours
  • Include: Joomla version, PHP version, description of issue

Debug Logs:

  • Enable Debug Mode
  • Copy console output
  • Include in support request

Reporting Bugs

Found a bug? Email us with:

  1. Steps to reproduce
  2. Expected vs actual behavior
  3. Debug console output
  4. Browser and Joomla versions

Feature Requests

Have an idea? We'd love to hear it!

Changelog

Version 1.2.0 (Current)

  • 2nd release
  • Intelligent adjacent page detection
  • Hover-based prefetching
  • Critical resource preloading
  • Multiple strategy modes
  • Debug mode
  • Mobile optimization
  • Data-saver respect
  • Fixed bug that prevented front-end admin article and module editing.

Credits

Developed by:Morrison Web Design

Website: https://joomlaprefetch.com

Support: This email address is being protected from spambots. You need JavaScript enabled to view it.

Built with:

  • Modern JavaScript (ES6+)
  • Joomla Plugin API
  • W3C Prefetch Standards

License Agreement

By purchasing Smart Prefetch, you agree to:

  1. Use on one site per license
  2. Not redistribute or resell the plugin
  3. Receive updates for one year from purchase
  4. Use for commercial or personal projects
  5. Contact support for any questions

Full license terms provided with purchase.

Quick Start Checklist

Ready to go? Here's your quick-start:

  • Purchase plugin from joomlaprefetch.com
  • Login to download portal
  • Download smartprefetch.zip
  • Install via Extensions → Manage → Install
  • Go to Extensions → Plugins → Smart Prefetch
  • Enable plugin
  • Save & close
  • Test by navigating your site
  • Notice the speed! 🚀

Questions? Email This email address is being protected from spambots. You need JavaScript enabled to view it. or use the contact form.