Configuring ClassiScript - a Step by Step Guide

Purpose of this tutorial is to guide the user through the whole process of creating a classifieds website with ClassiScript - installation, setting everything up, going live.
Note: it is not yet complete and is still being updated.

It may seem like a lot of reading at first glance, but this is basically everything you will need in order to have a fully functional site.

We will also provide another tutorial soon about what could be done after going live in order to popularize the site - how to fill it up with classifieds, monetization tactics, etc.

So lets start.


Installation should usually take about 4-5 minutes, it's described in detail here: You'll need some knowledge on how to create a database and work with cPanel and FTP.
But if you are not familiar with those we also offer free installation, so if you want us to install it on your hosting, drop us a line from the Contacts page.

After install completes you should get an administrator account. Login with it and you'll get into the Administration panel.

Choosing Your Language

A good place to start would be to select the language(s) that your site will use.

Go to Admin -> Languages (example) and make sure that only the language(s) that you use are active.
Then go to Admin -> Settings (example) and in the Default language field put your default language. If you have a single-language website then the default language will be obvious.

For multi-language websites you'll need to decide which will be your main language and which will be secondary. The main (default) language is the one that will open up when users first visit the site. They can later switch to another language by clicking the country flag in the header.
If you are not sure about the main language, then it's best to use the language of the country for which the site is intented - this will make sure your target users feel 'at home' and not on some foreign website.

Note: it is important not to change the default language once the site goes live, because it will cause your URLs to change, which is considered to be bad for SEO (well not too bad, but should be avoided, especially when you have lots of pages).

Configuring Header Logo & Footer

The header logo and footer links are configured through the Custom Blocks section in Admin panel (example).
Custom blocks are small pieces of HTML that are displayed somewhere on the site. Each of those blocks has their fixed position, for example:

  • header-1 - block that will be displayed in the top of the page (before the "Welcome, Guest" links).
  • header-logo - holds the main logo in header.
  • footer-copyright - holds the footer content.

An important thing about custom blocks is that they are localizable fields - this means they can be different for each language. Localizable fields are marked with the respective country flag next to them.

So to configure your header logo - click edit on the header-logo custom block and inside the HTML field put something like this:

    <a href="/" title="Home" class="plain">
        <span class="main_color">Your</span>
    <br/><span style="font-size: 16px;">some tagline here</span>

Of course this is just an example, you can change it to anything you want.
Remember this text will be available only for the language shown by the respective country flag. If you have other languages you'll need to go to the translations page for that language and change the translation for header-logo.

To edit the footer text - do the same procedure for the footer-copyright custom block.

Configuring The Homepage

The homepage is configured from Admin -> Static Pages (example). You should first check the documentation for Static Pages to get an idea of how they work and what are Shortcodes.

After that click edit on the 'home' row and in the HTML field you'll see the contents of the homepage. It's a mixture between HTML and shortcodes.

Typically the homepage may look something like this:


<div style="height: 80px">&nbsp;</div> 

[list-latest-classifieds num="10"]

The [list-categories] shortcode, as the name says, will display a list of categories.
Below it there will be an empty space 80px high.
[list-latest-classifieds num="10"] is another shortcode that displays the 10 latest classifieds.

Static pages are again localizable fields, so if you use more than one languages, make sure the other languages also contain the same code for the homepage.

Even when you configure the homepage, it may still look empty when you open it - this is because there are no categories and ads to list. We will do this now.

Creating Categories

This part is explained in detail in the documentation page for Categories. It explains how to create categories and subcategories, what are their properties and how to define category-specific fields for the classifieds.