RepairPluginDocs

Shortcodes

Learn how to embed the RepairPlugin booking system on any WordPress page using shortcodes for the full flow, search bar, and pricing tables.

shortcodeembeddingfrontendsearch-barpage-builder

What can you do with this?

  • Add the complete booking flow to any page with [Repair_All] — customers see categories, brands, models, repairs, service methods, and checkout.
  • Add a search bar with [Repair_Search_Box] so visitors can quickly find their device model from any page.
  • Show a category, brand, or model grid on any page with [categories], [brands], or [models] for quick navigation.
  • Display a repair pricing table with [Repair_Pricing_Table] so customers can see all repair prices for a specific model.
  • Create landing pages with pre-selected categories, brands, models, or locations for SEO or marketing campaigns.
  • Pre-select a language for multilingual websites that don't use Polylang.
  • Use any page builder — Elementor, Divi, WP Bakery, or Gutenberg all work.

Where to find it

  1. In the WordPress admin menu, click RepairPlugin.
  2. Click Settings in the submenu.
  3. In the settings sidebar, click Plugin Shortcode.
https://www.repairplugin.com/wp-admin/admin.php?page=wp_repair_settings&section=plugin_shortcode
The Plugin Shortcode settings page showing shortcode fields, brand filter, and Base URL options

This page shows both shortcodes with copy-to-clipboard buttons, brand/location filters, and the Base URL setting for the search box.

Pre-selected shortcodes for specific categories, brands, and models are found on their management pages:

  • Category shortcode: RepairPlugin > Categories — select a category, click the shortcode icon.
  • Brand shortcode: RepairPlugin > Categories — select a brand, click the shortcode icon.
  • Model shortcode: RepairPlugin > Models & Repair — select a model, click the shortcode icon.
  • Location shortcode: RepairPlugin > Enhanced Locations > Locations — click the shortcode button on a location row (requires location-based pricing to be active).

How to set it up

Place a shortcode on a page

  1. Copy the shortcode you want (e.g., [Repair_All]).
  2. Go to WP Dashboard > Pages and edit the target page.
  3. Add a Shortcode block (Gutenberg) or an HTML/Code module (page builders).
  4. Paste the shortcode into the block.
  5. Set the page layout to full-width for the best result (at least 1200px wide recommended).
  6. Click Save or Publish.

Pre-select a brand

On the Plugin Shortcode settings page, select a brand from the Brand dropdown next to the Steps Shortcode field. The shortcode updates automatically:

[Repair_All brand="Apple"]

Click Copy to clipboard to copy it. Use the reset icon to clear the brand filter.

Pre-select a location

When location-based pricing is active, a Location dropdown appears next to the Search Box Shortcode field. Selecting a location generates:

[Repair_Search_Box location="3"]

The search box needs to know which page has the [Repair_All] shortcode so it can send customers there after they pick a model.

  1. Under the Search Box section, find Base URL.
  2. Choose Find It Automatically (default) or Use My Custom Link.
  3. If using a custom link, enter the full URL of the page where [Repair_All] is placed.
  4. Click Update.

This URL is also used for Finalize, Reschedule, and Cancel links in emails.

https://www.repairplugin.com/book-a-repair
The search bar widget allowing customers to search for their device directly

Pre-select a language

If your site uses a translation plugin other than Polylang (which is detected automatically), add the language attribute:

[Repair_All language="Dutch"]
[Repair_All language="French"]
[Repair_All language="English (United States)"]

The language name must match the LANGUAGE NAME column from Settings > Localization.

Settings reference

SettingDescriptionDefaultCustomers see
Steps ShortcodeShows the main booking shortcode. Copy and paste it into any page to display the complete multi-step booking flow[Repair_All]The full booking interface — category selection, brand, model, repair list, service methods, and checkout.
Brand filterWhen you select a brand, it adds brand="BrandName" to the shortcode. Only categories and models for that brand will appear-- All --They skip brand selection and go straight to choosing their model.
Search Box ShortcodeShows the search bar shortcode. Copy and paste it into any page to display a search bar where customers can type a device name and see matching models[Repair_Search_Box]A search bar where they can quickly find their device. Especially useful on homepages or landing pages.
Location filterAdds location="ID" to the shortcode to skip the location selection step. Only visible when location-based pricing is turned on-- All --They go directly to model and repair results for that location.
Base URLTells the search bar which page to send customers to after they pick a model. This URL is also used for finalize, reschedule, and cancel links in emailsFind It AutomaticallyAfter searching for their device, they're taken to the right page with the full booking flow.
Custom LinkLets you manually set the URL of the page with [Repair_All]. Only appears when "Use My Custom Link" is selectedemptyCorrect navigation from search results to the booking flow. Use this when automatic detection doesn't find the right page.

