CSV Importer

Mass import up to thousands of Cars into WP Car Manager with the CSV Importer. This user-friendly importer, with clear step-by-step instructions helps you import Cars including their categories, tags, files into WP Car Manager.

Installation

  • Unzip and upload the plugin’s folder to your /wp-content/plugins/ directory
  • Activate the extension through the ‘Plugins’ menu in WordPress

For more information on installing and managing plugins see here

Preparing the CSV file

Before you can start the import process you need to create a CSV file that contains the cars you want to import. We’ve created an example CSV file you can use that contains the default headers and a sample car row.

Usage

After installing the extension head over to Tools > Import and click on the WP Car Manager CSV Importer link.

Click on the CSV Importer in the list of available importers

Upload the CSV file

At the first step of the CSV Importer you select your CSV file and set the used delimiter. By default CSV files use a comma , as delimiter but if you’ve created a spreadsheet on Mac using Numbers and exported to CSV the delimiter is most likely a ;

Select the CSV file and set the delimiter

Mapping the data

At the next step you ‘map’ the columns found in the CSV file to your car data fields. The extension will try to map as many columns automatically by recognizing the column header names. After you’ve mapped all columns you want to import to WP Car Manager fields press the Start Import button.

Map the CSV columns to the correct WP Car Manager fields

After the import is done you will be redirected to a page telling you how many cars have been imported.

Troubleshooting

My csv file won’t upload on my Multisite

In WordPress Multisite(Network) you need to add the csv file extension to the list of allowed file extensions in the network wide general settings.

Add csv extension to list of allowed file extensions

FAQ

How do I add multiple car features?

Enter all features you want to add to the car in one column separated by a pipe |.

Will new Makes and Models automatically be added?

Yes, all Makes and Models that don’t exist yet in your WP Car Manager website will automatically be added.

CSV Exporter

Export all your cars / vehicles to a CSV file with a single click! The CSV Exporter exports all cars including features, makes, models and all car data to a CSV file! The exported CSV is importable with the CSV Importer Extension (to be released soon).

Installation

  • Unzip and upload the plugin’s folder to your /wp-content/plugins/ directory
  • Activate the extension through the ‘Plugins’ menu in WordPress

For more information on installing and managing plugins see here

Usage

After installing the extension head over to Car Listings > Export to CSV. This screen will show you how many cars are found that can be exported. Click the Start Export button to generate and download the CSV file.

Press the "Start Export" button to download the CSV file
Press the “Start Export” button to download the CSV file

Adding Export Fields

You can expand the default set of fields that are exported by the CSV Exporter Extension with custom meta data. The key of the array is the database meta field and the value is the label you want to use in your CSV file. You can use the wpcm_ce_extra_fields_vehicle_meta filter to add the custom meta fields.

<br />
add_filter( ‘wpcm_ce_extra_fields_vehicle_meta’, function( $fields ) {<br />
	$fields[ ‘my_custom_meta_key’ ] = ‘My Custom Meta Label’;<br />
} );<br />

FAQ

Is there an extension available for importing the CSV file?

Not yet but we’re working very hard to have this available very soon. Be sure to subscribe to our newsletter so we can notify you once the extension is released!

ADF Leads

Thank you for purchasing the ADF Leads extension for WP Car Manager. With this extension you can collect customer leads in the industry standard Auto-Lead Data Format (ADF), directly from the listing page.

Installation

  • Unzip and upload the plugin’s folder to your /wp-content/plugins/ directory
  • Activate the extension through the ‘Plugins’ menu in WordPress

For more information on installing and managing plugins see the Managing Plugins documentation.

Setup

Before installing and activating the extension, make sure you have the following plugins active:
WP Car Manager version 1.3.0 or higher
If you’re installing WP Car Manager for the first time, it’s important you follow the onboarding steps offered to you after activation. The onboarding screen offers you the possibility to create all (3) needed pages for WP Car Manager to function properly. We highly advise you let the onboarding screen create these pages.

