Skip to content
Docs

Single-Page Resume Form (Pro)

WP Career Board Pro 1.4.3 ships three resume form variants so site owners can pick the candidate experience that fits their audience. All three write to the same wcb_resume post type and the same REST endpoint, so candidates can move between variants without losing data.

The three variants

Section titled “The three variants”
Variant Block Shortcode What it is
Resume Builder (default) wcb/resume-builder [wcbp_resume_builder] Multi-step accordion: each section collapses, entries shown as compact cards with inline edit forms. Best for first-time candidates who want guided section-by-section completion.
Resume Form (Single-Page) wcb/resume-form [wcbp_resume_form] Single-page comprehensive form. Every section expanded on one scrolling page. Best for returning candidates editing an existing resume, partner integrations, sites that prefer a continuous-scroll feel.
Quick Profile wcb/resume-form-simple [wcbp_resume_form_simple] Minimal single-page profile: headline, summary, top skills, location, open-to-work, photo. Best for sidebars, modals, onboarding flows where a full resume is overkill.

All three operate on the resume the URL points at (?resume_id=N), require the resume to belong to the current user, and write to the same PUT /wcb/v1/resumes/{id} endpoint.

When to pick which

Section titled “When to pick which”

Default site: ship wcb/resume-builder on the resume page (the setup wizard does this for you). Candidates get the friendly stepped flow.

Returning-candidate edit page: switch the resume page to wcb/resume-form so candidates see everything at once and can edit freely without expanding accordions.

Onboarding card / sidebar / modal: use wcb/resume-form-simple for a quick-completion experience. Candidates can flesh out the full resume later via the builder.

Sections covered by wcb/resume-form

Section titled “Sections covered by wcb/resume-form”

All seven sections defined by ResumeModule::get_groups():

  1. School - school_name, certificate, field_of_study, start/end dates, grade, description
  2. College / University - institution, degree_type, field_of_study, start/end dates, gpa, description, achievements
  3. Work Experience - company, job_title, employment_type, location, start/end dates, current_role checkbox, description, skills_used
  4. Certifications - cert_name, issuing_body, issue/expiry dates, credential_id, credential_url
  5. Skills - skill_name, proficiency
  6. Languages - language, proficiency
  7. Portfolio / Links - label, url

Each section has an Add [Section] button at the top right. Each entry has a Remove button at the bottom that prompts a confirm dialog before deleting.

Editor inserter

Section titled “Editor inserter”

The block appears in the block inserter under the Widgets category. Two attributes:

Attribute Type Effect
compact bool Tighter padding (sidebars, modals, narrow columns). Default off.

Switching the resume page from builder to single-page

Section titled “Switching the resume page from builder to single-page”
  1. Go to Pages → All Pages and find the page that hosts your resume editor (usually titled “My Resume” or similar - created by the Pro setup wizard).
  2. Edit the page in the block editor.
  3. Remove the Resume Builder block.
  4. Insert the Resume Form (Single-Page) block.
  5. Save.

Candidates who already have resume data see the same data - no migration needed. The two blocks share the database.

Compatibility note

Section titled “Compatibility note”

The section filters - wcbp_resume_groups, wcbp_resume_textarea_fields, wcbp_resume_checkbox_fields, and wcbp_resume_date_fields - drive the two section-based variants: Resume Builder and Resume Form (Single-Page). An add-on that adds a “Patents” section or changes a field’s input type via these filters affects both automatically.

The Quick Profile variant (wcb/resume-form-simple) does not render the repeater sections, so the section filters above do not apply to it. All three variants share the wcb_resume_form_fields custom-field filter (see Custom Resume Fields), which is the right hook when you want a field to appear everywhere.

Where to go next

Section titled “Where to go next”