User Guide

This is MOTOCOM theme Listing Based Buisness Niche documentation, containing helpful information, features and detailed instructions about how to use the niche.

1. General Information & Installation

1.1 Introduction

If you would like to build an exceptional listing website, MOTOCOM's niche Listing Based Business is just what you need! It is designed in such a way that it could be used as a Labor directory, Doctor directory, Hotel directory, Wedding, Fitness, or as a directory for other professionals as it has a lot of features a directory website may need with very little efforts. The inner pages are carefully designed to provide all the essential information any directory business would need. ​The best thing about this website is its excellent, semantic, and validated code with strong search ability and good loading time. It is a user-based directory theme with excellent features and design. It is well documented and on top of all, it is backed up by excellent customer support.It provides really an easy way to convert any existing site into a fully featured directory business website.Moreover, it also features location based directory. Maps & map markers functionality gives users fast and easy ability to find nearby places by powerful search system.

1.2 How To Set Up Listing Based Business

This section will contain the information regarding the plugins which are used in setting up of Listing Based Business niche of MOTOCOM theme.

The Listing Based Buisness niche includes the two main plugins MOTOCOM Listing and Web Directory Free .

You will get the option for installing the plugins of the niche from plugins screen . Here you can choose any one option from Auto Install or Manual Install.

Here the general description of both the plugins.

  • Web Directory Free - Build Directory or Classifieds site in some minutes. The plugin combines flexibility of WordPress and functionality of Directory and Classifieds.It is really easy to convert any existing site into a fully featured directory business website with the directory plugin.
  • For detailed information Click here

  • MOTOCOM Listing - It is an addon plugin of Web Directory.

2. Directory Listings

Directory Listings comes with the Web Directory Free plugins which have so many settings that are easy to customize and self-explanatory.

Navigate to Dashboard >> Directory Listing

2.1 Directory Listings

In this setting you can see all your listings and you can also create a new listing .

2.2 Create New Listings

Using this user can create the new listings for their website.

Create New Listings

  • Add Title - Enter the title of the listing.
  • Add Description - Enter the description of the listing.

Listing Media

  • Attach Images - User can upload the image of the listing.
  • Attach Videos - Enter full YouTube or Vimeo video link here.

Listing Categories - User can select the category of the listing.

Content Fields

  • Phone - Enter the contact number of the listing.
  • Website
    • URl - Enter the URL of the website.
    • Link text - Enter the text for the URL of the link.
  • Email - Enter the Email ID of the listing.
  • Listing Locations - You can enter the location details like Country, postal code, or some additional information for the listing with this setting.
  • Slug - You can enter the slug here.

Note - After entering, all the details do not forget to hit Publish button.

2.3 Directory Categories

Using this setting user can add the categories of the directory.

Create Category

  • Name - Please enter the name of the category. The name is how it appears on your site.
  • Slug - The “slug” is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.
  • Parent Category - Select the parent category from here. It will assign a parent term to create a hierarchy. The term Jazz, for example, would be the parent of Bebop and Big Band.
  • Description - Enter the description of the category.It is not prominent by default; however, some themes may show it.
  • Image - User can upload the image of the category and can also remove it.
  • Create Category - Hit the button to create a new category.

2.4 Directory Locations

With this setting you can add the locations of the directory.

Create Location

  • Name - Please enter the name of the location. The name is how it appears on your site.
  • Slug - The “slug” is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.
  • Parent Category - Select the parent category from here. It will assign a parent term to create a hierarchy. The term Jazz, for example, would be the parent of Bebop and Big Band.
  • Description - Enter the description of the location.It is not prominent by default; however, some themes may show it.
  • Create Location - Hit the button to create a location.

2.5 Directory Tags

With this setting you can add the listing tags.

Create Tag

  • Name - Please enter the name of the category. The name is how it appears on your site.
  • Slug - The “slug” is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.
  • Description - Enter the description of the category.It is not prominent by default; however, some themes may show it.
  • Create Tag - Hit the button to create a tag.

3.Directory Listing Shortcodes

In these section you will learn and get information about the Shortcodes used for Listing Based Buisness niche of MOTOCOM theme.

3.1 Directry Listing Shortcode

These are the basic shortcodes which comes with the theme

3.1.1 Directory Listing

This shortcode is used to display the listing. It is an automated shortcode with no additional settings.

3.1.2 Webdirectory Listing Page

It is an optional shortcode. It is used for building separate page for single listing. You have to create a new page and add this shortcode on the page.

3.1.3 Webdirectory Listing Page Header

This shortcode is used to display the header of webdirectory listing page. It is an automated shortcode with no additional settings.

3.1.5 Search Directory Listing

By using this shortcode, you can add a directory listing search form at any section of the website according to the need.

Search Directory Listing Settings

  • Enable Background Shape - To enable the background shape of search form please select the checkbox.