Configuration

The ADF Leads can be configured in the WP Car Manager settings page (Car Listings -> Settings -> ADF Leads).

WP Car Manager - ADF Leads Settings
The ADF Leads Settings Screen

The configuration requires the following information:

Vendor Name
Required
The name of the vendor (dealer) receiving the lead.

Provider Name
Required
The name of the service originating the lead.

Provider Email
Required
The email of the service originating the lead.

Submission Email
Required
The email address receiving the lead.

Testing the Configuration

Once the ADF Lead is configured, you can test the submission by enabling the “ADF Debug Mode” setting. This setting allows you to preview the generated ADF data without sending the email to the configured submission email.
When testing is complete, simply disable the “ADF Debug Mode” to continue sending ADF leads.

Submitting ADF Leads

WP Car Manager - ADF Leads Frontend Form
The ADF Leads Form

Once activated, the ADF Leads extension replaces the “Email Us” link on the vehicle listing with a lead form for collecting the customer’s name, telephone, email address, and a short message.
When submitted, this form generates the ADF lead with the vehicle info, customer info, and provider info, which is then sent to the configured submission email.

FAQ

Does this support my automotive CRM provider?

The Auto-lead Data Format (ADF) is an industry standard format for communicating leads between automotive companies. Most automotive CRM providers accept leads in ADF format.

Makes and Models Sync

Thank you for purchasing the Makes and Models Sync extension for WP Car Manager. With this extension you can import up to 60 makes and over 900 models into your WP Car Manager website.

Installation

  • Unzip and upload the plugin’s folder to your /wp-content/plugins/ directory
  • Activate the extension through the ‘Plugins’ menu in WordPress

For more information on installing and managing plugins see here

Setup

Before installing and activating the extension, make sure you have the following plugins active:

  1. WP Car Manager version 1.3.0 or higher

If you’re installing WP Car Manager for the first time, it’s important you follow the onboarding steps offered to you after activation. The onboarding screen offers you the possibility to create all (3) needed pages for WP Car Manager to function properly. We highly advise you let the onboarding screen create these pages.

Importing the Makes and Models

You can find the import screen via Tools > Import.

The Makes and Models Sync link is located in the Tools screen
The Makes and Models Sync link is located in the Tools screen

On the import screen you can select what Makes you like to import. The extension will automatically import all Models of the Makes you are importing. If a Make already exists that you selected for import, the extension will still import all of it’s models that don’t exist yet.

Select the Makes you want to import and press the 'Import Makes & Models' button.
Select the Makes you want to import and press the ‘Import Makes & Models’ button.

FAQ

What happens if a Make/Model already exists?

The extension checks if a Make or Model already exists before importing it into your website. By doing so we’ll prevent the creation of duplicate Makes or Models.

Note that if a Make already exists that you selected for import, the extension will still import all of it’s models that don’t exist yet.

Paid Listings

Paid Listings for WP Car Manager powered by WooCommerce. Setup purchasable car listing packages which can be purchased during frontend car submission.

Installation

  • Unzip and upload the plugin’s folder to your /wp-content/plugins/ directory
  • Activate the extension through the ‘Plugins’ menu in WordPress

For more information on installing and managing plugins see here

Setup

Before installing and activating the extension, make sure you have the following plugins active:

  1. WP Car Manager version 1.3.0 or higher
  2. WooCommerce version 2.5.0 or higher

If you’re installing WP Car Manager for the first time, it’s important you follow the onboarding steps offered to you after activation. The onboarding screen offers you the possibility to create all (3) needed pages for WP Car Manager to function properly. We highly advise you let the onboarding screen create these pages.

If you’re installing WooCommerce for the first time, it’s important you follow the onboarding wizard it provides upon installation. This makes sure all the needed pages are created as well as making sure your settings like currency and country are setup correctly. The onboarding wizard also helps you setup your payment gateway(s), which you’ll need to start selling car listings.

