Troubleshooting

Bridge errors loudly on bad maps on purpose. Treat that as documentation, not insult.

I see unmapped or wrong map errors — what first?

Confirm sid_map includes a row for that service ID. Confirm the product ID is correct and the format is sid=product_id or valid JSON. Save, clear Joomla cache, hard-refresh, hold again. Unmapped services never fall back to another product.

The hold path fails validation — why?

Confirm the slot is still in the future and not already taken. Confirm the OSB service is published and bookable without Bridge on a baseline test if needed. Holds on past starts should not succeed; past starts are hidden in the bridge UI but other entry paths may still exist through OSB itself.

The product is in cart but not purchasable — why?

Confirm the J2Commerce product is published and purchasable on the same Joomla install you configured. Confirm you did not map to a draft product ID from staging notes. Conditional Products may block checkout separately; Bridge does not override those rules.

Continue to Checkout never appears — what order do I check?

Confirm the hold was valid on a mapped service. Confirm the mapped product entered the cart. Confirm Bridge is enabled. Open browser developer tools and look for JavaScript errors that prevent CTA rendering. Clear cache and retest with a simpler template temporarily if script conflicts are suspected.

Calendar JavaScript looks dead on osbtable pages — what now?

Confirm Bridge is enabled. Confirm OS Services Booking works on a non-embedded page. Look for template or optimization plugins breaking jQuery or OSB script order. Clear Joomla and browser cache. Version 1.0.5 and later specifically addressed Colorbox-before-jQuery and PHP 8.4 noise in embedded calendars; upgrade if you are on ancient builds.

Past times still show or the clock stays 24-hour — why?

Confirm you run current Bridge build, clear cache, and verify custom.css is not forcing old layout rules that hide the new UI. Layout parameters on the Layout tab affect expansion and columns, not AM/PM labeling, which comes from bridge slot rendering.

Storefront or Conditional Products “break” with Bridge — is Bridge broken?

Check expectations first. Bridge does not enforce Conditional Products rules and does not render Storefront catalogs. Test each RCA product against its own job description before you open three support tickets at once.

When do I email support?

Email This email address is being protected from spambots. You need JavaScript enabled to view it. with Joomla version, PHP version, OS Services Booking version, J2Commerce version, Bridge version 1.0.12 or newer, the service ID and product ID from sid_map, exact symptom, and whether Storefront or Conditional Products are installed.