Catalog shortcodes

These shortcodes display specific parts of your device catalog on any page. Each one requires a code attribute — the unique code assigned to the category, brand, or model within RepairPlugin.

SettingDescriptionDefaultCustomers see
[categories]Displays the booking flow starting from a specific category. Customers see brands, models, and repairs within that category. Requires the code attribute. Optional: location (location ID or name) to lock to a specific location, language to pre-select a language
Example: [categories code="CAT001"]
The category grid shortcode output showing device type icons in a grid layout
SettingDescriptionDefaultCustomers see
------------
[brands]Displays the booking flow starting from a specific brand within a category. Customers see models and repairs for that brand. Requires the code attribute. Optional: location, language
Example: [brands code="BRD001"]
The brand grid shortcode output displaying brand logos for customers to select from
SettingDescriptionDefaultCustomers see
------------
[models]Displays the booking flow starting from a specific model. Customers go directly to the repair selection for that model. Requires the code attribute. Optional: location, language
Example: [models code="MDL001"]
SettingDescriptionDefaultCustomers see
------------
[Repair_Pricing_Table]Displays a read-only pricing table listing all available repairs and their prices for a specific model. Useful for SEO landing pages and transparency. Requires the code attribute. When location-based pricing is active, you must also provide the location attribute. Optional: language
Example: [Repair_Pricing_Table code="MDL001"] or [Repair_Pricing_Table code="MDL001" location="3"]

Tip: Combine [models] and [Repair_Pricing_Table] on the same page to show both the booking flow and the pricing table for a device: [models code=MDL001][Repair_Pricing_Table code=MDL001]. Display Opening Hours shortcodes RepairPlugin also provides 8 shortcodes for showing opening hours, open/closed indicators, and conditional content on your website. These are documented separately in Opening Hours Display.

Pre-selected shortcodes

Shortcode typeWhere to get itExample
Category pre-selectedRepairPlugin > Categories[Repair_All category="5"]
Category + Brand pre-selectedRepairPlugin > Categories > Brand[Repair_All category="5" brand="Apple"]
Model pre-selectedRepairPlugin > Models & Repair[models code=ABC123][Repair_Pricing_Table code=ABC123]
Brand only (all categories)Settings > Plugin Shortcode[Repair_All brand="Samsung"]
Location pre-selectedEnhanced Locations > Locations[Repair_All location="3"]

Page builder tips

Page BuilderRecommended ModuleNotes
ElementorShortcode moduleDon't use a text box. Make sure the column is at least 1250px wide.
DiviCode moduleDon't use a text box. Avoid sections with dividers.
WP BakeryRaw HTML moduleDon't use a text box. Make sure the column is at least 1250px wide.
GutenbergShortcode blockSet the page to full-width layout.

Frequently asked questions

Can I put the shortcode on multiple pages?

Yes. You can place [Repair_All] on as many pages as you like — for example, separate landing pages for different brands or categories using pre-selected shortcodes.

What's the minimum page width for the booking flow?

For the best visual result, your page should be at least 1200px wide. Use a full-width page template in your theme or page builder.

What happens if I place two [Repair_All] shortcodes on the same page?

This isn't supported. RepairPlugin uses shared internal state, so the second shortcode would overwrite the first one's configuration. Place only one booking shortcode per page.

Can I use shortcodes in widget areas or custom post types?

Shortcodes work anywhere WordPress processes them, including widgets and custom post types. However, some internal features (like reschedule and finalize links) expect the shortcode to be on a standard WordPress page. If you place the shortcode elsewhere, the booking form works but those internal redirect links may not find it.

Command Palette

Search for a command to run...