How To

How to create a business listing

You can create a new business listing on front-end or back-end.

When a business listing is created on front-end, the user who creates the listing becomes the owner of the listing and the userID is associated to the business listing. There are 3 possibilities to create a new listing:

  1. By using the business plans menu item

The user has to select the desired package and after the selection of the package, the user should register or log in into his/her account.

_images/howto_1.png

After that, the business listing details should be completed and the new listing should be saved for it to be added on admin area and on Control Panel.

This new listing enters in an “Approve creation” state and has to be approved by the site administrator for it to show on the Directory section. Unless the Show pending approval on general settings is set to yes and in this case the new listing will show in the Directory section without needing approval from the administrator.

_images/howto_2.png
  1. By using front-end Control Panel

The user has to log in or create a new account to add a new business listing.

_images/howto_3.png

After accessing the front-end Control Panel and selecting the New button, the user has to enter all the business listing details and save it.

_images/howto_4.png

This new listing enters in an “Approve creation” state and has to be approved by the site administrator for it to show on the Directory section. Unless the Show pending approval on general settings is set to yes and in this case the new listing will show in the Directory section without needing approval from the administrator.

  1. By using Add a business menu item
_images/howto_5.png

In this case, there are less steps to add a new listing.

The user as to log in or create an account and complete the business details. The new listing enters in an “Approve creation” state and has to be approved by the site administrator for it to show on the Directory section. Unless the Show pending approval on general settings is set to yes and in this case the new listing will show in the Directory section without needing approval from the administrator.

On back-end, there is no userID associated and the business listing can be claimed. The administrator can add a new listing on the Business Listing section by selecting the New button and completing the business details, save it and approve it, for it to be listed on the Directory on front-end.

How to claim a business listing

_images/howto_6.png

A business can be claimed if there is no owner associated with it, no user id is set. If the business listing has no owner associated with it and the Enable Claim Business option is set to yes on general settings, a claim button will be displayed when viewing the business listing in frontend. In order to claim a business, a business owner has to create an account and login into the account. Claiming the business is done by completing a claiming form. The user will enter the personal details and claim the business listing. The business will enter in an “Approve claim” state and has to be approved by the administrator, who has to approve the claim in back-end in business listing edit view by selecting the Approve claim button, and an email will be received in the administrator email address. After the site administrator approves the claim, the user can edit the business listing data on front-end Control Panel.

How to create and edit a custom attribute

The site admin can add new fields on directory items (business listings, offers & events) by using custom attributes. Custom attributes can be added by the administrator on Custom attributes section under the Business Listings section. You can set if the attribute will be mandatory or not, whether will be shown on front or not and whether it will be active or inactive. There are several types of custom attributes: input, select box, checkbox, radio button, header, textarea and link. The admin can choose one of these types and fill in the option names for the chosen type, when needed.

If the packages are disabled on general settings, the custom attributes will display automatically on business listings edit view, and if filled, also on business listings details view. Otherwise, if the packages are enabled, the custom attribute will not display until it is added as a feature on the business listings package.

How to contact a business listing

_images/howto_7.png

If the Enable Contact Business is set to yes on general settings, the user should be able to contact the business listing by using the Contact business button on the listing details view. The user has to complete the form and click contact business button when ready. At the top of the form, you can choose which contact person you want to contact, if there are any contact persons for the listing. After contacting the business listing, an email will be received by the site admin and also by the business owner. A copy of the contact messages is also stored on the database and can be viewed on the Business Messages section under the Business Listings menu on admin and front-end Control Panel.

How to report a business listing

_images/howto_8.png

If the Enable reporting is set to yes on general settings, the site guests can report a business listing by using the Report listing button on business listing details view. In order to report it, the user has to complete the form by choosing the cause of the report, entering his/her email address and the message, and then send the report. After sending the report, an email will be received on the administrator email address and the report will only be visible in that email.

How to setup a review

If the Enable review is set to yes on general settings, the user should be able to leave a review on the business listing details page by using the Add review button. To leave a review, the user is required to logged in, if the Reviews by user only option is set to yes on general settings. The user has to complete the form, agree to the reviews terms and conditions in order to save the review. After saving the review will enter a pending approval state. Depending on the general settings the review will be shown on business listing details, if the Show pending review option on general settings is set to yes, or it will be visible only when approved by site admin. After leaving a review, an email will be received in the administrator email address after the email is being saved and also on the business owner email address when the email is visible on listing profile.

