Job
One job in full: the description, the company, the salary, where the job is on a map, and a button to apply.
This is a background feature. Members reach it by tapping a job rather than by navigating to it.
Before you start
Section titled “Before you start”| Plugin | JobBoardWP |
| Endpoint groups | Jobs. Maps for the map card, Bookmarks for Save |
| Plan | Every plan |
| For the map | A Google Maps API key under Memberside → API Keys |
| For Save | Ultimate Member - User Bookmarks, with Jobs added to Enable bookmark |
Add it to your app
Section titled “Add it to your app”It is added for you. Placing Jobs, My Jobs, Job Moderation or Job Categories puts the job screen on the Background tab, because each of them opens jobs.
Open its settings from the preview to give it a title of its own, to hide the company’s links, or to hide the map.
Settings
Section titled “Settings”| Setting | What it does | Default |
|---|---|---|
| Title, Description | Shown at the top | Empty |
| Company links | The company’s website, Twitter, Facebook and Instagram links under its name | On |
| Map | A map card with the job’s location, and Open in Maps | On |
| Map colours | The map card’s palette. On the Appearance tab, and only while Map is on | Automatic |
Ways in
Section titled “Ways in”- Tapping a job in Jobs, on the list or a pin on the map.
- Tapping a category’s job in Job Categories.
- Tapping a Jobs result in Search.
- Tapping a saved job in Bookmarks.
- Tapping a job on a member’s Jobs or Job dashboard profile tab.
- Tapping a job in My Jobs.
- Tapping a job in Job Moderation.
- Posting a job in Post a Job, which opens the new job.
- Tapping a job approved or job expired notification in Notifications.
What your members see
Section titled “What your members see”The job title, the company with its logo and tagline, the location, the job type badges, the salary where there is one, when it was posted and when it expires, then the full description.
Apply sits at the bottom. It opens a new email for a job that takes applications by email, and the employer’s page for one that takes them by website. A job that is filled or expired has no Apply button, as on the website.
A banner at the top says when a job is not live: pending review, draft, expired or filled. Only the job’s author and moderators can open a pending or draft job at all.
The map card shows where the job is, with Open in Maps to hand the address to the phone’s maps app for directions. It appears only for a job whose location was picked from the address suggestions, on the website or in the app, because only those have coordinates. A job with a plain text location shows the text and no map.
Save bookmarks the job, into a folder where your site uses them, and the job then appears in Bookmarks. A visitor who is not signed in is asked to sign in first. The button is not drawn at all until your site lets members bookmark jobs.
Author and moderator controls
Section titled “Author and moderator controls”The kebab menu in the corner holds what the viewer may do with this job. The site decides the list, from JobBoardWP’s own rules, so the app never offers a control that the site would refuse.
| Viewer | Controls |
|---|---|
| The job’s author | Edit, Mark filled or Mark unfilled, Delete |
| A moderator, on a pending job | Approve, Delete |
| A moderator, on any other job | Delete |
| Anyone else | No menu |
Edit opens the Post a Job form filled in with the job. It appears only while JobBoardWP allows editing that job:
| Job status | Edit appears when |
|---|---|
| Draft or expired | Always |
| Pending review | Pending Job Edits is on |
| Published | Published Job Edits is not “Users cannot edit their published job listings” |
With Published Job Edits set to require approval, saving an edit sends the job back to pending review until a moderator approves it again.
Mark filled appears on published jobs only.
Delete asks first. An author’s delete is permanent, exactly as JobBoardWP’s own job dashboard does it. A moderator deleting somebody else’s job moves it to the trash, where it can be restored from wp-admin.
A moderator is anyone with JobBoardWP’s edit_others_jb-jobs capability. On a
default site that is administrators.
Notifications
Section titled “Notifications”With Ultimate Member - Real-time Notifications active, the author of a job is notified when it is approved and when it expires. Tapping either notification in the app’s notification list opens this screen for the job.
A push notification is different. Tapping a job approved or job expired push still opens the author’s profile, not the job.
If the job has been deleted since, the notification keeps its original link to the profile rather than opening a screen that cannot load.
When it does not work
Section titled “When it does not work”| Symptom | Cause | Fix |
|---|---|---|
| Tapping a job does nothing | The Job screen was removed from Background | Place a job feature again, which adds it back |
| “That job could not be found” | The job was deleted, or it is pending or a draft and the viewer is neither its author nor a moderator | Working as intended |
| No Apply button | The job is filled or expired, or it has no application contact | Check the job in wp-admin |
| No Edit on your own job | JobBoardWP’s editing settings do not allow it for that status | Change Pending Job Edits or Published Job Edits in JobBoardWP → General → Job Submission |
| An edit sent the job back to pending | Published Job Edits requires approval | Working as intended, or allow edits without approval |
| No Approve for an administrator | The job is not pending | Working as intended |
| Tapping a job push opens a profile | Push taps land on the author’s profile | Open the job from the notification list instead |
| No map card | The job has a plain text location, Map is off, or your site has no Google Maps API key | Edit the job and pick its location from the suggestions, turn the setting on, or set the key |
| No Save button | Ultimate Member - User Bookmarks is inactive, Jobs is not in its Enable bookmark list, or the Bookmarks group is off | Activate it, add Jobs in Ultimate Member → Settings → Extensions → User Bookmarks, and enable the group |