webJobs™ v1.0 Installation Manual
http://www.webscribble.com/products/webjobs/
Copyright © 2004 Web Scribble Solutions, Inc. All rights reserved.

Table of Contents

webJobs™ Overview

Features

System Requirements

License Agreement

Brief Installation Instructions

Detailed Installation Instructions

Frequently Asked Questions

webJobs™ Overview

webJobs™ is a unique product that allows you to easily set up and maintain a job-searching site where employers and job seekers come together to satisfy each other's needs. webJobs™ provides an easy billing system, extensive searching capabilities, and intuitive resume and cover letter uploads.

From the creators of the popular webDate™ matchmaking site software, webJobs™ offers you the customizability and ease of installation that you've come to expect from Webscribble, without a need for special modules or extensions. Of course, you are also welcome to take advantage of our technical support or free installation services, if desired.

With a completely reconstructed Smartway administrative backend and page generation engine, webJobs™ offers exciting new levels of customizability. The new engine allows for multiple languages, customizable error messages, time zone adjustments, XML-based form customization, and more!

back to top

Features

Main Features

• Fully-featured job searching and posting system, including resume and cover letter uploads, resume searches, and easy an billing system.
• Fast, easy installation: With our easy installation instructions, you can be up and running within minutes!
• Easy-to-use administrative backend: Based on the popular webDate™ administrative system, but completely reconstructed for additional features, you can manage and customize your site from the Web!
• Completely configurable layout: webAffiliate™ uses templates, language files, and XML form files, which means that it's only a matter of editing these files, either yourself or through our easy-to-use Web-based interface, to make custom changes or to integrate webJobs™ seamlessly with the rest of your site.

User Interface

• Internationalization: webJobs™ allows each user to view the main webJobs™ pages in his or her own language. In addition, users can select their own time zone.
• Registration: webJobs™ provides an easy registration system for both employers and prospective employees.
• Upload system for job seekers: Job seekers can upload resumes and cover letters through their webJobs™ member area. As the administrator, you can set limits on file sizes and number of uploads.
• Job Searching/Applying: Job seekers can search for job postings by a wide variety of criteria. Additionally, they can set a "job agent" to monitor new postings for them and email them when a new job meets their specified criteria. If they find a job in which they're interested, webJobs™ even provides them with a way to apply for the job online.
• Employer Job Posting: Employers can easily post jobs and billed appropriately. To save time, they can buy multiple postings at once. Employers can track how many times a job has been viewed or applied for.
• Resume Searching: Employers can purchase packs of resume / job seeker searches (size determined by the administrator).

Administrative Area

• Web-based configuration: You can edit your MySQL configuration, administrative password, default settings, and more.
• Manage billing: You can decide how long a job posting should last and its cost, and the cost and size of resume search packs.
• IP banning: If a user is causing trouble, you can deny use of the site based on IP address. Wildcards are recognized, so that, for example, you can ban an entire Class C group if necessary.
• Censor submitted postings and files: You would hope that job postings and resumes wouldn't require censoring, but we provide a word censor just in case. Alternatively, you can use this to provide automatic text replacements for other purposes, such as correcting common typographical errors.
• Customize HTML templates: If you know HTML, you can edit, directly over the Web, the templates used by the webJobs™ system, saving the hassle of downloading and re-uploading.
• Customize emails: Modify the emails automatically sent out by the webJobse™ system.
• Customize the text used: Almost every piece of text used in webJobs™ pages can be changed, by editing the language files, the form files, or the dropdown select box database.
• C: Send an email to all members, employers only, or job seekers only. Emails can be sent in HTML or plain text.
• Member management: As the administrator, you can manage your members and review employers' billing history, if necessary.

back to top

System Requirements

In order to install, you will need the following:

1. A licensed copy of webJobs™.
2. A .ZIP decompression utility, such as:
   • WinZip (PC)
   • Info-ZIP unzip (Linux, often installed with many distributions)
   • MacZip (MacOS)
3. An FTP client program, such as:
   • WS_FTP (PC)
   • SmartFTP (PC)
   • Fetch (Mac)
4. A web server running PHP 4.1.0 or newer with the XML extension (a fairly widespread extension) and Zend Optimizer. NOTE: Windows/IIS is not officially supported. Apache running on Windows is supported.
5. MySQL version 3.23 or newer.
6. A basic understanding of HTML and preferably CSS.
7. A basic understanding of installation scripts.

Although not required, you may wish to have either an ASCII text editor, such as Notepad, or a web page editor, such as Macromedia Dreamweaver or Microsoft FrontPage, in order to edit the HTML templates offline.

back to top

License Agreement

The webJobs™ product is licensed, not sold. You may use it only under terms of our license agreement, which can be found at http://www.webscribble.com/products/license.shtml. By installing this software, you agree to be bound by the terms of this license.

back to top

Brief Installation Instructions

Follow these instructions if you are knowledgeable about using FTP and configuring MySQL databases. If you would like a more in-depth guide, please see the Detailed Installation Instructions section.

1. Unzip, into a temporary local directory, all of the files that you received on the installation CD or in the email attachment. Make sure that the ZIP program retains the directory structure.
2. Connect to your web host via your FTP program and upload all of the files (except phpinfo.php, which is provided as a convenient diagnostic tool) to your public HTML directory (or a subdirectory). Again, make sure to preserve the directory structure.
3. Set the permissions on (CHMOD) all of the uploaded files appropriately. templates, engine/scheduler/trigger, and smartway/conf, and all files directories underneath them, need to be set to 777 (except the .htaccess files; .htaccess should always be 644 or, at most, 755).
4. In your web browser, navigate to http://YOUR-DOMAIN/webJobs-BASE-DIRECTORY/install.php (replace YOUR-DOMAIN and webJobs-BASE-DIRECTORY with your actual domain name and the directory to which you uploaded the webJobs™ software, respectively). Follow the script instructions.
5. If the installation script completes successfully, it should give you a link to the administrative area. Login with your administrative login name and password, which you supplied to the installation script. You can now continue to customize your site. In particular, you should edit the default email templates and set up your billing scheme. See the administrative area section for details on how to accomplish this.

