Create your brand

Customization guide

To understand all the job board features and get familiar with the product we will go through the main settings. To customize your project open the administration area and follow our recommended CHECKLIST. After any changes, please click top right menu – “CLEAR CACHE” to refresh and activate new settings.

 

1. Change the admin access credentials

Data security comes first. Manage your password in the Admin -> Settings -> Change your password section.

 

2. Main Settings

Enter website name, set job expiry time in days and save your timezone.

 

3. Look & Feel

Add your logo by clicking and uploading the image. In this section you can set a default company logo as well. If an employer signs up but does not upload the logo, the default one will be used instead.

In the next step manually – via file manager (not from the Admin) upload the fav-icons (fav.png [square], fav-ios.png [square], fav-startup.png [320×480]) in the public_html folder. Make sure the icons got the same name, so they will get properly replaced. If you need to adjust the logo – change its size or location, visit Admin -> Custom CSS section and add simple style directions for correction.

logo-setup

If you wish to use your own social media share image for Facebook, Twitter, G+ and Linkedin, upload “share-image.png [1200×630]” into the public directory as well. When somebody shares a job from your website, this is the image that will accompany that social media post. To change the social media links in the footer, add the URLs. If you leave these empty, they won’t be shown.

Setup the homepage – choose which page will be served first to the visitors. Display job listings or show a landing page to explain your project.

 

4. Pagination

Manage how many job ads, job applications and subscribers will be displayed on a single page.

 

5. URL / Routing

Change the job board page routes. Rename to your custom ones, or translate them into your language. Beware of the format, use lowercase strings without spaces and special characters.

 

6. Security / SPAM

Activate / deactivate job moderation. When activated, company job ads have to be “approved” by you, before they get published. Activate / Deactivate captcha Anti-Spam feature for contact and sign up forms.

 

7. Mailer

Make sure that you have completed the email setup from our installation guide. Enable SMTP and customize the “SENT FROM” field.

 

8. Manage static pages

Each page you create is automatically creating a file on the server. For example if you create a page in admin called “mypage”, this will create a new file “_tpl/{THEME}/static/static_mypage.tpl”. In the admin section you can manage links, pages and orders. To change the content of a static page simply insert your texts and HTML into relevant file. You can use free online page builders like layoutit.com, where you build the UI, download the code and insert it into your job board page. There is a possibility to switch the mode and create an external page, pointing to your existing content / site.

 

9. Fill in SEO

hosting-banner-new
SEO manager will boost your presence in the search engines. Fill in the page titles, keywords and descriptions. Connect Google Analytics.

10. Set up job categories, locations and types

Beware of the permalink / URL format. Write these in lowercase without spaces and special characters.

 

11. Set up and manage language translations

Need your website in Hindi, German, Spanish, Portuguese, French, Czech, Russian or Chinese? These translations are included by default. Open “_config/config.envs.php” and change the website language to the one above. Example: ‘lang_code’ => ‘xy’, where xy is the code of your language (“hi”, “de”, “es”, “pr”, “fr”, “ru” and “cn” for the above).

How to translate the website wording and change some strings? Open Admin -> Translations -> Edit translations and select your language. Search for the string / text and change the value. After you click away from the input new value will be saved and you will get notified by a popup message. Clear cache to refresh the templates with new translations.

 

12. Set up email templates

All email templates can be found in the Admin -> Translations -> Edit translations section. Search for the “email_” string to find them quickly. Easiest way to change the template is to copy it into external editor, change it there and copy it back afterwards. This applies especially to HTML emails. Fast and satisfactory way is to use plain emails, without any formatting. You only need to keep the {bracket} structure, as the word in between the brackets will be replaced with dynamic content. (e.g. Your application for {JOB} —> will become –>Your application for Website Developer in NY).

If you want to test all your email templates at once, open index.php, find the line “email_debug.php” and ucomment it. Open it (“_tools/email_debug.php”) and set email address where the test emails will be delivered. After you reload the website, you will receive all the existing emails. This way you can do some troubleshooting / designing of the templates.

 

13. Change the design

Want to change the design / colors quickly and easily? Open Admin -> Settings -> Custom CSS and look inside the input area. Here you can find predefined website elements for every part of the job board. Simply add your styles, change the colors and reload the website. That will do the trick.

styles

In this section you can easily change the background image of the landing page:

#headerSection {
background: url(‘http://yoursite.com/uploads/YOUR_IMAGE.png’) no-repeat center center fixed !important;
}

and also background image behind the searchbar on the job listing page:

.sub-header {
background-image: url(‘http://yoursite.com/uploads/YOUR_IMAGE.png’) !important;
}

Add your custom graphics that represent your niche and distinguish your project.

Need more complex changes? In the “_tpl/{THEME}/css” folder you can find main website stylesheets. Amend these directly, or use “_tpl/{THEME}/sass/main.scss” SASS file and compile it.

 

14. Setup data feeder

Data feeder is a feature that allows you to easily populate the job board with data. From this section you can quickly post jobs, create new companies and candidate profiles (premium) . This is especially useful for anyone in the recruiting business who wish to place candidates himself. Jobs posted are by default owned by the administration company. In your project, you should change the company details to match your profile.

3

a) Step 1 – change the administration company email to yours. In the email box that you setup you will receive all the job applications and CVs.

