Important settings for the app

Few important settings are needed to run the app. Without these settings app can't do some process.

Delivery settings

Delivery settings is one of the most important settings for the app. Delivery settings mean which settings your app will use to send mail. Most of the mail in app are user invitation mail, password reset mail, Notification mail.

You can setup mail from here: Settings > App Settings > Delivery

App delivery settings will mostly use for user invitation and password reset mail. Also if you choose mail notification channel from notification settings then this will also use for sending notification mail. You can find this settings from App panel navigation menu.

You have four option to set up delivery settings

1. Mailgun

To set up Mailgun you will need a Domain name ( Here is how you can add domain in mailgun), API key, From name, From email.

SMTP
2. Amazon SES

Amazon SES needed Api Region, Access Key ID, Secret Access key, From name and From email to set up.

You also have to verify the email address which you are using as from email.

SMTP
3. SMTP

SMTP needed hostname, port, encryption, username, password, From name and From email to set up.

SMTP
N.B:ervice: You have to enable 2-Step Verification (ON) and create App passwords from your Google account Security.


Click on your Google profile image (Right top side) > Click Manage your google account > Click Security (left side) menu > Scroll down and enable "2-Step Verification" from Signing in to Google section.

After enable 2-Step Verification, you will get an option “App password” > Go to there > Click Select App > Choose Other > Type any name > click Generate > Password will generate.

From name: Jobpoint Test
User name: demo@gmail.com
From email: demo@gmail.com
host: smtp.gmail.com
Port: 587 (Encryption type: TLS)
Port: 465(Encryption type: SSL)
Password: Generated app password

Google Workspace or Google Cloud Identity users:

For Gmail sender email: You have to enable "Less secure app access" from your Google account security settings.

Click on your Google profile image (Right top side) > Manager your google account > Security (left side) menu > Scroll down and goto "Less secure app access" section > click "Turn on access" > do "Allow less secure apps: ON"

4. Sendmail

Sendmail needed path(optional), from name and from email to set up.

SMTP

Set up Cron Job

Cron Job is a process that is executed by your hosted server, in the background.

Cron jobs are used for very important tasks such as:

  • Email conversation with candidates
  • Sending emails
  • And much more……
Due to composer dependencies, PHP version ">= 8.0" must require to run cron job on your root domain/server.
How to setup Cron Job:

We provide you with a command inside the Application setting. You will need to add this command inside your web hosting providers control panel.

If you are using shared hosting from the hosting service provider and have a Cpanel/Control panel. Service Provider: Bluehost, DreamHost, Namecheap, HostGator

After setup the Cronjob, go to src folder and open .env file: update QUEUE_CONNECTION=database and Save.
NOTE: Sometimes PHP path may specify to your different web host. If your cron command isn't run, please contact your Hosting Provider about the exact PHP path.

Cpanel: (Bluehost, DreamHost, Namecheap, HostGator - Service provider)

Add Cron Job to run scheduler:
  • Search for the Cron Job in your cPanel.
  • Click and go into the setup page for your Cron job.
  • Select “Once per minute” from Common Settings.



  • Run this command in to the “Command:” field
  • /path/to/php /path-to-your-project/src/artisan schedule:run >> /dev/null 2>&1

    Example:
    Root domain:

    /usr/local/bin/php /home/jobpoint/public_html/src/artisan schedule:run >> /dev/null 2>&1

    Subdomain: [If subdomain directory is inside of public_html folder]

    /usr/local/bin/php /jobpoint/public_html/folder_name/src/artisan schedule:run >> /dev/null 2>&1

    If subdomain directory is outside of public_html folder:

    /usr/local/bin/php /home/jobpoint/folder_name/src/artisan schedule:run >> /dev/null 2>&1

    Subfolder:

    /usr/local/bin/php /home/jobpoint/public_html/folder_name/src/artisan schedule:run >> /dev/null 2>&1


If you find any problem in running jobs please check your php.ini/php extension configuration.
Make sure there are no function that are called by the queue driver, such as, proc_open, pcntl_alarm, pcntl_async_signals, pcntl_signal in the disable_functions.
If there any you’ll need to remove/enable those functions. Or you can contact with your hosting service provider.