3.1.6 Additional shortcodes

These are some additional shortcodes which comes with the Web Direstory Free plugin.

For further information Click Here

4. Widgets

The Listing Based Buisness niche of MOTOCOM Theme includes several additional widgets.You can access all the widgets in the Widgets section of the wordPress admin.Webdirectory Free plugin provides various types of widgets to display listings, categories, locations items in different views: on the map, in slider, carousel, grid, table, menu. Also special search form and listings levels table widgets.

Some additional widgets of the directory listing are described below.

  • Directory - Display Directory.
  • Directory Categories - Display categories of the directory.
  • Directory Buttons - Display the buttons related to directory like Submit, Print Directory, etc.
  • Directory Listings - It shows the listings of the directory.
  • Directory Locations - Display the buttons related to directory like Submit, Print Directory, etc.
  • Directory Search - Display the directory search form.
  • Directory Sidebar Listings - It shows the directory listing in the sidebar.
  • Directory Slider - Display the Directory listings in slider view.
  • Directory Listing Levels - Display the listing levels.
  • Directory Map - Display google maps with listings locations as map markers.
  • Directory Sidebar Categories - Display the categories of the listing in sidebar.
  • Directory Sidebar Locations - Display the locations of the listing in sidebar.

5. Directory Admin Settings

The Directory Admin Panel appears on the dashboard which includes some settings of the directory listings. It contains some separate tabs with own groups of settings.

Navigate to Dashboard > > Directory Admin > > Directory Settings

5.1 General Settings

This section contains some general settings of the directory listing.

Addons

  • Ratings & Comments addon -It gives the ability to place ratings and comments for listings..

Ajax Loading

  • Use Ajax Loading - To enable ajax loading turn on the button. It loads maps and listings using AJAX when clicking on the search button, sorting buttons, pagination buttons.
  • Display "Show More Listings" button instead of default paginator - To display the Show more listing button turn on the button. When switched off - default pagination will be used.

Title , Labels & Permalinks

  • Directory Title - Enter the title of the directory according to the need.
  • Sticky Listing Label - Enter the label for sticky listing.
  • Featured Listing Label - Enter the label for the featured listing.
  • Listing Permalinks Structure - You can select any structure for the listing permalinks.
5.2 Listings Settings

It includes some basic settings of listings.

Listings Settings

  • Show listings on home page - Turn On the button to show listing on the home page.
  • Number of listings on home page - Enter the number of listings that you want to show on the home page.
  • Number of listings on excerpt pages - Enter the number of listings which you want to show on excerpt pages like categories, locations, tags, search results.
  • Enable contact form on listing page - To enable the contact form on listing turn on the button. Contact Form 7 or standard form will be displayed on each listing page
  • Contact Form 7 shortcode - Enter the shortcode of contact form 7.This will work only when Contact Form 7 plugin enabled, otherwise standard contact form will be displayed.
  • Show contact form only for logged in users - If you enable this then only logged-in users are able to see the contact form.
  • Allow custom contact emails - When enabled users may set up custom contact emails, otherwise messages will be sent directly to authors emails.
  • Enable report form - To enable report form turn on button.
  • Enable bookmarks list - This option enables/disables My bookmarks functionality.
  • Show print listing button - You can show/hide print listing button on single listing page.
  • Show listing in PDF button - You can show/hide Save listing in PDF button on single listing page.
  • PDF page orientation - You can select any mode of pdf page ( Landscape, Portrait).
  • Allow regular users to change listings expiration dates - With this setting listings, owners can manually change the expiration dates of their listings, after that date, their listings become expired.
  • Hide comments (reviews) number on index and excerpt pages - The number of comments or reviews will be hidden from index and excerpt pages .
  • Hide listings views counter - This setting will hide the listings view count .
  • Hide listings creation date - This setting will hide the date when the listing was created .
  • Hide author information - This setting will hide the author name and possible links to the author website.
  • Listings comments mode - Select any mode for lisitng comments.
  • Listing tabs order - You can arrange the orders of the listing tab from here.
  • Enable statistics functionality - It will enable the statistics charts on the frontend users dashboard.

Listings Logos & Images

  • Enable lightbox on images gallery - You can enable/disable the lightbox on images on the gallery.
  • Enable automatic rotating slideshow on images gallery - This setting will automatic rotating the slideshow.
  • The delay in rotation - Enter delay time for rotation. The time will be measured in milliseconds.
  • Enable default logo image - It will add a default logo image for the listing.
  • Default logo image - This image will appear when the listing owner did not upload their own logo.
  • Images gallery width - Select the width of the image gallery in pixel. This option needed only when 100% width of the images gallery is switched off.
  • Images gallery height - Select the height of the image gallery (in pixel). Set to 0 to fit the full height.
  • Do crop images gallery - It works when gallery height is limited (not set to 0).

