Introduction

Installation of the theme

uListing – Listing and Classified Ads WordPress Plugin Documentation

uListing is a new groundbreaking plugin from StylemixThemes. If you wanted to create a professional business listing site on WordPress without spending a big sum, then uListing is exactly what you need. With our free plugin you can create a listing business in a matter of minutes and you don’t even need a premium WordPress theme. uListing plugin is built on Vue.js with care and love, so to make your experience with the plugin as easy and pleasant as possible.

Here you can watch a video tutorial on using the uListing plugin:

Some of the features of the uListing – Listing and Classified Ads WordPress Plugin include:

Fully customizable form fields
Drag & Drop Builder to create an inventory grid, list and single layouts
Sorting options for categories, listings, and front-end for users to choose sort order
Possibility to post listings without access to WP dashboard
Accept payments using PayPal, Stripe
Configurable quick-search field and sorting bar for listings
Advanced search screen with ability to show/hide fields available for search
Upload images per listing, allow restricted numbers of images based on fee plan
Lots of image options: drag & drop image uploads, easy image ordering, primary image settings and more
Attributes, Options displayed with images
One Click Demo Import

What to do if the plugin installation fails

What should I do if the plugin installation failed?

After activation, if you received this error, change your permalink settings.

uListing plugin requires Permalink Structure rather than “Plain”. We recommend to use “Post name” Permalink Structure

You can install the plugin just as you would install any other WordPress Plugin

Before installing the “uListing” plugin, please ensure your WordPress installation meets the following requirements: https://wordpress.org/about/requirements/.
  • WordPress 4.6 or higher
  • PHP 5.6.2 or higher (PHP 7.0 Recomended!)
Installing “uListing” plugin is just like any other WordPress plugin.

Theme Activation

Installation and Demo Import

Installation and Demo Import

You can install the plugin just as you would install any other WordPress Plugin

Before installing the “uListing” plugin, please ensure your WordPress installation meets the following requirements: https://wordpress.org/about/requirements/.
  • WordPress 4.6 or higher
  • PHP 5.6.2 or higher (PHP 7.0 Recomended!)
Installing “uListing” plugin is just like any other WordPress plugin.
Navigate to your WordPress “Plugins” page, inside of your WordPress dashboard click “Add New” and follow these instructions:
In the search field enter “uListing plugin”. Then hit Enter.
Click “Install Now”. Once installed, click “Activate”.
Plugin is installed and activated, good job :P

Demo Import

Demo Import

After activation, if you received this error,
Change your permalink settings. uListing plugin requires Permalink Structure rather than “Plain”. We recommend to use “Post name” Permalink Structure.
Then go to Settings - > Permalinks and change Permalink setting to Post name.
After that, go to the demo import page where demo import page will appear.
Click “Run Demo Import”.
If you have problems during the demo import, look at the permalink settings once again.
Demo content imported, good job :P

Setting Up your Website

Main Settings

Main Settings

Our plugin has created several pages that are needed to work with the demo Listing types. Here you can see all the pages and open these pages to view the demo import.
To configure the main parameters such as payment, user roles, inventory layouts, specify pages for list types and for set up other settings go to the Listing Types -> Settings.
Here you can see the currency settings.
Here you can use these shortcodes wherever you like. Just copy and change " listing_type_id " to your listing type id.
You can get a ListingType ID here. Just open the ListingTypes and click one of them to get an ID.
From the URL, copy the list type ID and from Listings  categories get the category slug and put them to the shortcode.
After writing the shortcodes, save the changes and see your page, there will be listings which are contained in this Listing Type and in this Category that you specified. In my case, the type of listing is cars, and the category is sale.

Page Settings

Page Settings

Here are the pages that are created and specified when importing a demo content.
You can change specific pages by selecting other pages.

Setting Up the Footer

Inventory Settings

Inventory Settings

Here you can see the ready inventory layouts or create your own inventory layout.
To set up the sidebars, click on Theme Options > Blog (or Shop Pages) in the WordPress menu. Usually in the business of inventory more customers use ready-made inventory templates. With our plugin, you can create any type of inventory templates from scratch. important thing that you can create and customize any type of view, for example, Grid View, List View, Map View, etc. Our developers have tried their best to make an excellent plugin with great functionality.
After the demo import you will have 3 made inventory layouts.
Here, if you want to create your own inventory layout, click the Create New Layout button and write the name of the layout.
Here, if you write the name of the layout, click the "Create" button.
Here, with these basic and general elements, you can start creating a layout.

