RepairPluginDocs

Link to RepairPlugin

Create direct links to specific categories, brands, or models in your RepairPlugin booking form. Use them in your website menu, buttons, ads, or landing pages.

deep-linkingurl-parametersmenunavigationlanding-pagefrontend

What can you do with this?

  • Add a "Repair your iPhone" button to your homepage that takes visitors straight to the iPhone repair list.
  • Create menu items in your website header that link to specific categories like Smartphones, Tablets, or Laptops.
  • Build landing pages for ads that skip the first few steps and go straight to a specific brand or model.
  • Share direct links in emails, SMS, or social media that take customers right where they need to be.
  • Auto-scroll to the booking form when the page loads, so visitors don't have to scroll down manually.

Example: You run a Google Ads campaign for Samsung Galaxy screen repairs. Instead of sending visitors to your homepage, you link them directly to yoursite.com/repair/?selected=repairs/Samsung/Galaxy-S24 -- they land right on the repair selection for that model.

Where to find it

There's no admin page for this. You build the URL yourself by adding a ?selected= parameter to the page where your [Repair_All] shortcode is placed.

Base URL: The URL of the page where you placed your [Repair_All] shortcode (e.g., https://yoursite.com/repair/).

How to set it up

Understand the URL structure

Every direct link follows the same pattern:

https://yoursite.com/repair/?selected=[step]/[name1]/[name2]

Replace https://yoursite.com/repair/ with the actual URL of the page where your [Repair_All] shortcode is placed.

To send visitors to the category selection step (Smartphones, Tablets, Laptops, etc.):

https://yoursite.com/repair/?selected=types

To show all brands within a specific category:

https://yoursite.com/repair/?selected=brands/Smartphones

Replace Smartphones with your category name. See the encoding rules below if your category name contains special characters.

To show all models for a specific brand within a category:

https://yoursite.com/repair/?selected=models/Smartphones/Apple

To go directly to the repair selection for a specific model:

https://yoursite.com/repair/?selected=repairs/Apple/iPhone-15

Note: The repairs URL uses the brand name and model name (not the category name).

Encode names for the URL

Category, brand, and model names need to be formatted for the URL. RepairPlugin uses these rules:

Character in the nameBecomes in the URLExample
Space- (hyphen)iPhone 15 becomes iPhone-15
Hyphen (-)_ (underscore)Galaxy S-24 becomes Galaxy_S-24
Plus sign (+)plusiPad 10.2+ becomes iPad-10.2plus
Forward slash (/)-slash-AC/DC becomes AC-slash-DC
Ampersand (&)-nd-Bang & Olufsen becomes Bang-nd--Olufsen

Tip: Not sure how a name is encoded? Navigate to the model manually in your booking form and check the URL in your browser's address bar. RepairPlugin updates the URL automatically as you click through the steps.

Auto-scroll to the booking form

If your booking form isn't at the top of the page, add scroll_to_rp=1 to automatically scroll visitors to it:

https://yoursite.com/repair/?selected=repairs/Apple/iPhone-15&scroll_to_rp=1
  1. In your WordPress admin, go to Appearance > Menus.
  2. On the left side, expand the Custom Links section.
  3. In the URL field, paste your direct link (e.g., https://yoursite.com/repair/?selected=brands/Smartphones).
  4. In the Link Text field, type the menu label (e.g., "Smartphone Repair").
  5. Click Add to Menu.
  6. Drag the new item to the desired position in your menu.
  7. Click Save Menu.

In most page builders (Elementor, Divi, WP Bakery, Gutenberg), you can add a button block and paste the direct link as the button URL. For example:

  • Elementor: Add a Button widget, paste the URL in the Link field.
  • Divi: Add a Button module, paste the URL in the Button Link URL field.
  • Gutenberg: Add a Buttons block, paste the URL in the link field.

Settings reference

ParameterDescriptionDefaultCustomers see
?selected=typesOpens the booking form at the category selection step--The category grid (Smartphones, Tablets, Laptops, etc.).
?selected=brands/[category]Opens the booking form at the brand selection step for a specific category--The brand grid for that category (Apple, Samsung, etc.).
?selected=models/[category]/[brand]Opens the booking form at the model selection step for a specific brand within a category--The model list for that brand (iPhone 15, iPhone 14, etc.).
?selected=repairs/[brand]/[model]Opens the booking form at the repair selection step for a specific model--The repair list for that model (Screen Replacement, Battery Replacement, etc.).
&scroll_to_rp=1Scrolls the page automatically to the booking form on load. Combine with any ?selected= parameter--The page scrolls down to the booking form instead of showing the top of the page.

Frequently asked questions

What if my category or brand name contains special characters?

Replace special characters using the encoding rules in the table above. The easiest way to find the correct URL is to navigate to the step manually in your booking form -- RepairPlugin updates the browser URL as you click through each step. Copy that URL and use it as your direct link.

Can I include a location in the URL?

No. Location pre-selection is only available through shortcode attributes (e.g., [Repair_All location="3"]). If you need location-specific links, create separate pages with location-specific shortcodes and link to those pages. See Shortcodes for details.

What's the difference between this and pre-selected shortcodes?

Pre-selected shortcodes (like [categories code="CAT001"]) require you to create a separate WordPress page for each link target. Direct URL links let you use a single page with one [Repair_All] shortcode and create as many different links as you want -- no extra pages needed.

Command Palette

Search for a command to run...