|
| 1 | +About |
| 2 | +----- |
| 3 | +Jobskee is an open source job board with minimal configuration and relatively small footprint. |
| 4 | + |
| 5 | +Author |
| 6 | +------ |
| 7 | +Elinore Tenorio ( [email protected]) |
| 8 | +Manila, Philippines |
| 9 | + |
| 10 | +Stacks used |
| 11 | +----------- |
| 12 | + |
| 13 | +* Slim Microframework |
| 14 | +* RedBeanPHP |
| 15 | +* Bootstrap 3 UI |
| 16 | +* PHPMailer |
| 17 | +* Markdown |
| 18 | +* etc. |
| 19 | + |
| 20 | +Requirements |
| 21 | +------------ |
| 22 | +* PHP 5.3 and above |
| 23 | +* MySQL |
| 24 | +* mod_rewrite enabled |
| 25 | + |
| 26 | +Installation |
| 27 | +------------ |
| 28 | +1. Export sql file |
| 29 | +2. Update admin table with your desired username and password (sha1) |
| 30 | +3. Upload the files |
| 31 | +4. Update config.php with your settings |
| 32 | +5. Change file permission of /assets/images and /assets/attachments to 777 |
| 33 | +6. Check that all .htaccess files were uploaded |
| 34 | + |
| 35 | +Installation Notes |
| 36 | +------------------ |
| 37 | + |
| 38 | +### Enable PHP5.3+ using .htaccess |
| 39 | + |
| 40 | +Some old hosting providers still use PHP5.2 version, note that Jobskee will not run on this old version. |
| 41 | + |
| 42 | +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: |
| 43 | + |
| 44 | +`AddType application/x-httpd-php53 .php` |
| 45 | + |
| 46 | +### Importing jobskee.sql |
| 47 | + |
| 48 | +When you download Jobskee, you will find a database file included that you need to import to a MySQL database. |
| 49 | + |
| 50 | +Before importing however, you can edit the file to update several things: |
| 51 | + |
| 52 | +ADMIN ACCOUNT |
| 53 | + |
| 54 | +You can look for this line in the .sql file |
| 55 | + |
| 56 | +`INSERT INTO admin (id, email, password) VALUES |
| 57 | +(1, ' [email protected]', 'd033e22ae348aeb5660fc2140aec35850c4da997')`; |
| 58 | + |
| 59 | +and change it with the values you want: |
| 60 | + |
| 61 | +`INSERT INTO admin (id, email, password) VALUES |
| 62 | +(1, 'your desired admin email address', sha1('your desired admin password'))`; |
| 63 | + |
| 64 | +You can also customize the default values for Categories and Cities with the values you want before importing jobskee.sql to your own database. |
| 65 | + |
| 66 | +### Setting up your Jobskee job board |
| 67 | + |
| 68 | +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. |
| 69 | + |
| 70 | +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: |
| 71 | + |
| 72 | +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.) |
| 73 | + |
| 74 | +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. |
| 75 | + |
| 76 | +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. |
| 77 | + |
| 78 | +These are the recommended settings: |
| 79 | + |
| 80 | +Using "localhost" |
| 81 | + |
| 82 | +// SMTP SETTINGS |
| 83 | +define('SMTP_ENABLED', true); |
| 84 | +define('SMTP_AUTH', false); |
| 85 | +define('SMTP_URL', 'localhost'); |
| 86 | +define('SMTP_USER', ' [email protected]'); |
| 87 | +define('SMTP_PASS', ''); |
| 88 | +define('SMTP_PORT', 25); |
| 89 | +define('SMTP_SECURE', ''); |
| 90 | + |
| 91 | +and using Gmail |
| 92 | + |
| 93 | +// SMTP SETTINGS |
| 94 | +define('SMTP_ENABLED', true); |
| 95 | +define('SMTP_AUTH', true); |
| 96 | +define('SMTP_URL', 'smtp.gmail.com'); |
| 97 | +define('SMTP_USER', ' [email protected]'); |
| 98 | +define('SMTP_PASS', 'gmail password); |
| 99 | +define('SMTP_PORT', 465); |
| 100 | +define('SMTP_SECURE', 'ssl'); |
| 101 | + |
| 102 | +APPLICATION URL PATHS - as commented in the file, you need to provide your full URL including the trailing slashes. |
| 103 | + |
| 104 | +SHARETHIS_PUBID - in order to enable the social media sharing for the jobs, you need to register a Publication ID at www.sharethis.com |
| 105 | + |
| 106 | +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` |
| 107 | + |
| 108 | +GA_TRACKING - get insights to your job board by adding a Google Analytics tracking ID here. |
0 commit comments