Author Archive

Why I can’t see jobs on the map?

Job Listing is displayed on the map if it is geolocated, so if it has latitude and longitude values. For that to happen, you need to create an unrestricted Google Maps API key.

Learn how to create Google Maps API key here

In this case skip the part where you set ‘Accept requests from these HTTP referrers’, set it to ‘None’ instead

When the job is geocoded?

Calls to the Google API are made when:

  • A job is submitted.
  • The location of a job is changed.
  • Jobs are imported (using WP All Import) that have location data.

Geolocation data for a particular location is cached for 1 week, so an API call is not necessarily made every time in the above instances.

It’s explained in WPJM documentation

If you already added jobs before configuring API key, you have to update them again to have the jobs geolocated.

Having problems with your WordPress site not sending emails?

Popular email clients like Gmail, Yahoo, Outlook, etc are constantly improving their services to reduce email spam. One of the things their spam tools look for is whether an email is originating from the location it claims to be originating from. If the proper authentication isn’t there, then the emails either go in your SPAM folder or worst not get delivered at all.

This is a problem for a lot of WordPress sites because by default, WordPress uses the PHP mail function to send emails generated by WordPress or any contact form plugin like WPForms. The issue is that most WordPress hosting companies don’t have their servers properly configured for sending PHP emails. The combination of two causes your WordPress emails to not get delivered.

To avoid that use WP Mail SMTP by WPForms plugin:

WP Mail SMTP by WPForms

 

How to update theme and plugins?

It’s recommended to configure Envato Market auto-updates plugin. It’s installed automatically with theme and you’ll find in your wp-admin -> Envato Market

After each theme update, please update included plugins. You’ll see admin notice in dashboard for that, if you disabled those, check in the Appearance -> Install Plugins

However, if you didn’t configure Envato Market auto-updates plugin (it’s recommended) you can update theme and plugins manually as follows:

  1. Go to your downloads section on ThemeForest http://themeforest.net/downloads and download theme (Installable WordPress file only) – it will be the lastest version.
  2. Extract the zip file and upload all files (overwrite old files) on your server to
    wp-content/themes/workscout/
  3. After uploading new version of theme you also have to update plugins. You will see a list of plugins that require update in Appearance → Install Plugins.

You won’t loose any content or settings, but if you’ve made any customizations to source files they will be lost, so please use Child Themes http://codex.wordpress.org/Child_Themes to modify theme .php files. 😉

Getting Google API Key

All new created websites are required by Google to use an API key to access the Google Maps API services.

Billing

To use the Maps JavaScript API, you must enable billing. You can enable billing separately (see Usage and Billing) or when you get your API key.

How to generate API key?

To generate your API key, you need to  access the Google Developer console. In the Google Developers Console, follow these steps:

Create Project

Generate API Key

It’s important to add your website URL to ” Accept requests from these HTTP referrers” field, make sure to add it as

http://yourpage.com/*

and

https://yourpage.com/*

this way all subdomains and subpages will be accepted. Contrary to what Google suggest, you need to use http:// or https:// in front of your domain, it will not work with just *. It sometimes takes couple minutes to have your site accepted.

After adding it, click Create.

You’ll need to generate 2 API keys if you want to geocode your jobs and/or use radius based search. The 2nd key must be configured same way, but without any domain/key restrictions. This API key is used for server-side geocoding and it won’t work with domain restriction. It’s not shared anywhere publicly so don’t worry that someone else is going to use it.

Copy API Key

Copy the unrestricted API key and paste it in Job Listings -> Settings -> Google Maps API and if you want to use radius based search, copy it also to wp-admin -> WorkScout Core -> Map Options -> Google Maps API key for server side geocoding.

 

The restricted API key should go to wp-admin -> WorkScout Core -> Map Options -> Google Maps API key, if you selected Google Maps as Maps Provider.

You still have to add Google Maps API key in Job Listings -> Settings, even if you use OpenStreetMap as map provider.

Lear more about geolocation for jobs

Enable APIs

