“Nine to Five” Documentation by “Magnet Co” v1.5.1


“Nine to Five”

By: Magnet Co
Email: support@magnet.co

Thank you for purchasing our theme. If you have any questions that are beyond the scope of this help file, please feel free to email via our user page contact form here. Thanks so much!


Table of Contents

  1. HTML Structure
  2. CSS Files and Structure
  3. JavaScript
  4. Installation & Setup
  5. Theme Options
  6. Sources and Credits
  7. Version History

A) HTML Structure - top

This theme is a fixed layout with two columns. All of the information within the main content area is nested within a div with a class of "focus". The sidebar's content is within a div with a class of "sidebar". The general template structure is the same throughout the template. Here is the general structure.

HTML Structure

B) CSS Files and Structure - top

The default wordpress style.css is used to name the theme and that then references css/master.css, which is the main stylesheet.

The theme settings page within the WordPress admin allows two stylesheets to be switched between for the dark and light skins. This changes the secondary css file reference between css/dark.css and css/light.css.

The theme also uses css3 to create rounded borders and text shadows where needed. All these selectors can be found in a third css file called css/advanced.css.

If you would like to edit a specific section of the site, simply find the appropriate label in the CSS file, and then scroll down until you find the appropriate style that needs to be edited.


C) JavaScript - top

This theme imports fix Javascript files.


D) Installation & Setup - top

Server Requirements

Preparing WordPress

  1. Download the latest copy of WordPress from http://wordpress.org/download/.
  2. Extract and move it to your installation directory.
  3. Point your web server at the directory and navigation to your site in a browser.
  4. Follow the WordPress installation procedure and login to the admin area.

