Ubercart Quest: Clean URL for Drupal

Note: This post was created awhile back on another platform and I migrated to my current one.

Problem:

Product’s images are not showing

One possible cause mentioned in the Ubercart forum is that Clean URLs is not enabled.

Step 1: Enable `mod_rewrite`

Clean URLs requires mod_rewrite to be enabled

(Note: mod_rewrite is an Apache 2 module)

To check if mod_rewrite is enabled, run the following command:

1

/usr/sbin/apache2ctl -M

Look for:

1

rewrite_module

This is the mod_rewrite module required for Clean URLs.

Step 2: Enable `mod_rewrite` if it’s not enabled

To enable mod_rewrite, run:

1

sudo /usr/sbin/a2enmod rewrite

After entering the command, you should see:

1
2


Enabling module rewrite.
Run '/etc/init.d/apache2 restart' to activate new configuration!

To disable mod_rewrite, use:

1

sudo /usr/sbin/a2dismod rewrite

After disabling, you should see:

1
2


Module rewrite disabled.
Run '/etc/init.d/apache2 restart' to activate new configuration!

Remember to restart Apache 2 after making changes:

1

sudo /etc/init.d/apache2 restart

Step 3: Check Your Apache 2 Configuration

(I’m an Apache 2 noob, so bear with me.)

In the /etc/apache2/sites-enabled folder, create a config file for your Drupal site.

Example file: /etc/apache2/sites-enabled/drupal.conf

Basic Configuration:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


<VirtualHost *:80>
    ServerName www.example.com
    DocumentRoot /var/www/drupal-6.13
    <Directory /var/www/drupal-6.13>
        Options FollowSymLinks
        AllowOverride None
        Order allow,deny
        Allow from all
    </Directory>
</VirtualHost>

Enable Rewrite Rules

Add the following inside the <Directory> section:

1
2
3
4
5


RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?q=$1 [L,QSA]

Final Configuration:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15


<VirtualHost *:80>
    ServerName www.example.com
    DocumentRoot /var/www/drupal-6.13
    <Directory /var/www/drupal-6.13>
        RewriteEngine on
        RewriteBase /
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule ^(.*)$ index.php?q=$1 [L,QSA]
        Options FollowSymLinks
        AllowOverride None
        Order allow,deny
        Allow from all
    </Directory>
</VirtualHost>

Restart Apache 2 again:

1

sudo /etc/init.d/apache2 restart

Step 4: Enable Clean URLs in Drupal

Go to Administer → Site Configuration → Clean URLs

You should see the following path:

1

home > administer > site configuration

Enable Clean URLs.

Ta-da! 🎉 Now the product images should display correctly!

System Information:

Debian Lenny with Apache 2

For more information about mod_rewrite:
Apache module mod_rewrite