first-step

a) Step 2 – via Admin -> Companies -> Detail login into the employer area and change the company details. Add your logo, timeline picture, customize the address and other fields. Just make sure the employer name will be left to “Admin” (in dashboard settings section), as this is not being used anywhere in front-end, but it is used to identify the admin profile.

step-2

 

15. Schedule job board maintenance

It is useful to schedule a Cron job for the “_tools/cron_maintenance.php” script to run daily. This removes or deactivates (according to settings) all the temporary and expired jobs from the job board, automatically. You can read more how to do this below in the section “16.”.

 

16. Set up job alerts / newsletter – the easy way

hosting-banner-new
The easiest way to send out a newsletter, is to use a transactional email provider. Go to Admin -> Subscribers -> Export to CSV, to export all email addresses into external file. You can after import this into any online service such as Amazon SES, Mailchimp, Mandrill, Elastice Mail or Sendin Blue and send out the bulk emails.
 

17. Website maintenance and automatic job alerts / newsletter

On the website, we would like to do some cleaning, to keep the database small and efficient. Otherwise the expired jobs and data would just accumulate over the time. For less experienced users, there is a cleaner created in the admin. Every now and then, you can clear / deactivate all the expired and temporary jobs from your website, with a click of a button.

There are 2 options what to do with the expired jobs in your job board. This option can be switched in Admin -> Settings -> Main Settings -> Expired Jobs Action. You can either deactivate (keep and archive) expired jobs or delete them completely.

Very useful for the maintenance of your job board is to setup automatic scripts (“Cron jobs”), that will do the job for us, so we do not need to click anything. We mention 2 ways how to set up a Cron job:

 

Shared hosting Cron jobs

Check with your hosting provider, what are the requirements to create & schedule a Cron job. Some of them easily let their users to execute long running PHP scripts and some of the providers restrict it. You can create a new Cron job from the cPanel account panel, as shown on the image below. First you select a PHP script that you want to run and then set a time when it will be executed. This way you can schedule the newsletter & maintenance scripts that have been already prepared for Simplejobscript. You can find these in the “_tools” folder.

cron

 

Custom hosting Cron jobs – Geeky part

In “_tools” folder, you can find some useful scripts for website maintenance and newsletter. These are great candidates to put inside Cron, and make them run automatically. Firstly, lets install the tool. For Ubuntu / Debian run:

sudo apt-get install cron

Access crontab scheduler crontab -e. Craft your command and save it. Use example below to get an idea on how does it work. Example:

0 0 * * * cd /var/www/yourproject/_tools && php cron_maintenance.php > logs/cron_maintenance.log /dev/null 2>&1

Code above will run every day at midnight, delete all the expired and temporary jobs and log the result messages into a file. Example to setup a newsletter:

0 1 * * 1 cd /var/www/yourproject/_tools && php cron_weekly_newsletter.php > logs/cron_newsletter.log /dev/null 2>&1

Cronjob above will run once a week at 1AM, get all the latest jobs from the database, create a list of subscribers – and send them a newsletter email with latest job opportunities, organized by the category of their interest (I subscribed to marketing jobs, therefore I will receive only latest marketing jobs). For newsletter it is recommended to take a look at your email provider / server settings. Due to the fact that email sending might get blocked. Simplejobscript newsletter script by default sends out 90 emails in 24 hours – to prevent a blockage from email provider. You can distribute this number throughout the week (7 * 90 emails), to bypass provider limits. Or alternatively, sign up with transactional email sending service / paid SMTP plan to send more.

 

18. Change the code

Need to develop custom features? This is how the job board works code-wise. Website follows Model-View-Controller software architecture. Data is stored in the MySQL database, front-end is handled by the Smarty templating engine and PHP controllers are connecting these two main components.  Folder structure overview:

  • root folder important files: website installer.php, main website router index.php and all the ajax-call php files
  • sjs-admin  admin controllers and templates located within same folder
  • blog  website blog related files
  • _cache – main settings, translations and SEO are stored here, so they can be accessed repeatedly without loading
  • _config website configuration. The only file to edit is config.envs.php. Set up database connection, website language, register your plugins, change URLs 
  • controllers – main functionality is in here. Index.php is delegating web requests to this folder. Here, front-end templates are being assigned.
  • _lib – all website classes, working with the database
  • _tools – website translations, cron job scripts
  • _tpl – website templates. To create your custom theme, create a folder and change the main settings in admin.
  • js – website assets and libraries. Admin support files.
  • plugins – additional functionality
  • uploads – website uploads – images, logos, invoices, CVs

 

Premium plugins setup
To read more on how to setup the PayPal payments, Indeed and other premium plugins visit our plugins guide section.

 

Download Simplejobscript HERE