Locatie en openingstijden

Dit document behandelt de locatie- en openingstijdenfunctie van de ADP Car Market Hub WordPress Plugin: hoe dealerlocaties worden weergegeven op voertuigdetailpagina's, hoe shortcodes locatiegegevens elders kunnen insluiten en hoe de functie wordt geconfigureerd.

Wanneer u dit document moet gebruiken

Lees dit document als u voor het eerst locaties instelt, openingstijden toevoegt aan de voertuigdetailpagina of de shortcodes voor locatie en uren op andere pagina's gebruikt.

Overzicht

De plugin bevat een functie Locaties die locatiegegevens van dealers of vestigingen (adres, telefoon, Google Maps-locatie en openingstijden) opslaat samen met een of meer AutoScout24 Seller IDs. Wanneer de Seller ID van een voertuig overeenkomt met een geconfigureerde locatie, toont de plugin automatisch het bijbehorende adresvak en openingstijdenvak na het contactformulier op de voertuigdetailpagina.

Dezelfde informatie kan ook op elke WordPress-pagina worden weergegeven met behulp van speciale shortcodes.

Vereisten of randvoorwaarden

• Er moet ten minste één locatie zijn geconfigureerd in de plugin-beheeromgeving (plugin-instellingen → tabblad Locaties).
• Elke locatie moet gekoppeld zijn aan ten minste één Seller ID die overeenkomt met de _as24ci_seller_id post-metawaarde die is opgeslagen op voertuigberichten.
• Om locatie en uren automatisch op voertuigdetailpagina's te laten verschijnen, moet de plugin actief zijn en moet de Seller ID van het voertuig zijn ingesteld.

Stapsgewijze instructies

Een locatie configureren

1. Open in het WordPress-beheer de plugin-instellingen en navigeer naar het tabblad Locaties.
2. Klik op Locatie toevoegen of bewerk een bestaande locatie.
3. Vul de locatiegegevens in: - Naam: De naam van de dealer of de vestiging. - Straat: Straatnaam en huisnummer. - Postcode: Postcode. - Stad: Plaatsnaam. - Telefoon: Contacttelefoonnummer. - Google Maps-locatie: Optionele Google Maps-URL voor een knop "Route plannen". Wordt automatisch gegenereerd op basis van de locatienaam en het adres wanneer deze leeg is. U kunt ook een aangepaste Google Maps-URL plakken. - Seller IDs: Een of meer AutoScout24 Seller IDs die aan deze locatie zijn gekoppeld. - Openingstijden: Een of meer categorieën, elk met rijen van combinaties van dagbereik en tijdsbereik.
4. Sla de locatie op.

Na het opslaan verschijnen het adres en de uren van de locatie automatisch op de detailpagina van elk voertuig waarvan de Seller ID overeenkomt met een van de geconfigureerde Seller IDs voor die locatie.

Locatie-informatie op elke pagina insluiten met shortcodes

1. Open de WordPress-pagina of het bericht waar u locatie-informatie wilt weergeven.
2. Voeg een van de volgende shortcodes toe in de inhoudseditor:

• Locatievak (adres, telefoon, knop route plannen):

  [as24ci_location_box post_id="123"]

• Openingstijdenvak:

  [as24ci_hours_box post_id="123"]

Vervang 123 door de WordPress post-ID van het voertuig waarvan u de bijbehorende locatie wilt weergeven.

1. Als u het attribuut post_id weglaat, gebruikt de shortcode de ID van het huidige bericht in de loop. Dit is handig wanneer u de shortcode in een voertuigbericht-template plaatst.

Configuratiereferentie

Locatievelden

Elke locatie wordt opgeslagen als een item in de optie locaties van de plugin (as24ci_locations). De volgende velden worden ondersteund:

Structuur openingstijden

Openingstijden zijn georganiseerd als een lijst met categorieën. Elke categorie heeft een label en een of meer rijen:

Voorbeeldstructuur voor een enkele categorie:

