Search

Running our new site for the first time

Tue Jul 28 19:42:21 2009 Posted by

Ok. Now our new site is ready. Lets try to open it in our favorite browser by entering the URL you set to be the one for this site. So if for example you set www.example.com just enter this URL in your browser's address bar and...



Some quick info for the screen above:
What you actually see is your newly created site. There is no content at the moment because there is no active module.

The only thing we have to do now is to Edit our site once and set the main module. Then you should activate this module and set the permissions for this module (We will later explain how to do this). If you set the User Manager module to be your main module, the site will look like this:


____________

Creating a site

Tue Jul 28 19:35:05 2009 Posted by

Creating a site with Qool is pretty straight forward. Click on the Create a new site link on the system wide options section and you will get this page:



The options are explained here:

  • Site Key
    Each site must have a unique name that will let Qool install modules for it without messing up all other sites. It should be a word without spaces and special chars except the underscore “_”. Choose this name wisely and note it down cause you will not be able to change it later.

  • Site Title
    This will be your site's title. You can change it later.

  • Keywords
    Keywords are used to fill the meta keywords value of each page in your site. So if your new site is about sports, then some good keywords could be soccer, basketball, premiere league etc.

  • Meta Description
    Describes what your site is about. Useful for search engines.

  • Slogan
    The slogan is a line of text that in some templates might follow your title and in others it will be placed in the footer.

  • Footer Message
    Some HTML code or plain text to put on your site's footer.

  • Authorization Type
    Whether the site will use Sessions or Cookies to track user activity.

  • New Users
    Whether new users need to verify their email upon registration.

  • Main Module
    Which module to set as the main module for your new site. For new sites only the System module is present. After creation all active modules will be listed there.

  • Rich Text Editor
    Which RTE to use. Some options are: TinyMCE, FCKEditor, Yahoo Editor and more...

  • # of page reloads before the anti Spam system starts to work
    We give a number of times a page has to reload in a specified time for the anti Spam system to start anti flood protection.

  • Duration of Spam ban in seconds
    Set the time a user will be displayed the banned page for in seconds. So 300 seconds is 5 minutes.

  • Default Template
    Set the default template for this site.

  • Default Language
    Choose the language you want the Qool interface to be displayed.

  • Site Url
    Now this is very important. If for example you have installed Qool on
    www.example.com and you want to create a site for sports like: http://sports.example.com then fill the field with sports.example.com omitting the http:// part.

  • Site Status
    This is where you set if you want your site to be published or not. This is very useful if you want to publish the site later but let users see a message that the site is under construction.

  • Site Password
    Site password is very important because you will need it every time you edit your site. Note this down too cause you will not be able to change it through the admin panel any more.



For the example I will use these settings (I omit some for convenience ):

  • Site Key : sample

  • Site Title : This is a new site

  • Slogan : The Ultimate New Site

  • Footer Message : The New site is powered by me and © by myself

  • Rich Text Editor : Yahoo Editor

  • Default Template : Art

  • Site URL : www.example.com

So lets create a new site. We fill in the fields like the image above and we hit the Create button. The system informs us that the site has been created and that the default modules has been installed. Then it will redirect us to the admin panel and we should see something like this:



Some quick info for the screen above:
We can see that there are 2 sites now listed in the Available Sites Section and that the second site has been selected. Just below you can see the installed modules of this site and the module blocks for each module if any. There is also a new section called Available Modules Section. This will be explained later .

Now lets explain what just happened.

When you hit the Create button, Qool starts some internal checks to see if all is OK for the site to be created. Then if all is OK, Qool creates some database tables and stores some settings to the database for this site. After that, the system creates the folders needed for this site to work. These folders are:

  • /assets/2/ Where “2” is the id of the site just created

  • /assets/2/media/

  • /assets/2/images/

  • /assets/2/files/

  • /assets/2/flash/

____________