Author Archive

How to create Open AI API key?

  1. Create an OpenAI Account

    Go to https://openai.com
    – Click the “Log In” button (top right corner) and select API Platform.
    – Register using your email, Google, or Microsoft account.

    After signing up, navigate to API Keys https://platform.openai.com/api-keys
    – Click the “Create new secret key” button.
    – This begins the setup process for your API key.

  2. Generate Your API Key
    In the “Create new secret key” dialog:
    – Enter a name for your key (e.g., demo API key) to identify it later.
    – Choose the project (default is fine unless you have multiple projects).
    – Click “Create secret key”
    Your new key will be shown only once — copy it immediately.
    This key is what you’ll use in our data scraper and other tools that are coming soon

  3. Top up balance

    Minimal amount is $5 – rest assured it $5 will lasts forver in case  AI features for WorkScout 😉

    Go to Billing and click Add credits to balance

AI Review Highlights

AI Review Highlights plugin reads reviews for resumes (freelancer profiles) and companies and uses AI to generate clear summaries of the most common pros and cons.

Visitors get a quick overview instead of scrolling through reviews.

How to use?

  1. Go to https://purethemes.net/license/ and download AI Review Highlights for WorkScout plugin
    You’ll need purchase key: How to find my license key?
  2. Upload ai-review-highlights-for-workscout.zip in WP Dashboard → Plugin → Add New and install & activate.
  3. You will see AI Review Highlights in two places:
    1. Companies → AI Reviews Highlights
    2. Resumes → AI Reviews Highlights

  4. Before use, you need to visit Settings where you can configure plugin to your needs and add your Open AI api key
    How to create Open AI API key? →

AI Hiring Assistant


AI Hiring Assistant analyzes job applications with AI to rate candidate fit. Works in tandem with WP Job Manager Applications.

Key features:
1. Analyses the job description and the candidate’s full application (name, email, message, resume, even PDF content)
2. Evaluates how well the candidate fits the job using Open AI API
3. Scores candidate based on: skill match, relevant experience, communication clarity, cultural fit signals
4. Returns a clear report with:
a.  1–5 rating
b. a short summary
c. strengths (pros)
d. weaknesses (cons)
e. a hiring recommendation

How to use?

  1. Go to https://purethemes.net/license/ and download AI Hiring Assistant plugin
    You’ll need purchase key: How to find my license key?

  2. Upload zip in WP Dashboard → Plugin → Add New and install & activate.
  3. Go to WP Job Manager → AI Hiring Assistant in your WordPress sidebar go directly to Settings.
    Add your Open AI api key
    How to create Open AI API key? →

  4. Now all employers will see “AI Summary” button in “Manage Candidates” page. Once clicked a report will be generated and displayed

  5. As an site admin you can check stats under “Statistics” tab

Theme Translation

If you would like to change some texts from english to english please check this article: How to change some texts/words?

Ready-made translations

WorkScout is pre-translated into 20+ languages and verified by native speakers, ready to use:

  • fr_FR Français (France)
  • fr_CA Français (Canada)
  • pl Polski
  • de_DE Deutsch (Deutschland)
  • de_AT Deutsch (Österreich)
  • nl_NL Nederlands (Nederland)
  • nl_BE Nederlands (BelgiĂ«)
  • el ΕλληΜÎčÎșÎŹ
  • tr TĂŒrkçe
  • es_ES Español (España)
  • es_MX Español (MĂ©xico)
  • pt_PT PortuguĂȘs (Portugal)
  • pt_BR PortuguĂȘs (Brasil)
  • it Italiano
  • ro RomĂąnă
  • bn àŠŹàŠŸàŠ‚àŠČàŠŸ
  • cs ČeĆĄtina
  • sk Slovenčina
  • sv Svenska
  • da Dansk

Translation is 100% complete including WorkScout and all WP Job Manager add-ons.

If your language is not on the list simply send us a message and we will generate language files for you within few hours:
Request Missing Language →

Each translation is generated using the OpenAI API with the GPT-4o model. The translations are very accurate and natural. You’ll likely need to adjust only a few words or phrases – if any. 🙂

How to install ready to use translation?

  1. Make sure you set your language in Dashboard → Settings → General
  2. Go to https://purethemes.net/license/ and download Translation Importer plugin
    You’ll need purchase key: How to find my license key?

  3. Upload translation-importer.zip in WP Dashboard → Plugin → Add New 
  4. Once installed and activated, open Translation Importer plugin page then  select your language and click “Download and Install” and that’s it, done!
  5. Important! Add translated URL titles in Settings → Permalinks for Job  base – otherwise listing pages might lead to 404 error page.

    e.g for Spanish
    http://example.com/job/single-listing
    http://example.com/trabajo/single-listing

  6. How to edit translation? →

Dashboard page titles

Dashboard page titles has to be changed in WordPress page editor:

 

Homepages

Texts on homepages have to be translated in Elementor (click Edit with Elementor on WordPress toolbar).

Multi-Language Support

If you’d like to enable language switcher on your website we recommend TranslatePress. Free version offers 1 additional language, Pro version – unlimited.

How to edit translation?

  1. To do that, install Loco Translate, then go to Loco Translate → Languages and select either the WorkScout theme or plugins like WorkScout Core, WP Job Manager etc. (translations are split between them).
  2. Before editing strings in the Listeo theme, you need to relocate the translation files. To do this, go to the “Relocate” tab in Loco and select languages/loco/themes/ as the directory where the translation file will be stored and click Move files

    Why?     Because the files need to be saved in a safe location where WordPress won’t delete them during updates.

