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:
- A licensed copy
of webJobs™.
- A .ZIP decompression
utility, such as:
- An FTP client
program, such as:
- 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.
- MySQL version
3.23 or newer.
- A basic understanding
of HTML and preferably CSS.
- 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.
- 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.
- 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.
- 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).
- 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.
- 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.
- 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).
- Set the permissions on all .htaccess files to 644 (read/write permissions for the owner
and read permission for the group and everyone else).
- Set the permissions on the templates directory, its subdirectories, and everything underneath them to 777.
- Set the permissions on the smartway/conf directory, its subdirectories, and everything underneath them to 777.
- Set the permissions on the engine/scheduler/trigger directory, its subdirectories, and everything underneath them to 777.
- Everything else should be set to 755.
This is a common source of future errors. Without this step, the webJobs™ software would not be
able to update your configuration files or templates.
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:
- 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.
- 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.
- 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.