On the business listing details view, under the review, the user has two options: to report the review or to respond to it.

How to report an abuse

_images/howto_9.png

In order to report an abuse, the user has to complete the form by entering the email address and the cause of the abuse, and then submit it. The reports to reviews are visible only to the administrator on Review abuses, under the Reviews & Ratings section on back-end.

How to respond to a review

_images/howto_10.png

In order to respond to a review, the user has to complete the form by entering the personal information and the review response, and then submit the answer. The response will show under the review and also on Review responses, under the Reviews & Ratings section on back-end.

How to add a review question

The administrator has also the possibility to customize the reviews by adding review questions.

A review question can be added only by the site admin in the Review Questions under the Reviews & Ratings section on back-end. The review questions contains the following fields: name, type, status, mandatory. The question type can be: rating, text and Yes/No question. The review questions will be displayed for each review with the corresponding answers.

How to add a review criteria

The administrator has also the possibility to customize the reviews by adding review criteria.

A review criteria can be added only by the administrator in the Review Criteria under the Reviews & Ratings section on back-end. The review criteria will be shown on front-end at the beginning of the review and will allow the users to enter a rating for each criteria entered.

How to create an offer

_images/howto_11.png

An offer can be created from admin area by the site admin or by the business owner on front-end Control Panel.

In order to create an offer in front-end the user will have to create a business listing first, in order for the offer to be associated with a business listing. When creating a new offer, the offer enters in an “Approve creation” state will be shown on front-end if the site admin approves the offers or Show pending approval is set to yes on general settings is set to yes. When a new offer is created the site admin receives a notification email.

If packages are enabled and the offers feature are not added on package configuration, the offers will not be shown on front-end and a “not included” will be shown for that offer. The user is allowed to create a maximum number of offers that is defined on general setting or package configuration.

How to create a coupon

During the process of creating an offer, on the offer edit view, the business owner or site admin has the possibility to enter the number of coupons for an offer.

If coupons are enabled on general setting and the number of coupons is higher than 0, on offers details view (front-end) a button “Get this deal” will appear. After the maximum number of coupons is reached the “Get this deal” button will be hidden on front-end. In order to get a coupon a user has to login in order to prevent multiple coupons being generated for one user.. After the coupon is generated it can be viewed on coupon section admin area and on control panel.

_images/howto_12.png

How to create an event from frontend / backend

_images/howto_13.png

An event can be created from admin area by the site admin or by the business owner on front-end Control Panel.

In order to create an event in front-end the user will have to create a business listing first, in order for the event to be associated with a business listing. When a new event is created, the event enters in an “Approve creation” state will be shown on front-end if the site admin approves the offers or Show pending approval is set to yes on general settings is set to yes. When a new event is created the site admin receives a notification email. If packages are enabled and the events feature are not added on package configuration, the events will not be shown on front-end and a “not included” will be shown for that event. The user is allowed to create a maximum number of events that is defined on general setting or package configuration.

How to buy a package

_images/howto_14.png

When a business listing is associated with a paid package and it’s saved for the first time with that package, an order will be generated. If a new listing is created with a paid package the user is being redirected automatically to the orders section on front-end Control Panel to purchase the package.

When performing a payment the user will be redirected on billing details view. The user should fill all the details to continue with the payment process. Depending on the payment method available on the site the user will be redirected on payment gateway site or the payment will be processed directly.

The site admin has the possibility to change the order status to paid on admin area on orders section without a payment being done.

How to create discounts

_images/discounts.png

The site admin can create multiple discounts that can be applied for different packages. When creating a discount, the admin can choose the package, the coupon code, maximum uses per coupon and a value. Discounts can be applied on the payment process, on payment methods screen. The user can enter the coupon code and click on Apply button. If a discount is available for the selected package that the user is paying, the discount should be reflected on payment summary.

_images/howto_15.png

How to setup an email

Emails that are sent to the site administrator, business owners and site users can be configured in the email section on admin area. For each email section you can change the subject, the content and set if the site admin should receive the emails. Some emails are automatically received by the site admin and the setting is ignored.