Can’t install theme – missing the style.css stylesheet error

A common issue that can occur when installing a WordPress themes is “The package could not be installed. The theme is missing the style.css stylesheet.” error message being displayed when uploading or activating the theme:



One of the reasons you may receive this error is if you have uploaded the incorrect file. You have two options for downloading your theme.

downloadButton.png

  1. ‘All files & documentation’ (full zip folder). You will need to extract and locate the installable WordPress file.
  2. ‘Installable WordPress file only’ – use this download file which you can directly upload to WordPress

Please make sure you are uploading only the installable theme which is called NameOf Theme.zip. If you upload ALL these files you will receive an error.

How to modify freelancer review criteria?

You can use the workscout_reviews_criteria filter to modify the criteria by adding code to your theme’s functions.php file (preferably  or in a plugin. Here are several examples:

Adding New Criteria

function modify_workscout_reviews_criteria($criteria) {
    // Add new criteria
    $criteria['timeliness'] = array(
        'label' => esc_html__('Timeliness', 'workscout-freelancer'),
        'tooltip' => esc_html__('Ability to meet deadlines and deliver work on time', 'workscout-freelancer')
    );
    
    $criteria['creativity'] = array(
        'label' => esc_html__('Creativity', 'workscout-freelancer'),
        'tooltip' => esc_html__('Creative problem-solving and innovative approach to work', 'workscout-freelancer')
    );
    
    return $criteria;
}
add_filter('workscout_reviews_criteria', 'modify_workscout_reviews_criteria');

Removing Existing Criteria

function remove_workscout_criteria($criteria) {
    // Remove specific criteria
    unset($criteria['communication-skills']);
    
    return $criteria;
}
add_filter('workscout_reviews_criteria', 'remove_workscout_criteria');

Modifying Existing Criteria

function update_workscout_criteria($criteria) {
    // Modify existing criteria labels or tooltips
    if (isset($criteria['quality'])) {
        $criteria['quality']['label'] = esc_html__('Work Quality', 'workscout-freelancer');
        $criteria['quality']['tooltip'] = esc_html__('Overall quality and accuracy of delivered work', 'workscout-freelancer');
    }
    
    return $criteria;
}
add_filter('workscout_reviews_criteria', 'update_workscout_criteria');

Completely Replace Criteria

function replace_workscout_criteria($criteria) {
    // Replace with entirely new criteria
    return array(
        'expertise' => array(
            'label' => esc_html__('Technical Expertise', 'workscout-freelancer'),
            'tooltip' => esc_html__('Level of technical skill and knowledge demonstrated', 'workscout-freelancer')
        ),
        'reliability' => array(
            'label' => esc_html__('Reliability', 'workscout-freelancer'),
            'tooltip' => esc_html__('Consistency in delivering promised results', 'workscout-freelancer')
        ),
        'value' => array(
            'label' => esc_html__('Value for Money', 'workscout-freelancer'),
            'tooltip' => esc_html__('Quality of work relative to cost', 'workscout-freelancer')
        )
    );
}
add_filter('workscout_reviews_criteria', 'replace_workscout_criteria');

How freelance marketplace works?

WorkScout not only offers classic job board and resume feature but also includes a freelance marketplace, enabling freelancers to earn by completing micro jobs or user-posted projects.

  1. Employers can add micro jobs on gig basis. Freelancers can submit bids with their price and timeframe.
  2. Freelancers can manage their ongoing bids and employers their micro jobs in dashboard.
  3. Once employer select freelancer he wants to hire both will get access to project page.
  4. Each micro job has a dedicated project page for discussions, attachments, and progress updates. They can split project payments into multiple smaller payments using the Milestones feature.

    For example, a freelancer completes 40% of a project, submits a milestone, waits for employer approval and payment, then continues with the next phase.Once both parties confirm a milestone, the employer sees a Pay Now button.Payments are processed via Stripe Split Payments, automatically distributing funds and admin commission. Alternatively, the admin can collect payments (using any WooCommerce gateway) and manually pay freelancers.

    Related article: Commissions and Wallet →
  5. When project is finished by setting milestone to 100% they can both give each other reviews.

Related Article

Commissions and Wallet

AI Assistant Guide

Ask clear and specific questions!

Agent usually understand the context but you should ask in detailed way, for example:

❌ package change
✅ How can I modify paid package settings?

❌ disable similar jobs
✅ How can I disable similar jobs sections on single listing page

❌ Deactivate Resume
✅ How to disable specific resume listing?
✅ How to disable resume feature?

❌ Jobs don’t work
✅ I added jobs but I can’t see them  on map

Can AI Agent help me with coding?

No. Agent do not have access to theme files and cannot assist with coding, as this is restricted by our system prompt. Responses are based on our training data and the general knowledge about WordPress of the GPT-4o mini model.

AI suggested non-existent option

This might happen when a question is not precise or not covered in training data. The AI predicts answers based on patterns, so it may suggest for example setting that doesn’t exist.

Can I talk with AI agent in any language?

You can chat with the AI in your language, but answers may be less precise since Listeo training data is in english.

Also, if your question is not precise or uses unusual terminology in your language (e.g. “Add an Add” instead “Add Job”), the AI might not fully understand it.

 

By starting a conversation with chatbot, you acknowledge that we may have access to your conversation with chatbot in order to help improve the chatbot and training data.