Description & Excrept Settings

  • Enable description field - You can hide/show the main description text editor from listing.
  • Enable HTML and shortcodes in description field - It will enable the HTML code and other shortcodes.
  • Enable summary field - You can enable/disable the summary field.
  • Excerpt max length - Insert the number of words you want to show in the listings excerpts.
  • Use cropped content as excerpt - When the excerpt field is empty - use the cropped main content.
  • Strip HTML from excerpt - Check the box if you want to strip HTML from the excerpt content only.
5.3 Pages & Views

Excrept Views

  • Show listings number - It will show/hide the listing number on the top of the listings block.
  • Enable views switcher - Show/hide views switcher at the top of listings block.
  • Listings view by default - Select any mode in which you want to display listings.
  • Listing title mode - Select the mode to display the title of the listing.
  • Logo image mode - Select mode of the logo image.
  • Number of columns for listings Grid View - Use a slider to set the number of columns. The value will appear as a label.
  • Number of columns for mobile devices - Set the number of columns of listing to be displayed on mobile devices.
  • Aspect ratio of logo in Grid View - Select the aspect ratio of the logo from the given option.
  • Wrap logo image by text content in List View - With the enabled option, the logo image will be wrapped by text.
  • Listing thumbnail logo width in List View - You can set the width of the listing's thumbnail logo. The width will be in pixel.

Categories Settings

  • Show categories list on index and excerpt pages - Enable the button to show categories list on index and excerpt pages.
  • Categories depth level - When set to 1 only root categories will be listed.
  • Categories columns number - Select the number of columns to display the categories.
  • Show subcategories items number - Enter the number of subcategories that will be displayed in the table.
  • Show category listings count - This will show the category listings count in brackets when enabled.

Location Settings

  • Show locations list on index and excerpt page - Enable the button to show location list on index and excerpt pages.
  • Locations depth level - When set to 1 only root locations will be listed.
  • Locations columns number - Select the number of columns to display the locations.
  • Show sublocations items number - Enter the number of sublocations that will be displayed in the table.
  • Show location listings count - This will show the location listings count in brackets when enabled.

Sorting Settings

  • Show "order by" options - Enable the button to show Order By option to sort listings.
  • Allow sorting by date - Enable the button to sort listings by date.
  • Allow sorting by title - Enable the button to sort listings by title.
  • Allow sorting by distance when search by radius - Enable the button to sort listings by distance.
  • Default order by - With this setting, you can set the default order (Date, Title, Random, Rating) of the listings.
  • Default order direction - With this setting, you can set the default order direction (Ascending, Descending) of the listings.
  • Exclude listings with empty values from sorted results - If enabled it will exclude those listings which have empty value.
  • Sticky and featured listings always will be on top - When switched off - sticky and featured listings will be on top only when listings were sorted by date.
5.5 Maps & Addresses

Map Types

  • Select Map Engine - You can select any map engine ( No maps, Google Maps, MapBox (OpenStreetMap) ).

MapBox Settings

  • MapBox Access Token - Enter your Map Box access token here.
  • MapBox Maps style - Select style for your MapBox from the given options.
  • MapBox Custom Map Style - This setting will be used when do not select any native style.

General Map Settings

  • Show map on home page - It will show a map on the home page if enabled.
  • Show map on excerpt pages - It will show a map on the excerpt pages like categories, locations, search, etc if enabled.
  • Show map on single listing - Turn "on" the button to show the map on the single listing.
  • How many map markers to display on the map - Choose an option on how to map markers to be displayed
  • Show directions panel for individual listing map - With this setting users may pave the route on the map and get the list of directions for selected location separately.
  • Default map zoom level - Select the zoom level of the map for the submission page.
  • Default map height - Enter the default map height. Enter numerical values only. The value will be in pixels.
  • Show circle during radius search - To show the circle during the location search turn "On " the button.
  • Enable clusters of map markers - When enabled map markers will be grouped in clusters.
  • Make map markers mandatory during submission of listings - If enabled listing must have at least one map marker.
  • Enable automatic user Geolocation - This setting will requires https.
  • Default zoom level - Select the default zoom level of the map according to the need.

MapBox Settings

  • MapBox Access Token - Enter your Map Box access token here.
  • MapBox Maps style - Select style for your MapBox from the given options.
  • MapBox Custom Map Style - This setting will be used when you do not select any native style.

Map Controls Settings

  • Enable Draw Panel - Users can draw a shape on the map and find map markers inside the drawn area.
  • Show search form and listings sidebar on the map - Search and display listings information directly on the left-side panel inside the map window.
  • Enable full screen button - Enable/disable full screen button.
  • Enable zoom by mouse wheel - This setting will work only for the desktops.
  • Enable map dragging on touch screen devices - When enabled users can zoom on the map for touchscreen devices.
  • Center map on marker click - The map will center on a marker.
  • Hide compact search form on the map for mobile devices - This setting will affect all maps: directory pages, map shortcodes, map widgets.

