Listings Shortcodes

Shortcodes are a way for programmers or administrators to install certain parts of this plugin onto a page that they specifically want to assign as the page for that shortcode function.

The most prevalent shortcode for this plugin would be the Listing Core shortcode. By placing the shortcode below into any page ( could even be the Home Page ) you will have a OnList directory listing instance appear magically on that page. We call it the Main Listing Page.

Listings Shortcodes

Main Listing Page: …………………………………………………………….. [onlist-listings]

A Categories Page: …………………………………………………………………. [onlist-categories]

A Log In Page: ………………………………………………………………………………… [onlist-loginform]

A Short List View (Recent Listings): ……………………………………………….. [onlist-listview]

Search Form (place in widget – form autoloads on home): ……………[[onlist-searchform]]

There is also a Widget for Category Lists. Appearance > Widgets > Onlist Category Sidebar.

 

Please note that if you are using the Theme OnLister you will not need to place any shortcode into the Listing Main Listing Page. This is done automatically when installing OnLister.

 

OnLister is the theme that is being used for this demonstration site. To get OnLister visit http://themes.tradesouthwest.com/wordpress/onlister/index.html

onlister theme

Add A Listing

Adding a new listing can be accomplished using the standard editor. If you want to find more information on the editor you can visit the link provided in the drop-down Help tab at the top of the editor page.

help

The editor can be limited by certain website administrator’s preferences but by default you should be able to add text and media using the toolbar at the top of the editor.

When adding media you will use the Featured Image box—to the lower right of the editor page—to upload the image (or use one already saved). Once you have your main image you can add more images inside of the editor box using a single image or Add Media button will allow you to select Inserting a Gallery, if your website has this activated.

 

When initially opened, the visual editor will display a single row of icons:

screenshot of WordPress TinyMCE WYSIWYG toolbar first row

  1. Style – various formatting styles defined by your theme
  2. Bold
  3. Italic
  4. Unordered list (bullet points):
    • Item 1
    • Item 2
  5. Ordered list
    1. Item 1
    2. Item 2
  6. Blockquote (a way of displaying quoted text; each theme will style this differently.)

    Always forgive your enemies; nothing annoys them so much.

  7. Align Left
  8. Align Center
  9. Align Right
  10. Insert / Edit Link
  11. Remove Link
  12. Insert Read More tag
  13. Toolbar Toggle (enables the second row of editing icons)
  14. Toggle Distraction-free Writing Mode

User Levels

User Roles are a way for WordPress to keep track of who can do what on your website. OnList Directory and Listing script uses the built-in WordPress role attributes. So if you are familiar with WP then this should be easy to do. If not then here you go:

From the Admin page go to Settings > General

instruct

Be sure to add Anyone Can Register – or no one will be able to register.

By default, WP uses Subscriber as the Default Role. You will want to set OnList User Roles to Author. This will allow any new registered person to add a Listing.

To prevent spam registration, use the User Role of Subscriber or Contributor. You will have to manually approve each new User but will have more control this way.

You may choose to shut off Anyone Can Register and install a Membership plugin.

If you only have a single user or team using the OnList plugin you may choose to turn off membership altogether.

linux

OnList Plugin Instructions

General Overview. For more Info click on Topic.

Setup
This section describes how to install the plugin and get it working.
1. Add shortcode to a page to display listings  ………………………………………[onlist-listings]
2. Optional, add shortcode to a page or use widget to display categories [onlist-categories]
3. Optional, add shortcode to a page to display login form …………………….[onlist-loginform]
4. Go through all options in OnList Settings to activate what you want to use.
5. Suggested to set Permalinks to `post name.`
Listings Shortcodes
Main Listing Page onlist-listings
A Categories Page onlist-categories
A Log In Page onlist-loginform
There is also a Widget for Category Lists. Appearance > Widgets > Onlist Category Sidebar.
User Levels

Upon install of OnList, change user roles to ‘Author’!*

* If site is not open to ‘anyone can post,’ then do not change user levels.
Displaying Fields (or not)
Provides the option to display fields in many formats on several pages, or not.
Address Presentation
Provides the option to display address on one line.
Images For Listings
All image placement uses the WP native Media Library. One nice advantage of Media Library is that you can insert an image ANYPLACE within your post/listing and can make galleries. Suggestion would be to put your images at the bottom of the content.
Show Maps on Page
Toggles whether or not Maps show on pages
Google Maps Key
For an API Visit: https://developers.google.com/maps/documentation/javascript/get-api-key.
link opens in new window
Before Content
Copy or write HTML into the textarea that will either match your theme or that you want to use to display before the listing. Before and After Content are only effective on the Single Template (single listings).
After Content
Both before and after textareas can be as simple as a clearfix element or you might use a section of your current theme to offset or create areas around the OnList section.
Comments on Public View
By default, ALL responses will show on public views*. Check OnList Options, Check to Allow Individual Authors to Choose Response View, to allow the authors to choose whether or not they want to receive comments for their listing. *If Show Comments Form is activated.
All Other OnList Settings
Set # of listings on home page.
Set # characters in excerpt
Set the height of excerpt box
Set text for listing link.
Listing Editor
Listing Tips and Tricks

For custom configuration of OnList please email Larry @ support@tradesouthwest.com