Initial setup

  1. Under Appearance » Themes choose the Nine to Five theme.
  2. Under Appearance » Widgets select the widgets you'd like in the sidebar, below the custom theme widgets (which we'll configure a little later).
  3. Under Appearance » Menus create a top menu called Navigation and a bottom menu called Links. Add links in the order you'd like.
  4. Under Settings » General » Membership, allow anyone to register if you'd like anyone to be able to signup and post a listing (we'll handle payments shortly).
  5. Under Settings » General » New User Default Role, choose Author.
  6. Under Pages add a new page called 'Post a Job' (or whatever you'd prefer) and under the Template dropdown choose Post a Job.
  7. Under Pages add a new page called 'Log In or Register' (or whatever you'd prefer) and under the Template dropdown choose Log In or Register.
  8. Under Pages add a new page called 'Lost Password' (or whatever you'd prefer), make sure the page URL is /lostpassword/ as this is hardcoded into the login template, and under the Template dropdown choose Lost Password. If you'd like a custom URL, simply edit the auth.php template directly.
  9. Under Posts » Categories set up your job board categories. Please note that you wont see the categories appear in the theme menu until you post a job to each of them. This is a WordPress functional requirement.
  10. Under Nine to Five Settings setup the store to your liking. Help is provided in-context on the page. Also see the options section below.

Optional Extras

Nicer URLs
Under Settings » Permalinks » Common Settings, enable friendly URLs by changing to a custom structure of /%postname%/.

A better search
The search box works alot better with the Search Everything plugin enabled (available at http://wordpress.org/extend/plugins/search-everything/ and through the plugins page in the admin panel).

Approving listings
Theres a very simple way to approve job listings before they are published directly to the site. Unfortunately, its not part of the theme structure due to a WordPress requirement.

  1. Find and open the file xmprpc.php in the root of WP site
  2. Locate line 2060
    $post_status = $publish ? 'publish' : 'draft';
    and replace it with
    $post_status = $publish ? 'draft' : 'publish';

Blogging
We've included with this theme a fully separated blog section with commenting so you can boost traffic to your site by posting relevant content about your particular industry.

To post a blog entry, add the post to the Blog post type on the left menu of the WordPress admin.


E) Theme Options - top

LAYOUT OPTIONS

Enable / Disable the top Category Bar
Choose whether to display the full-width categories bar at the top of the page. Another option is to use the sidebar categories widget.

Choose from two alternate Filter bar
Select a style for the job type filters on the job list pages. Full tabs or rounded checkboxes.

Edit the filter types
Change the default Full time, Freelance and Contract to something else here.

Please note that once you set the fields for position type filters, all jobs posted after that will use these values. If you should ever wish to change these filters down the line, please update the job posts accordingly.

BRANDING OPTIONS

Edit the Custom Logo
To replace the logo used by the theme, enter the full URL of an image here. Note: It should measure no more than 300 x 80px.

Edit the Custom Favicon
A favicon is a 16x16 pixel icon that represents your site, displayed in a browsers address bar; paste the URL to a .ico image that you wish to use as the favicon.

Edit the Custom Login Image
To replace the default Wordpress logo on the login screen, enter the full URL of an image here. Note: It should measure 310 x 70px.

STYLING OPTIONS

Choose the skin
Choose a theme skin. Dark works better with dark backgrounds as the header, sidebar and footer type colors are reversed.

Choose the Typography
Choose between Helvetica (sans serif) or Georgia (serif) to set the right mood for your site.

Edit the Background Color
Choose a background color for the site.

Edit the Background Image
Choose a background image for the site.

Edit the Background Position
Choose the positioning of the background image for the site.

Edit whether or not the Background Repeats
Choose a background repeat pattern for the site.

Edit the Category Background
Choose a category colour scheme. This changes the category menu bar running across the top of the page.

Edit the Filter Background
Choose a primary theme colour scheme. This changes the sub bar style across the site.

Edit the Subtitle Background
Choose a secondary theme colour. This changes the top filter style across the site.

Edit the Title Background
Choose a title background type. This changes the background of the job permalink page and several others across across the site.

Edit the Button Color
Choose a tertiary theme colour. This changes the button and link styles across the site.

HEADER OPTIONS

Sign In Link
Enter the URL to your custom login page or leave as standard.

Register Link
The same as above, but with the appropriate ?action=register ending for WordPress to auto detect it as a register action.

SIDEBAR OPTIONS

Enable / Disable Quick Search
Chose whether or not to enable the default search widget for the sidebar. The search box appears on the filter bar on the left hand side on several pages.

Enable / Disable Search on all pages
Choose whether or not to display search on all pages (alternatively, on just those without the filter bar containing the search box).

Enable disable sidebar Categories
Chose whether or not to enable categories as a list in the sidebar.

Edit the Category Maximum
Enter a maximum number of categories to display when enabled.

Enable / Disable Smart Tags
Chose whether or not to enable a cleaner view of tags in the sidebar.

Edit the Smart Tag Maximum
Enter a maximum number of tags to display when using smart tag display.

Enable the CTA ("Call To Action")
Chose whether or not to enable the default call to action widget to encourage people to post a job listing.

Edit the CTA Button Text
Change this text to reflect what you want to be displayed on the button.

Edit the CTA Button URL
Enter the URL of the page that is used to post jobs.

Edit the CTA Caption Text
Change this text to reflect what you want the call-to-action text to be.

Enable / Disable the About Us text
Chose whether or not to enable the default About Us text widget.

Edit the About Us Text
If the about us widget is enabled, text entered in this field will be displayed. You can use basic HTML here including images.

Enable / Disable Advert
A standard advert unit suitable for a 120x90 ad with text.

Edit the Advert Content
This will insert a 120x90 ad in the sidebar. You can use javascript or basic html here.

Set a Custom Widget Order
Chose the order in which you would like the widgets above to appear. The Display Order of each is listed by each option above. 1,2,3,4,5,6 would display them all as they appear top to bottom here.

FOOTER OPTIONS

Edit the Copyright Notice
Add your copyright notice to the bottom of the site.

Add some Additional Text to the footer.
Add some optional text underneath the copyright statement. Useful for SEO.

Add your Analytics Code
Add your analytics code just before the closing tag by entering it here. You can insert javascript or basic html here.

JOB POSTING OPTIONS

Display Salary field
Allow job posters to specify the job salary.

Maximum Skills Allowed
Enter the maximum number of skills you will allow users to post for a job.

Allow Location 'Anywhere'
Allow users to be able to post jobs with a location of 'Anywhere'.

Allow Anonymous Posts
Allow users to post jobs with an anonymous company.

Allow Permanent Posts
Allow users to post jobs that do not expire.

JOB READING OPTIONS

Require resume
Use this option for enabling or disabling requiment to upload contractor resume in application form.

Allowed resume file types
Enter a comma-separated file types allowed for upload in Application Form. Or enter * to remove file types restrictions.

Max resume file size (MB)
Enter max file size allowed for upload in Application Form. PLEASE NOTE: If you entered size larger than in "upload_max_filesize" PHP directive, default value will be used.

Share button in Jobs
Use this option for enabling or disabling share button in job reading.

Share button in Blogs
Use this option for enabling or disabling share button in blogs reading.

Custom RSS Feed
Set your own RSS feed (e.g. Feedburner).

Safe Email Display
Use PHP to hide email addresses from spammers. PLEASE NOTE: This method does not guarantee the email addresses against all spam bots.

New Badge Display
Enter how many days after posting the new badge should be displayed for.

PAYMENT OPTIONS

Enable Paid Listings
Choose whether or not to charge users to post jobs.

PayPal Email
Enter your PayPal email address - this is the account which will be credited.

Default currency
Use this option to set default currency for paid listings.

Cost per Job
Enter an amount in USD to charge for each job listing.

Header Image
Enter the URL of an image (90x750px) to use when customers are using the PayPal site, if this is left blank your email address will be displayed in it's place.

Return Button Text
Enter some text to be displayed on the button users click on the PayPal site to return to post a job.


Extra

Export settings
Export your sites setup to an xml file. Does not include content. That requires a wordpress content export.

Import settings
Import your sites setup from an xml file. Does not include content. That requires a wordpress content export file.

F) Sources and Credits - top

WordPress Plugins

Search Everything

  • URL: http://wordpress.org/extend/plugins/search-everything/
  • License: http://www.gnu.org/licenses/gpl.html

jQuery Plugins

jQuery Autocomplete

  • Version: 1.1
  • URL: http://bassistance.de/jquery-plugins/jquery-plugin-autocomplete/
  • License: http://www.gnu.org/licenses/gpl.html
  • Author: Jörn Zaefferer

jQuery PNG Fix

  • Version: 1.2, 09.03.2009
  • URL: http://jquery.andreaseberhard.de/
  • License: http://www.opensource.org/licenses/gpl-license.php
  • Author: Andreas Eberhard

jQuery Select Skin

  • Version: 1.0.4 (03/03/2009)
  • URL: http://www.lotsofcode.com/javascript-and-ajax/jquery-select-box-skin.htm
  • License: http://www.gnu.org/licenses/gpl.html
  • Author: Colin Verot

jQuery UI

  • Version: 1.8.1
  • URL: http://docs.jquery.com/UI
  • License: http://www.gnu.org/licenses/gpl.html
  • Author: http://jquery.org/team

jQuery ColorPicker

  • Version: 23.05.2009
  • URL: http://eyecon.ro/colorpicker/
  • Licence: http://www.gnu.org/licenses/gpl.html
  • Author: eyecon.ro

G) Version History - top

Version 1.5.1

Additions

  • Added a directory warning permission for file uploads
  • Added Dutch language file courtesy of neefje
  • Database requests reduced and optimised for site speed

Fixes

  • File upload bug with session storage fixed

Version 1.5

Additions

  • Adapted for WordPress 3.1
  • Custom job category menu items
  • Database requests reduced and optimised for site speed

Fixes

  • Post a job link fixed when permalink disabled
  • Default job expiry date adjusted to 7 days
  • Top and bottom navigation as editable WP Menus
  • Logout link redirects back to same page
  • All fields translatable

Version 1.4

Salary and Benefits fields added

You can now add these optional fields to each job posting.


Multiple payment currencies added

Its now possible to set the currency to something other that just USD.

Version 1.3

File Upload Re-written

Due to some incompatibilities with html5 and javascript upload securities the file upload functionality was completely rewritten.

  • single.php
  • header.php

As an additional feature it now includes a graphical progress bar.


Fixed an issue with &

  • postajob.php

Version 1.2

Post a Job template

Completely rewritten the postajob template to function without requiring xml-rpc or the admin password.


Language Translations

Moved all english language snippets into a .PO file format to allow localisations in future releases.
Upcoming

  • French
  • German
  • Spanish
  • Italian
  • Dutch
  • Russian
  • Chinese (Simplified)


Inactive states

Adjusted the UI for the job list templates to hide the inactive filtered jobs instead of greying them out.
Edited:

  • index.php
  • search.php
  • archive.php


Register link on postajob

Added a register link on the postajob message "To post a job you must be signed in".
Edited:

  • postajob.php


Commenting

Added user commenting to the blog templates.
Added / edited:

  • comments.php
  • single-blog.php


Blog Permalinks

Enabled permalinks for the blogging section.


HEX Editor

Added visual HEX colour selector.


Custom login and registration pages

Added:

  • auth.php
  • lostpassword.php

Version 1.1

Editable Filter Types

Added ability to rename and adjust the filter types.
Changed filter code block in:

  • archive.php
  • search.php
  • index.php

Corrected form fields in:

  • postajob.php

Corrected ajax functions in:

  • header.php

In the theme settings an option was added for Filter Types. Edited:

  • functions.php

Initial Theme Settings Autosave

Added initial save settings to db routine to avoid issues with postajob template on first use if neglected to save the Settings at least once in admin area.
Changed files:

  • index.php
  • header.php
  • functions.php

Version 1.0

Initial launch version


Once again, thank you so much for purchasing this theme. As we said at the beginning, we'd be glad to help you if you have any questions relating to this theme. No guarantees, but we'll do our best to assist. If you have a more general question relating to the themes on ThemeForest, you might consider visiting the forums and asking your question in the "Item Discussion" section.

Magnet Co.

Go To Table of Contents