After you’ve installed, activated and correctly setup the plugins described above, you can install and activate the Paid Listings extension.

Note: The Paid Listings extension detects if above required plugins are installed and activated upon activation. If they are not, the extension will display a warning and will deactivate itself.

Usage

Setup the Car Listing Package

Before you can start selling Paid Car Listings, you will need to create at least one Car Package WooCommerce product. We’ve described the steps to do so below, each step is numbered and has a corresponding number in the image.

  1. In the WordPress admin menu, go to Products > Add Product
  2. Enter a title for your Car Listing Package, this will be displayed on your website as well.
  3. Select the Car Package as product type.
  4. Set the price of your Car Package.
  5. Set the amount of car listings someone can place with this package.
  6. Set the duration of the car listing(s) in days.
Setting up the WooCommerce Car Package product
Setting up the WooCommerce Car Package product

You can create as many Car Packages as you like by repeating these steps. You can for example create a Car Package which allows someone to list one car for 30 days for $4.99 and create a Car Package that allows someone to list five cars for 30 days for $20.99. This way you can offer your users discounts if they pre-purchase a larger amount of listings.

Setup Car Submission Settings

Although optional we do recommend you have a look at the Submission settings before you start offering paid listings on your website. WP Car Manager and its Paid Listing extension come with default values that are correct for most websites but we recommend you go over them and confirm them.

You can view your Car Submission settings by going to Car Listings > Settings in the WordPress admin menu. In the settings screen, click on the Submission tab.

Setting up the Car Submission Settings
Setting up the Car Submission Settings

After confirming the submission settings, or changing them and saving your changes, your website is ready to start selling car listings. If you used the WP Car Manager onboarding page, a page is created named Submit Car. On this page your users can submit their vehicles, select one of the Car Listing Packages you created and pay via WooCommerce using one of the WooCommerce payment gateways you installed.

Managing User Listing Packages

You can view and manage user purchased listing packages in your WordPress administration panel by going to Car Listings > Listing Packages.

List of packages purchased by your users
List of packages purchased by your users

You can a edit a listing package by clicking the wheel icon, located at the end of each row. At the listing package edit screen you can change any data of a Listing Package you like. It’s recommended not to manually change Order ID’s, unless you know what you’re doing. This screen is mostly used to alter the limit or count of listing packages.

Editing an User Package
Editing an User Package

Adding new listing packages to users can be done by clicking the Add Package button located right of the page title (Paid Listing Packages).

Adding a Car Package to a user
Adding a Car Package to a user

The product and Customer ID fields are mandatory, the rest of the fields are optional.

If you choose not to enter a WooCommerce Order ID, the user package will simply not be linked to any order. This doesn’t affect the way the user listing works, it’s simply not linked to any WooCommerce order.

If you choose not to enter a Duration and/or Limit, the duration/limit of the chosen Product Package will be used. Meaning you can leave these fields blank when entering a new package to a user unless you want to have a different value than the Car Package normally has.

The Count field will be set to 0 if you leave this blank, as most newly added user packages will start with 0 listings used.

Customer Usage

After following the instructions in the Setup and Usage section, your users will now automatically be prompted to choose a package when they submit their car via your website.

You can choose whether a user will be prompted to choose a package before entering the car details or afterwards. By default a user is asked to choose a package after entering the car details, you can change this at the Paid Listing Flow setting located in the Submission tab in your WP Car Manager settings.

Users can choose one of the available packages when creating a listing on you website
Users can choose one of the available packages when creating a listing on you website

The user will always be offered to purchase any of the Car Packages you created in the Usage section. The user will also be offered all Car Packages that they own that still have available listings on them.

