Skip to main content

Cinode Candidate Form plugin - WordPress

Installation and user guide for our forms functionality for candidates and a short guide explaining how to use WordPress plugin.

Magnus Burton avatar
Written by Magnus Burton
Updated over a week ago

The Cinode WordPress plugin allows you to seamlessly integrate customised recruitment forms into your website. It streamlines candidate data collection, enhances control over form content, and ensures all applications are automatically transferred to your Cinode recruitment pipeline for efficient processing.


Key Features

  • Create and manage candidate forms directly within your WordPress site.

  • Automated transfer of application data to your Cinode recruitment pipeline.

  • Customisable forms to align with your recruitment needs and brand experience.


Data Transferred to Cinode

The following information is sent to Cinode when a candidate submits an application:

  • First name

  • Last name

  • Email address

  • Phone number

  • Description

  • LinkedIn URL

  • State

  • Currency ID

  • Pipeline ID

  • Pipeline Stage ID

  • Recruitment Manager ID

  • Team ID

  • Company Address ID

  • Recruitment Source ID

  • Available From Date

  • Attachments (e.g. CV)


Requirements

To install the plugin, you need:

  • A WordPress website (minimum version 5.9)

  • PHP version 8.0 or higher

  • An active Cinode account

  • (Optional) An email plugin such as WP SMTP

  • The Cinode Recruitment Plugin ZIP file (available on GitHub)


Installation Guide

  1. Log in to your WordPress Dashboard.

  2. Navigate to Plugins → Add New.

  3. Click Upload Plugin, then choose the plugin ZIP file.

  4. Click Install Now, and once installed, activate the plugin.

After activation, a new menu item for Cinode Recruitment will appear in your WordPress Dashboard.


Configuration

  1. Generate your API key:

    • Log in at app.cinode.com.

    • Go to Administration → Integrations → Tokens.

    • Click the + icon to create a new token.

  2. Contact Cinode at support@cinode.com to obtain your Company ID.

  3. In the Cinode Recruitment Plugin Options, enter your Company ID and API key.

Note: The user role in Cinode must be set to Recruiter for the plugin to function correctly.

The "Mimic User" setting defines the permissions granted by the token, based on the roles of the user it mimics (e.g. Manager, Recruiter, Admin).


Using Shortcodes

You can use shortcodes to embed and customise your recruitment form.

Basic Example

[cinode pipelineId="0" pipelineStageId="0" recruitmentManagerId="0" teamId="0" recruitmentSourceId="0" campaignCode="0" currencyId="1"]

Note: If you set pipelineId, you must also specify pipelineStageId. These IDs must refer to a Candidate Pipeline, not a Project Pipeline.

Advanced Customisation

[cinode pipelineId="0" pipelineStageId="0" recruitmentManagerId="0" teamId="0" recruitmentSourceId="0" campaignCode="0" currencyId="1" firstname_label="Custom Name" lastname_label="Custom Last Name" email_label="Custom Email" phone_label="Custom Phone" message_label="Custom Message" linkedin_label="Custom LinkedIn" location_label="Custom Location" attachment_label="Custom Attachment" accept_label="Custom Accept Text" privacy_url="https://your-privacy-policy.com" privacy_error="Please accept GDPR terms" submitbutton_label="Submit Application" successful-submit-msg="Thank you for your application!" unsuccessful-submit-msg="Application not sent" requiredfield_msg="This field is required"]


Troubleshooting

Application Not Sent

  • Verify that all installation and configuration steps were followed.

  • Open your browser’s Developer Tools (Ctrl + Shift + I or Cmd + Shift + I on Mac).

  • In the Network tab, filter by cinode-recruitment and inspect the Preview tab for any error messages.

None: If the response data contains an error 401 (Unauthorised), it means the API token does not have the correct permissions. Double-check that the token was created for a user with the Recruiter role in Cinode, and ensure the token is still valid.

Continuous Loading After Submission

This may indicate an issue with the confirmation email. To resolve:

  1. Go to the Cinode Recruitment plugin settings in WordPress.

  2. Re-save the email subject and body content.

  3. Save the settings to refresh the configuration.

Did this answer your question?