#1481 Posted in ‘Route 66’

Latest post by Lefteris Kavadas on Wednesday, 04 February 2026 11:09 EET

Manny Munoz

Dear Support Team,

I'm running Joomla 5.4.0 with PHP 8.4.17

After tried to upgrade Route66 from an old version (can't remember the version) to the latest 2.3.1, but after the upgrade I got this error message:

 

Failed opening required 'D:\domains\domainname.com\httpdocs/plugins/system/route66/lib/plugin.php' (include_path='.;.\includes;.\pear')

 

I visited phpMyAdmin > _extensions > plg_system_route66 and edit the enable from 1 to 0, and the Administrator page kind of work, but when trying to access the Plugin, Extension or other panil in the System I get this error message:

 

Failed opening required 'D:\domains\domainname.com\httpdocs\administrator/components/com_route66/lib/seoanalyzer.php' (include_path='.;.\includes;.\pear') 

 

Please advise how to fix this?

Thanks so much!

Manny

 

 

Lefteris Kavadas

Hi Manny,

Thank you for the detailed report.

Those files (lib/plugin.php and lib/seoanalyzer.php) are no longer part of Route 66 v2.x, so this error usually means something is still trying to load files from an old version.

The most common causes are:

  1. Leftover files from a previous version. The upgrade process normally removes deprecated files, but in some cases this may fail (e.g. interrupted update or file permission issues).
  2. PHP OPcache. OPcache may still be referencing old file paths.
  3. Third-party extension or custom code. Another extension or override may still be trying to include those old Route 66 files.

What to try first

  1. Keep the Route 66 system plugin disabled (as you already did).
  2. Clear OPcache (restart PHP / web server).
  3. Reinstall Route 66 v2.3.1 over the existing installation (no uninstall needed).
  4. Re-enable the Route 66 system plugin.

If the issue persists after that, please open a new private ticket and include:

  • Administrator login credentials
  • FTP (or file manager) access

I’ll take a look directly and clean up any remaining leftovers for you.

Best regards,
Lefteris

Manny Munoz

Hi Lefteris,

Thank you so much for you prompt reply!

I have turned off opcache and turned back on again but that did not make a different. I don't have access on my Plesk 

The old version or Route 66 PRO that I had was 1.11.1, which I have on another Joomla blog which I also wants to upgrade once we sorted this current Joomla issue on my main site

I'll create a private chat and pass you the logon details, the error shows up when trying to do the upgrade to 2.3.1

Thanks again

Manny

Lefteris Kavadas

Hi Manny,

I’ve resolved the issue on your site.

It was caused by leftover files/extensions from Route 66 v1.11.1 that were still being referenced after the upgrade.

I can’t say with certainty why the cleanup failed during the update (this can happen due to file permissions, interrupted updates, or server-level restrictions), but we’ll be updating Route 66 so that all deprecated extensions are explicitly disabled before removal, to prevent this from happening again in future upgrades.

Upgrading another site from v1.x → v2.3.1

If you plan to upgrade another site from the 1.x series, I strongly recommend the following steps before installing v2.3.1:

  1. Go to System → Manage Extensions
  2. Search for “route” to list all Route 66 extensions
  3. Disable all Route 66 extensions
  4. Install Route 66 v2.3.1

Alternatively, you can wait for the next Route 66 update, which will handle this process automatically during the upgrade.

If you need any help with the second site as well, feel free to reach out.

Best regards,
Lefteris

Manny Munoz

Thank you so much Lefteris for fixing the site, you are amazing!

 

And for the 2nd Joomla blog (5.4.2 and php 8.4) I should have waited for the new version but what i was to disable all route66 items listed (16 in total) when searching for "route" in extensions

After the installation I got this error message:

Failed opening required '/home/domainname/public_html/plugins/system/route66/lib/plugin.php' (include_path='.:/opt/cpanel/ea-php84/root/usr/share/pear')

Maybe different error message from the previous blog because this one runs Linux in the backend

Would you please be able to have a look if I pass you the credentials?

I really appreciate your help

 

Thanks again,

Manny

 

Manny Munoz

Hi Lefteris,

Route66 PRO v2.3.1 is now working okay on my other blog, what I did was to copy the enable/disable settings under jos_extension table from the blog that you fixed to the other one

On Blog 1 the Crawl detected okay the 100 pages that I have, but on Blog 2 it only detected about 5 out of the over 1,500 articles that I have. I have Full Reset and Purge but still it only detect 5 pages. I guess it needs some time?

And one last thing is that, when I go to Joomla 5.4.2 >> Databases I see the Route 66 saying there is a problem that reads as follows:

  • Database version (2.3.1) does not match manifest version (1.9.4)
  • 4 database changes were checked
  • 0 database changes did not alter table structure and were skipped

I'm not worried about it, it is all working okay with the exception that on Blog 2 the Crawl doesn't get the over 1,5k I have 

Thanks again for your great help!

Manny

 

Manny Munoz

Sorry Lefteris, still got an issue on Blog 2, where the crawling of pages is only 5. The Joomla administrator portal works fine, but when I click on the links on the front end I find a page cannot be found, and the crawling is actually finding the pages with 404 error

I have enabled Debug on the system, and when visiting one of the affected pages it gives this error message:

 

Call Stack
#    Function    Location
1    ()    JROOT/libraries/src/Router/Router.php:166
2    Joomla\CMS\Router\Router->parse()    JROOT/libraries/src/Application/SiteApplication.php:767
3    Joomla\CMS\Application\SiteApplication->route()    JROOT/libraries/src/Application/SiteApplication.php:243
4    Joomla\CMS\Application\SiteApplication->doExecute()    JROOT/libraries/src/Application/CMSApplication.php:304
5    Joomla\CMS\Application\CMSApplication->execute()    JROOT/includes/app.php:58
6    require_once()    JROOT/index.php:51

 

Let me know what you think

Thank you!

Manny

 

 

Lefteris Kavadas

Hi Manny,

Thanks for the detailed update, that helps a lot.

Database version warning

The database warning is probably caused by leftover Route 66 extensions from the 1.x series.

Even if they are disabled, they are still installed and Joomla keeps their old manifest data.

You can safely:

  1. Go to System → Manage Extensions
  2. Search for “route
  3. Uninstall any Route 66 extensions that still show a 1.x version
  4. Keep only the Route 66 extensions that belong to v2.3.1

After that, the database warning should be gone.

Crawler detecting only 5 pages

This is not a timing issue.

The crawler is correctly indexing only the pages that are accessible on the frontend.

Since the pages are returning 404 errors, Route 66 stops there — that’s expected behavior.

Frontend 404 errors (root cause)

In Route 66 v2.x, the URL Patterns settings were moved:

They are no longer in the plugins
They are now in Components → Route 66 → Options

Normally these settings are migrated automatically during the upgrade, but since the upgrade initially failed, that migration likely did not complete.

Additionally, since you manually updated plugin records in the database, it’s very possible that some plugin settings were changed or reset in the process.

If you don’t remember the exact configuration, it would be best to check a backup of the site and compare the previous Route 66 settings.

What to do now:

  1. Go to Components → Route 66 → Options
  2. Reconfigure your URL Patterns / routing settings
  3. Save the options
  4. Clear Joomla cache
  5. Run crawl again

Once the frontend URLs resolve correctly, the crawler will start detecting all articles normally.

If you’d like, I can log in directly and configure this for you to make sure everything matches your previous setup. Just let me know and I’ll take care of it.

Best regards,
Lefteris

Lefteris Kavadas

Hi Manny,

I’ve updated the URL patterns under the Route 66 component options, and the frontend links are now working correctly.

For reference, I set the article URL pattern to:

{articleAlias}

Since everything is working as expected now, this is the pattern you should continue using going forward (and in future versions as well).

If you notice anything else behaving unexpectedly, just let me know.

Best regards,
Lefteris

Manny Munoz

Hi Lefteris,

Thanks so much for your incredible help, that is great, it is all working okay now

I have nearly 3k pages on this blog, but the Crawl only keep detecting exactly 1,600 pages, is there a limit somewhere?

Apart from that, everything is superb, thanks again for your great help!

Best wishes,

Manny

 

Lefteris Kavadas

Hi Manny,

Glad to hear everything is working fine now.

There is no hard limit in Route 66 PRO on the number of pages that can be crawled, so the 1,600 pages you’re seeing is not a restriction.

What usually happens in cases like this is one (or a combination) of the following:

  • Some pages are not reachable via internal links (orphans), so the crawler can’t discover them
  • Pages are excluded by menu structure, access level, language, or publication status
  • Pages return non-200 responses (404, redirects, noindex, unpublished, etc.)
  • Pagination or category layouts limit how deep articles are linked internally

Route 66 crawls by discovering links, not by reading the database directly, so it can only index pages that are actually accessible from the site structure.

What you can do

Check whether the missing articles:

  • are unpublished
  • belong to categories not linked in menus
  • have access levels other than Public

If you want, you can tell me:

  • which content type is missing (articles, categories, tags, etc.)
  • whether those articles are linked through menus or category layouts

Best regards,
Lefteris

Manny Munoz

HI Lefteris,

You're right, the crawl is only grabbing pages on the spanish category articles on the blog, which happen to be that number, have just added 1 and indeed the number of crawled articles came up

I have hundreds of other articles in english that are not shown. The reason I have 2 languages is to target the Google search queries of users, so depending of whether they ask in english or spanish, I'm trying to put the relevant article on top of the searches

If you could kindly have another look as to why this english category is not been crawled, that would be absolutely brilliant

Thank you!

Manny

Lefteris Kavadas

Hi Manny,

This is not related to languages, categories, or Route 66 limits.

Route 66 crawls only pages that are reachable via frontend links.

It does not scan the database.

The pages that are missing from the crawl are simply not linked anywhere on your site. Because of that, the crawler cannot discover them.

If you believe those pages are linked, please send one example URL of an article that:

  • exists,
  • is published,
  • and is reachable via normal site navigation,

and I’ll check it immediately.

Once a page is linked somewhere on the frontend, Route 66 will pick it up automatically.

Best regards,
Lefteris

Manny Munoz

Hi Lefteris,

Thanks so much for your message and apologies for my delay in coming back to you, I've been away

Have checked today and the Crawl still only detects 1,600 pages, I don't understand what I've done wrong. If you visit Content >> Categories, you can see I have 2 x categories, one with 1,153 articles published and another with 1,555 also published. 

This page, which is published and has a link on one of the tables in this page: https://astrogradual.com/articles is not being crawled: https://astrogradual.com/venus-transit-sextile-venus

I tried to make this blog 'bilingual' when I started it 2 x years ago, and orginally I thought that maybe the Route66 crawls only one language and not the other, but no, the crawled articles contains articles in both languages I just can't figure out why half of them are missing

I'll really appreciate if you could have another look if you got time

Thank you!

Manny

 

 

Lefteris Kavadas

Hi Manny,

I’ve checked the URL you provided, and it has already been crawled.

You can see it here in Route 66:

https://astrogradual.com/administrator/index.php?option=com_route66&task=page.edit&id=721

So Route 66 is working correctly in this case.

Just to clarify one important point again:

having a page published is not enough for a crawler.

Route 66 only crawls links that it can discover by navigating the site, exactly like search engines do. This means:

  • a page must be linked from another page
  • and that page must also be linked
  • and so on, starting from an entry point (usually the homepage or menu links)

For example, even if:

  • a category is published, and
  • all its articles are published,

…if there are no menu links or frontend paths leading to that category or its articles, the crawler cannot discover them.

This is why the total number of crawled pages depends on site structure and internal linking, not on how many articles exist in the backend.

If you believe there are still articles that are:

  • published,
  • reachable via normal site navigation,
  • and missing from the crawl,

please send one example URL and I’ll check it immediately.

Best regards,
Lefteris

Manny Munoz

HI Lefteris,

Thank you so much for your amazing help 

Please go ahead and close this ticket, I can see that those pages that I'm missing, even though they are all linked on the portal, are crawled by Google but not indexed, so there must be something wrong with them

Will check at my end and any issues I'll let you know :)

Thanks again Lefteris, you're amazing!

Manny

Lefteris Kavadas

Hi Manny,

Just to clarify one last thing for the record:

Whether Google has crawled or indexed a page is not related to Route 66 here.

Route 66 only reflects what it can discover through your site’s internal links. If there is a page that:

  • is published,
  • is reachable through normal site navigation,
  • and still does not appear in the Route 66 crawled pages list,

then that would indicate a real issue worth investigating.

If you come across such a case, just send one example URL and I’ll happily take another look.

Feel free to close the ticket for now, and you’re always welcome to reach out if anything else comes up.

Best regards,
Lefteris

Note: An active subscription is required in order to get support for our paid extensions. For our free extensions, if you don't have an account, register and then submit your support request.  In case you just want to ask a question, you can also use the contact form .

Firecoders
Are you using our extensions? Please post a review at the Joomla extensions directory!
Post a review