# JOMOFFERS # Quick Start - JomOffers ##### Overview This guide will help you get started with using the JomOffers extension quickly. It highlights preliminary steps that are a must for JomOffers configurations. After you are done with them, you can go ahead and create the listings on your site. ##### Creating Administration Menu Links

This step is not needed if new installation being made.

Go to the System -> Administrator modules and insert new. Than choose Administrator Menu. From the presets, select Comdev and place it under menu position. Do the same for the JomOffers: ![](https://wiki.comdev.eu/download/attachments/4194513/screenshot-2021-12-22-19-30-33-536.jpeg) ##### Creating Menu Links Menus are used to control website navigation. A menu contains one or more menu items which provides your users with a navigational experience. The menu items in our case must point to the JomOffers. It is mandatory that you create menu links such that Items menu and the Front Admin access is created. Get started with creating menu links using the information given in the [Menu Items](https://wiki.comdev.eu/books/JomOffers/page/menu-items "Menu Items") documentation in the Administrative Guide. #### Creating Groups In order to add users to groups for membership plans, you must create a super group named JomOffers, then create groups for each of your membership plans underneath your super group. These groups are used to provide Group ID when creating a membership plan. Users created using User Manager can be linked to each of these membership plan groups. To begin creating groups for membership plans, follow the [Creating a Group](https://wiki.comdev.eu/books/JomOffers/page/membership "Membership") documentation in the Administrative Guide. #### Creating Membership Plans and Memberships Memberships in JomOffers are required to set user group level based on the monthly/Yearly pay plan the user selects. Using membership plans, you can decide how much to charge a user and how many listings a user can make a particular membership plan. Before you can create a membership plan, you must create Joomla groups using the above section information. Read more about creating membership plans for your site using the [Memberships](https://wiki.comdev.eu/books/JomOffers/page/membership "Membership") section in the Administrative Guide. #### Adding a New Address The Address feature lets you provide the country, region and city for the associated product listing. The advantage with the Address field in JomOffers is that after you configure a particular address, it is shared across various components in the Comdev extension. Get started with creating addresses that will be used in your listings by referring to the [Address](https://wiki.comdev.eu/display/JD2/Address) documentation in the Administrative Guide. #### Adding a New Category Categories allow the site owner to categorise listings into appropriate sections. JomOffers categories are independent of the Joomla category system. Nested categories (sub-categories) are supported in JomOffers. The component comes with a default category named "UNCATEGORIZED", which holds listing items that are not attached to any category (same function as the default Joomla system). To start creating categories, follow the [Categories](https://wiki.comdev.eu/books/JomOffers/page/categories "Categories") documentation in the Administrative Guide. #### Adding Custom Fields Custom fields are a powerful tool to build content. We provide a variety of field types with the ability to outline into groups. Each field can be assigned to a single category or all categories. Custom fields in JomOffers provide multiple options such as dropdowns, text area, radio buttons, and so on. Based on your requirement create a custom field and make it searchable for better user experience. Read more about how to create custom fields in the [Custom Fields](https://wiki.comdev.eu/books/JomOffers/page/custom-fields "Custom Fields") section from the Administrative Guide. #### Creating a New Listing 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 the definition. Get started with creating listings for each category by referring to the [Listings](https://wiki.comdev.eu/books/JomOffers/page/listings "Listings") section in the Administrative Guide. # Configuration Steps ## Overview These configuration steps needs to be done in order for the component to work correctly. More about menu links can be [found here.](https://wiki.comdev.eu/display/JO/Menu+Items) ### Create Menu links Items menu link needs to be created.
### Joomla / Groups Membership Plans are based on the Joomla Groups therefore before creating any of the Membership plans - corresponding Joomla groups needs to be created. The main group for the component needs to be called JomOffers. Each of the plans needs to be placed under that JomOffers parent group e.g. **JomOffers**
- Free - Basic - Silver - Gold
[![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/1SQobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/1SQobraz.png) **Screen 1: Joomla Membership** ### Permissions It is important to set the right permissions for the components: Comdev and Directory, in order for the users to access the Front Admin. Otherwise Users won't be able to access the Front Admin (Permissions Denied) or get 500 Error when trying to upload the images. Example below shows access for the Registered Group. Same settings should be applied for each group that should have access to the Front Admin. #### Setting permissions for the Comdev Extension [![C7hobraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/c7hobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/c7hobraz.png) **Screen 2: Comdev Permissions** #### Setting permissions for the Directory Extension [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/CXaobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/CXaobraz.png) **Screen 3: JomOffers Permissions**
# Menu Items ### Overview In this section, we will learn how to create menu items to access JomOffers. Menus are used to control website navigation and are a set of menu items. Menu items provide the navigational experience to your users. The menu items in our case must point to the JomOffers. ### Creating Administration Menu Links

This step is not needed if new installation being made.

Go to the System -> Administrator modules and insert new. Than choose Administrator Menu. From the presets, select Comdev and place it under menu position. Do the same for the JomOffers: ![](https://wiki.comdev.eu/download/attachments/5734794/screenshot-2021-12-22-19-30-33-536.jpeg) ### Creating Menu Items to access JomOffers

Creating an Items menu link is mandatory. If you have a multilingual site, ensure that you create an Items menu link for each language. You can hide this menu link, but it needs to be created nonetheless. Though you are creating an Items link that does not point to any category or address, you can create other links with Items menu type that can point to an address or a category once main Items link has been created.

#### Reverse Auctions: To create menu items with Items menu item type, do the following: 1. Click **Menus** > **<your\_menu>(Main Menu)** > **Add New Menu Items**. 2. Provide a title in our case is **Latest Listings** in the **Menu Title** field. Now, since the Latest Listings menu item provides a list of all the latest postings on the site, we have selected the menu type as Items. The Alias field will build URL for the site. When search is done this will be the landing page for the search results as well. 3. Provide the options as seen in the following image: [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/3HZobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/3HZobraz.png) **Screen 1:** Items menu item screen Provide the values based on the following table. 4.
**Menu Item Type** Click **Select**. A pop up is displayed. In this case, since we are creating the Items menu item, click **JomOffers**> **Items** from the list.
**Category** Select the appropriate category, if creating direct category link.
**Address** Select the appropriate address if, creating direct address link.
**Auction type** Set an Auction type: Reverse or Regular (BIDS)
**Link** This field is auto populated based on the menu item type selected.
**Target Window** Select the parent for this menu item.
**Template Style** Select the template style you want for this menu.
Click **Save**.
#### Bids 1. Click **Menus** > **<your\_menu>(Main Menu)** > **Add New Menu Items**. 2. Provide a title in our case is **Latest Listings** in the **Menu Title** field. Now, since the Latest Listings menu item provides a list of all the latest postings on the site, we have selected the menu type as Items. The Alias field will build URL for the site. When search is done this will be the landing page for the search results as well. 3. Provide the options as seen in the following image: [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/AX7obraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/AX7obraz.png) Ensure that you see a green tick next to this menu item. The green tick indicates that the item is published. To publish an item, select the check box next to the item and click **Publish**. To view the created menu item, go the front end of your site. The new menu item is displayed. ### Creating Menu to access JomOffers Front Admin To create menu items with Front Admin menu item type, do the following: 1. Click **Menus** > **<your\_menu>(Main Menu)** > **Add New Menu Items**. 2. Provide a title as **Front Admin** and the alias as **front-admin** in the Menu Title field. 3. Provide the options as seen in the following image: [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/YWjobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/YWjobraz.png) **Screen 2:** JomOffers Front Admin menu item screen 4. Click **Save**. ### Front Admin Options For the Menu to be able to access the JomOffers Front Admin, certain settings need to be made. The following table shows the three menu links that need to be made and linked with JomOffers Options. You can create these 3 menu items anywhere on the site e.g. link them under User Menu.
##### Profile Edit Menu Link This link should point to Edit profile menu item created using Edit User Profile menu item type. 1. Click **Menu** > **<your\_menu>(Main Menu)**>**Add New Menu Item**. 2. Provide the Title as **Edit Profile** and the menu item type as **Edit User Profile,** under **Users Manager**. 3. Click **Save**.
![](https://wiki.comdev.eu/download/attachments/8585317/jomoff_menuitem_3.jpg?version=2&modificationDateamp;api=v2)
##### Admin Menu Link This link should point to the login form menu item created using Login Form menu item type. 1. Click **Menu** > **<your\_menu>(Main Menu)**>**Add New Menu Item**. 2. Provide the Title as **Login Form** and the menu item type as **Login Form**, under **Users Manager.** 3. Click **Save**. The following image shows how the Login Form menu item is used. [![Bez nazwy.jpeg](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/2xibez-nazwy.jpeg)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/2xibez-nazwy.jpeg) ![](https://wiki.comdev.eu/download/attachments/8585317/jomoff_menuitem_4.jpg) When user is not logged into the front page, he will be redirected to the built-in Joomla login form. After successful login, he will be redirected to the JomOffers Front Admin. The following image shows the redirect URL that needs to be provided. The value you provide in the Login Redirect field depends on the following:
- http://domain.com/index.php/front-admin - Use if URL rewriting is not applicable. - http://domain.com/front-admin - Use if URL rewriting is applicable.
In our example, we are using the http://domain.com/front-admin URL as shown in the following image where front-admin is the alias of the [JomOffers Front Admin Menu Link](https://wiki.comdev.eu/display/JO/Menu+Items#MenuItems-front-admin): ![](https://wiki.comdev.eu/download/attachments/8585317/jomoff_menuitem_5.jpg)
##### Profile View Menu Link This link should point to the user profile created using User Profile menu item type. 1. Click **Menu** > **<your\_menu>**>**Add New Menu Item**. 2. Provide the Title as **User Profile** and the menu item type as **User Profile**. 3. Click **Save**.
![](https://wiki.comdev.eu/download/attachments/8585317/jomoff_menuitem_6.jpg)
**Now link menus with JomOffers Options**: Make the following settings for the Front Admin are made in the JomOffers options for the user to be redirected correctly to the Front Admin, when he is not logged in.
1. Click **System** > **Control Panel**. 2. Under **Extensions**, click **JomOffers**. 3. Click **Options** in the top right-hand corner of the screen. 4. Click the **Front Admin** tab. 5. Change the **Profile Menu Link**, **Login Menu Link**, and **View Profile Menu Link** field as per the following image. ![](https://wiki.comdev.eu/download/attachments/8585317/jomoff_menuitem_7.jpg) **Screen 3:** JomOffers Front Admin options 6. Click **Save**.
The Front Admin lets users add listings in the front of the site. For more information about how to add listings, see [Front Admin](https://wiki.comdev.eu/display/JO/Front+Admin).
# Administrator's Guide # Auction Types Overview In the context of auctions, the main difference between a reverse auction and a regular (or forward) auction lies in the roles of buyers and sellers, and the direction in which the price moves: ### Regular (Forward) Auction:
1. **Role of Participants**: Sellers offer goods or services, and buyers place bids to purchase them. 2. **Price Movement**: The price typically starts low and increases as buyers compete by placing higher bids. The item is sold to the highest bidder. 3. **Objective**: Buyers aim to outbid each other to win the item or service being auctioned.
**Example**: An art auction where various bidders compete to buy a painting, with the highest bid winning the item. ### Reverse Auction:
1. **Role of Participants**: Buyers post their requirements for goods or services, and sellers place bids to offer the goods or services. 2. **Price Movement**: Sellers decreases price compete by offering lower bids. The buyer selects the lowest bid or the best offer. 3. **Objective**: Sellers aim to underbid each other to win the contract or sale.
**Example**: A company needs a bulk supply of office chairs and invites suppliers to bid. Suppliers compete by offering lower prices, and the company chooses the supplier with the most competitive offer. In summary, the key difference is that in a regular auction, buyers compete to purchase from sellers, driving the price up. In a reverse auction, sellers compete to fulfill a buyer's need, driving the price down. # Dashboard ### Overview Administration dashboard gives you an overview of all the activities you can do using the JomOffers extension. It provides you a view of all the menu items, system configuration checks, license information, and links to the documentation. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/U6bobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/U6bobraz.png) **Screen 1: Dashboard screen** ### Menu Items The menu items are present in a grid format format for easy access. The following image shows the Menu items present on the dashboard screen. **Screen 2: Menu items area** The following table provides an explanation about different menu items available:
**Dashboard** Home or dashboard for the JomHoliday extension
**Listings** Shows the Listings administration screen
**Categories** Shows the Categories administration screen
**Custom Fields** Shows the Custom Fields administration screen
**Resource Custom Fields**Shows the Resource Custom Fields administration screen
**Addresses** Shows the Address administration screen
**Business Types**Shows the Business Types administration screen
**Bookings**Shows the Bookings administration screen
**Booking Addons**Shows the Booking addons administration screen
**Membership Plans** Shows the Membership Plans administration screen
**Messages** Shows the messages received
**Reviews: Categories** Shows the Reviews administration screen to add review parameters for each category. For example, Quality, Customer Service, and so on.
**Reviews: Recommended** Shows screen to add recommended audience for the listing or category. For example, For young people, Gizmodo, and so on.
**Documentation** Access the JomHoliday documentation.
### System Configuration Checks Any configuration problems or current configuration status is displayed in this area as shown in the following screen: **Screen 3: System configuration checks area** ![](https://wiki.comdev.eu/download/attachments/7438861/screen1.png?version=2&modificationDateamp;api=v2) # Address {{@105}} # Categories {{@106}} # Custom Fields {{@56}} # 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.
**New** Creates a new Address entry. You must create separate entries for each level of depth that you need.
**Edit** Provides the edit mode to make changes to the existing level or titles created.
**Publish** Publishes the created address entry.
**Unpublish** Removes the entry from the list of published address entries
**Archive** Archives address entries that are not used anymore.
**Trash** Deletes the address entry that is not required anymore.
**Options**Displays the configuration screen for the JomOffers extension.
## 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:
##### Edit Listing area **Title** Title for the Listing.
**Alias** URL alias for “SEF/SEO” URL.
**Category** Category where the listing will be published.
**Work Type**Work location where the listing needs services for.
**Regular Auction****If set to Yes than Bids auction type is created otherwise Reverse Auction**
**Price/Budget****Budget for the services required or Bid product price**
**Select Company**Select the company that you need specific offers from.
**Ref Number - REF**Reference number for a specific listing.
**Days Published**Number of days for which the listing remains active.
**Text Area** 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)
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.
**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](https://wiki.comdev.eu/display/JO/Multilingual+Site).
**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 - Super Users - 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.
**Tags** Provide the tags for the listing. Tags are integrated and maintained with Joomla Tags Component.
**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. [![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**
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.
##### Images **Add file area** Add Files Click to select the image that needs to be uploaded.
Drag & Drop Files Here Drag a bunch of images to this area to upload multiple images.
Upload Into 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.
Add available images & attachments Click to add already uploaded images and attachments to this listing.
**Images area** Editing an Image ![](https://wiki.comdev.eu/download/attachments/8585295/jomoff_adminguide_36.jpg) 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.
**Attachments area** 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.
Attachments are detected automatically based on file extension that’s are allowed in Configuration .
##### Video YouTube VideoProvide the YouTube video URL in this field as shown in the following image. ![](https://wiki.comdev.eu/download/attachments/8585295/jomoff_adminguide_37.jpg)
## 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' ```
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-)
---
# Work Type ## Overview Work Type for **Reverse Actions** defines the location where you want to avail the services required in the listing. For example, for a service such as gardening, the Work Type would be On Place or Remote. But, in case of accountant services, the Work Type would be In House. ### Creating a Work Type Creating a custom field involves setting certain options. To create a custom field, click New as shown in the following image. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/UHIobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/UHIobraz.png) **Screen 1: Work Type screen** The following table explains the different options available on the screen.
**New** Creates a new Custom Field.
**Edit** Provides the edit mode to make changes to the existing level or titles created.
**Publish** Publishes the created custom field.
**Unpublish** Removes the entry from the list of published custom fields.
**Archive** Archives custom fields that are not used anymore.
**Trash** Deletes the custom fields that are not required anymore.
**Rebuild** Refreshes to incorporate the changes made to the entries in the Custom Field feature.
**Options**Displays the configuration screen for the JomOffers extension.
### Editing a Work Type If you want to edit existing entries, you can either click the entry from the Work Type screen or select the checkbox next to the entry, and then click **Edit**. #### Work Type Edit After you click the required entry that you need to edit, you can change the configurations for the fields as shown in the following image. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/zFdobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/zFdobraz.png) **Screen 2: New Category tab screen** After you click the required entry that you need to edit, you can change the configurations based on the options as seen in the following table.
**Title** Custom Address Field
**Alias** URL alias for “SEF/SEO” URL
**Parent** Select the parent address entry
**Text box** Provide a description about the entry. You can format the text using the formatting options in the text box. You can also insert images or links to URLs for more information.
**Category Image** Upload an address image
#### Publishing tab After you have provided the above information, you can provide the publishing information in the Publishing tab as seen in the following image. You can change the values for the given options using the following table.
**Status** Based on the status seen here, the visibility changes as follows: - Published - Entries are visible on the front-end. - Unpublished – Entries are invisible in the front-end, but can be published later. - Archived – Older entries that are not ready for deletion yet. - Trashed – Older entries that should be removed.
**Access** Access level for site users is as follows: - Public access grant access to everybody. - Superusers access grants access to only users - Registered access grants access only to registered and logged in users. - Special access only grants access to users specified as “Special”.
**Language** Select the language for the address entry.
**ID** Address ID, which can be used in modules, plugins and menus.
**Created by** User name who created the entry.
**Created Date** Date when the entry was created.
# Offers ## Overview For every listing made, contractors or companies can provide an offer. This offer includes information such as pricing, time taken to complete the task and description about the services provided. ### Making an Offer The following image shows the offer screen. ![](https://wiki.comdev.eu/download/attachments/8585355/jomoff_adminguide_49.jpg) **Screen 1: Making an offer** Let us understand each of the buttons seen on the screen using the following table.
**Title** Title of the offer
**Price** Price of services
**Price Negotiable** Slide to select whether price is negotiable
**Time to Complete (days)** Duration taken to complete the services
**Description**Detailed description of the services offered.
### Editing the Offers The following screen shows the offers made for all the listings available. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/7OVobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/7OVobraz.png) **Screen 2: Offers for all listings** If you want to edit existing entries, you can either click the entry from the Offers screen or select the check box next to the entry, and then click **Edit**. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/totobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/totobraz.png) **Screen 3: Editing an offer** After you click the required entry that you need to edit, you can change the configurations based on the options as seen in the following table.
**Title** Title of the offer made.
**Price** Price mentioned by the contractor for the services offered.
**Price Negotiable** Enabled if price is negotiable.
**Status**Edit status, if required from the following options. By default, every offer made is in the Published state. - Published - Unpublished - Trashed - Archived
**Offer Status**After reviewing the offer, set the state of the offer to one of the following states. - Not Accepted (Default status) - Accepted - Rejected
**Time to Complete (days)**Number of days to complete the services required.
**ID**Offer ID, which can be used in modules, plugins and menus.
**Created by**User name who created the entry.
**Description**Description about the serviced offered.
# Membership {{@109}} ### Creating a new Group for Membership Plans In order to add users to groups for membership plans, you must create a super group named JomOffers. Then, under it you must create groups for each of your membership plan. These groups are used to provide Group ID when creating a membership plan. Users created using User Manager can be linked to each of these membership plan groups. To create the JomOffers group and other groups, do the following: 1. Click **Users** > **Groups** > **Add New Group**. 2. Provide a name for the group. We need to create JomOffers group before creating other groups. So, provide the name as **JomOffers** [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/xi5obraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/xi5obraz.png) 1. Repeat steps 1 and 2, but select the parent as JomOffers. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/OODobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/OODobraz.png) 2. Click **Save**.
Name **JomOffers** for the main group is mandatory, however groups for membership under that group can have any names e.g. Lite, Pro or Free, Basic etc...
### User Permissions based on groups For the users to access Front Admin certain user permissions need to be granted. These settings need to be done in the JomOffers and Comdev Options. To provide user permissions for JomOffers, do the following: 1. Click **Components** > **JomOffers** 2. Click **Options** from the right-hand side of the screen. 3. Click **Permissions**. 4. Provide the permissions as shown in the following image. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/Xtfobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/Xtfobraz.png) 5. Click **Save**. User permissions also need to be set for Comdev extension as explained here. 1. Click **Components** > **Comdev**. 2. Click **Options** from the right-hand side of the screen. 3. Click **Comdev**. 4. Provide the permissions as shown in the following image. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/oJrobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/oJrobraz.png) 5. Click **Save**.

Users, which belongs to Joomla group JomOffers, will now have access to Front Admin.

If Permissions for the Comdev component are not set, users would not be able to upload images. A 500 error would show that permissions are denied.

# User Guide # Front Admin Overview ## Overview The dashboard gives a quick snapshot of all the tasks that you can perform using the Front Admin. It also provides multiple menu items that you can use to create listings, view listings, viewing offers, and so on. The other options that you can control are viewing statistics, viewing messages, and so on. For the Menu to be able to access the JomOffers Front Admin, certain settings need to be made. You must create the Profile Edit Menu link, Admin Menu link, and Profile View Menu link in the JomOffers Front Admin configurations to be able to access Front Admin. For more information, see the Front Admin Options section in the [Menu Items](http://confluence.comdev.eu/display/JD2/Menu+Items#MenuItems-FrontAdminOptions) documentation. ## Accessing the dashboard When you access the home URL for JomOffers extension, do the following: 1. Click **Front Admin**. 2. Provide the login details for the required user and click **Submit**. The dashboard with various options can be seen as shown in the following image. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/T98obraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/T98obraz.png) ![](https://wiki.comdev.eu/download/attachments/8585303/jomoff_adminguide_54.jpg) **Screen 1: Dashboard screen** You can click the options as seen in the following table.
##### Listing stats Shows the general statistics about the listings![](https://wiki.comdev.eu/download/attachments/5734996/frontend_listing_stats.png)
##### Report Most Viewed graph View the statistics for the site based on the listings viewership.
##### Membership Upgrade Your Membership NOW! Upgrade to another membership plan. Click Upgrade on the plan tab for the plan you want to upgrade to as shown here. ![](https://wiki.comdev.eu/download/attachments/5734996/Dashboard_Membership.jpg)
##### Profile Profile View the profile details for your profile.
##### Approve Comments Click the review to see the listing page it applies to. To approve a listing, select the check box next to the review comment and click **Approve**. If you want to delete the comment, click **Delete**. ![](https://wiki.comdev.eu/download/attachments/5734996/frontend_comments.png)
Approve comments appears only when enabled under JomDirectory Options -> Front Admin settings
# Manage Listings ### Overview You can view all the listings created for your site or create a new listing. The created listings let you add descriptions, images, provide ratings, and much more. ### Creating a New Listing The following image shows the Listings screen. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/wQ5obraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/wQ5obraz.png)**![](https://wiki.comdev.eu/download/attachments/5735004/frontend_listings.png)** **Screen 1: Listing screen** The following table explains the different options seen on the screen.
**Button** **Usage**
**Insert New** Creates a new Address entry. You must create separate entries for each level of depth that you need.
**Publish** Publishes the created address entry.
**Unpublish** Removes the entry from the list of published address entries
**Delete** Deletes the address entry that is not required anymore.
# User Membership # Listing Messages {{@111}} # Making an Offer / Bid ## Overview For every listing made, contractors or companies can provide an offer. This offer includes information such as pricing, time taken to complete the task and description about the services provided. ### Making an Offer To make an offer, navigate to the listing that you want to make an offer to. The following image shows the offer screen. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/dzbobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/dzbobraz.png) **Screen 1: Making an offer** Let us understand each of the buttons seen on the screen using the following table.
**Title** Title of the offer
**Price** Price of services
**Price Negotiable** Slide to select whether price is negotiable
**Time to Complete (days)** Duration taken to complete the services
**Description**Detailed description of the services offered.
### Make a Bid To make a bid navigate to the listing that you want to make an offer to. The following image shows the offer screen. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/m3Wobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/m3Wobraz.png)

Please notice that in order to place an offer user would need to be logged in.

# Modules # Latest Items Module ### Overview Modules are extensions that assist in creating blocks of information on your site. They aggregate information from components and can be placed in predefined positions on the page based on your Joomla template. ### JomOffers Latest module This module helps you create the panel where latest listings are displayed. You can decide where to position the latest panel on the page and also control on which pages the panel should appear. To view all the available modules, click **Extension** > **Module Manager**. The modules available are listed as seen in the following image. ### Editing the JomOffers Latest module To edit the module, click on the module link or select the checkbox next to the module name, and then click **Edit**. The following image shows the module edit screen. #### Module tab This tab controls the layout where the latest listings panel is to be displayed on the screen. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/cR9obraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/cR9obraz.png) **Screen 8: Module tab** Provide the options as per the following table.
**Layout** Select the required layout in the Layout field. The available options are: - Slider – Displays the latest listings in the form of a slideshow. - Default –Displays the latest listings in the default format. ![](https://wiki.comdev.eu/download/thumbnails/5734945/Latest_Default.jpg) - Grid – Displays the latest listings in a grid format. ![](https://wiki.comdev.eu/download/thumbnails/5734945/Latest_.jpg) - Clean - Displays the latest listings in a clean format
**Columns count**Number of columns of listing that should be listed in the panel
**Count** Number of listings that should be listed in the panel.
**A number of Characters** Number of characters that will be displayed in the short description for listing thumbnail.
**Image Width** Provide the image width for the thumbnail image.
If Slider Layout set, image width must be the same size than Slider Width or larger.
**Image Format** The format for the thumbnail listing image. 1:1 = Image will be unchanged. 4:3 = image will be resized to 4:3 format. 10:9 = Image will be resized to 10:9 format.
**Latest or IDs** Select how you want the listings to be displayed as: - Latest - IDs
**Enter IDs** If ID is selected in the column above, mention the starting ID of the listing.
**Featured** Enable to show only featured listings.
**Show Address** Enable to show the address of the listing.
**Show Description** Enable to show the description up to the character limit set.
**Category** Enable either of the following options. - Current Browse (auto) – Automatically displayed based on the category. - Selected Below – Listings belonging to only these categories are shown.
**Choose Category** If Selected Below is selected for the above field, select the required category.
**Sort Options** Select how the displayed listings should be sorted by. - Latest - Most Viewed - Alphabetically - Updated - Most Rated DESC - Most Rated ASC
**Slider Settings** Heading
**Slider Width** Slider width in pixels
**Slider Height** Slider height in pixels
**Slide Delay (seconds)** Slideshow delay in seconds
**Slider Shadow** Enable to provide the shadow effect.
**Slider Thumbs** Enable to show image thumbnails
**Slider Caption** Enable to show the image caption.
**Show Title** Show or hide the title for the search panel.
**Position** Select the position based on your Joomla Template.
**Status** Select from the given options. - Published - Unpublished - Trashed
**Start Publishing** Provide a date when the latest listings panel should be published.
**Finish Publishing** Provide a date when the latest listings panel should be unpublished.
**Access** Provide access level for the panel. - Guest - Public - Registered - Special
**Ordering** Provide the order in which the side panel should appear. If more than one module is positioned at the same location, you can set the order of appearance in this field.
**Language** Select the language for which you want to display this panel. For each language, you must create a new JomOffers Latest module.
**Note** Provide additional information.
#### Menu Assignment tab This tab controls where the module should be displayed. You can decide if it should be displayed on all pages for the site or just selective pages. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/tHKobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/tHKobraz.png) **Screen 9: Menu Assignment tab** Select the required menu for module assignment. The available options are: - On all pages - No pages - Only on the pages selected - On all pages except those selected # Search Module ### JomOffers Search module This module helps you create the search panel with fields that are searchable. All the fields that are defined as searchable during creation can be seen on this panel. You can decide where to position the search panel on the page and also control on which pages the panel should appear. To view all the available modules, click **Extension** > **Module Manager**. To create a new module, click **New**. Select the JomOffers Search module. Provide the information as given in the following sections. Click **Save** to save the module. ### Editing the JomOffers Search module To edit the module, click on the module link or select the checkbox next to the module name, and then click **Edit**. The following image shows the module edit screen. #### Module tab This tab controls the layout where the search panel is to be displayed on the screen. [![obraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/8Ntobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/8Ntobraz.png) **Screen 3: Module tab** Provide the options as per the following table.
**Layout** Select the required layout in the Layout field. The available options are: - Horizontal – Horizontal Keyword field, category and address search field as seen in the following image: ![](https://wiki.comdev.eu/download/attachments/5734945/horizontal_search.png) - Side Search – Vertical Side panel to filter search results as seen in the following image: ![](https://wiki.comdev.eu/download/attachments/5734945/side_search.png)
Custom fields that have the Field can be Searched field enabled are seen in this panel. For more information, see [Custom Fields](https://wiki.comdev.eu/books/JomOffers/page/custom-fields "Custom Fields") in the Administrative Guide.
- Modern Search – Single keyword search field as seen in the following image: ![](https://wiki.comdev.eu/download/attachments/5734945/modern_search.png)
**Show Address**Hide or Show the address field in the frontend
**Show category**Hide or Show category selection in the frontend
**Custom Fields**Select if search should process custom fields
**Default category**Select a default category that will be preselected in the frontend
**Show Title** Show or hide the title for the search panel.
**Position** Select the position based on your Joomla Template.
**Start Publishing** Provide a date when the search panel should be published.
**Finish Publishing** Provide a date when the search panel should be unpublished.
**Access** Provide access level for the panel. - Guest - Public - Registered - Special
**Ordering** Provide the order in which the side panel should appear. If more than one module is positioned at the same location, you can set the order of appearance in this field.
**Language** Select the language for which you want to display this panel. For each language, you must create a new JomOffers Search module.
**Note** Provide additional information.
#### Menu Assignment tab This tab controls where the module should be displayed. You can decide if it should be displayed on all pages for the site or just selective pages. [![ClJobraz.png](https://wiki.comdev.eu/uploads/images/gallery/2024-03/scaled-1680-/cljobraz.png)](https://wiki.comdev.eu/uploads/images/gallery/2024-03/cljobraz.png) **Screen 4: Menu Assignment tab** Select the required menu for module assignment. The available options are: - On all pages - No pages - Only on the pages selected - On all pages except those selected # Live Search Maps Module {{@132}} # Slideshow PRO Module {{@133}}