How will the update affects the files and database

When a new version is installed over an existing version, the database and settings are preserved. All the directory extension files will be overridden and if some changes have been performed, it is recommended to do a backup before update. For more details on how to update please also check the chapter “Update the extension”. The automatic and the manual update have the same effect, there is no difference between them. The only difference is that on automatic update only stable versions are available.

How taxes works

_images/howto_16.png

The taxes can be created only from the admin site, on Taxes section. The admin can fill in the tax name, fill in the amount and decide whether to set it in value or percentage and a tax description. They display when the user pays the order on the front-end control panel section and they are added to the package price. After the payment is done, taxes show on invoice details view.

How to create a map key

Since June 22, 2016 GoogleMapsV3 no longer supports keyless access so you need to get a key for every (referrer) domain which has never had a Google Map on it before. Get your key here:

_images/howto_17.png

By selecting the Get a Key button, a popup will show to require you to enter the name of your project and to accept the terms and conditions.

_images/howto_18.png

After that, you can select the “Create and enable API” button and the key can be generated.

_images/howto_19.png

You can now enter the key in the General Settings->Front end tab->Map Section->Google Map Key and save it.

After creating the browser key on your API Dashboard you need also to enable the services. On the above picture, by selecting the API Console button, you will be presented with your credentials. After that, on the same page you have to select Libraries and go to your API Manager Overview screen.

_images/howto_20.png

In here, you need to enable the following services:

  • Google Maps JavaScript API
_images/howto_21.png
  • Google Static Maps API
_images/howto_22.png
  • Google Places API Web Service
_images/howto_23.png

For Google map key-zipcode you have to set a map key that has no restriction and no referrer. This key will not be public on the website and it will be used for zip code translation to map coordinates. It can be proceeded in the same way as for the API key.

How to setup a package

If packages are enabled on general settings, then a package should be associated with the business listing. A package has several features, which can be added or removed by the administrator. Also the business listings custom attributes should be added as a feature in the listing’s current package, if the user wants them to display on the business listing details view. The user can choose the package that suits him/her better. After the user chooses the package, an order is created automatically on Orders section on both, the admin area and front-end Control Panel. The user must pay the order on front-end Control Panel, so the package features can be associated with the listing. Otherwise the listing will be shown with limited features. On orders edit view there is a start date for the order. Start date represents the date when the package will be active. If one business buys a new package and there is already a paid package active, the start date of the new package will be set to expiration date of the previous package.

When a package expires, the listing is associated with a free package, if there is any. And the listings details view will have the features of the free package. But in the case when there isn’t any free package to be associated with the listing and its own current package has expired, the business listing will not be active anymore and will not be listed in the Directory. In this case, the user can decide to upgrade the previous package or choose another one and a new order will be created. After the new order is paid, the business listing will continue to be listed in the Directory with the features of the just paid package.

A package has four types of payment plans:

  1. Lifetime

When choosing lifetime type, you are presented with only one option, the price of the package. It means that the package can be paid for a lifetime period and it will never expire.

_images/howto_24.png
  1. Fixed period

On the fixed period type, you are presented with two options: price and time period. You can decide the time period on which the package will be active and how much it will cost for this time period.

_images/howto_25.png
  1. Recurring

On the recurring type, you are presented with three options: price, time period and number of occurrences. You can decide the time period on which the package will be active and how much it will cost for this time period. You can also set the number of occurrences, which means that you can decide how many times the order will be repeated, after its time period comes to an end, and the payment will be done automatically.

_images/howto_26.png
  1. Recurring with trial

On the recurring with trial type, you are presented with five options: price, time period, number of occurrences, trial price and trial time period. You can decide the time period on which the package will be active and how much it will cost for this time period. You can set the number of occurrences, which means that you can decide how many times the order will be repeated, after its time period comes to an end, and the payment will be done automatically. Also in this type, you can set a trial time period for the package and the price for this trial time period. The trial period price will be included in the total price of the package. The trial period start date can be also set and edited on the orders edit view, on admin area. So a package start date can be set on a future date, but as long as the trial period start date is set on an actual date and the order is paid, the listing will be active with the package features. Only when the trial period has finished and the time period of the package has not started yet, the listing will not be active anymore.

_images/howto_27.png