Knowledge Base - Gateway for Adsmanager

Adsmanager Preparation

Overview

To geocode your Adsmanager articles using the Geocode Factory Adsmanager gateway plugin you will need to use your Adsmanager fields. Geocoding simply means to assign the proper coordinates for their location.

If you are using a paid version of Adsmanager, you will can your articles geocoded by using the special "GMap" custom field. This special field allows your users to generate the coordinates (latitude, longitude) by adding their address information in this field (and/or manually moving the marker on the map).

geocoder field type

If you are using a free version of Adsmanager, you have two options on the ways to get your articles geocoded (see below):

1
Address fields

You can use address fields like street, postcode, city, etc and automatically fetch the coordinates (geocoding) based on the data in these fields (using Geocode Factory 5).The address fields are field types of your choice. For instance they can be drop-down selection or textbox field types. In this case however you will still need to create coordinate fields to store the data (see 2 below).

2
Coordinate fields

Or you can simply use coordinate fields (latitude and longitude) and input the coordinate values directly (manually). If you use this option, you don't need to create address fields. Using only coordinate fields without address fields is only for a few rare and exceptional cases. It would be a case where the users who create the ads would manually input the coordinate values.

Please note that in both these cases for the free version of Adsmanager you will need to create two coordinates fields. These fields are of course latitude and longitude. Even if you use address fields to fetch the coordinates, you will need a longitude and latitude field where the coordinates data from the geocoding process will be stored. The process of creating coordinate fields is very similar to creating address fields as we shall see.

 

Adsmanager Custom Fields

Follow the following steps to create the fields before configuring the Adsmanager gateway plugin.

Once inside your Adsmanager component in the Joomla administration area, click on the "Fields" option from the left sidebar (or from the Joomla admin main menu dropdown).

You should then see a list of your Fields.

Now, to add a new custom field click on the "New" button , like in the following example image.

adsm-new-field-button

 

If you are using a free version of Adsmanager:

Note: If you want to use coordinate fields (latitude and longitude) and input the coordinate values directly (manually), you don't need to create address fields but only coordinate fields (as described in point "2" above).  So you can skip this part and go straight to number 2.

1
Address fields

First address field: Street

new-address-field-adsm

Type: In this case the field type is a "Text Field".

Name: Give a name to your field.

Title: Give it a title.

Description: Enter the "Description" settings as you like (optional).

Category: You will also need to select at least one category or the "All ads" option (not shown in image above).

Finally, save your new field and repeat these steps for as many fields as you like (ex: region, country, etc).

Note: You should already have a city and postal code field available to you by default in your Adsmanager installation.

 

2
Coordinate fields - latitude and longitude

First coordinate field: Latitude

lat-new-field-adsm

 

Type: In this case the field type is a  "Number Text" or "Text Field".

Name: Give a name to your field.

Title: Give it a title.

Description: Enter the "Description" settings as you like (optional).

Category: You will also need to select at least one category or the "All ads" option (not shown in image above).

Finally, save your new field and repeat these steps for the Longitude field as well.

Adsmanager (free version) is now ready!

 

If you're using a paid version of Adsmanager:

In the case where there is no "GMap" type field already created by default, you will have to create one.

 adsm-geocoder-new-field

Type: In this case the field type is a "GMap" field.

Name: Give a name to your field.

Title: Give it a title.

Description: Enter the "Description" settings as you like (optional).

Category: You will also need to select at least one category or the "All ads" option (not shown in image above).

Map related options: You can also configure tha map related options at the bottom of the GMAp field list (not shown in image above). You can choose to show this map inside each individual ad (ex:details page).You can consult the Adsmanager documentation for more info (this map is not part of Geocode Factory).

Finally, save your new field. Adsmanager is now ready!

Applies To

Geocode Factory 5