Address Settings

  • Default country/state for correct geocoding - Enter default county/ state. This value needed when you build a local directory, all your listings place in one local area - country or state. This hidden string will be automatically added to the address for correct geocoding when users create/edit listings and when they search by address.
  • Address format - Order address elements as you wish, commas and spaces help to build address line.
  • Restriction of address fields for one specific country - Restrict autocomplete functionality by maps service only to one selected country or keep it worldwide.
  • Enable address line 1 field - Enable/disable address line 1 field in locations metaboxes.
  • Enable address line 2 field - Enable/disable address line 2 field in locations metaboxes.
  • Enable zip code - Enable/disable full zip code field in locations metaboxes.
  • Enable additional info field - Enable/disable additional info field in locations metaboxes.
  • Enable manual coordinates fields - Enable/disable manual coordinates field in locations metaboxes.

MapMarker & InfoWindow Settings

  • Type of Map Markers - Select the type of the map markers according to the need.
  • Default Map Marker color - Select any color for the Map Marker.
  • Default Map Marker icon - Select any icon of Map Marker.
  • Map marker size - Select the map marker size. The size will be in pixel.
  • Map InfoWindow width - Select the Map InfoWindow Width. The width will be in pixel.
  • Map InfoWindow vertical position above marker - Select the vertical position of the Map InfoWindow.
  • Map InfoWindow logo width - Select the Map InfoWindo logo width here.
5.6 Email Notifications

Email Notifications

  • This email will be used for notifications to admin and in "From" field. Required to send emails - Enter admin email address here.
  • Days before pre-expiration notification will be sent - Enter the number of days here.
  • Pre-expiration notification text - Enter the Pre-expiration notification text here.
  • Expiration notification text - Enter Expiration notification text here.
5.7 Advanced Settings

JavaScript & CSS

  • Include directory JS and CSS files on all pages - Enable the option to include JS and CSS files.
  • Include lightbox slideshow library - This adds functionality to watch listings images as full size animated slideshow.
  • Do not include jQuery UI CSS - If the button is enabled it will include jQuery UI CSS.

Miscellaneous

  • Prevent users to see media items of another users - When enabled, users are not able to see media of each other.
  • Enable autocomplete on addresses fields - Disable if you are using a predefined locations tree and do not want to see country, city, e.t.c. in the input autocomplete field.
  • Enable "Get my location" button on addresses fields - Enable/disable geolocation button on addresses fields.

Re-Captcha Settings

  • Enable reCaptcha - Turn "on" the button to enable the ReCaptcha.
  • reCaptcha version - Select the version according to the need.
  • reCaptcha site key - Enter reCaptcha API key.
  • reCaptcha secret key - Enter ReCaptcha secret key.
5.8 Customization

Color Palattes

  • Compare palettes at the frontend - This setting enables a special interactive widget helping to compare color palettes.
  • Color palette - Select any color palette according to the requirement.

Main Colors

  • Primary color - The color you have selected from the color palette will be reflected here.
  • Secondary color - You can change the secondary color from here.

Links & Buttons

  • Links color - You can change the color of the links.
  • Links hover color - You can change the links hover color.
  • Button primary color - You can change the primary color of the button.
  • Button secondary color - You can change the secondary color of the button.
  • Button text color - You can change the button text color.
  • Use gradient on buttons - To enable the gradient color option turn "On" the button.

Search Block

  • Search form background color - The color you have selected from the color palette will be reflected here.
  • Opacity of search form background, in % - Select the opacity of background color of the search form.
  • Search form text color - You can change the text color of the search form.
  • Use overlay on search form - To enable the overlay on the search form turn "On" the button.

Misc Settings

  • Logo hover effect on excerpt pages - Enable/disable logo hover effect on excerpt pages .
  • Bottom margin between listings - You can adjust the bottom margin between listings.
  • Listing title font size - You can adjust the Listing title font size.
  • jQuery UI Style - Controls the color of calendar, dialogs, and slider UI widgets.
5.9 Social Sharing

Listing Social Sharing Buttons

  • Buttons style - Select the style of social sharing buttons according to the need.
  • Include and order buttons - Select the social sharing services you need and order their buttons.
  • Enable counter - This setting will enable or disable the counters near social sharing buttons.
  • Buttons place - Select the position of the button.
  • Social buttons width - You can adjust the width of the social button. This width will be in pixels.
5.10 Ratings & Comments

Ratings Settings

  • Only registered users may place ratings - When checked only registered users can place ratings.
  • Allow users to reset ratings of own listings - When checked users can reset ratings of their listings.
  • Allow sorting by ratings - Switch on/off sorting by ratings.

Comments Mode

  • Comments mode - Select any option according to the need.