All Collections
Guides
TutorCruncher Socket Guides
Socket for Public Tutor Listings
Socket for Public Tutor Listings

Learn how to use the TutorCruncher Socket to list your Tutors on your website.

Sam Linge avatar
Written by Sam Linge
Updated over a week ago

Before starting, you will need to enable Public Tutor Profile functionality by navigating to System > Settings > People and Activity > People and enable the 'Public Tutor Profiles'. This generates public profiles for Tutors which will then be accessible via the API.

Setup Socket Integration.

Wherever you wish to include the Tutors, input the following code:

<div id="socket"></div>

Then, below where you have imported Socket, put in the following:

<script>
  socket('YOUR_API_KEY')
</script>

You need to replace YOUR_API_KEY with your public API key.

See here for an example.

Socket Fields for a Tutor's details:

Fields

Description

Example

distance

Used to filter your users by distance to an address/postcode

N/A

id

The tutor's ID within TutorCruncher

214699

link

The link that will be generated for their profile

214699-martha-s

name

The tutor's name

Martha S

photo

A link to the tutor's profile picture

primary_description

The Custom Field with the name 'Primary Description', or the first custom Field that is of type Text Long, arranged in order of priority.

I have been a Maths teacher (13+) since I graduated from university and tutor students outside of work. I also have experience in working with students with learning disorders.

tag_line

The Custom Field with the name 'Tag Line', or the first custom Field that is of type Short Text, arranged in order of priority.

Fantastic Maths Tutor available throughout London

town

The town the tutor has listed in their address

Putney

url

A link to more details about that contractor (see below)

country

The country the tutor has entered in their address

United Kingdom

Socket Parameters:

Name

Default

Description

api_root

TutorCruncher Socket Backend

The URL of the backend you wish to use. TutorCruncher Socket Backend

element

#socket

The id of the element created

router_mode

hash

The routing mode when clicking on a Tutor's profile.

mode

grid

Which mode you want to use (explained below)

url_root

/

The root URL of the page you are using Socket from eg. '/our-tutors/'

subject_filter

true

Whether or not the subject filter is displayed

We use some strings within Socket that you may want to change by also passing them as parameters:

skills_label

'Skills'

contractor_enquiry_message

'Please enter your details below to enquire about tutoring with {contractor_name}.'

enquiry_message

'Please enter your details below and we will get in touch with you directly.'

contractor_enquiry_button

'Contact {contractor_name}'

contractor_details_button

'Show Profile'

submit_enquiry

'Submit Enquiry'

enquiry_submitted_thanks

'Enquiry submitted, thank you.\n\nYou can now close this window.'

enquiry_button_text

'Get in touch'

Socket display modes:

  • Grid: Generates a <div> of your Tutors in a grid format, as per the example here.

  • Enquiry: Generates an enquiry form inside the page using fields that you can customise within TutorCruncher, as per the example here.

  • Enquiry Modal: Generates a button inside the page which, when clicked, will load a modal of the enquiry form. Read more about modals here.

How do I allow my Clients request a Tutor directly?

As long as you have a Tutor listed on your website, your Clients can request a Tutor.

See here for an example.

How do I automatically create a Job whenever a Client requests a Tutor?

Navigate to System > Settings > People and Activity > Activity and enable the 'Create Job for enquiries' checkbox. Now, whenever a Client enquires, a new Job will be created with the Tutor listed as an applicant for it. You can then decide whether or not to assign that Tutor or choose a different one.

How do I choose which Tutors should be displayed?

Navigate to the Tutor profiles that you want to approve and apply the 'Public Profile' Label.

You can then view the fields that will be displayed within System > Settings > Integrations > Approve Tutor Profiles.

If no Tutors are listed, you can click the Refresh Public Profiles button to refresh the list. If you still have no Tutors displayed, you will need to check that you have applied the 'Public Profile' Label correctly.

If a Tutor's profile is ready to be listed, click the Approve button next to their item on the list.

How do I approve public Tutor profiles?

Our website integration TutorCruncher Socket allows you to automatically display Tutor profiles on your website. Get more information on how to set up Socket in the video below. Once Socket is integrated with your website, you will need to approve public tutor profiles to display them on your website.

The steps outlined in this video:

  • Apply the 'Public Profile' Label to the Tutor profiles that you want to list.

  • Navigate to System > Settings > Integrations > Approve Public Tutor Profiles to review and approve the Tutor profiles

  • If no Tutors are listed, you can click the Refresh Public Profiles button to refresh the list.

  • If you still have no Tutors displayed, check that you have applied the 'Public Profile' Label to their profiles.

  • If an Administrator or a Tutor makes a change to a public profile, then you'll need to approve the change in the same way as releasing them initially.

  • If you think a Tutor's profile is ready to be listed, click the Approve and release button next to each Tutor's profile on the list.

My Tutor's profiles on my website are out of date, how do I update them?

If an Administrator or Tutor makes a change to a public profile, then you'll need to approve those changes via System > Settings > Approve Public Tutor Profiles.

How do I remove a public Tutor profile?

To remove a public Tutor profile, follow these steps:

  1. Navigate to their Tutor profile within TutorCruncher and remove the 'Public Profile' Label.
    โ€‹

  2. Navigate to System > Settings > Integrations > Approve Public Tutor Profiles and click Refresh Public Profiles.
    โ€‹

  3. You will then need to select Approve and Release on the profile you removed that Label from and refresh your website for the listing to be removed.

Can I customise the fields that will be displayed on the Tutor listings?

By default, the Tutor's name and town will be displayed in Socket, as well as any teaching skills they have chosen. To add more fields, simply add or edit Custom Fields and make sure to enable the 'Client can access' checkbox so that they are displayed.

Note: It can take up to 24 hours for changes to customisable fields to display on your website via Socket.

How do I get a list of Tutors using the API?

If you make a request in the format below, you can get the list of the Tutors you have made publically accessible.

https://socket.tutorcruncher.com/contractors/

If we take our demo branch as an example:

Example of listing Tutors on a website:

<body>
<h1>This is a webpage for my tuition agency</h1>
<p>Listed below are my tutors</p>
<div id="socket"></div>
<p>We just love using TutorCruncher for our business.</p>
<script src="https://cdn.tutorcruncher.com/socket/latest/socket.js"></script>
<script>
socket('YOUR_API_KEY')
</script>
</body>

See here for an example of it in action.

Example of listing Tutors and embedding an enquiry form:

<body>
<h1>This is a webpage for my tuition agency</h1>
<p>Listed here are my tutors</p> <div id="socket"></div>
<p>Get in touch by filling in the contact form below</p>
<div id="socket-enquiry">
</div>
<p>We just love using TutorCruncher for our business.</p>
<script src="https://cdn.tutorcruncher.com/socket/latest/socket.js"></script>
<script>
socket('YOUR_API_KEY', {
mode: 'enquiry',
element: '#socket-enquiry'
})
</script>
<script>
socket('YOUR_API_KEY')
</script>
</body>

See here for an example of it in action.

How do I get more details about a Tutor?

To get more details about a Tutor, (such as their teaching skills or any other Custom Fields etc.), navigate to this URL link.

Did this answer your question?