Matador Jobs provides a number of “shortcodes” for our users to simply add functionality to their pages from the WordPress Classic Editor, WordPress Block Editor, or various page builder plugins. Shortcodes are like placeholders in your editor for Matador to insert code when the page is generated for the user.
The Anatomy of a Shortcode
Shortcodes are simple to use. Shortcodes are sometimes as easy as typing the name of the shortcode enclosed by square brackets [ and ], which are located next to the P key on your standard QWERTY keyboard. Sometimes a shortcode has two words in its name, and when it does, the words are separated by an underscore _, which you type by holding shift and then the dash key - (next to the 0). A shortcode might look a lot like these examples:
[shortcode]
[another_shortcode]Shortcodes can have parameters (also called arguments). These are extra instructions provided by the user to the shortcode to help it do exactly what the user wants. Parameters are separated from the shortcode name and each other by spaces, and each contain a rule name followed by an equals = sign followed by the rule value. Rule values must be enclosed in either double " or single ' quotes when they contain spaces, though you can include them always if you want. Here are some examples:
[shortcode parameter=value]
[another_shortcode parameter_1="value" parameter_2="value with spaces"]Often, shortcode parameters are optional. When omitted, the default will be used. So if you’re using a default value, you can save yourself some keystrokes by omitting the parameter altogether.
How to Use a Shortcode
Shortcodes in the “Block Editor”
The WordPress “Block Editor” known also by its former development code-name Gutenberg Editor is the new WordPress page and post editor. Our shortcodes work in the Block Editor via the “Shortcode” block. Here is how:
- Press
Enteror Return to start a new block. - Type a forward-slash / to bring up block search.
- Begin typing the word “shortcode”. When the search finds the “Shortcode block” arrow-down or click on it.
- In the space provided, type our your desired Matador Jobs shortcode.
Shortcodes in “Widgets”
Shortcodes work only in the “Text” widget. Add a “Text” widget to your widget area and type the Shortcode you’d like to use.
Shortcodes in “Classic Editor”
Its easy to include WordPress Classic Editor… just type your Shortcode! No really, its that easy!
Shortcodes in “Page Builders” including Elementor, Divi, and WPBakery
In almost all cases, including a shortcode in the 3rd-party WordPress “page builder” is easy but you should consult the online documentation for your 3rd-party page builder for specific instructions.
The Matador Jobs Shortcodes
Now that we know what a shortcode is and how to use it, lets get into the Matador Jobs Shortcodes:
- [matador_job] to display the content of a single job record.
- [matador_job_field] to display the content of a Matador Job meta field.
- [matador_jobs] to display a list of jobs, paginated if needed, and alias shortcodes [matador_jobs_list], [matador_jobs_table], [matador_jobs_listing].
- [matador_portal] to display a complete “portal” with list of jobs, paginated if needed, along with filtering and search functionality.
- [matador_taxonomy], [matador_category], and [matador_location] to create lists of taxonomy terms for job filtering purposes.
- [matador_search] to create a job search form.
- [matador_application] to create a job application.
- [matador_general_application_link] to create a link to the page with the general application.