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
Log in to your WordPress Dashboard.
Navigate to Plugins → Add New.
Click Upload Plugin, then choose the plugin ZIP file.
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
Generate your API key:
Log in at app.cinode.com.
Go to Administration → Integrations → Tokens.
Click the + icon to create a new token.
Obtain your Company ID. Read more about that here.
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 + IorCmd + Shift + Ion Mac).In the Network tab, filter by
cinode-recruitmentand 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:
Go to the Cinode Recruitment plugin settings in WordPress.
Re-save the email subject and body content.
Save the settings to refresh the configuration.