This is accessible through the back-end Components, Ideal Directory menu item and then clicking on the Listings link below the component's toolbar.

The fields you see in each listings are:


Whether the listing is published or not and whether it is a Featured listing.


It will display a miniature of the listing's log (if any)


The listing's title.


The listing's alias field. If empty this field is created automatically based on the listing's title.


The Category assigned to the listing

Linked User

The linked user is the "Owner" of the listing. A link to the Joomla! user will be displayed and the user's email address.


The listing's access level. A listing can be public or assigned to a particular access level.


The language assigned to a listing.


The numeric Listing ID. This is the unique identifier of every listing.

The toolbar contains the icons which allow you to manage the listings:


Creates a new listing


Edit the first listing you have selected in the list


Set the selected listings' Status to Published. They will be visible in the component's front-end.


Set the selected listings' Status to Unpublished. They will no longer be visible in the component's front-end. Unpublished listings are not seen in the front-end unless the user is an administrator. All back-end users will see unpublished listings marked with a red background "unpublished" label.


Set the selected listings' Featured to Yes. They will assign the Featured status in the component's front-end.


Set the selected listings' Featured to No.


Changes the status of the selected listings to indicate that they are archived. Archived listings can be moved back to the published or unpublished state by selecting "Archived" in the Select Status filter and changing the status of the listing to Published or Unpublished as preferred.


Checks-in the selected listings. Works with one or multiple listings selected.


Batch processes the selected listings. Works with one or multiple items selected.


Changes the status of the selected listings to indicate that they are trashed. Trashed listings can still be recovered by selecting "Trashed" in the Select Status filter and changing the status of the listings to Published or Unpublished as preferred. To permanently delete trashed listings, select "Trashed" in the Select Status filter, select the listings to be permanently deleted, then click the Empty Trash toolbar icon.


Opens the Options window where settings such as default parameters can be edited.

Editing a listing

Clicking on a listing's title or checking its checkbox at the far left-hand side and clicking on the Edit button opens the listing editor page. Before editing the listing, take a look of an example listing view in order to understand what you are editing.

Example of single listing page (front-end)

Field in the listing editor page:


The listing title


The Alias will be used in the SEF URL. Leave this blank and Joomla will fill in a default value from the title. This value will depend on the SEO settings (Global Configuration->Site).

Using Unicode will produce UTF-8 aliases. You may also enter manually any UTF-8 character. Spaces and some forbidden characters will be changed to hyphens.

When using default transliteration it will produce an alias in lower case and with dashes instead of spaces. You may enter the Alias manually. Use lowercase letters and hyphens (-). No spaces or underscores are allowed. Default value will be a date and time if the title is typed in non-latin letters.


If you get a blank page, a 403 Forbidden error page or a 406 Not Acceptable error page when you try accessing a listing in the front-end the alias is the most likely culprit. Many servers use the mod_security2 Apache module. This is a kind of firewall which blocks requests based on several information they carry with them. Some words in the URL such as "MySQL", "drop", "table", "permissions", "grant", "wget" and "curl" in certain combinations can trigger mod_security2's protection and throw an error page when trying to access it. If the listing's title contains such words, the alias (therefore: the URL) will contain them and cause mod_security2's protection to be triggered. In this case you have to go to the back-end of Ideal Directory, edit the listing and change its Alias to something different. This is not an issue with Ideal Directory; it's how mod_security2 is configured on your server.

Then you'll see several tabs. Under each tab there are more listing fields:


Contact Person

The person responsible for this location. This is not required, but ill be displayed in the front-end if not empty.


The listing's email address. If empty it will use the Linked User's email address instead.

Linked User / Owner

The user linked to this listing. It may also be referred as the listing's owner.


The established date of the business.


The listing's address.

Address (second line)

In order to improve Geo location accuracy add Apartment, suite, unit, building, floor, etc in this field


A geographically localized community within a larger city, town, suburb or rural area. Many cities use districts and wards as official divisions of the city, rather than traditional neighbourhood boundaries.

City or Suburb

The listing's city

State or Province

The listings State or Province

Postal/ZIP Code

The listing's Postal/ZIP Code


The listing's country


The listing's website. IDN (International) links are converted to punycode when they are saved


Published status of the item. Possible values are:


The item is published. This is the only state that will allow regular website users to view this item.


The item is unpublished.


The item has been archived.


The item has been sent to the Trash.


The Category this item belongs to.


Whether or not the item will be displayed in featured view.


The viewing Access Level for this item. More information on Joomla! Access Levels


The listing's language


Enter one or more optional tags for this item. You can select existing tags by entering in the first few letters. You may also create new tags by entering them here. Tags allow you to see lists of related items across content types (for example, articles, contacts, categories, etc).


A listing can have up to 10 telephone numbers . Each telephone number can have up to four types (land line, mobile, fax and WhatsApp). There's also an Extension and a Brief comment fields.

Social media

A listing can have up to 10 social networks, which will display in the front-end as icons. In the URL field you'll enter the username or the short link of the social network. For example, you'll enter IdealExtensions for the Facebook page