If the user chooses one of their own packages, the listing will be submitted and a listing will be subtracted from their package. If the user chooses a new listing, they will be redirected to the WooCommerce checkout page which will have the selected Car Package in their cart. On the checkout page they can fill out the required personal information, select a payment method and do the payment. After the payment is complete the package will be added to the user’s account and their listing will be submitted.

Depending on your WP Car Manager submission settings, the listings will be published immediately or will be pending for administrator review.

FAQ

When does the expiration date gets set?

The listing expiration date will be calculated and set when the listing gets published. Depending on your submission settings this will be done immediately after payment or whenever and administrator approves the listing.

Note that the amount of days a listing receives is saved upon purchasing the listing. So if someone purchases a package that includes listing for 30 days today and you change the listing duration to 20 days tomorrow, the user will still receive 30 days listing(s).

Car Dashboard

Upon installation the plugin you will be allowed to let WP Car Manager setup 3 pages, including the ‘Car Dashboard’ (could be translated to your websites language) page that contains our [wpcm_dashboard] shortcode.

The Dashboard page is an overview page of all cars created of logged in user. This page allows logged in users to edit or delete their own listings. You can create the Dashboard page manually by creating a new page and add the [wpcm_dashboard] shortcode to it.

If you allowed to plugin to create the page via the installation screen everything will be setup correctly. If you manually created the page, please don’t forget to set your new page as the Car Dashboard in the Pages tab of your WP Car Manager settings.

Shortcode Attributes

The Car Dashboard shortcode has not attributes.

Submit Car Form

Upon installation the plugin you will be allowed to let WP Car Manager setup 3 pages, including the ‘Submit Car Page’ (could be translated to your websites language) page that contains our [wpcm_submit_car_form] shortcode.

To allow users to submit their listings to your website, simply add the [wpcm_submit_car_form] to a page. You can change the behavior of the form by going to the Car Submission tab in your WP Car Manager settings. Here you can change settings like the default listing duration, if user can create a new account while they create a listing and the default role new users will get.

If you allowed to plugin to create the page via the installation screen everything will be setup correctly. If you manually created the page, please don’t forget to set your new page as the Submit Car Page in the Pages tab of your WP Car Manager settings.

Shortcode Attributes

The Submit Car Form shortcode has not attributes.

Content Templates

When outputting cars, WP Car Manager uses special templates to control the appearance of the listing and detail pages. For example, price.php contains the following:

<br />
<?php
if ( ! defined( 'ABSPATH' ) ) {
	exit;
} // Exit if accessed directly


global $vehicle;
?></p>
<div class="wpcm-price-wrapper" itemprop="offers" itemscope itemtype="http://schema.org/Offer">
	<span class="wpcm-price"><?php echo $vehicle->get_formatted_price(); ?></span></p>
<p>	<meta itemprop="price" content="<?php echo $vehicle->get_price(); ?>”/><br />
	<meta itemprop="priceCurrency" content="<?php echo wp_car_manager()->service( ‘settings’ )->get_option( ‘currency’ ); ?>”/>
</div>
<p>

This template part outputs the price on your car detail page:

The price template
The price template

WP Car Manager comes with a separate template file for almost every part of your car pages, allowing your full freedom in customizing your car listings.

You can override template files and add your own ones! Click here to learn how

Share This

The Share This extension adds the ability to add 5 social sharing buttons to your vehicle detail pages. The extension support the following social media platforms:

  • Facebook
  • Twitter
  • Google Plus
  • LinkedIn
  • Tumblr

Buttons Location

The social sharing buttons can be added to 3 different locations on your vehicle detail page.

  1. Above Price
  2. Below Summary
  3. Below Buttons

The screenshot below demonstrates where the buttons would be places on these locations.

The possible position of the share buttons
The possible position of the share buttons

Disable Social Platforms

You can disable sharing buttons for specific social platforms by deselecting that platform via the Share This tab in your plugin’s settings page.

You can disable social platforms via the Share This settings tab
You can disable social platforms via the Share This settings tab