# Listings

## Overview

Listings are essentially auctions, encompassing both reverse auctions and standard bid auctions. Each listing is associated with a specific category. They are created in the same way as Joomla articles, although they are not defined as Joomla articles.

## Creating A New Auction

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/8pWobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/8pWobraz.png)

**Screen 1: Listing screen**

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

<div id="bkmrk-new-creates-a-new-ad"><table><tbody><tr><td>**New**

</td><td>Creates a new Address entry. You must create separate entries for each level of depth that you need.

</td></tr><tr><td>**Edit**

</td><td>Provides the edit mode to make changes to the existing level or titles created.

</td></tr><tr><td>**Publish**

</td><td>Publishes the created address entry.

</td></tr><tr><td>**Unpublish**

</td><td>Removes the entry from the list of published address entries

</td></tr><tr><td>**Archive**

</td><td>Archives address entries that are not used anymore.

</td></tr><tr><td>**Trash**

</td><td>Deletes the address entry that is not required anymore.

</td></tr><tr><td colspan="1">**Options**</td><td colspan="1">Displays the configuration screen for the JomOffers extension.</td></tr></tbody></table>

</div>## Edit Auction

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 Auction tab

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

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/MSkobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/MSkobraz.png)

**Screen 2: Edit Listing screen**

The following table shows the options available:

<div id="bkmrk-edit-listing-area-ti"><table style="width: 100%;"><tbody><tr><td data-highlight-colour="yellow" style="width: 15.9456%;">##### Edit Listing area

</td><td style="width: 18.047%;">**Title**

</td><td style="width: 66.0074%;">Title for the Listing.

</td></tr><tr><td data-highlight-colour="yellow" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Alias**

</td><td style="width: 66.0074%;">URL alias for “SEF/SEO” URL.

</td></tr><tr><td data-highlight-colour="yellow" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Category**

</td><td style="width: 66.0074%;">Category where the listing will be published.

</td></tr><tr><td style="width: 15.9456%;"> </td><td style="width: 18.047%;"><span style="background-color: rgb(241, 196, 15);">**Work Type**</span></td><td style="width: 66.0074%;">Work location where the listing needs services for.</td></tr><tr><td style="width: 15.9456%;"> </td><td style="width: 18.047%;"><span style="background-color: rgb(241, 196, 15);">**Regular Auction**</span></td><td style="width: 66.0074%;">**If set to Yes than Bids auction type is created otherwise Reverse Auction**</td></tr><tr><td style="width: 15.9456%;"> </td><td style="width: 18.047%;"><span style="background-color: rgb(241, 196, 15);">**Price/Budget**</span></td><td style="width: 66.0074%;">**Budget for the services required or Bid product price** </td></tr><tr><td style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Select Company**</td><td style="width: 66.0074%;">Select the company that you need specific offers from.</td></tr><tr><td style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Ref Number - REF**</td><td style="width: 66.0074%;">Reference number for a specific listing.</td></tr><tr><td style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Days Published**</td><td style="width: 66.0074%;">Number of days for which the listing remains active.</td></tr><tr><td data-highlight-colour="yellow" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Text Area**

</td><td style="width: 66.0074%;">Provide a description for the listing.

You can create a short description as well a long description.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/3nOobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/3nOobraz.png)