Go to Library -> Maps and click  Google Maps JavaScript API –  Enable the service.

Other APIs you need to enable to get full functionality of WorkScout are marked on this screenshot

Adding API Key

  1. Job Listings → Settings → Google Maps API Key (key here is required for geocoding in job submission form)
  2. WorkSCout Core → Settings → Google Maps API Key

Chosing Map Provider

Google Maps API pricing got you down? You can use alternatives like OpenStreetMaps, MapBox, Bing Maps, Thunderforest or HERE maps.

What’s more WorkScout supprorts also location autocomplete feature powered by OpenStreetMap which means that you don’t need to use Google API even for this.  It’s exclusive to WorkScout – not found in other job board themes!  We took care to develop it with best UX/UI practices and it works as good as Google’s autocomplete.

An example of map and location autocomplete field powered by OpenStreetMap:

Please note that OpenStreetMap location address suggestions work only on “type and hit enter”.  OpenStreetMap usage policy doesn’t allow generating address propositions on each key press (like Google does).  That would generate too many requests per second and could overload their servers. Technically it’s possible but OSM foundation shares their api for free so we wanted to respect their usage policy.

An example of map and location autocomplete field powered by Google Maps:

You will find all map settings in WorkScout Core → Map Settings:

 

How to update WorkScout to version 2.0

On January 10th, 2020 we’ve released new version of WorkScout – 2.0. As WorkScout was made in 2015 and was over 4 years old theme, we had to take some drastic measures to make it up to current standards. This means we had to rewrite big part of theme, change how some things works, and most important, refresh the design.
If you had version prior to 2.0, it’s important that you’ll read this guid to understand how to update your site correctly.

Most important thing – please do not update your live site, create some staging environment, copy of your current site, and work first on it to learn how things work now. Many parts of theme were rewritten and most of functionality was moved to a plugin (WorkScout Core) as it’s required now by ThemeForest. We try to do it so it won’t break any default installation of previous version, but any modification made in child themes might cause some problem.

Installing WorkScout Core

After updating theme files, you’ll see notification about new plugins to install.

Click the “Begin activating plugins” and follow the instructions there to install new required plugins. If you’ll have problems with updating WPBakery Page Builder, go to Plugins to deactivate it first, then update from Appearance → Install Plugins, and activate again.

After installing WorkScout Core, you’ll see new menu in your WordPress Dashboard → WorkScout Core. This replaces the old OptionTree theme options panel. Most functionality related options are in WorkScout Core, the visual options are in Appearance → Customize

Setting Up-Dashboard

One of the biggest new features is new Dashboard for users https://www.youtube.com/watch?v=PCfFRzACSiY

To set it up correctly you need to create some new pages. Below is a list of pages you need to create, and what content whey should have.

  • Page Title: Dashboard Page | Content: [workscout_dashboard] | set Page Template to “Dashboard Page”
  • Page Title: Messages | Content: [workscout_messages] | set Page Template to “Dashboard Page”
  • Page Title: My Profile | Content: [workscout_my_account] | set Page Template to “Dashboard Page”
  • Page Title: Lost Password | Content: [workscout_lost_password]
  • Page Title: Reset Password | Content: [workscout_reset_password]

Additionally, set the “Dashboard Page” Page Template for pages you have set as Job Listings → Settings → Pages to also show them within the dashboard view

If you are using Resumes, do the same for pages set in Resumes → Settings → Pages

Go to WorkScout Core → Pages and select the newly created pages for the options you see there.

Setting Up Maps

Chosing Map Provider

We’ve added support for alternative map provides, so you don’t have to use Google Maps, the options for that are in WorkScout Core → Map Settings.

You’re previously set API keys (they used to be set in Customise / Maps Options) should be automatically fetched from previous settings to new settings, so you should just save them. If that didn’t happen, you can copy your API keys from your Google Cloud project.

Changelog – WorkScout

Version 2.0.15 13/08/2020
  • fix
    Fix for Customizer issue WordPress 5.5 update

  • fix
    Fix for latest WooCommerce file version

  • fix
    Updated included plugins

