Vacancies Block

The Vacancies Block is a component used to display a list of job openings. It is designed to pull information from one or more "Vacancy" posts, making it easy to manage and display current job listings in a structured and consistent format.

Example on the current website

-   Example: View live example

-   Preview with image:

-   Editor preview:

Content Editor Fields

This block works by linking to content created in a separate "Vacancies" section of the WordPress admin.

Block-Level Fields

• Heading:

  • Description: The main title displayed above the list of vacancies.
  • Usage: Enter a heading for the section, for example, "Current Openings" or "Join Our Team".
  • Requirement: Optional.

• Vacancies:

  • Description: A relationship field where you select which "Vacancy" posts to display.
  • Usage: Search for and select one or more "Vacancy" posts that you have already created. The block will display them in the order you select them.
  • Requirement: At least one "Vacancy" post must be selected for the block to appear.

"Vacancy" Post Fields

To create the content for this block, you first need to go to the "Vacancies" custom post type in the WordPress admin menu and create a new entry. The fields for each entry are:

• Title (Standard WordPress Title):

  • Description: The job title for the vacancy (e.g., "Marketing Manager").
  • Requirement: Required.

• Excerpt (Standard WordPress Excerpt):

  • Description: A brief description of the job role.
  • Usage: Write a short summary of the position's responsibilities and requirements.
  • Requirement: Optional.

• Vacancy Location:

  • Description: A text field for the job's location.
  • Usage: Enter the city or site name (e.g., "Shore Planet Aquarium – Ellesmere Port").
  • Requirement: Optional.

• Vacancy Contract:

  • Description: A text field for the type of employment contract.
  • Usage: Enter the contract type (e.g., "Full-Time, Permanent").
  • Requirement: Optional.

• Vacancy Hours:

  • Description: A text field for the working hours.
  • Usage: Enter the expected hours (e.g., "40 hours per week").
  • Requirement: Optional.

• Vacancy Link:

  • Description: A call-to-action link, typically leading to an application page or a full job description.
  • Usage: Add a URL and the link text (e.g., "Apply Now").
  • Requirement: Optional.

Example Usage:

Steps:

1. Create the Vacancy Content:

   • In the WordPress admin, navigate to the "Vacancies" post type.
   • Click "Add New".
   • Enter the job title in the Title field: "Marketing Manager".
   • Add a job summary in the Excerpt field.
   • Fill in the custom fields:
     • Vacancy Location: "Shore Planet Aquarium – Ellesmere Port"
     • Vacancy Contract: "Permanent, Full time"
     • Vacancy Hours: "40 hours per week"
     • Vacancy Link: Add a URL to the application portal with the title "Apply Now".
   • Publish the "Vacancy" post.

2. Add the Block to a Page:

   • Edit the page where you want to display the vacancies (e.g., the "Careers" page).
   • Insert the Vacancies Block.
   • In the block's Heading field, enter "Current Vacancies".
   • In the Vacancies relationship field, search for and select "Marketing Manager".
   • Save the page.

Result:

The block will render a dedicated section on the page with a main heading. Below it, each selected vacancy will be displayed in its own container, showing the job title, key details (location, contract, hours), a short description, and a final call-to-action link to apply.

Benefits:

• Centralized Management: All job listings are managed in one place ("Vacancies" CPT), making it easy to add, edit, or remove them.
• Reusable Content: A single vacancy post can be added to multiple pages if needed.
• Consistent Formatting: Ensures all job listings are displayed with the same professional and easy-to-read layout.
• Simple for Editors: The process of adding and displaying vacancies is straightforward and requires no coding.

Conclusion:

The Vacancies Block is an efficient and user-friendly way to manage and display job openings. By separating the content from the page layout, it allows for easy, site-wide updates and ensures a consistent, professional presentation for potential applicants.