Creating Layout

Creating Layout

First click on the plus button to add a section.
After adding a new section, you can hover over these draggable buttons. In our builder, you can easily move or change the position of the section elements by dragging.
Each section has three buttons (Edit section, Move section, Delete section).
In the "Edit Section" you can change the section styles, such as the background color, and also make the full width or you can set indents for adaptive.
In the "Move Section" you can swap this section with other sections by drag and drop. For example:
Hover over this button and hold the left side of the mouse and move.
Each section has a row, and each row has a column. With this structure, you can create any type of layout. It is like a Grid system. About the Grid System you can find more information here: https://getbootstrap.com/docs/4.1/layout/grid/. Ok, let's create a custom layout. We will add a new section, then we will use general and basic elements to create a layout template. Here we will use columns first. Then there are other elements in the columns.
If you click the edit button here, the row column settings will appear. And there you can select the column settings. If you want three columns, just select 3, and the column will be divided into 3.
But we do not want it now. We want to add a column first. Let’s do it. Just drag this element to the section.
Now we have a section in which there are columns, so now click the edit button that you recently added. And select your choice to split the columns. In my case 3. I mean that I want to split a column into 3 parts.
Then click the Save button to save the changes. if you fail, repeat this repetition carefully.
Now we will add another one columns.
Here I want to divide this column into 2 parts.
It looks great, right? But I want to resize the parts of the second column. For example, I want the size of the parts of my second column to be like this.
The columns can be divided into 1, 2, 3, 4, 5, 6 and 12. So it is very flexible. I divided one column into 2 parts. Now I want to also split the child columns. Now I have two child columns with a size of 6 columns. 6 + 6 = 12 full column size.
Here, click the "Edit" button and select "Advanced" tab, and here you can see the size of the columns by clicking to the drop-down.
Now I changed the size of this part to 4.
And this part to 8.
And here we will add these elements.
  • Title
  • Html view box for viewing text, Column Switch
  • Sort
  • Filter
  • List, Pagination
After adding the title, you can click the edit button to see the title options
You can change the background color or padding, margins for different screen sizes, and you can choose a template style. Now select template style and click save.
drag the rest of the requirement 5 elements that I recently told you.
Select template styles for each element.
After that, click "Save button" to save the changes. Now our first custom inventory layout is ready. Let's make the settings for the payment gateway.

Paypal Standard

Paypal Standard

If you do not know about Paypal Gateway, you can read this manual to learn about it.
Paypal Overview
Paypal Developer Documentation There you need to create two accounts (Business (Seller) & Personal (Buyer)), I have already created these accounts. If you also created PayPal accounts, then install PayPal.
After that, click on the settings button.
Here you need to write your Paypal Business account and select the sandbox payment mode (test mode) or “Live”, and in the latter case, copy this IPN url and put it into your PayPal Business account, After that, just click on the Save button
Now you have set up your PayPal gateway on your side. There you have to put your IPN URL.

Stripe

Stripe

If you do not know about Stripe Gateway, you can read this manual to learn about it.
Stripe Documentation
There you need to create account, I have already created this account. If you also created Stripe account, then install Stripe.
After that, click on the settings button.
Here you have to put your Publishable, Secret key and Signing secret. You can get them from your account.
To get Signing Secret, put your webhook on your webhooks and get your signature secret
if you put your webhook, just go inside, and there will be your secret signature, and click here to see your secret.
After that, click "Save" to save the changes. That's all! your payment gateway is ready for testing.

Attributes

Attributes

Attributes

To create a new attribute, click on Attribute.
Enter the attribute information after this click on the "Create" button
Here, during creating an attribute, you can use types, here more common types are available for you. To see them, click on the type drop-down menu.
Now I have created a area attribute, if you want to edit a area attribute, just hover over it and the edit button will appear there.
Click the edit button to change this attribute.
Here you can change the name, affix and icon or image. if you want to change the attribute type, delete this attribute and create it with a different type.
To delete an attribute, click the delete button in the attribute list. The attribute will be deleted automatically.

