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:
    • Login credentials via email
    • Your unique license key (Transaction ID)
    • Download link to the plugin package

Step 2: Install the Plugin

  1. Login to Downloads Portal
    • Use credentials from your email
    • Access: https://joomlaprefetch.com/downloads
  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: Activate Your License

  1. Go to Plugin Settings
    • Navigate to: Extensions → Plugins
    • Search for: "Smart Prefetch"
    • Click on the plugin name
  2. Enter Your License Key
    • Find the License Key field
    • Paste your Transaction ID (from purchase email)
    • Example: 6XY13966L59587323
  3. Enable the Plugin
    • 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

License Key: Your unique license key

  • Required for activation
  • Found in your purchase confirmation email

Advanced Settings

Prefetch Strategy: (Default: Intelligent)

  • Intelligent - Automatically detects adjacent pages (recommended)
  • Hover Only - Only prefetch on link hover
  • Aggressive - Prefetch more pages (uses more bandwidth)
  • Conservative - Prefetch fewer pages (saves bandwidth)

Exclude URLs: Comma-separated list

  • URLs to never prefetch
  • Example: /checkout, /cart, /admin

Prefetch Delay: Milliseconds (Default: 100)

  • How long to wait on hover before prefetching
  • Lower = faster, higher = less aggressive

Respect Data Saver: Yes/No (Default: Yes)

  • Skip prefetching when user has data-saver mode enabled
  • Recommended: Yes (respects user preferences)

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?

High Priority (Always):

  • Next/previous article in sequence
  • Next/previous page in pagination
  • Adjacent category in list

Medium Priority (Intelligent mode):

  • Related articles
  • Popular links on page
  • Category landing pages

Low Priority (Aggressive mode only):

  • All internal links in viewport
  • 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

Performance Best Practices

Optimal Configuration

For News/Blog Sites:

  • Strategy: Intelligent
  • Prefetch: Next/previous articles
  • Result: Readers breeze through content

For E-commerce:

  • Strategy: Conservative
  • Exclude: /checkout, /cart
  • Result: Fast browsing without prefetching checkout

For Documentation:

  • Strategy: Intelligent
  • Prefetch: Adjacent docs
  • Result: Seamless learning experience

For Portfolios:

  • Strategy: Hover Only
  • Prefetch: Project pages
  • Result: Instant project viewing

When to Use Each Strategy

Intelligent (Recommended for most sites):

  • Automatically balances speed and bandwidth
  • Perfect for blogs, news, documentation
  • Adapts to user behavior

Hover Only (Best for high-traffic sites):

  • Only prefetches what user shows interest in
  • Reduces server load
  • Great for limited hosting resources

Aggressive (Best for small sites):

  • Maximum speed, more bandwidth usage
  • Ideal for portfolio sites (few pages)
  • Premium hosting with unlimited bandwidth

Conservative (Best for mobile-heavy traffic):

  • Minimal bandwidth usage
  • Respects data plans
  • Emerging markets with expensive data

Troubleshooting

Plugin Not Working

Check These First:

  1. Is the plugin enabled?
    • Extensions → Plugins → Smart Prefetch
    • Status should be "Enabled" with green checkmark
  2. Is license key valid?
    • Check for typos in license field
    • License should be PayPal Transaction ID format
  3. Clear Joomla cache:
    • System → Clear Cache
    • Select all, click "Delete"
  4. 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

Too Much Bandwidth Usage

Solutions:

  1. Switch to Conservative mode
    • Plugin Settings → Strategy: Conservative
  2. Exclude heavy pages
    • Add URLs to "Exclude URLs" field
    • Example: /videos, /downloads
  3. Enable Data Saver respect
    • Respect Data Saver: Yes
    • Skips prefetch for users on limited data

Conflicts with Other Extensions

Known Compatible Extensions:

  • JCH Optimize
  • Cache Cleaner
  • Regular Labs extensions
  • 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 $35 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 license key and 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!

  • Email: This email address is being protected from spambots. You need JavaScript enabled to view it.
  • Subject: "Feature Request"
  • Describe your use case

Changelog

Version 1.0.0 (Current)

  • Initial release
  • Intelligent adjacent page detection
  • Hover-based prefetching
  • Critical resource preloading
  • License validation system
  • Multiple strategy modes
  • Debug mode
  • Mobile optimization
  • Data-saver respect

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
  • Check email for credentials and license key
  • Login to download portal
  • Download smartprefetch.zip
  • Install via Extensions → Manage → Install
  • Go to Extensions → Plugins → Smart Prefetch
  • Paste license key
  • 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.