=== OnList ===
Contributors: tradesouthwest
Donate link: https://paypal.me/tradesouthwest
Tags: directory, classifieds, listings, ecommerce, business directory, listing, classified ads, responsive, forms, metabox, real estate, catalog
Requires at least: 3.8
Tested up to: 4.9.1
Requires PHP: 5.2
Stable tag: 2.0.1
License: Apache License
License URI: See File, LICENSE
Plugin URI: http://themes.tradesouthwest.com/wordpress/plugins/

Fast and simple setup for creating an online listing site or directory.

== Description ==
Create a basic yet stylable directory type listing with custom categories. All field names can be changed to fit the purpose of your website. Fields are by default named Country, Address, State, City, ZipCode, Phone, Email, Website and Other. Map included for each listing and uses the Address and Postal/ZipCode fields to calculate the location. Simply add a google Maps API key into the control panel and away you go. Fast and simple online directory plugin.

Set number of listings on a page. Set number of characters on front page excerpt. Supports a Featured Image that shows in main page listings and on archive and single lists. Other images can be added in the standard editor so lister has full control of images and can even create a gallery. Supports Comments and uses theme comment form. Supports Excerpts. Set text for ‘read more’ link. Includes default categories for all USA States that can be enabled. (Listings Categories can be anything… food, music, plays. OnList only provides the states since most use this type of plugin for listing by locations.) Set size of maps box. Also has a before and after content editor so you can make the OnList meld with your current theme. Includes three shortcodes: One to list the main page and another to create a Categories page with and a third for creating a user login page. Category Widget can be added to any sidebar and this plugin supports nav menu entries.

Please note: You must have a google Maps API Key for Maps to work. (See Q. and A. below)
Custom theme, OnList-One is available for free.
Demo at http://tradesouthwest.com/onlist/

== Features ==
* Most useful settings to start a directory, with little to no configuration.
* Change listing field names to make OnList versatile.
* Custom meta data for every listing.
* Branding for your log in page.
* Branding of User dashboard features.
* Dashboard widgets to show user content.
* Before and After Content widgets included.
* Category Widget included for sidebars, plus category shortcode.
* Supports comments which can be used for service requests or reviews.
* Supports Featured Image.
* Supports Excerpts.
* Turn on or off comments.
* Set number of days to display a listing.
* Spam protection assets to safe guard email and phone numbers.
* Certain fields can be hidden to paid or subscribed users only.
* Page view counter shows on listing.
* Has auto detect features to keep from clashing with other plugins and themes.
* Sub-Categories can be added.
* USA States are included but can be excluded as categories.
* Only two fields: Address and Postal/Zip Code is all that is needed to show map.
* Set size of map box on page.
* Add any label to “Other” field (Specialist In, UPC, Certification Number, etc.)
* Plugin is responsive layout.
* Uses three shortcodes and Google Maps API key to display all settings on page.
* Custom templater functions help display listings on most any theme.

== Screenshots ==
1. Listing fields

 

2. Admin Page with settings

3. Admin Page Three

4. Editor meta boxes

5. Basic listing page

 

== Installation ==
This section describes how to install the plugin and get it working.
1. Upload `onlist.zip` to the `/wp-content/plugins/` directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Go to Settings and configure OnList settings.
4. Add shortcode to a page to display listsings [onlist-listings]
5. Optional, add shortcode to a page or use widget to display categories [onlist-categories]
6. Optional, add shortcode to a page to display login form [onlist-loginform]
7. Go through all options in OnList Settings to activate what you want to use.
8. Suggested to set Permalinks to `post name.`

== Frequently Asked Questions ==
Q.: How do I let other people add a listing?
A.: This plugin uses normal WordPress login and user functions. So just use it like you would a blog. Have People register and then they will have their own listing admin area without the administrative rights. (They can not change the plugin settings.)

Q.: Where are the controls for this plugin?
A.: You will find the setup under menu page “OnList Settings.”

Q.: Can I change the listing style?
A.: If you know CSS then you can use any CSS editor to add a selctor in your Customizer or and other stylesheet. Using the Inspector on your browser it is easy to look up the selector name. Most all of OnList selectors start with onlist-.

Q.: How do I get an API key to use the maps?
A.: To get an API Key, Visit: https://developers.google.com/maps/documentation/javascript/get-api-key. API will be required to have a Google account in order to create the key but the proccess is simpler than pie. No programming experience or coding required. Just copy the number and paste it into the plugin field.

Q.: I just loaded a new theme and can not see the listings?
A.: Go to Settings > Permalinks and hit “Save Changes.” This refreshes your posts to recognize the OnList post. It is also possible that you have changed the permalink settings. Try to keep settings as “Post name” permalink.