Adding Other Content

Listing Types

Listing Types

To create a new Listing Type, click the Add New button.
Enter a name for the listing type then click to save button to save your new listing type.

Using Attributes

Using Attributes

Then scroll down to this form.
Here you can see all available attributes. Drag the necessary attributes to the left section.
Here I dragged all necessary attributes to the left section.
After that click on the Save button.

Using Search Forms

Using Search Forms

Here you can collect various filters by attributes, and these filters will appear on the front page of the listing type, see the following example
You can also use shortcodes to display some filters. Add a few filters, copy and paste this shortcode into your page and use it. If you do not know how to use shortcodes, you can scroll through the module to shortcodes. There are chapters on shortcodes on the top.

Using Listing Order

Using Listing Order

Here we have to add order lists.
They will appear there.

Creating Preview

Creating Preview

Now we have learned a lot. It is time to learn how to create previews, such as a grid, a list.
To do this, click on the button of the preview item.
Here you can see a very large builder. Now we will explore it.
  • This is a grid view. Now by default it is also a grid view
  • This is a list view. You can click to see its view.
  • This is a map view. You can click to see its view.
  • Grid, list and map templates are available here. You can customize the size of their columns in some views and you can select templates to display them.
  • The basic elements for displaying attributes using the Attribute Box, Thumbnail Box and with shortcodes.
  • The general attributes.
  • View Content.
To collect content page, you need to see the Inventory Layout chapter, in which we explained how to create a layout.

Creating Single Listing Page Preview

Creating Single Listing Page Preview

Here you need to create a single inventory page using attributes and elements.
If you are created then you can see it in the example. Please do not forget that It is up to you how to create single page inventory
Here we will choose our inventory layout.
Here you need to select the attributes that the user enters in time to add the new listing
You can learn more about uListing Compare in the chapter on add-ons

Inventory Layout

Inventory Layout

Here we will choose our inventory layout.

Submit Form

Submit Form

Here you need to select the attributes that the user enters in time to add the new listing

Listing Compare

Listing Compare

You can learn more about uListing Compare in the chapter on add-ons

WPBakery Visual Composer page builder

Listings

Listings

To add a new list, you must first create an account. Create a new account with an available user role.
After registration you will be redirected to this page. Here you can view the payment history, your plans, or you can add a new list with available list types, or you can buy a new plan. Now by default there will be a simple user role with one free listing limit. But you can create other user roles from the admin dashboard if you purchased for User Role Add on.
Now we will add a new listing for the Building Listing Type. To create a new list, click the Add Listing button.
Here you need to select the type of listing. Select building type.
Fill in all the requirements fields here. If you have completed all the requirements fields, click the "Create" button
After creation, click on the “My Listing” button to see your listings.
If you click on the buy plan button, those tariff plans that you created from the tariff plans will appear here.
If you click the "Buy Package" button, all available payment methods will appear here. Then you can safely pay for the pricing plan.
After successful payment all your pricing plans will appear here.
If you want to see information about the pricing plan, you can click on the details button from the table. On the tab, click on the payment history, and here you can see your payments for pricing plans
If you want to edit your listing, just click the "Edit" button.
After clicking the edit button, the listing edit page will open.
Here edit the information about your listing, then click the update button.

uListing addons

Listing addons

uListing Subscription

uListing Subscription

