Skip to content

Get Started

This documentation is for webmasters implementing the DO AudioTours player on real estate websites. The player automatically displays multilingual audio tours when they're available through the agent's MLO subscription.

Try our live demo to see the audio player in action.

Quick Setup

1. Add Player Code

Place this code where you want the audio player to appear:

<!-- Widget Code -->
<do-audio-tour-player-v2 
    listingId="[MLS_NUMBER]"
    zipCode="[ZIP_CODE]">
</do-audio-tour-player-v2>

<!-- Widget Script -->
<script id="do-audio-tour-player" 
    type="module" 
    src="https://player.doaudiotours.com/do-audio-tour-player-v2.js?key=[YOUR_API_KEY]">
</script>

2. Replace Values

  • Replace [MLS_NUMBER] with your listing's MLS number (must be dynamically populated for each listing)
  • Replace [YOUR_API_KEY] with the API key from the email you received
  • Optional: Replace [ZIP_CODE] with the listing's ZIP code (should be dynamically populated if used)

3. Implement Dynamic Values

The player requires proper dynamic values to function. For example:

<!-- WordPress Example -->
<do-audio-tour-player-v2 
    listingId="<?php echo get_post_meta(get_the_ID(), 'mls_number', true); ?>"
    zipCode="<?php echo get_post_meta(get_the_ID(), 'zip_code', true); ?>">
</do-audio-tour-player-v2>

<!-- JavaScript Example -->
<do-audio-tour-player-v2 
    listingId="<%= listing.mlsNumber %>"
    zipCode="<%= listing.zipCode %>">
</do-audio-tour-player-v2>

Implementation Examples

Basic HTML Page

<!DOCTYPE html>
<html>
<body>
    <!-- Widget implementation with sample values -->
    <do-audio-tour-player-v2 listingId="12345" zipCode="90210"></do-audio-tour-player-v2>
    <script id="do-audio-tour-player" 
        type="module" 
        src="https://player.doaudiotours.com/do-audio-tour-player-v2.js?key=YOUR_API_KEY">
    </script>
</body>
</html>

Optional Settings

Setting Description Example
listingId Required: Your MLS number listingId="12345"
zipCode Optional: ZIP code for the listing zipCode="90210"
pageTranslate Enable page translation pageTranslate="true"
playerTheme Choose light or dark theme playerTheme="light"
defaultLanguage Set default language defaultLanguage="es-US"

How do I get MLS numbers dynamically?

Your MLS number should be available through your listing platform. Common methods:

  • WordPress: <?php echo get_post_meta(get_the_ID(), 'mls_number', true); ?>
  • IDX: data-mls or similar attributes on listing elements
  • Custom: Your listing database field

Nothing appears on the page?

  1. Check browser console for errors
  2. Verify API key is correct
  3. Confirm MLS number is valid

Support

Having technical issues? Check our:

Need implementation support? See our Contact & Support page.