back to top

Detailed Installation Instructions

Follow these instructions if you have little or no experience in uploading and installing third-party scripts and/or configuring MySQL databases. If you are a more advanced user, you may wish to skip the details and instead read the brief version of these instructions.

Step 1: Unzip the installation files.

Whether you received the webJobs™ software on CD or via email, you should put the .ZIP file into a temporary folder/directory on your local computer (not on your web server) and run your unzipping program to extract all of the files to this temporary folder.

Step 2: Connect to your FTP server and upload the unzipped files.

Using your FTP client, connect to your host's FTP server (if you don't know the host name, username, or password for this, you will need to contact your host to find them out) and navigate to the directory in which you want to install the webJobs™ system. This directory must be your public HTML directory (usually named www or public_html) or a subdirectory thereof.

Upload all of the files, except phpinfo.php*, to this directory, but make sure to retain the directory structure. In other words, if a file was originally located in smartway in the .ZIP file, upload it to the smartway directory on the server. Depending on your FTP program, you may have to create the directories yourself before uploading the files, although many good, modern FTP client programs will do this for you.

* phpinfo.php is a script that accesses PHP's internal diagnostic information. It is provided for your use as a webmaster, but should not be left on the server when you are not using it, as it is a bad idea to provide make that server information publically accessible.

Make sure to upload everything in BINARY mode. Failure to follow this guideline will result in corrupted files.

Step 3: Set the file permissions.

1. Set the permissions on every directory (including the base webJobs™ directory) to 755 (read, write, and execute permissions for the owner, group, and everyone else).
2. Set the permissions on all .htaccess files to 644 (read/write permissions for the owner and read permission for the group and everyone else).
3. Set the permissions on the templates directory, its subdirectories, and everything underneath them to 777.
4. Set the permissions on the smartway/conf directory, its subdirectories, and everything underneath them to 777.
5. Set the permissions on the engine/scheduler/trigger directory, its subdirectories, and everything underneath them to 777.
6. Everything else should be set to 755.

Step 4: Run the install script.

When you uploaded the unzipped files, one of those files was an installation script that will help you to configure your database and server properly. You will now run that script.

For this step, you will need your MySQL information, including your host, username, password, and the name of the database that webJobs™ will use (the database does not need to exist already). Note that your MySQL username and password may be different from your FTP username and password. If you do not know this information, you will need to obtain it from your web host.

In your normal web browser (not your FTP client), navigate to the web page where install.php would reside after you uploaded it. For example, if your domain name is www.mydomain.com, your base public HTML directory is public_html, and you installed webJobs™ into public_html/webJobs/, you would need to point your browser to http://www.mydomain.com/webJobs/install.php.

Next, follow the script instructions carefully. The script is a simple two-step process that creates the necessary tables in the database and populates them with enough information to get you started. It will also update your configuration information, which is stored on your web server in the smartway/conf/config directory. After the script completes itself successfully, it will attempt to lock itself down to prevent further access; this prevents it from being run behind your back, which could potentially erase your database information. If it cannot do this for some reason, it will warn you to delete install.php as soon as possible to prevent unauthorized access.

Step 5: Log in to the administrative area and continue to configure the site.

You're almost done! Now go to the webJobs™ administrative area (the URL will be provided by the installation script) and log in using the username and password that you supplied to the webJobs™ installer script that you just ran. There are several things that you might want to take care of:

1. Customizing system settings
   There are several variables that you can change in the System Configurator. Among these are the default time zone and language and upload size and quantity limits. After tweaking any settings as desired, click Save to apply the changes or Cancel to void them.
2. Customizing billing
   You will also want to click on the Billing tab on the left and configure the resume search packs and job posting types that will be available to employers.
3. Other customizations
   You may also wish to change the emails, templates, or forms, or to set up your censor. For more information, please refer to the administrator's guide.

back to top

Frequently Asked Questions

• How do I know what PHP version I have?
  Either you can ask your web host, or upload the included phpinfo.php file to your web server and run it.
• Will the webJobs™ software run with PHP 5?
  There should be little reason for it not to work, but it has not been tested. Keep in mind that PHP 5 is not yet of production quality, and we do not recommend that you use it with the webJobs™ software yet. Please use the latest version of PHP 4.x (as of this writing, 4.3.6) for maxmimum stability.
• What is Zend Optimizer, and how do I get it?
  We encrypt our PHP code with Zend Encoder for efficieny and intellectual property protection. Zend Optimizer allows web servers to run this encypted code, and allows PHP scripts to run more quickly. It is freely available from Zend, but must be installed by your web host.
• What PHP configuration settings do I need to check?
  We have taken care to make webJobs™ as independent of configuration settings as possible. You will need to ensure that file_uploads is set to 1 (it almost always is). Other than that, register_globals, safe_mode, and other settings should not affect the webJobs™ software.
• Can you install it for me?
  Yes, we offer free installation with all of our products. Please submit a ticket and include your order number, FTP, and MySQL information. If you have shell access or access to a MySQL control panel, such as phpMyAdmin, this information would be helpful as well.

back to top

Copyright © 2004 Web Scribble Solutions, Inc. All rights reserved. webJobs™ and webDate™ are trademarks of Web Scribble Solutions, Inc. All other trademarks and/or service marks referenced in this document are property of their respective owners.