JOMEVENTS

Events Extension & Plugins 

Quick Start - JomEvents

Overview

This guide will help you get started with using the JomEvents extension quickly. It highlights preliminary steps that are a must for JomEvents 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 JomEvents:

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 JomEvents. 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 documentation in the Administrative Guide.

Creating Groups

In order to add users to groups for membership plans, you must create a super group named JomEvents, 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 documentation in the Administrative Guide.

Creating Membership Plans and Memberships

Memberships in JomEvents 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 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 JomEvents 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 documentation in the Administrative Guide.

Adding a New Category

Categories allow the site owner to categorise listings into appropriate sections. JomEvents categories are independent of the Joomla category system. Nested categories (sub-categories) are supported in JomEvents. 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 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 JomEvents 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 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 section in the Administrative Guide.

Configuration Steps

Overview

These configuration steps needs to be done in order for the component to work correctly.

Joomla / JomEvents 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 JomEvents. Each of the plans needs to be placed under that JomEvents parent group e.g. 

JomEvents

Permissions

It is important to set the right permissions for the components: Comdev and JomEvents, 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

Setting permissions for the JomEvents Extension

Menu Items

Overview

In this section, we will learn how to create menu items to access JomEvents. 

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

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 JomEvents

screenshot-2021-12-22-19-30-33-536.jpeg

Creating Menu Items to access JomEvents

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

To create menu items with Items menu item type, do the following:

  1. Click Menus > <your_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


    Screen 3: Items menu item screen


    Provide the values based on the following table.


  1. Menu Item Type

    Click Select. A pop up is displayed. In this case, since we are creating the Items menu item, click JomEvents > Items from the list.

    Category

    Select the appropriate category, if creating direct category link.

    Address

    Select the appropriate address if, creating direct address link.

    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.

  2. Click Save.


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 checkbox 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 JomEvents Front Admin

To create menu items with Front Admin menu item type, do the following:

  1. Click Menus > <your_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


    Screen4: JomEvents Front Admin menu item screen

  4. Click Save.

Front Admin Options

For the Menu to be able to access the JomEvents Front Admin, certain settings need to be made. The following table shows the three menu links that need to be made and linked with JomEvents 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>>Add New Menu Item.
  2. Provide the Title as Edit Profile and the menu item type as Edit User Profile.
  3. Click Save.

This link should point to the login form menu item created using Login Form menu item type.

  1. Click Menu > <your_menu>>Add New Menu Item.
  2. Provide the Title as Login Form and the menu item type as Login Form.
  3. Click Save.

The following image shows how the Login Form menu item is used

Bez nazwy.jpeg

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 JomEvents 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 JomEvents Front Admin Menu Link:

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.

Make the following settings for the Front Admin are made in the JomEvents 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 JomEvents.
  3. Click Options in the top right-hand corner of the screen.
  4. Click the Front Admin tab. 
  5. Change the Profile Menu LinkLogin Menu Link, and View Profile Menu Link field as per the following image.

    Screen5: JomEvents 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. The following image shows the Front Admin.

Administrator's Guide

Administrator's Guide

Dashboard

Overview

Administration dashboard gives you an overview of all the activities you can do using the JomEvents extension. It provides you a view of all the menu items, system configuration checks, license information, and links to the documentation.

Screen 1: Dashboard screen

Menu Items

The following table provides an explanation about different menu items available:

Dashboard

Home or dashboard for the JomEvents extension

Address Shows the Address administration screen

Custom Fields

Shows the Custom Fields administration screen

Categories

Shows the Categories administration screen

Venues Categories Shows the Venues Categories administration screen
Venues Shows the Venues administration screen
Events Shows the Events administration screen

Membership Plans

Shows the Membership Plans administration screen

Messages

Shows the messages received

Documentation

Access the JomEvents 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

Administrator's Guide

Address

Overview

The Address feature, as the name suggests, lets you provide the country, region and city for the respective product listing. The advantage with the Address field in Extensions is that after you configure a particular address, it is shared across various components in the Comdev extension.

Based on the depth of levels you want, such as the continent as Europe, country as the UK and region as Wales, you can configure the Address tree to have unlimited levels. The Address feature provides multilingual support. This means you can specify different names based on your language preference. For more information, see Languages.

Creating A New Address

The following image shows the Address Feature screen. To add an address, click Components > Comdev > Address. Click New to create a new address.