1. Install‎ > ‎

Guide for IIS


Requirements

Before proceeding, make sure you have PHP 5+ and IIS 7+ with CGI enabled and either Microsoft's URL Rewrite module or ISAPI_Rewrite 3.


Install Procedure

If the requirements are met, follow these steps:


Download

Download the latest version from http://www.jobberbase.com/download (if you haven't already done this) and unzip it.


Database setup

Before setting up the database, there are some things that you should be aware of: some hosting companies don't allow you to have more than one database (usually in case of low-end (very cheap or free) hosting plans). If that's your situation, follow the next step (Single database hosting), otherwise jump to step "Multiple database hosting".


Single database hosting

 If you know that this is your case, then please follow these steps:

  1. You must decide for a string (you can use jb_, for example) which will be prepended to every jobberbase table name. You will have to set this string in the DB_PREFIX field that is described in step 3.

  2. Open jobberbase.sql in a text editor of your choice and use its find & replace feature, as follows (Hint: in the find & replace dialog, there's usually a button (Replace All, in case of Notepad) for replacing all the occurrences at once):

  3. Replace all occurrences of CREATE TABLE IF NOT EXISTS ` (note the ` char ) with CREATE TABLE IF NOT EXISTS `THE_STRING_THAT_YOU_DECIDED_ON (for example, CREATE TABLE IF NOT EXISTS `jb_).

  4. Replace all occurrences of INSERT INTO ` with INSERT INTO `THE_STRING_THAT_YOU_DECIDED_ON (for example, INSERT INTO `jb_).

  5. Save your changes and then open phpmyadmin, select your database and then import your jobberbase.sql file.

  6. Skip step "Multiple database hosting" and continue with "Environment Setup".


Multiple database hosting 

Create a new database and import db/jobberbase.sql into it (usually done from within phpmyadmin).

Note: PHPMyAdmin instructions: Create a new database (example: jobberbase) in the database window and no need to change any of the default settings. Click Go and the database is live. Now click import from the list of menu items in the top section and select the jobberbase.sql file from your local machine. After refesh you should see the list of example content tables on the left side panel. If any of these things did not work for you then you need read the manual that comes with PHPMyAdmin and try again).


Environment and code setup

In order to install jobberBase, you need FTP or SSH access, to upload all the files. jobberBase is software that you host on your server.


Directory structure and permissions

Upload the contents of the public folder to your server. Some users make the mistake that they upload the public folder, but instead you should only upload the files and folders contained in the public folder.

Make sure that the following folders have write permission:

  • /uploads (uploaded resumes are temporarily stored here)
  • /_templates/<YourTheme>/_cache (smarty cache) - by default, YourTheme is a folder called default
  • /admin/_templates/_cache (smarty cache)

Note: Go to folder options and un-check the 'read only' option to enable write access.


Translations

Translations are located under the theme folder, i.e. /_templates/<YourTheme>/_translations

Translations for text elements in the site (except pages, job category names and others such as these) are located in an .ini file, in the translations folder, the default being translations_en.ini.

Email translations are stored in an xml file, under _translations/_emails, the default being emails_en.xml.
 

Config and environments

A single jobberBase instance/codebase can run under multiple hosting environments. The config system allows you to define environments (such as the one on your local/development machine, a staging environment and the live/production server). 

These environments have to be manually defined in _config/config.envs.php, as PHP arrays. The default environment (suited for local hosting) looks like this:

$__instances['local'] = array(
// should be a unique part of the url (or the entire url if you wish)
'prefix' => 'localhost',
// mysql credentials
'db_host' => 'localhost',
'db_port' => 3306,
'db_user' => 'root',
'db_password' => '',
'db_name' => 'jobberbase',
'db_prefix' => '',
// your site's full url
'app_url' => 'http://localhost/jobberbase/trunk/public/',
// error reporting
'ini_error_reporting' => E_ALL,
'ini_display_errors' => 'On',
// environment setting 1 (use 'local' for localhost/testing OR 'online' for live, production environment)
'location' => 'local',
// environment setting 2 (use 'dev' together with 'local' in the previous setting OR 'prod' with 'online')
'environment' => 'dev',
//use 'apache_mod_rewrite' for Apache hosting or 'iis_url_rewrite', 'iis_isapi_rewrite' for IIS hosting
'rewrite_mode' => 'apache_mod_rewrite'
);

Each environment is defined as part of the $__instances array, with a unique key (e.g. local).

Change the value of rewrite_mode accordingly - either 'iis_url_rewrite' if you are using Microsoft URL Rewrite module or 'iis_isapi_rewrite' if you are using ISAPI Rewrite module.

Note: Only change db_prefix if you've followed step 2.2.1 (single database hosting).

Note: some users are having trouble setting the db_host. To find out your database host, either ask your hosting company or login to phpmyadmin and you should have somewhere in the upper area the string Server and next to it an URL or IP. That's what you should put as database host.

URL Rewrite

For Microsoft URL Rewrite:

- copy web.config from the docs/install-iis folder to your JobberBase root folder

- copy web-admin.config from the docs/install-iis folder to your JobberBase "admin" folder and rename it to web.config

For ISAPI Rewrite:

- copy .htaccess from the docs/install-iis folder to your JobberBase root folder (an .htaccess file already exists in the root folder but you can safely overwrite it)

- copy .htaccess-admin from the docs/install-iis folder to your JobberBase "admin" folder and rename it to .htaccess(an .htaccess file already exists in the root folder but you can safely overwrite it)

- if you still get a 404 (page not found) error, try to uncomment (by removing the # char from the beginning of the line) the #RewriteBase / line from your root .htaccess and the #RewriteBase /admin line from your admin .htaccess


Testing the site

If you've went through all previous steps, you should be done. 

Open up a browser and type in your site's URL (e.g. http://www.yoursitesnamecomeshere.com/).


Admin

Assuming that your Jobberbase installation is located at http://www.yoursitesnamecomeshere.com/, you can access the administration panel by visiting http://www.yoursitesnamecomeshere.com/admin/

This section is password protected, the username being admin and the default password admin

After the first login, be sure to change your password!

In the administration panel you can:

  • change settings regarding site details, job pagination, mailing options, url options and lot more
  • view all the jobs, activate the new ones, delete jobs, edit jobs, post a new job
  • change the cities (add/edit/delete) that are included by default in Jobberbase
  • change the categories (add/edit/delete/reorder) that are included by default in Jobberbase
  • change the header/footer/sidebar links
  • view statistical information
Comments