![](https://wiki.comdev.eu/download/attachments/8585295/jomoff_adminguide_31.jpg)<div data-hasbody="true" data-macro-name="info"><div>In the above image, the highlighted tag appears when you click **Read More**. Any content above the 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.</div></div></td></tr><tr><td data-highlight-colour="yellow" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Article *Button***

</td><td style="width: 66.0074%;">Click to select a relevant article. If an article is provided, it can be seen under the Details tab in the listing.

</td></tr><tr><td data-highlight-colour="yellow" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Page Break *Button***

</td><td style="width: 66.0074%;">Insert a page break in the displayed text.

</td></tr><tr><td data-highlight-colour="red" style="width: 15.9456%;">##### Address area

</td><td style="width: 18.047%;">**Address**

</td><td style="width: 66.0074%;">Address of the listing

</td></tr><tr><td data-highlight-colour="red" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Street, House No.**

</td><td style="width: 66.0074%;">Street and house number of the listing - If both Address and Full Address specified, map location will position automatically.

</td></tr><tr><td data-highlight-colour="green" style="width: 15.9456%;">##### Location area

</td><td style="width: 18.047%;">**Maps latitude**

</td><td style="width: 66.0074%;">It utilizes the GEO-location based on Google Maps.

Provide the latitude information for the location mapping.

</td></tr><tr><td data-highlight-colour="green" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Maps longitude**

</td><td style="width: 66.0074%;">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.

</td></tr><tr><td data-highlight-colour="green" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Maps Search**

</td><td style="width: 66.0074%;">Search for a specific location. Type in the location and press Enter to go to the exact location.

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;">##### Sidebar

</td><td style="width: 18.047%;">**Featured**

</td><td style="width: 66.0074%;">Enable to make the listing appear as featured listing.

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Approved**

</td><td style="width: 66.0074%;">Enable to approve the listing. Listing will not be published.

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Language**

</td><td style="width: 66.0074%;">Select the language for which the listing needs to appear for. [For multiple languages, you must create separate entries for each language](https://wiki.comdev.eu/display/JO/Multilingual+Site).

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Status**

</td><td style="width: 66.0074%;">Select the required status.

- Published
- Unpublished
- Trashed
- Archived

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Created by**

</td><td style="width: 66.0074%;">Select the user who created the listing.

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Access**

</td><td style="width: 66.0074%;">Provide the access level for the listing.

- Guest
- Public
- Super Users
- Registered
- Special

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Date created**

</td><td style="width: 66.0074%;">Select the date when the listing was created. You can select a future date for publishing the listing as well.

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Publish Up**

</td><td style="width: 66.0074%;">Select a date when you want to publish the listing. Here too, you can schedule to post the listing at a future date.

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Publish down**

</td><td style="width: 66.0074%;">Select a date when the listing should stop being published.

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Modified Date**

</td><td style="width: 66.0074%;">Select a date when the listing was modified.

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**Tags**

</td><td style="width: 66.0074%;">Provide the tags for the listing. Tags are integrated and maintained with Joomla Tags Component.

</td></tr><tr><td data-highlight-colour="blue" style="width: 15.9456%;"> </td><td style="width: 18.047%;">**ID**

</td><td style="width: 66.0074%;">This is an auto-generated field.

</td></tr></tbody></table>

</div>#### 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.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/e1Dobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/e1Dobraz.png)**![](https://wiki.comdev.eu/download/attachments/8585295/jomoff_adminguide_33.jpg?version=2&modificationDateamp;api=v2)**

**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 “London”, the location will map to this location.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/XACobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/XACobraz.png)**![](https://wiki.comdev.eu/download/attachments/8585295/jomoff_adminguide_47.jpg)**

**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.

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/HEEobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/HEEobraz.png)

**Screen 5: Custom Fields tab**

For more information about creating custom fields, see [Custom Fields](http://confluence.comdev.eu/display/JD2/Custom+Fields+Templates).

### 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:

[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/DyYobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/DyYobraz.png)

**Screen 6: Images tab**

<div data-hasbody="true" data-macro-name="info" id="bkmrk-to-set-the-the-order"><div>To set the the Order of the images (which one displayed first) drag and drop images to switch positions.</div></div><div data-hasbody="true" data-macro-name="note" id="bkmrk-the-first-image-in-t"><div>The first image in the gallery is used as the image thumbnail for the listing.</div></div>Provide the options as shown in the following table.

<div id="bkmrk-images-add-file-area"><table style="width: 100%;"><tbody><tr><td colspan="1" data-highlight-colour="yellow" style="width: 14.9508%;">##### Images

</td><td style="width: 15.9516%;">**Add file area**

</td><td style="width: 47.5896%;">Add Files

</td><td style="width: 21.6316%;">Click to select the image that needs to be uploaded.

</td></tr><tr><td style="width: 14.9508%;"> </td><td style="width: 15.9516%;">Drag &amp; Drop Files Here

</td><td style="width: 47.5896%;">Drag a bunch of images to this area to upload multiple images.

</td></tr><tr><td style="width: 14.9508%;"> </td><td style="width: 15.9516%;">Upload Into

</td><td style="width: 47.5896%;">Select which category the image falls under:

- Slideshow - detailed view main gallery
- Gallery - in gallery tab
- Logo - displayed in sidebar under custom fields and over the image with transparency in listings page.

</td></tr><tr><td style="width: 14.9508%;"> </td><td style="width: 15.9516%;">Add available images &amp; attachments

</td><td style="width: 47.5896%;">Click to add already uploaded images and attachments to this listing.

</td></tr><tr><td style="width: 14.9508%;">**Images area**

</td><td style="width: 15.9516%;">Editing an Image

 ![](https://wiki.comdev.eu/download/attachments/8585295/jomoff_adminguide_36.jpg)

</td><td style="width: 47.5896%;">Click the ![](https://wiki.comdev.eu/download/attachments/8585295/Listings_edit_icon.jpg) Edit icon to edit the image details. The options are as seen in the following image:

 ![](https://wiki.comdev.eu/download/attachments/8585295/Listings_Images_edit1.jpg)

Click the ![](https://wiki.comdev.eu/download/attachments/8585295/Listings_close_icon.jpg) Delete icon to delete the image.

</td></tr><tr><td style="width: 14.9508%;">**Attachments area**

</td><td style="width: 15.9516%;"> </td><td style="width: 47.5896%;">Click the ![](https://wiki.comdev.eu/download/attachments/8585295/Listings_edit_icon.jpg) Edit icon to edit an attachment that is linked to the listing. The screen is as shown here:

 ![](https://wiki.comdev.eu/download/attachments/8585295/Listings_Images_Attachments.jpg)

Click the ![](https://wiki.comdev.eu/download/attachments/8585295/Listings_close_icon.jpg) Delete icon to delete the attachment.

<div data-hasbody="true" data-macro-name="note">  
</div>Attachments are detected automatically based on file extension that’s are allowed in Configuration .

</td></tr><tr><td colspan="1" data-highlight-colour="blue" style="width: 14.9508%;">##### Video

</td><td colspan="1" style="width: 15.9516%;">YouTube Video</td><td colspan="1" style="width: 47.5896%;">Provide the YouTube video URL in this field as shown in the following image.

![](https://wiki.comdev.eu/download/attachments/8585295/jomoff_adminguide_37.jpg)

</td></tr></tbody></table>

</div>## Cron job for BIDS - Regular auctions  


For regular auctions a cron job needs to be added to clear auctions which have been finished, interval should be set to 1 or 5 minutes:

```bash
curl -s 'http://extdev.comdev.eu/index.php?option=com_jomoffers&task=auction.check'
```

<div bis_skin_checked="1" class="wiki-content" id="bkmrk--6"><div bis_skin_checked="1" class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div bis_skin_checked="1" class="codeContent panelContent pdl"><div bis_skin_checked="1"><div bis_skin_checked="1" class="syntaxhighlighter sh-default nogutter  java" id="bkmrk--7"></div></div></div></div></div>Instruction how to set cron job for Plesk panel can be found here:

[https://support.plesk.com/hc/en-us/articles/115003121073-How-to-add-a-scheduled-task-in-Plesk-UI-using-crontab-syntax-](https://support.plesk.com/hc/en-us/articles/115003121073-How-to-add-a-scheduled-task-in-Plesk-UI-using-crontab-syntax-)

<div bis_skin_checked="1" class="wiki-content" id="bkmrk--8"></div><div bis_skin_checked="1" id="bkmrk--9"></div><div id="bkmrk--10">---

</div>