Use categories, countries, regions or cities as subdomains

It’s not plug and play configure Osclass or any other service to work with multiple subdomains. There are three steps:

  • DNS Wildcard
  • Apache Wildcard
  • Osclass subdomain configuration

DNS Wildcard

First of all you need to let know to the whole internet which IP resolve any of your subdomains. So, will resolve the same IP as

In the examples I will use as your IP server and as a domain You should replace this values for your IP and domain. Furthermore, I’m not sure if the following solutions varies depending the DNS Manager you use but here I put two examples:


*    A


As you can see the value you have to change is the A record. Finally, if you have another subdomain pointing to another IP, you should just specify it before the *.

Once you’ve done this, it could take up to 24 or 72 hours to take

Apache Wildcard

I’m not sure how it can be done in each specific hosting service, so I would explain what you have to specify in the VirtualHost configuration.

<VirtualHost *:80>
    ServerAlias *

    CustomLog /var/log/apache2/example.net_access_log combined
    ErrorLog /var/log/apache2/example.net_error_log
    <Directory /var/www/>
        Options -Indexes FollowSymLinks -MultiViews
        AllowOverride All
        Order allow,deny
        allow from all

What we’re saying with this configuration is that all the petitions that come to any subdomain of will go to the folder where Osclass is installed.

Changes in config.php

In order to accept any subdomain, Osclass’ config.php have to be modified, the line that contain the WEB_PATH have to be changed to


define('WEB_PATH', 'http://'.$_SERVER['HTTP_HOST'].'/path/to/Osclass/');


Cookies configuration

Cookies have to be set to accept all subdomains as only one website, change your php.ini file, search for the line

session.cookies_domain =


and change it to


session.cookies_domain = .domain.tld

Note: From Osclass 3.3 and newer versions, if you’re not able to modify your server’s configuration files, you could define COOKIE_DOMAIN in the config.php

define('COOKIE_DOMAIN', '.domain.tld');


Note: It’s important to have a “.” (dot) before the domain. Do not include “www” or anything else.


Osclass subdomain configuration

Now we have to specify which type of subdomain we want: categories, countries, regions or cities. You can change this configuration in your oc-admin > Settings > Advanced.

Let me know if you have problems with your configuration in the comments of this post.