Category: Sales
  Row 1: Mon–Fri / 08:00–18:00
  Row 2: Sat / 09:00–16:00

Zowel de velden days als time zijn vrije tekstvelden. De plugin valideert of analyseert de inhoud ervan niet.

Shortcodes

Beide shortcodes accepteren een attribuut post_id. Indien weggelaten, wordt de huidige post-ID in de loop gebruikt. Als er geen overeenkomstige locatie wordt gevonden voor de Seller ID van het voertuig, retourneert de shortcode een lege uitvoer.

Operationele opmerkingen

• Het zoeken naar locaties wordt uitgevoerd door de _as24ci_seller_id post-metawaarde van het voertuig te vergelijken met de seller_ids-array van elke geconfigureerde locatie. De eerste overeenkomende locatie wordt gebruikt.
• De vakken voor locatie en uren worden na de contactformuliersectie gerenderd via de as24ci_after_contact_form action hook. Beide vakken zijn verpakt in een container-div (as24ci-location-hours-wrapper). Als geen van beide inhoud heeft, wordt er niets gerenderd.
• Het openingstijdenvak wordt alleen gerenderd wanneer de overeenkomende locatie ten minste één niet-lege urencategorie heeft.
• Locatiegegevens worden opgeslagen als een geserialiseerde array in de WordPress-optietabel met autoload uitgeschakeld. Het wordt alleen geladen op voertuigdetailpagina's en in het plugin-beheer, niet bij elk paginaverzoek.
• Het locatievak bevat een knop "Route plannen" wanneer er een Google Maps-URL beschikbaar is — ofwel het veld url is ingesteld, of het kan automatisch worden gegenereerd op basis van de locatienaam en het adres. Er worden geen externe API-aanroepen gedaan; de automatisch gegenereerde URL gebruikt het eenvoudige https://www.google.com/maps/search/?api=1&query=…-formaat.
• Als een voertuig geen _as24ci_seller_id-metawaarde heeft, worden noch het locatievak noch het urenvak gerenderd.

Probleemoplossing

Het locatievak verschijnt niet op een voertuigdetailpagina.

• Controleer of het voertuig een _as24ci_seller_id-metawaarde heeft. Dit wordt ingesteld tijdens de import. Open het voertuig in het WordPress-beheer en controleer de voertuig-metavelden.
• Controleer of er een locatie is geconfigureerd in de plugin-instellingen met een overeenkomende Seller ID.
• Controleer of het contactformulier zichtbaar is op de pagina. De vakken voor locatie en uren worden na de contactformuliersectie gerenderd via een hook op as24ci_after_contact_form. Als het contactformulierblok is uitgeschakeld in de Layout Manager, wordt de hook mogelijk niet geactiveerd.

Het openingstijdenvak verschijnt niet, hoewel er wel een locatie is geconfigureerd.

• Controleer of de locatie ten minste één categorie voor openingstijden heeft met ten minste één rij.
• Als de categorie en rijen aanwezig zijn maar het vak nog steeds niet verschijnt, controleer dan of de gegevens correct worden opgeslagen in het tabblad Locaties in het beheer.

De shortcode geeft lege uitvoer.

• Controleer of het attribuut post_id verwijst naar een gepubliceerd voertuig met een geldige _as24ci_seller_id.
• Controleer of er een locatie is in de plugin-instellingen met een overeenkomende Seller ID.
• De shortcode retourneert lege uitvoer wanneer er geen overeenkomende locatie wordt gevonden of wanneer het voertuig geen Seller ID heeft. Dit is verwacht gedrag.

De knop "Route plannen" verschijnt niet.

• De knop wordt gerenderd wanneer de locatie een Google Maps-URL heeft of voldoende adresgegevens (naam, straat, postcode, plaats) om er automatisch een te genereren. Als geen van beide beschikbaar is, vul dan het veld Google Maps-locatie of de adresvelden in op het tabblad Locaties in het beheer.

Gerelateerde documenten

• Voertuigdetailpagina's
• Shortcodes-referentie