Bugshooting Search Engine Friendly URLs in Joomla 2.5

Sometimes Joomla URLs can be tricky to set up and this tutorial will show you how to bugshoot problems with them in Joomla 2.5.

Installations on your computers are particularly problematic and my advice would be "don't worry about Search Engine Friendly URLs on your computer". After all, search engines don't index your computer.

Here are some possible solutions if you are having URL problems on your live server:

How Do You Know You Have a Problem?

It will be hard to miss if you have Joomla URL problems. Your site might look normal:

tutuploadsmedia_1314217807911.png

But if you click on any of the links, you'll get an error message:

tutuploadsmedia_1314217844947.png

Solution #1

Go to the administrator area of your Joomla site and click on Global Configuration:

tutuploadsmedia_1314217924834.png

Set "Search Engine Friendly URLs" to No. Then check your site again to see if this has resolved the problem.

tutuploadsmedia_1314218184402.png

That will solve the probem in the short-term.

If you do want to keep bugshooting the URLs, follow these next steps:

#2: .htaccess file

Next we're going to test the file that is essential for Search Engine Friendly URLs: .htaccess.

First, we need to login and see our files. In this example we're going to use CPanel which is the same hosting software we use in Joomla Explained.

Start by logging into your CPanel:

tutuploadsmedia_1314218653047.png

Find and click the "File Manager":

tutuploadsmedia_1314218719861.png

Make absolutely sure that you click the "Show Hidden Files (dotfiles)." box. Otherwise you might not be able to find the .htaccess file because some systems will hide it from view.

tutuploadsmedia_1314218916490.png

Find your Joomla files. They will look like the image below. Scroll down and find the .htaccess file.

tutuploadsmedia_1314218955673.png

Select that file and click "Edit" at the top of the page. A new screen will open like this. It might not look 100% the same, but it should look very, very close.

tutuploadsmedia_1314219178942.png

So what happens if either you don't have any .htaccess file or yours looks nothing like this?

We need to download a copy of the file from Joomla.org. Head there and download a fresh copy of Joomla 1.7:

tutuploadsmedia_1314219461499.png

Download the Joomla 1.7 files and extract them. You're looking for htaccess.txt:

tutuploadsmedia_1314219504729.png

Back in your CPanel File Manager, click Upload.

tutuploadsmedia_1314219572670.png

Browse and upload the htaccess.txt file that you just found.
Once it's uploaded, select the file, click Rename and rename it to .htaccess (Rename any existing .htaccess files to something like .htaccess-backup)

#3 Check Your Server

Edit your .htaccess files and place only these lines inside:

RewriteEngine On
Options +FollowSymLinks
RewriteRule ^joomla\.html https://www.joomla.org/? [R=301,L]

Now point your browser to: https://www.example.com/joomla.html (replacing example.com with your URL)

If it redirects you to joomla.org then mod_rewrite is working. If it gives you an error then mod_rewrite is not working.

#3: Working with Your Host

If the .htaccess file didn't help, my next advice you would be to talk to your host and ask them about URL rewriting.

If at all possible, use one of the hosts recommended here if possible: https://www.ostraining.com/hosting/. Some bad hosts and some hosts such as GoDaddy and Network Solutions are notorious for URL problems with all sorts of websites.