Locate in map

The content of this field is retrieved directly from the Address, city, state and country fields under the Basic tab. When the Locate in map button is clicked Ideal Directory will find the location on the map and update the Latitude and Longitude Fields automatically. If the pin on the map is not accurate, then you can click on the pin and drag it to the desired location.


The listing's latitude.

Latitude is a geographic coordinate that specifies the north–south position of a point on the Earth's surface. Latitude is an angle which ranges from 0° at the Equator to 90° (North or South (negative)) at the poles.


The listing's longitude.

Longitude is a geographic coordinate that specifies the east-west position of a point on the Earth's surface. It is an angular measurement, usually expressed in degrees. The longitude is measured as the angle east or west from the Prime Meridian, ranging from 0° at the Prime Meridian to +180° eastward and −180° westward.


Intro text

Intro text is meant to be a brief introduction text.


The description text will be displayed in the single listing page.


All the listing images can be managed under the images tab:


The listing's logo.

Marker Icon

The map marker icon is the icon displayed in the map for the current listing


A listing can have up to 10 images in the slide show. Optionally a title and a description can be added to the image which will display over the image.


Interface to add a list of up to 10 links to display in the front-end.


The link URL. It must start with either http:// or https://


The link title will be displayed as the link label

Icon Class

Accepts any css class, as long as the front-end template loads this library as well. When you start typing you'll see a suggestion list. Keep in mind that it's just a suggestion and you can enter any CSS class loaded by your template. Ideal Directory will try to load the default icon library in your Joomla!™ version.

Joomla! 3.x by default load Bootstrap v2 icons, which start with icon-, example icon-comment. Some templates load Bootstrap v3 icons, which start with glyphicon, for example glyphicon glyphicon-comment.

Opening hours

Opening hours

Choose the days from the select list to add opening hours for the selected day. If the location opens and closes multiple times in a single day, just add multiple rows for each time.

Times are specified using 24:00 time. For example, 3pm is specified as 15:00. When you start typing you'll see a suggestion list in order to help you enter the correct time if you are not familiar with the 24 hour format. Opening hours are also added to the site using markup in order to improve SEO, therefore it needs to be entered in 24 hour format.

Opening hours exceptions

Add recurrent exceptions. Each selected date will override the Opening Hours for that particular day, regardless which day of the week it falls on.

Custom Field groups

Ideal Directory component uses Joomla!™ framework in order to add Custom Fields to the listing page. Each custom field group will display in a separate tab here and on a different tab or slider in the front-end(depending on the presentation style selected).

For more information, please read the Custom Fields section of this document.


Interface to manage some of the publishing data.

Start Publishing

Date and time to start publishing. Use this field if you want to enter a listing ahead of time and then have it published automatically at a future time.

Finish Publishing

Date and time to finish publishing. Use this field if you want to have a listing automatically changed to Unpublished state at a future time (for example, when it is no longer applicable).

Created Date

This field defaults to the current time when the Listing was created. You can enter in a different date and time or click on the calendar icon to find the desired date.

Created By

Name of the Joomla!™ User who created this item. This will default to the currently logged-in user. If you want to change this to a different user, click the Select User button to select a different user.

Modified Date

(Informative only) Date of last modification.

Modified By

(Informative only) Username who performed the last modification.


(Informative only) Number of revisions to this item.


(Informative only) The number of times an item has been viewed.


This is a unique identification number for this item assigned automatically by Joomla!™. It is used to identify the item internally, and you cannot change this number. When creating a new item, this field displays 0 until you save the new entry, at which point a new ID is assigned to it.

Meta Description

An optional paragraph to be used as the description of the page in the HTML output. This will generally display in the results of search engines. If entered, this creates an HTML meta element with a name attribute of "description" and a content attribute equal to the entered text.

Meta Keywords

Optional entry for keywords. Must be entered separated by commas (for example, "cats, dogs, pets") and may be entered in upper or lower case. (For example, "CATS" will match "cats" or "Cats"). Keywords can be used in at least two ways:

  • To help Search Engines and other systems classify the content of the Listing;

  • In combination with other Joomla!™ extensions, to display specific content based on the listing keywords.


The instructions for web "robots" that browse to this page.

Use Global

Use the value set in the Component→Options for this component. The recommended setting in the Component Options is Index, Follow if you want to display the directory in Search Engine Results.

Index, Follow

Index this page and follow the links on this page.

No index, Follow

Do not index this page, but still follow the links on the page.

Index, No follow

Index this page, but do not follow any links on the page.

No index, no follow

Do not index this page or follow any links on the page.


Describe what rights others have to use this content.

Copyright © 2006-2024 All Legal Rights Reserved. and this site is not affiliated with or endorsed by The Joomla! Project™. Any products and services provided through this site are not supported or warrantied by The Joomla! Project or Open Source Matters, Inc. Use of the Joomla!® name, symbol, logo and related trademarks is permitted under a limited license granted by Open Source Matters, Inc.

Back to Top