Adds Vehicle search, Vehicle list and Vehicle Detail Page.
Features
- Integration to AutoDesktop
- Car search
- Show car-data
- Send leads to AutoDesktop
Requirements
For versions 2.x.x PHP 7.1+ is required!
A theme (does not work with themeless builders like Oxygen)
!There's currently issues with Divi 4.10.x - if you plan on using Divi please avoid using Divi 4.10.x!
Credits
Developed by AutoIT A/S
To be able to shown your own cars from AutoDesktop you must contact AutoIT Support, so we can create your personal API Key.
Please let us know if you like the plugin or you hate it or whatever... Please fork it, add an issue for ideas and bugs.
This plugin is internally using our proprietary JSON/REST API http://api-v1.biltorvet.as - this API connects to AutoIT A/S services, and proxies other 3rd party services as necessary to reduce the complexity of implementation. This server is located in Denmark and is thereby liable to the Danish law. This API operates with personal data. You can find our privacy policy at https://www.biltorvet.as/media/1389/privatlivspolitik-biltorvet-as.pdf
See the release tab in this repository to see the latest changes.
It's very important to follow the installation guide closely in order to make the plugin work. We advice against installing the plugin directly from Wordpress. Instead download the files from this repository. Make sure the plugin folder is called autoit-dealer-tools.
The plugin GitHub Updater makes updating this plugin easier: https://github.com/afragen/github-updater
Caching
All the custom pages can be cached but it's important to purge the cache of the vehicle details page often (The vehicle feed that's used get's updated each 15min).
Sharing the vehicle detailspage on socialmedia / SEO
The vehicle detailspage is created dynamically and so are the different tags that are used when sharing the page on socialmedia. It's important to disable Wordpress standard canonical url tag on this page and if Yoast Seo (or any other SEO plugin) plugin is used, either disable the autogenerated tags completely or for the vehicle detailspage only.
Create a wordpress landingpages for the following:
- A page for the car search and result list
- A page for the car detail
- A page for the form to book testdrive
- A page for the form to send purchase request
(List of shortcodes and implementation guide found at the bottom of this page)
Head over to the settings page of the plugin:
- Fill out the api-key that has been provided by AutoIT A/S.
- Choose you primary color (This will be used in multiple places)
- Configure the rest of the settings if needed.
Save the settings in all three tabs (if not the plugin might throw errors).
You are now ready to place the shorcodes on the landingpages
A shortcode is a piece of syntax that can be inserted anywhere in the WordPress text editor, and will then be processed into some kind of functionality. You can imagine shortcodes as building blocks you can move around. Shortcodes have optionally attributes, that change their output.
A shortcode is delimited by square brackets, for example [bdt_cta type="TestDrive"]
Examples of building the searchpage / resultlist and vehicledetailspage are shown at the end of this section
These shortcodes should work anywhere in WordPress.
bdt_vehicletotalcount
shows a total count of vehicles for the current dealer.
bdt_vehicle_search
Print out the vehicle search filter.
bdt_vehicle_search_results
Print out the search results - list of cars.
bdt_vehicle_search_frontpage
Specialized search for use on the frontpage (or any other landingpage that is not the main search and result page)
(Lots of possible ways to tweak what is shown and how it looks. See the setting "Forsidesøgning" in the plugin settings)
bdt_vehicle_card
Print out a vehicle "card" - a box with short informations about the vehicle. This is equal to one search result item from the vehicle search results.
Attributes:
- vehicle - specifies the vehicle ID. If omitted, it will look for bdt_vehicle_id URL parameter.
Labels
If statuscodes are used in AutoDekstop (statuscode are set in the tab "Status, annoncering og leasing") they will be shown on top of the vehicle image on the vehiclecards. A total of five labels can be shown on a vehiclecard at any given time. A special dealer specific label (Dynamic label, which can be change via the plugin settings) can be activated (Please contact our Support deparment for further information) and set in the settings menu.
bdt_featuredvehicles
Shows a list of vehicles that had been marked as "In focus" in AutoDesktop. This allows sold cars to show until removed from the index.
Attributes:
- type - Set the vehicle type. Valid types: Motorcycle, Car, Truck and Van.
- show - Set the amount of featured vehicles shown.
Example 1: [bdt_featuredvehicles show="3"] - 3 vehicles with the statuscode "I fokus" are shown.
Example 2: [bdt_featuredvehicles show="3" type="Car"] - 3 cars with the statuscode "I fokus" are shown.
bdt_get_vehicles
Creates a list of cars from specific filters
Attributes:
- make
- model
- companyid
- propellant
- bodytype
- vehicletype (Personbil, Varebil, Motorcykel, Lastbil)
- vehiclestate (Fabriksny, Brugt)
- hidesoldvehicles (true)
- minprice
- maxprice
- orderby
- ascending (true, defaults to false)
Both minprice and maxprice are needed in order to use the price filter (See example 4) and both values needs to be integers.
When using the attribute "orderby" the follwing values are valid: "(”DateEdited”, ”Mileage”, ”FirstRegistrationYear”, ”Consumption”, ”Make”, “Price”.
Example 1: [bdt_get_vehicles make="Audi"] - lists all cars with the make "Audi".
Example 2: [bdt_get_vehicles make="Audi" model="A5"] - lists all cars with the make "Audi" and model "A5".
Example 3: [bdt_get_vehicles make="Audi" model="A5" propellant="diesel"] - lists all cars with the make "Audi", model "A5" and uses diesel as propellant.
Example 3: [bdt_get_vehicles minprice=0 maxprice=50000 orderby="Price"] - lists all cars with with a cash price between 0,- and 50000,-. The list is order by price (descending).
bdt_get_vehicles_by_status_code
Creates a list of cars from status codes set in AutoDesktop (In order to use this shortcodes the dealer has to list cars using AutoDesktop. BilInfo cars are currently not supported as it's specific fields set in AutoDesktop).
Required attribute:
- status
Optional attributes:
- state
- make
- orderby
- ascending
The following status codes are currently supported:
- Sold - Shows all cars with the label "Solgt".
- New - Shows all cars with the label "Nyhed".
- Leasing - Shows all cars with the label "Leasing".
- Warehousesale - Shows all cars with the label "Lagersalg".
- Flexleasing - Shows all cars with the label "Flexleasing".
- Export - Shows all cars with the label "Eksport".
- Upcoming - Shows all cars with the label "På vej ind".
- Rental - Shows all cars with the label "Udlejning".
- Commision - Shows all cars with the label "Kommision".
- Wholesale - Shows all cars with the label "Kun engros".
- Demo - Shows all cars with the label "Demonstration".
- NewCar - Shows all cars with "Fabriksny" checked in AutoDesktop.
- Carlite Dealer Label - Shows all vehicles with "CarLite forhandler label" checked in AutoDesktop.
- Trailer - Show all vehicles with the "Trailer" statuscode checked in AutoDesktop.
- NoTax - Show all vehicles with the "Uden afgift" statuscide checked in AutoDesktop.
Example 1: [bdt_get_vehicles_by_status_code status="Sold"] - lists all cars marked as "Solgt".
bdt_get_vehicles_by_type
Creates a list of cars from their type.
Required attribute:
- type
Optional attributes:
- make
The following types are currently supported:
- Car - Shows all vehicles of the type "Car".
- Van - Shows all vehicles of the type "Van".
- Motorcycle - Shows all vehicles of the type "Motorcycle".
- Truck - Shows all vehicles of the type "Truck".
The following states are currently supported:
- BrandNew - only vehicles with "Fabriksny" checked in AutoDesktop.
- Used - Used vehicles.
Example 1: [bdt_get_vehicles_by_type type="Car"] - lists all vehicles with the type "Personbil".
[bdt_map]
It's only possible to use this shortcode once on every page!
To activate the map go to the plugin settings as check "Activate map". The rest of the settings can be left as they are or changed if needed. Add the following CSS to get a full-width map with a height of 400px:
#map { height: 400px; width: 100%; }
Custom tiles and markers are support by adding them in the plugin settings. Below is a list of a few free tiles that can be used:
- https://{s}.basemaps.cartocdn.com/rastertiles/voyager/{z}/{x}/{y}{r}.png
- https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
- https://{s}.tile.openstreetmap.fr/hot/{z}/{x}/{y}.png
- https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}{r}.png
if the shortcode is used on the vehicle detailspage use the attribute "detailspage" with the value "true" ([bdt_map detailspage="true"]) the department where the vehicle is located will automatically be marked on the map.
These will work only on a vehicle detail template page.
bdt_cta
This will generate a CTA button, with a link to the contact page or booking page with parameters that facilitate the leads functionality. It can be opened and content inserted will become wrapped in a link element.
Attributes:
- color - hexadeximal color with a hash, or a color name that colors the CTA text and icon. If omitted, the CTA takes on the primary color.
Attributes:
- type - one of the five following types:
- TestDrive - book test drive
- PhoneCall - call me back
- Purchase - buy the car
- Email - send email
- Contact - general contact
Example 1: [bdt_cta type="TestDrive"]
Example 2: [bdt_cta type="TestDrive"] This content will be shown instead of the icon and predefind text.[/bdt_cta]
bdt_prop
Fetch a property of a car - currently needs to be the danish caption. These are directly matched from the database, so this list may be
incomplete/obsolete.
Attributes:
- p - see the list below.
- nona="-" - text to show when no match was found. If omitted, returns "Ikke angivet".
- raw="true" - returns the unformated value. Useful in cases where the value needs to be further processed or used.
Example: [bdt_prop p="0-100"]
Properties:
- Company,
- BodyType,
- Mileage,
- ModelYear,
- Price,
- XVat - Without VAT(MOMS) Ja/Nej,
- Acceleration,
- FirstRegistrationDate,
- AirbagCount,
- CylinderCount,
- DoorCount,
- GearCount,
- GearType,
- SeatCount,
- AnnualOwnerTax,
- PropellantType,
- Width,
- Color,
- Height,
- Kmx1l - kilometers per liter,
- Whx1km,
- Length,
- DeliveryCost,
- MaxTorque,
- MaxHorsepower,
- EngineSize,
- RegistrationNumber,
- VIN,
- LastChangedDate,
- TopSpeed,
- TotalWeight,
- TankCapacity,
- AllowedTrailerWeightWithBrakes,
- AllowedTrailerWeightWithoutBrakes,
- DealersReferenceNumber,
- EquipmentItem - A general type for all equipment. Equipment is not mapped, i.e. you cannot fetch a particular equipment item.
- LeasingDeal,
- LeasingBusiness,
- LeasingFirstPayment,
- LeasingFirstPaymentVAT,
- LeasingRunTime,
- LeasingMonthlyPayment,
- LeasingMonthlyPaymentVAT,
- LeasingRemainingValue,
- FinancingAnnualLoanFeesInPercents,
- FinancingAnnualDebitorInterest,
- FinancingFixedInterest,
- FinancingMonthlyPrice,
- FinancingLoanTransfer,
- FinancingRunTime,
- FinancingInterestRate,
- FinancingTotalCreditFees,
- FinancingTotalFeesToPay,
- FinancingTotalSetupFees,
- FinancingDownpayment,
- FinancingDownpaymentInPercent
bdt_specifications
Print out a table of the specifications.
[bdt_prop p="description"]
Print out the car description.
bdt_equipment
Print out a table of equipment
bdt_additional_equipment
Print out a table of additional equipment set in AutoDesktop.
bdt_recommendedvehicles Print out three recommended unsold vehicles, related to the current vehicle.
bdt_slideshow
Print out a slideshow of current vehicle's images.
bdt_vehicle_labels
Print out a list of labels asociated with the given car. Labels come in predefined colors, that can be overwritten with CSS in your child theme:
- .bdt .badge-primary - used as default label color,
- .bdt .badge-danger - used for sold label,
- .bdt .badge-success - used for new label,
- .bdt .badge-warning - used for reserved label,
- .bdt .badge-info - used for leasing label
- .bdt .badge-orange - used for "I fokus" label
- .bdt .badge-secondary - used for "Lagersalg" label
- .bdt .badge-dark - used for "Uden afgift" label
- .bdt .badge-purple - used for "Udlejning" label
Attributes:
- allowed="" - comma separated list of labels that are allowed to be shown. Use this if there are too many labels available, and you don't necessarily want to show them all. If ommited, all labels will be returned.
Example 1: [bdt_vehicle_labels allowed="Nyhed,Solgt,Leasing,Reserveret,Demonstration,Fabriksny,Kun engros"
bdt_vehicle_search_backtoresults
Prints out a "smart" back button, that returns you to the vehicle search results if available, or car search if not.
bdt_vehicle_price
Shows intelligently the "most attractive" price of a vehicle - i.e. financing or leasing if available, or the cash price as fallback.
bdt_sharethis
Shows icons for Facebook-sharing, sharing by mail and printing.
To be able to send leads to AutoDesktop you need to create forms on the pages that you have specified on the settingspage of the AutoIt plugin.
To be able to send leads when the forms get submitted, you need to set the ID’ to the specific inputs fields. Se example below to see an example with the Contact Form 7 plugin.
To show a car-card next to the form, as showed below, use this shortcode: [bdt_vehicle_card]
NB The vehicle-card will only be visible, when a client comes directly from a vehicle detailspage.
[bdt_widget] Required attribute:
- type
Supported widget-types:
- Santander - Santander widget. WORKS ONLY ON THE VEHICLE DETAIL PAGE.
The widgets should work without any additional parameters, as the usual clientID parameter is resolved automatically by association to the companyId associated with the current API key. Widgets can be used anywhere in your WordPRess installation, except for Santander widget that can only be used on a vehicle detail page, because it requires some inputs about a vehicle to be displayed.
The [bdt_widget] shortcode can be opened in order to insert some content and put a link on it. In such case, the widget won'd be embedded; but when the link is clicked, a new window opens with a widget inside. In case that your desired widget type doesn't show up, make sure that it had been activated for your company - contact Biltorvet A/S support to get a widget activated for your API key. Additionaly, you may want to reuse a specific widget ID instead of relying on automatic resolve. For that, use externalid attribute, for example [bdt_widget externalid="XXXXXX-XXXX-XXXX-XXXXXX"].
Widget attributes
All widgets have following common attributes, that you can use to tweak their appearance for your particullar instance:
- color - sets the primary theme color for the given widget.
- logourl - sets the URL for the logo to be displayed inside.
- fontcolor - sets the primary theme color for the font inside.
- fontfamily - sets the google font to be loaded for the whole widget. (not implemented yet)
Example 1: [bdt_widget type="Santander" color="#ff0000"]
Widget type specific attributes
Some widgets allow you to specific attributes.
Santander:
- hideVehiclePrice="true" - hides the vehicle price in the widget, which is useful in the vehicle detail page, where there's probably price in some other place already.
- brandingid - some dealers have a specific branding.
FindLeasing
Jyffi
FindLeasing
Shortcode:
[bdt_findleasing_calculator] renders a FindLeasing widget if the current vehicle has the relevant leasing calculations from FindLeasing (FindLeasing external id).
Note: This widget only works on the vehicle details page
Jyffi
Currently in dev mode.
How the search, result and detailspage can be build.
Car search / resultlist
Vehicle detailspage
When using the plugin it's important to notice that the searchpage and resultlist won't work optiomal unless the landingpage used for the shortcodes is placed in the root of the domain.
Example 1: demo1.biltorvet.as/brugte-biler - Everything will work justfine.
Example 2: demo1.biltorvet.as/out-new-homepage/brugte-biler - Filtering options, pagination and such won't work as it should.
Be sure to remember this when creating a website using this plugin.
Car search / resultlist
[bdt_vehicletotalcount]
[bdt_vehicle_search]
[bdt_vehicle_search_results]
Vehicle detailspage
[bdt_vehicle_search_backtoresults]
[bdt_sharethis]
[bdt_slideshow]
[bdt_prop p="makeName"]
[bdt_prop p="model" nona="true"]
[bdt_prop p="variant"]
[bdt_vehicle_labels allowed="Nyhed,Solgt,Leasing,Reserveret,Demonstration"]
[bdt_vehicle_price]
[bdt_cta type="TestDrive" color="#ffffff"] (Change the color if needed)
[bdt_cta type="Purchase" color="#ffffff"]
[bdt_prop p="FirstRegYear"]
[bdt_prop p="Color"]
[bdt_prop p="mileage"]
[bdt_prop p="Geartype"]
[bdt_prop p="PropellantType"]
[bdt_prop p="Kmx1l"]
[bdt_cta type="Contact"]
[bdt_cta type="Email"]
[bdt_cta type="PhoneCall"]
[bdt_prop p="company"]
[bdt_prop p="description"]
[bdt_equipment]
[bdt_specifications]
[bdt_additional_equipment]
[bdt_recommendedvehicles show="3"]
Bookingspage
[bdt_vehicle_card nona="Ingen bil valgt"]