Version 2.0.13 14/05/2020
  • fix
    Fixed editing pending resumes in Candidate dashboard

  • fix
    Fixed issues with static registration form (privacy policy check, ReCaptcha v3)

  • fix
    Fixed job tag archive

  • new
    Added options to set redirect pages after login and registration per user role (work only with static form)

  • fix
    Dashboard has option to add custom menu for Candidate and Employer sections

  • fix
    Fixed resume sidebar

  • fix
    Fixed resume categories counter

  • fix
    Fix for map unnecessarily loading in admin
Version 2.0.9 18/04/2020
  • new
    Support for social login plugins – https://wordpress.org/plugins/miniorange-login-openid/ and http://miled.github.io/wordpress-social-login/

  • fix
    Fixed registration emails if user registers by adding Job or Resume

  • fix
    Fixed submit job and resume forms if not used with Template Dashboard

  • new
    Added filter for header image on jobs (workscout_single_job_header_image) and pages (workscout_page_header_image)

  • fix
    Fixed option to set default logo for all jobs (Customize -> Jobs Options)

  • new
    WooCommerce Pricing Table element has option to set custom link instead of “add to cart”

  • fix
    Fixed “My applications” counter

  • new
    Added option for registration with reCaptcha v3 (WorkScout Core -> Registration Options)

  • new
    Added option to display taxonomies title and description (Customize -> Jobs Options) on taxonomy archive page (job categories etc)

  • fix
    Fixed bug with registration form user role

  • fix
    Fixed bug for WooCommerce Pricing Tables error if there’s no WC Paid Listing add-on

  • new
    Added salary data to schema.org markup

  • fix
    Reset button on jobs list correctly resets map and filters

  • new
    Added notice about missing API key for geocoding jobs

  • new
    Added og:image tag

  • fix
    Fix map issue if center point is not set

  • fix
    Fix category counter if category has child themes

  • fix
    Fix empty bookmark table

  • fix
    and some few more smaller improvements
Version 2.0.7 24/02/2020
  • fix
    Fix mobile CSS

  • fix
    Fix touch controls for range sliders

  • fix
    Fix new user mail when registering from Resume/Job submission form

  • new
    Autologin option (WorkScout Core -> Registration)

  • fix
    and some few more smaller improvements
Version 2.0.5 11/02/2020
  • fix
    Fixed new message notification

  • fix
    Fixed maps issues

  • fix
    Added Past applications page

  • fix
    Fixed recaptcha on registration

  • fix
    Fixed candidate applications counter

  • fix
    Fixed dashboard elements based on active plugins

  • fix
    Lots of smaller improvements
Version 2.0.4 03/02/2020
  • fix
    Fix for autoplay in all carousels

  • fix
    Fix for login form redirection (redirects to referrer site, not to my profile page)

  • fix
    Fix for “all jobs/resumes map”

  • fix
    Translations fixes

  • fix
    and some few more smaller improvements
Version 2.0.2 20/01/2020
  • fix
    Fix for welcome email on registration (edit in WorkScout Core -> Emails)

  • new
    Added email notifications for private messages (edit in WorkScout Core -> Emails)

  • fix
    Translations fixes
Version 2.0 10/01/2020
  • new
    Front-end User Dashboard: https://youtu.be/PCfFRzACSiY

  • new
    New Map Providers (OpenStreetMaps, Bing Maps, Mapbox, Google Maps)

  • new
    Private messaging system

  • new
    New homepage layout

  • new
    Redesigned header and menu style

  • new
    Redesigned footer style

  • new
    Newsletter widget in footer

  • new
    New full page layout with map on half of screen: https://workscout.in/browse-jobs-half-map/

  • new
    All theme settings are now moved from OptionTree (which isn’t used anymore) to WorkScout Core plugin and in Appearance > Customize

  • new
    Rewritten log in / registration system

  • new
    Various CSS/JS fixes

  • new
    Various mobile improvements

This changelog is maintained since January 2020