PHP HTML JavaScript
Clone or download
Permalink
Failed to load latest commit information.
app Adding max_searches limit for each user Dec 30, 2017
bootstrap Initial commit Sep 23, 2016
config Adding monster, jobs2careers Dec 30, 2017
database Adding max_searches limit for each user Dec 30, 2017
docker Adding docker support for local dev Apr 15, 2017
public Adding monster, jobs2careers Dec 30, 2017
resources Fixing more styling issues Dec 30, 2017
routes Adding notification page Apr 15, 2017
storage Updating email to use notifications page Apr 15, 2017
tests Adding max_searches limit for each user Dec 30, 2017
.env.example Adding monster, jobs2careers Dec 30, 2017
.env.travis Moving migration Sep 25, 2016
.gitattributes Initial commit Sep 23, 2016
.gitignore Upgrading mockery, csv, jobs-multi dependencies Dec 30, 2017
.scrutinizer.yml Excluding public folder from scrutinizer Oct 28, 2016
.travis.yml Updating travis config Dec 30, 2017
Dockerfile Adding docker support for local dev Apr 15, 2017
Procfile Updating procfile to fix heroku jobs queue Oct 6, 2016
app.json Updates to app.json Dec 31, 2016
artisan Initial commit Sep 23, 2016
changelog.md Fixing navbar styling Dec 30, 2017
composer.json Upgrading sendgrid client Dec 30, 2017
composer.lock Upgrading sendgrid client Dec 30, 2017
docker-compose.yml Fixing outdated bootstrap var Dec 29, 2017
gulpfile.js Adding flag in ui to filter out recruiters Oct 28, 2016
license.md More readme updates Sep 24, 2016
nginx.conf Procfile and nginx conf for heroku? Sep 23, 2016
package-lock.json Adding package-lock file Dec 29, 2017
package.json Fixing navbar styling Dec 30, 2017
phpunit.xml Improving test coverage Sep 25, 2016
readme.md Upgrading mockery, csv, jobs-multi dependencies Dec 30, 2017
server.php Initial commit Sep 23, 2016

readme.md

JobApis.com JobsToMail

Your personal job-search assistant

Twitter URL Latest Version Software License Build Status Coverage Status Quality Score Total Downloads

About

JobsToMail is an open source web application that allows users to sign up to receive emails with jobs from one of several job boards supported by the JobApis project. Users can sign up to receive jobs for free at www.jobstomail.com or use the setup instructions below to run the application on their own server.

This application is built on Laravel 5.5 using the Jobs Multi and Jobs Common packages. The frontend uses Bootstrap v4 and Gulp.

Mission

JobApis makes job board and company data more accessible through open source software. To learn more, visit JobApis.com, or contact us at admin@jobapis.com.

Setup

Requirements

This application is only designed to work with PHP 7.0+ and Postgres 9.5+. Some backwards compatibility may be possible, but is not officially supported at this time.

Installation requires the following:

Local installation

The recommended installation method is Composer.

  1. Use composer to create a new project:
composer create-project jobapis/jobs-to-mail
  1. Copy .env.example to .env and customize it with your environmental variables.

  2. Run npm install && gulp to build the frontend.

  3. Run the built-in web server to serve the application: php artisan serve.

  4. Visit the local application at localhost:8000.

  5. Once at least one user has signed up, you can run the job collection and email command: php artisan jobs:email.

Docker installation

After you've got Docker installed and running:

  1. Install composer dependencies: docker run --rm -v $(pwd):/app composer:latest install

  2. Copy .env.example to .env and customize it with your environmental variables.

  3. Run docker-compose build and then docker-compose up -d to get the services running.

  4. Run npm install && node node_modules/.bin/gulp to build the frontend.

  5. Run migrations: docker exec jobstomail_web_1 php artisan migrate.

  6. Run the collect and email command: docker exec jobstomail_web_1 php artisan jobs:email.

You can run tests with docker exec jobstomail_web_1 vendor/bin/phpunit.

Heroku installation

  1. Use the one-click Deploy to Heroku button: Deploy

  2. After it's deployed, you should be able to visit your app and see the home page.

  3. Set an application key by running heroku run "php artisan key:generate --show" --app=j2m and adding the key that is displayed to your app's config variables.

  4. Add a job in Heroku Scheduler to run php artisan jobs:email every night. This will ensure that users receive their emails.

Server installation

Additional Requirements

  1. Use composer to create a new project:
composer create-project jobapis/jobs-to-mail
  1. Copy .env.example to .env and customize it with your environmental variables.

  2. Run npm install && gulp to build the frontend.

  3. Point NGINX to serve to the /public directory. Your NGINX config block should look something like this:

server {
    listen       80;
    server_name  yourdomain.com;
    
    root   /home/user/jobs-to-mail/public;
    index index.html index.htm index.php;

    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    
    location ~ \.php$ {
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_index  index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}
  1. Ensure that PHP-FPM is running, and ensure that your site is running at your domain.

  2. Create a cron job to run the job collection and notification process nightly: php artisan jobs:email.

Command Line

After users sign up for a job search, the only thing needed to collect jobs and send them emails is the following command:

php artisan jobs:email

This command will loop through each user, collect jobs based on their search criteria, and then email them when their list has been compiled.

Because this job search can take a long time, it is best to use a worker and run the job in the background (via cron job). Instructions for setting this up in Heroku are above, but if you have trouble, you can post a question to the Issues tab in the Github repository.

You can also run this job for only one email address in your system when testing or debugging:

php artisan jobs:email --email=karl@jobstomail.com

Testing

Tests are run using PHPUnit. We also employ Faker to help with producing fake data and Mockery to mock dependencies in unit tests.

  • Run all tests
vendor/bin/phpunit

Code coverage reports are automatically generated, and can be found in the /build directory after running the test suite.

Seeding data

If you're doing local development, you may find it handy to seed the database with some test data. Using Laravel's seed commands you can do just that:

  • Truncate and seed the database tables
php artisan db:seed
  • Seed only
php artisan db:seed --class=TestingDatabaseSeeder
  • Truncate only
php artisan db:seed --class=DatabaseTruncater

Note: Truncation is permanent, so be careful running this in your production environment.

Contributing

Contributions are welcomed and encouraged! Please see JobApis' contribution guidelines for details, or create an issue in Github if you have any questions.

Legal

Disclaimer

This package is not affiliated with or supported by any job boards and we are not responsible for any use or misuse of this software.

License

This package uses the Apache 2.0 license. Please see the License File for more information.

Copyright

Copyright 2016, Karl L. Hughes.