Control Web Panel(CWP):

Hostinger hPanel:

Go to Cron jobs > select “Type: Custom” > Paste the provided command from the application settings without ( >> /dev/null 2>&1) these special characters. hPanel does not support special char in this server.

Command: /usr/local/bin/php /home/jobpoint/public_html/jobpoint/src/artisan schedule:run

DirectAdmin:

Remove the php path which we have provided, and paste the rest of the command.

Command: php /home/jobpoint/public_html/jobpoint/src/artisan schedule:run >> /dev/null 2>&1

Plesk:

Go to Websites & Domains > Scheduled Tasks > Schedule a Task > Select “Task type: Run a PHP script” > Paste “Script path” [project_path] > Arguments schedule:run > Select PHP version [7.4.xx] > Run: select Cron Style & input (*****) > save and run.

project_path: /var/www/xxx/xxxxx.plesk.page/httpdocs/jobpoint/src/artisan with arguments schedule:run

VPS Server:

If you run the application in VPS server, then configure Supervisor to manage the Laravel queue. Otherwise Cron job doesn’t work. Please follow your service provider documentation to run Supervisor and Cron jobs.

Imap Settings (Email Conversations)

Imap Settings is very important settings to receive mail.

You can setup imap setting from here: Settings > App Settings > Imap setting

Imap settings will mostly use for Candidate conversation through email. When an event is created for candidate and hiring team to get email from candidate system needs to receive these mails.

Note: Sending email (SMTP) and Receiving emails (IMAP) from candidates as conversations you must use the same email for both SMTP and IMAP.
1. Imap

To set up Imap you will need to set up imap map configuration

  • Imap Server ( ex: mail.your_domain.com )
  • Imap Port ( ex: 993 )
  • Encryption Type ( ex: SSL )
  • User ( ex: your_user )
  • Password ( ex: your_password )

SMTP

After setting up the configuration you need to set Cron Job & Scheduler

2. Gmail Imap

To set up Gmail Imap you will need Google Workspace

  • Gmail Imap Server ( ex: imap.gmail.com )
  • Imap Port ( ex: 993 )
  • Encryption Type ( ex: SSL )
  • User ( ex: your_email )
  • Password ( ex: your_password )
  • Enable less secure app
  • After setting up the configuration you need to set Cron Job & Scheduler
SMTP
  • You need to use a fresh Gmail workspace account to receive incoming emails [IMAP]. Or you can delete all emails from your existing email inbox and set up credentials to the IMAP setting. Otherwise, you can't get the conversation synced with the candidate.
  • For gmail receiver email for Google Workspace: You have to enable "Gmail imap settings" from your Google settings.

# Click on your Google Settings (Right top side) > See all settings > Forwarding and POP/IMAP > Enable settings as per given image below

N.B: For gmail receiver email for Google Workspace: You have to enable "Less secure app access" from your Google account security settings.

# Click on your Google profile image (Right top side) > Manager your google account > Security (left side) menu > Scroll down and goto "Less secure app access" section > click "Turn on access" > do "Allow less secure apps: ON"

SMTP

Integration

1. Zoom

To set up Zoom you will need a zoom API key, API Secret ( Here ) is how you can add zoom API key, API Secret.

zoom
2. Google Job Search

To set up Google Job Search ( Here) is how you can get Google ownership file and Google service account credential.

google-job

Steps to follow to get ownership file

  • Go To Google search console
  • Search property
  • Add Property
  • Select URL Prefix
  • Enter your desired domain. https://test.example.com
  • Verify the property
  • Ownership verifiedOwnership
  • Download the html file and it should be uploaded in Settings > integration > Google Search Integration > Upload Google ownership file

Steps to follow to get service account credential

  • Go to Google IAM & Admin
  • Select service account
  • Create Service account
  • Click on the your service account link and the select KEYS
  • Add key
  • Create new key and select json
  • A json file will be downloaded and it should be uploaded in Settings > integration > Google Search Integration > Google service account credential