Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Initial commit
  • Loading branch information
elinoretenorio committed Jan 23, 2014
0 parents commit 5a1cd18
Show file tree
Hide file tree
Showing 151 changed files with 53,277 additions and 0 deletions.
12 changes: 12 additions & 0 deletions .htaccess
@@ -0,0 +1,12 @@
# Force to use PHP5.3
# AddType application/x-httpd-php53 .php
RewriteEngine On

# Some hosts may require you to use the `RewriteBase` directive.
# If you need to use the `RewriteBase` directive, it should be the
# absolute physical path to the directory that contains this htaccess file.
#
# RewriteBase /

RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [QSA,L]
65 changes: 65 additions & 0 deletions CHANGELOG
@@ -0,0 +1,65 @@
==== CHANGELOG ====

Version 1.0.0 (01/01/2014)
-------------
* Added Blocks module
* Fixed 404 errors

Version 0.9 (12/14/2013)
-----------
* Added ban IP and email address
* Added page manager
* Added bulk upload using CSV
* Added categories and cities manager
* Added Notification class to handle all notification messages

Version 0.8 (12/7/2013)
-----------
* Separated admin templates to another folder
* Added viewer for job applications submitted
* Updated config file with template paths
* Added MarkDown editor for Bootstrap (toopay.github.com/bootstrap-markdown)
* Added email subscription

Version 0.7 (12/2/2013)
-----------
* Removed companies module
* Added separate admin templates
* Added search functionality

Version 0.6 (11/28/2013)
-----------
* Added Parsedown for MarkDown rendering (github.com/erusev/parsedown)
* Updated forms
* Added job expiration for cron job maintenance

Version 0.5 (11/25/2013)
-----------
* Added job application feature

Version 0.4 (11/23/2013)
-----------
* Added admin authentication
* Added job city filter

Version 0.3 (11/19/2013)
-----------
* Added pagination
* Added page views

Version 0.2 (11/18/2013)
-----------
* Created separate routing controllers
* Added front page jobs listing
* Added job posting
* Added job category filter
* Added SEO title and description
* Added OG tags for FB sharing

Version 0.1 (11/14/2013)
-----------
* Initial commit
* Added Slim Microframework for routing (slimframework.com)
* Added RedBeanPHP for ORM (redbeanphp.com)
* Added Bootstrap 3 for UI (getbootstrap.com)
* Added PHPMailer (github.com/Synchro/PHPMailer)
21 changes: 21 additions & 0 deletions LICENSE
@@ -0,0 +1,21 @@
The MIT License (MIT)

Copyright (c) 2013 Elinore Tenorio <elinore.tenorio@gmail.com>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
108 changes: 108 additions & 0 deletions README.md
@@ -0,0 +1,108 @@
About
-----
Jobskee is an open source job board with minimal configuration and relatively small footprint.

Author
------
Elinore Tenorio (elinore.tenorio@gmail.com)
Manila, Philippines

Stacks used
-----------

* Slim Microframework
* RedBeanPHP
* Bootstrap 3 UI
* PHPMailer
* Markdown
* etc.

Requirements
------------
* PHP 5.3 and above
* MySQL
* mod_rewrite enabled

Installation
------------
1. Export sql file
2. Update admin table with your desired username and password (sha1)
3. Upload the files
4. Update config.php with your settings
5. Change file permission of /assets/images and /assets/attachments to 777
6. Check that all .htaccess files were uploaded

Installation Notes
------------------

### Enable PHP5.3+ using .htaccess

Some old hosting providers still use PHP5.2 version, note that Jobskee will not run on this old version.

In order to use PHP5.3+, you can edit .htaccess file in the root folder and uncomment (remove the pound sign at the beginning of) this line:

`AddType application/x-httpd-php53 .php`

### Importing jobskee.sql

When you download Jobskee, you will find a database file included that you need to import to a MySQL database.

Before importing however, you can edit the file to update several things:

ADMIN ACCOUNT

You can look for this line in the .sql file

`INSERT INTO admin (id, email, password) VALUES
(1, 'admin@example.com', 'd033e22ae348aeb5660fc2140aec35850c4da997')`;

and change it with the values you want:

`INSERT INTO admin (id, email, password) VALUES
(1, 'your desired admin email address', sha1('your desired admin password'))`;

You can also customize the default values for Categories and Cities with the values you want before importing jobskee.sql to your own database.

### Setting up your Jobskee job board

After downloading Jobskee and have setup your database and correct folder permission on `assets/attachments` and `assets/images`, you can now setup your job board by opening the `config.php` file found in the root folder.

I'd like to mention some important values in the `config.php` that you need to set in order to successfully run your job board:

APP_MODE - currently defaulted to 'development'. You need to set this to 'production' when your site is in production mode as it affects several other configuration (i.e. database, debug, etc.)

APP_THEME - currently set to 'default'. This is the default theme used by Jobskee. If you would like to customize this theme, it is recommended that you copy `/views/default` to your new theme (i.e. `/views/my_theme`) and set APP_THEME to 'my_theme'. This will ensure that you can go back to the default theme, should your theme customization produce error that you cannot recover.

SMTP SETTINGS - the default SMTP settings is Gmail friendly and should work right away when you provide your correct Gmail information. For other settings, like using your own hosting's default mail host, you must configure it correctly in order for email notifications to work.

These are the recommended settings:

Using "localhost"

// SMTP SETTINGS
define('SMTP_ENABLED', true);
define('SMTP_AUTH', false);
define('SMTP_URL', 'localhost');
define('SMTP_USER', 'email@example.com');
define('SMTP_PASS', '');
define('SMTP_PORT', 25);
define('SMTP_SECURE', '');

and using Gmail

// SMTP SETTINGS
define('SMTP_ENABLED', true);
define('SMTP_AUTH', true);
define('SMTP_URL', 'smtp.gmail.com');
define('SMTP_USER', 'email@gmail.com');
define('SMTP_PASS', 'gmail password);
define('SMTP_PORT', 465);
define('SMTP_SECURE', 'ssl');

APPLICATION URL PATHS - as commented in the file, you need to provide your full URL including the trailing slashes.

SHARETHIS_PUBID - in order to enable the social media sharing for the jobs, you need to register a Publication ID at www.sharethis.com

CRON_TOKEN - this is used for running cron job to expire jobs. Provide a unique token that you can use in order to expire jobs using the path: `/cron/jobs/expire/:cron_token`

GA_TRACKING - get insights to your job board by adding a Google Analytics tracking ID here.

0 comments on commit 5a1cd18

Please sign in to comment.