Here you can watch a video tutorial about uListing Subscription Addon:
uListing Subscription is a paid add on to our free uListing plugin that allows to Create and Sell Subscription plans. If you have installed our powerful plugin uListing, You know that you can create a professional business listing site in few minutes, but still you have not as much flexibility on creating a payment plans. First go to Plugins -> Add New
After you have purchased our add-ons, you can upload this here.
Click the Install Now button to install the add-ons.
After installation, click the "Activate plugin" button to activate the uListing subscription add-on.
Here, after activation, enter your license key to activate the license.
If you also received this notice of successful activation, I congratulate you. Before adding an uListing subscription add-on, when we tried to add a new pricing plan, we had this screen where you can create only one time payment pricing plan.
But now this function is unlocked, here you can use the listing limit, feature limit, duration and etc.
And if you go to the Listing Types -> Settings -> Payment, here one more setting for PayPal appeared. Create a flexible plans with payments to PayPal or Stripe. You can also combine a one-time payment plans with subscription to give your users a greater choice. Let them choose if they want to pay a big sum once, or a little but regularly.
Click the install button to install PayPal subscriptions.
Click the Settings button to set up PayPal subscriptions.
Here you need to specify your Paypal account and your created app credentials. If you don't know, see these examples.
First create an app for your settings.
Here enter the name for your application and select your business account. Paypal will create a Client ID and Client secret for you.
Copy them and paste into Paypal settings .
To get a web hook ID, copy this web hook URL and go to your PayPal account. Click on the Add Webhook button.
After that paste your web hook url there and check your event types after all scroll until save button and click save button.
Copy this web-hook ID and paste it into your Paypal settings. That’s it. Now you can create subscription plans, and your users can buy these subscription plans with a Paypal account. To set up Stripe, you can read our Listing plugin guide, which explains these settings.

uListing User Roles

uListing User Roles

Here you can watch a video tutorial about uListing User Roles Addon:
uListing User Roles is a second addon to our free powerful uListing plugin that ads a feature to create different User Roles and attach each of them a different amount of available listings. You can give each role a custom name and amount of available listings. First go to Plugins -> Add New.
After you have purchased our add-ons, you can upload this here.
Click the Install Now button to install the add-ons.
After installation, click the "Activate plugin" button to activate the uListing User Roles add-on.
Here, after activation, enter your license key to activate the license.
Before adding the uListing user roles add-on, when we tried to add a new user role, we had this screen in which you already created only one user role. But now this function is unlocked, here you can add new user roles as much as you want

uListing Compare

uListing Compare

Here you can watch a video tutorial about uListing Compare Addon:
uListing Compare is a paid add on to our free powerful plugin for creating a business listing site. This addon allows creating a compare between two or more different listings. For example, if user is in need of a new apartment and he can’t choose between two similar ones, he can choose both of them and compare their price, area, number of bedrooms and more.
After you have purchased our add-ons, you can upload this here.
Click the Install Now button to install the add-ons.
After installation, click the "Activate plugin" button to activate the uListing compare add-on.
Here, after activation, enter your license key to activate the license. Before adding the uListing compare add-on, when we tried to add a new attribute for the comparison section, we had this screen on which you cannot add attributes for the compare section.
But now this function is unlocked, here you can use any attributes in the compare section.
uListing Compare gives you big flexibility on comparing attributes. uListing itself is a very powerful and free plugin! But Compare gives you a trully great addition to it’s features!

uListing Wishlist

uListing Wishlist & Saved Searchs

uListing Wishlist is a new addon to our uListing plugin. This addon adds a feature to create favorite ads by adding them to wishlist. It’s easy to setup and easy to use. Simply install and activate an addon. After that, you will have an option to enable wishlists option.
After you have purchased our add-ons, you can upload this here.
Click the Install Now button to install the add-ons.
After installation, click the "Activate plugin" button to activate the uListing Wishlist add-on. Here, after activation, enter your license key to activate the license.
Now in our site Wishlist is unlocked, here you can use Wishlist short code.
To work with the Wishlist, you need to follow a few steps. You need to select the page for this add-on. You can select page for this from Listing Types ▸ Settings ▸ Pages
Create a simple page or select from existing pages. Now I created a page and called it a wish page.
After this, save the changes. Then you need to add a Wishlist button to the grid or list to work with it. To add a button, open your Listing Type in my case these are cars.
Select a style for this button, then click the Save button. Then check it out from the grid view. As you can see, the wishlist button appeared here. If you click on this button, it will add the lists to the wishlist.
If you want to see your wish list, open your wish page, which you selected from Listing Types ▸ Settings ▸ Pages

Saved Searchs

In addition, if you activate the wishlist addon, you will receive the Save Searchs feature. Let's use it. First, we need to put this button to display the search button after the filter
Then we will select the template style for this button, then click on the “Save” button.
As you can see this button appeared here. Then we will make some filters, then click on this button to save our search filters.
If you click the Save button, a notification will appear. Now it's time to see our search filters. to see them, click on the wish page again
Here you can see the added search filters.