Listings

Overview

Listings are nothing but the product listings that you want to create in the directory. Each listing is attached to a category. They are created in the same manner as Joomla articles, but are not related to Joomla articles in definition.

Creating A New Listing

The following image shows the Listings screen.

Screen 1: Listing screen                      

The following table explains the different options seen on the screen.

Edit Listing

If you want to edit existing entries, you can either click the entry from the Listings screen or select the checkbox next to the entry, and then click Edit.

Edit Listing tab

This tab provides options to add title, description, select category, and other options for the Listing as seen in the following image

Screen 2: Edit Listing screen

The following table shows the options available:

Edit Listing area	Title	Title for the Listing.
	Alias	URL alias for “SEF/SEO” URL.
	Category	Category where the listing will be published.
	Tags	Provide the tags for the listing. Tags are integrated and maintained with Joomla Tags Component.
		Provide a description for the listing. You can create a short description as well a long description.   In the above image, a tag appears when you click Read More. Any content above this tag is the short description, while the entire content is the long description. Also, note that if there is no content after the Read More tag, the event description will be blank when users view the listing. Ensure that you have content after the Read More tag.
Joomla Articles area	Article Button	Click to select a relevant article. If an article is provided, it can be seen under the Details tab in the listing.
	Page Break Button	Insert a page break in the displayed text.
Address area	Address	Address of the listing
	Street, House No.	Street and house number of the listing - If both Address and Full Address specified, map location will position automatically.
Location area	Maps latitude	It utilizes the GEO-location based on Google Maps.   Provide the latitude information for the location mapping.
	Maps longitude	The information provided in this field is used to map the exact location. It utilizes the GEO-location based on Google Maps.   Provide the longitude information for the location mapping.
	Maps Search	Search for a specific location. Type in the location and press Enter to go to the exact location.
Sidebar	Featured	Enable to make the listing appear as featured listing.
	Approved	Enable to approve the listing. Listing will not be published.
	Language	Select the language for which the listing needs to appear for. For multiple languages, you must create separate entries for each language.
	Status	Select the required status. Published Unpublished Trashed Archived
	Created by	Select the user who created the listing.
	Access	Provide the access level for the listing. Guest Public SuperUsers Registered Special
	Date created	Select the date when the listing was created. You can select a future date for publishing the listing as well.
	Publish Up	Select a date when you want to publish the listing. Here too, you can schedule to post the listing at a future date.
	Publish down	Select a date when the listing should stop being published.
	Modified Date	Select a date when the listing was modified.
	ID	This is an auto-generated field.

Understanding the Location area in Edit listing tab

Let us understand how to provide the address and Street/House No for providing the exact locations on the map.  When you provide the address, street and House No. in the backend when creating listings, the location position automatically. If the House No. is not provided, additional location fields needs to be used.

Mapping using longitudes and latitudes

If you provide the latitudes and longitudes, and the Maps Search setting is left blank, the location mapping is done based on these parameters as shown in the following image.

Screen 3: Map using longitudes and latitudes values

Mapping with Map Search values 

If the Map Search field has a value provided to it, it takes precedence as shown in the following image. If the Map Search field value is given as “New York”, the location will map to this location.

Screen 4: Map using Map Search Field values

Custom Fields tab

This tab includes all the custom fields created for a particular category. If the custom field is not applied to a specific category, it can be seen for all categories when creating a listing. The following image shows the Custom Fields tab screen.

Screen 5: Custom Fields tab

For more information about creating custom fields, see Custom Fields.

Images tab

This tab includes information about images and videos attached to the listing. Before you can add images to the listing, you must save your listing at least once. This ensure that all the other data you have filled for the listing does not disappear after the images are added.

The Images tab can be seen as shown in the following image:

Screen 6: Images tab

To set the the Order of the images, which one displayed first, drag and drop images to switch positions.
The first image in the gallery is used as the image thumbnail for the listing.

Provide the options as shown in the following table.

Availability Calendar tab

This tab includes an ajax calendar where you can add the date-wise information related to the listing. Based on the services you offer, you can show the availability for that service.

Screen 7: Availability tab

To set the availability for a range of dates, drag and click the required range of dates. Provide the information about availability as shown in the following image.

Screen 8: Availability information

Click Save to save the availability information. If you want to delete a particular entry, click the colored band of availability and click OK as shown in the following image.

Screen 9: Deleting Availability information

Metadata tab

This tab includes the Meta title and Meta description for the listing as shown in the following image:

Screen 10: Metadata tab

Rules tab

This tab includes information about the permission status. For more information about setting permissions, see the Joomla documentation.

Screen 11: Rules tab