Content

Basic package

Extensions

 

 

 

INSTALLATION

Go to menu: Extensions > Extension Manager > Install > Upload Package File

, install

Select the package file in Your local folder and click to Upload & Install  button.

That's all!

The installation package will create:

  • Component Directory in Components
  • Module Global Themes Google Map in Extensions > Module Manager
  • Module Global Themes Categories in Extensions > Module Manager
  • Module Global Themes ABC List in Extensions > Module Manager
  • Plugin Global Themes Directory in Extensions > Plugin Manager - enabled as default
  • Plugin Global Themes Button in Extensions > Plugin Manager - enabled as default
  • Plugin T3 Framework in Extensions > Plugin Manager
  • Template gt_directory - Default in Extensions > Template Manager

See VIDEO TUTORIALS

Content

CONFIGURATION

Plugins - Global Directory, Global Button

Plugins do not need any configuration, all of them are enabled by default and using parameters directly from the central configuration panel accessible from the component Directory.

The Global Directory plugin adds the Global Directory content (map, labels, address, photo gallery, etc.) to the article.

The Global button plugin adds a shortcode to editor in various styles:

  • small card-styled banner
  • wide card-styled banner with introtext
  • wide card-styled banner with address
  • whole article

, global directory button

Content

Google Maps - module

  1. Set the module Status to Published
  2. Set the module Position to Gmap in gt_directory template
  3. Set the Menu Assignment based on Yout site map

, config mod googlemap

Any other Google Map configuration (defaults, height, searchbox settings, results, ....) is enabled in the central configuration panel - see next chapter: Component Directory.

The Google Map searchbox style is easy configurable in the template by ThemeMagic function:

  • Open the template and click the "ThemeMagic" button

, thememagic1

  • Expand the "Global Themes Modules" folder in the left site panel
  • Set for Google Map
    • Search background color
    • Search text color

, thememagic2

Content

Directory - component

As the first step it is needed to set up the basic category for directory. Joomla as default, allows you to create unlimited category tree. We recommend to create a base category named "Directory" and to put all other categories under this one.

Go to Content > Category Manager and set up categories below:

, config com category

Now let's go to the Components > Directory!

Click to Location button on the left-side panel.Define Your locations as a standard Joomla category-definition process supported by unlimited locations tree.

, com config location

Finally let's go and set up the basic configuration params. Click to Directory on the left-side panel. You will be back in main Directory administration dashboard sidebar.

Select the Options button on the right upper corner of the menu bar and set the basic params:

  • Google maps Latitude - Default Latitude for Google Map
  • Google maps Longitude - Default Longitude for Google Map
  • Zoom - Default zoom for Google Map
  • Google map height - Height of the Google Map Module
  • Searchbox width - Width of the searchbox
  • Searchbox style -  Style of the searchbox: Popup or Inline-expands under the Google Map
  • Map clustering - Markers on the Google Map can be clustered. We recommend to use Map clustering in order to avoid markers overlapping  on the map.
  • Show POI - Show/Hide Points Of Interest (POI) on the Google Map. If hide the Google Map will show olny businesses from the Directory.
  • Google API key -     Usage of the Google Maps Up to 25 000 is free. Leave the API empty. It is recommended by Google to use API key if Your site is frequently visited (more, than 25 000 map loads per day ) You can use it according to Google Maps API Terms of Service. Follow this LINK to get Your API key.
  • Sort position by - It is possible to arrange articles in order as you want. The Administrator can set the position in the search result for each article. Articles not set are automatically positioned within their main category or location based on the "Sort position by" switch setting.
  • Show in search result - Introtext or Address
  • Search result layout - Grid (4 column grid) or List (1 column list)
  • Default pagination - Number of results per page
  • Default category - Set the base category from category list. It should be the "Directory"
  • - Sorting order for Category tree
  • Show category in article - Show/Hide clickable category labels in te article
  • Default location - Select the default location from location list. It is selected as default for Google map.
  • - Sorting order for Location tree
  • Images gallery width - Set the gallery width for the image slider. Height is automatically set up based on the width.
  • Auto resize images - After an upload the image is automatically resized to width and height set in "Images gallery width" option
  • Maximum Size (in MB) - max. alloved upload file size
  • Legal Image Extensions - allowed image extensions to upload for content and gallery
  • Legal File Extensions- allowed file extensions to upload for attachements

Custom fields

  • Activate/deactivate custom field by turning the switch to Yes/No
  • Custom fields names are translateable.
    • Change custom field name: create custom language file named en-GB.custom.ini as a copy of /administrator/components/com_directory/language/en-GB/en-GB.custom.core.ini
      Change the content of this new language file and save it.

 

Content

Template - default frontend template

All Global Themes products are visualized in the powerfull T3 Framewrok. This is a really heavy tool enabling a wide range of possibilities in order to design Your site as Your best.

As the first step see video series showing main features HERE.

If You need detailed information click HERE. Of course You can skip installation, because it is a part of our installation package!

Especially for the Directory we prepared a special template named gt_directory with special layout and a few predefined colour schemes.

Go to Extensions > Template Manager and click to gt_directory - Default. Select a colour scheme from the list in Theme folder:

, config tpl theme

Finally set the Site Name, Slogan and upload and set Logo Image in the same folder.

Do not forget to set template as default and also Assignment for proper functionality.

If you need to customize the template DO NOT change default layouts and colour chemes or any original files from the template folder! All new upgrade will override your changes!

For simple css changes add a new file to templates/gt_directory/css/custom.css. Here you can make changes, new styles etc.

For layout customization clone one of the layouts and make changes on this new layout. Use Save as Copy button.

, template layout change

For basic styling open the ThemeMagic (upper menu in Template Manager) and use Save AS to create your own colour theme.

, template styles change

 

Content

Editors

Some editors, like JoomlaCK, process and format the entered text as default. It is necessary to disable these features, otherway it causes JavaScript crash in Google map. As result the map will disappear. Especially for JoomlaCK editor go to Extensions > Plugin Manager > Editor - JoomlaCK and select the Advanced Folder. Disable Process HTML Entities and Auto Format Source features.

, config plg jck

Content

Google Map Icons

In package You can find a free google map icon set. You can use them or use Your own icons too. Important! Do not replace icons after businesses are defined!

Upload your own icons into directory images/genthemes/gmapicons.

ADMINISTRATION

The main admin panel is in Components > Directory

All features of the directory tree and businesses are managed from this point. New, Edit, Publish, Unpublish, Archive, Trash.

New

Click the New button in the toolbar. It opens the form to edit the business.

As the first step enter the business Name, select Category and Location from select boxes. If You really want to add new business, click to Save button in the toolbar. This action will create a unique ID for new business and folder for images, gallery and attachements. After Saving You will see  ID and a new folders on business form, like Intro, Content, Opening hours and Media .

, admin new save

Content

Basic parameters

Enter all necessary information about the business.

Assign the business at least to one main Category and one main Location. You can use unlimited additional Categories and Locations.

Set the Google maps Icon and map's location by dragging the marker on the map or Get it from Address as well as the Streetview image.

If no streetview available for location set the button "Show streetview image" to  "NO".

Do not forget to set the Zoom. It can be individual for a business.

Content

Publishing

This folder contains all necessary settings regarding publishing the business. If you have set regular joomla tags you can use them for the business tagging.

Content

Intro

This folder contains all necessary settings regarding business intro.

Content

Content

This folder contains all necessary settings regarding the content.

Content

Opening hours

Fill in opening hours and starting day.

Content

Media

  • Video - copy & paste embed code from any external video tube, like youtube, vimeo, etc. If empty will not appear at the bottom of the business in folder Video (see below)
  • Show video - Show/Hide video on frontend
  • Create photo gallery - Show/Hide gallery on frontend
  • Attachements - - Show/Hide attachements on frontend
  • Upload - here you can upload files into three subfolders:
    • files - upload here all documents, images to show them as attachements.
    • gallery - upload here all images to  gallery.
    • images - upload here images to show them in Content, or as IntroImage.

Content

, admin new media

Content

Edit

Select a business or click to business name to open edit form.

Edit  form has the same functionality like New.

Content

 

Users

Administrator can access the full functionality of the component.

You can add a plain user with restricted rules - edit only own records:

  • Go to Users->Groups->Add New Group, create a new user group. Choose a name "Directory" and set its parent to "Public".
  • Go to System->Global Configuration->Global Configuration: folder "Permissions", open up the permissions for this new group Directory, "allow" the permission "Admin Login", user config 2
  • Go to System->Global Configuration->User Manager: set New User Registration Group to "Directory", user config 1
  • Go to Users->Access Levels, edit "Special," and add this group to the Special access Level. The admin menu is shown only to those under the access level Special.
  • Go to the Components->Directory, open up its options and go to Permissions. Open up the new group Directory and "allow" the permissions "Create", "Delete", "Edit" , "Edit State" and "Edit Own", user config 3
  • Add a new user and assign to this group if not already a member.
  • Go to Extensions->Template Manager and set the template gt_easyadmin for Administrator  as default. This is a modified isis template with restricted menu for non-root users. , user config 4
  • Administrator can access the full functionality but Directory member works in a simlified environment., user config 5

Content

Set accounts -subscription plans

Users can manage their own business baes on their account. The Directory uses 5 flexible accounts, the first one can be defined as Trial.

  • Open the "Pricing" tab in the Directory Options panel.

, account pricing

 

  • Turn  the Business version switch to "Yes".
  • Set Currency and Decimals according to PayPal Currency Codes
  • First month can or not to be free of charge - choice an option
  • All accounts can be activated by turning on the "Active" switch and setting up the life cycle (in months) and the price
  • All accounts can be free of charge by setting the price to 0 (zero)
  • First account have a special status: can be Trial by setting this switch to "Yes"
    • If Trial is turn to Yes, the account accepts restrictions:
      • Show google map: Yes/No
      • Show streetview image: Yes/No
      • Show video: Yes/No
      • Files to upload: Unlimited uploads/Only 1 file to upload
      • Show gallery: Yes/No
      • Show attachements: Yes/No

Open the "Payment" tab in the Directory Options panel.

, account payment

 

  • Expiration warning - The System informs the Administrator about jsut ending accounts. Set the number of days to be informed before an account expired.
  • Expiration tolerance - The System tolerates (do not unpublish) expired accounts. Set the tolerance on days.
  • Mail - Set the expiration warning mail details:
    • From email
    • From name
    • Subject
    • Body

Install one or more payment methods ( see below ) to receive on-line or off-line payments for subscriptions!

Content

PayPal - plugin

Directory user can manage own business based on his account. Account is activated automatically after payment via PayPal with PayPal account or Cerdit Card.
It is necesaary to correctly configure communication between the Directory and PayPal.
 
  • Create a business account on PayPal
  • Create testing accounts for your PayPal Sandbox  at https://developer.paypal.com - login with your business account's credentials.
    • Create both accounts  Business (for receive payments) and Personal (for sending payments)

, paypal1

 

, paypal2

  • Update yor Website preferences

, paypal3

  • Set Auto Return to "On"
  • Enter your site's URL to "Return URL" field
  • Set Payment Data Transfer to "On"
  • Save your setting
  • By return you will be informed about assigned Identity Token (PDT) - IMPORTANT - Save it somewhere to your PC - we will need it for the Directory configuration !

, paypal4

PDT is very handy in most of cases, but we can’t always rely on it since it requires the user to return to your page after doing the payment. That will often happen, but it’s not guaranteed to happen. This problem if corrected by Instant Payment Notifications (IPN) in addition to PDT.

  • Open your Profile -> My Selling Tools

, paypal4

  • Update the Instant payment notifications
    • Set Receive IPN Messges to "On"
    • Enter your site's notification URL:  yoursite/index.php?option=com_directory&task=checkpaypal
      •  for example for gen-themes is :  http://gen-themes.com/index.php?option=com_directory&task=checkpaypal
    • Save your settings

, paypal6


 

  • Install and Enable PayPal plugin.

, paypal

  • For PayPal account setting see  chapter PayPal
  • If an account is once set, let fill in credentials for the Directory-PayPal communication
    • Use Live or Sandbox - we strobgly recommend to test your settings through your sandbox account
    • Fill in both Live and Sandbox Login and PDT Token obtained from your PayPal accont.
    • Turn the Use switch to Sandbox for testing
    • Turn the Use switch to Live for real site run

 

Content

Off-line payment - plugin

  • Install and enable the plugin

, offlinepayment

  • Fill in requred field:
    • Bank Name
    • Account No.
    • IBAN code
    • SWIF code
    • Note

Content

Language customization

  • The main language file content is easy customizable:
    • Create custom language file named en-GB.custom.ini as a copy of /administrator/components/com_directory/language/en-GB/en-GB.custom.core.ini
    • Change the content of this new language file to modify local phrases like custom field names, account names, contact person names, price levels and save it.
    • Add new phrases from them main language file (/administrator/language/en-GB/en-GB.com_directory.ini) and save it.
    • See video tutorial Global Directory - Language customization

Content

Import

Data in regular csv format can be imported into Directory.

  • Set csv data parameters and upload the file to server
  • If you choice the GT directory structure (exported in phpmyadmin from the table gt_directory) the system can identify all columns to import

, import1

  • If you have own data structure you can create relations between the csv file columns and the Directory structure in the left-side panel.

, import2

  • Import data by clicking the button Save & Close

 

Content


Categories/Locations - module

Frontend module - quick search by Categories or Locations.

  • The module is installed in the Global Directory package, no further act necessary
  • Enable the module
    • Extensions->Module Manager->Global Directory Categories
  • Options:
    • Show - Category or Location
    • Layout:
      • Grid - 4 column grid , mod gt category2
  • List - one column list  , mod gt category3
  • Use icons - Select an option to use predefined icon or use Category or Location image
  • Expand - expand or collapse the Category/Location tree by default
  • Default frontend URL - direct link to Google Map module - enable to use the module anywhere on the frontend or leave blank if use on the same page as the Google Map module.

 

The module style is easy configurable in the template by ThemeMagic function:

  • Open the template and click the "ThemeMagic" button

, thememagic1

  • Expand the "Global Themes Modules" folder in the left site panel
  • Set for Quick Category search
    • Grid layout title color
    • Grid layout body color
    • List layout title color
    • List layout body color

, thememagic2

Content

 

Alphabetical quicksearch - module

Frontend module - quick search by name.

  • The module is installed in the Global Directory package, no further act necessary
  • Enable the module
    • Extensions->Module Manager->Global Directory ABL list
  • Options:
    • Layout:
      • Grid - 4 column grid
      • List - one column list  
    • Search
      • Search by the first letter - for example ckick the "G" will show all articles with the first letter "G"
      • Search by the first letter or in alphabetical order - for example ckick the "G" will show all articles with the first letter "G", "E", "F", etc.  (good feature for smaller directories)
    • Default frontend URL - direct link to Google Map module - enable to use the module anywhere on the frontend or leave blank if use on the same page as the Google Map module.

, mod gt abclist1

The module style is easy configurable in the template by ThemeMagic function:

  • Open the template and click the "ThemeMagic" button

, thememagic1

  • Expand the "Global Themes Modules" folder in the left site panel
  • Set for Quick ABC search
    • Button background color
    • Button text color

, thememagic2

Content

 

Labels - plugin

The advanced labelling plugin enables to use Joomla Tags for the Global Directory

  • Install the plugin
  • Add tags: Components->Tags->New
    •  Enter tag name
    •  Set Teaser image
    •  Arrange tags into tree structure

, gt labels 1

  • Enable the plugin
    • Extensions->Plugin Manager->System - Global Directory Labels
    • Options
      • Add a labelset:
      • Active: Turn On/Off the labelset
      • Options: Select a Tag or a Tag-tree
      • Type:
        • Checkbox - allows multiselection
        • Radio - allows to select only one option
      • Show:
        • Image & text - Teaser image + Title
        • Image - only Teaser image
        • Text - only Title
      • Assigned to:
        • Leave blank to apply for all businesses
        • Select categories to be assigned to
      • Apply for subcategories
        • If Yes, the labelset is assigned to all subcategories of all selected categories

, gt labels 2

  • Use created labelsets

, gt labels 3

 


Content

 

Prices - plugin

The plugin enables to use various prices  for the Global Directory

  • Install the plugin
  • Enable the plugin
    • Extensions->Plugin Manager->System - Global Directory Prices
    • Options
      • Match all selected - Show/Hide "Match all selected" button in the searchbox at frontend
      • Active: Turn On/Off the labelset
      • Input type:
        • Any value - allows enter any value to price
        • Predefined values - creates listbox from predefined values
      • Default value(s):
        • Add one default value for the price or add more predefined values separated with comma for example: 5,8,12,25,45
      • Currency - Set the currency for the price
      • Assigned to:
        • Leave blank to apply for all businesses
        • Select categories to be assigned to
      • Apply for subcategories
        • If Yes, the price is assigned to all subcategories of all selected categories
  • Change the name of the price

, gt prices1

  • Use created prices

, gt prices2

Content

 

Plan my route - plugin

  • Install the plugin
  • Enable the plugin
    • Extensions->Plugin Manager->Content - Global Directory GetDirections
  • Plugin do not need any other configuration. The "Plan my route" button will appear at frontend in the contacts panel.
  • Features:
    • 4 travel types:
      • drive
      • walk
      • bicycle
      • transit
    • Avoid highways
    • Avoid tolls
    • Plan route in-line
    • Step-by-step navigation on the Google Map


, plg gt getdirections

 

Content

 

Reservation - plugin

  • Install the plugin and enable the plugin
  • The plugin enables to use up to 5 types of rooms and services for one business
  • Edit rooms and services directly in the Global Directory article:

, plg reservation

 

  • Customize the room and service names : Language customization
  • Currency - currency for rooms and services
  • Use accommodation - enable/disable this feature
    • Use room - enable/disable the room
    • Number of rooms - number of available rooms for this type of room
    • Price per person - price for one person/bed for per night
    • Description - a short description of the room
    • Max persons - max persond/beds for this type of room
  • Use services - enable/disable this feature
    • Use service - enable/disable the service
    • Number of services - number of available services for this type of service
    • Service price - price for the service
    • Unavailable service days - days off - service is unavailable
    • Availabla hours - list of hours to be reserved, values terminated by comma

Content

 

Sendmail - plugin

  • Install the plugin and Enable the plugin
  • Plugin is a system ajax plugin supporting all Global Themes solutions.
  • No configuration necesary

Content

Google analytics

  • Tracking plugin for categories, locations, labels and searchwords for Google Analytics
  • Login  to your Google Analytics account (or create if not exists).
  • Check for your tracking code: Admin->Tracking Info->Tracking Code

, gt googleanalytics 1

 

  • Copy your tracking code to clipboard

, gt googleanalytics 2

  • Install gt_googleanalytics plugin
  • Enable plugin and enter tracking code, save settings
    • After saving the system will remove "script"  tags from the begin and the end of the original script 

, gt googleanalytics 3

 

  • Analyze your site searches in google analytics: Reporting->Behavior->Events
    • Please note, that the Google analytics data are processed with delay!
    • If you want to analyze your site on-line, use : Reporting->Real-Time->Events

, gt googleanalytics 4

Content

Custom fields

  • Over the 5 built-in text-type custom fields you can add unlimited own custom fields of various types.
  • Install and enable the gt_customfields plugin
  • Add custom fields as standard Joomla fields
    • rename the yoursite/plugins/globalthemes/gt_customfields/forms/custom.example.xml  containing example fields to cusom.xml
    • or create a new cusom.xml file in the same directory
    • DO NOT ADD fields that may access to Joomla folders (images, editor with insert image button) if the directory is edited by non-root user!
  • Attributes extending standard Joomla fileds
    • title - add title="false" to hide the filed title at frontend
    • site - add site="false" to hide field at frontend
  • Make your custom fields multilingual
    • Attributes "label" and "description" can be translated by adding translation to administrator/components/com_directory/language/en-GB/en-GB.custom.ini (copy and rename en-GB.custom.core.ini of not exists)  or to any other languages
    • for more details see video tutorial
  • Download  example custom.xml

Content

Rating & Emotions

  • Allows to rate or make emotion for the Global Girectory content, Photogallery and Video
  • Install the gt_rating package (content plugin and ajax plugin will be installed and enabed automatically)
  • Set the main plugin options:
  • Reset all - reset all rates and emotions
  • Access
    • Public
    • Registered - only for registered users
  • Block multiple rating
    • Session - visitor can rate or make emotion only once untill browser restart
    • IP - visitor can rate or make emotion only once untill somebody else rates or makes emotion for the same part of the content, gallery or video
  • Cancel emotion - allows for visitor to cancel actual emotion untill site reload

, plg gt rating1

  • Set options for each part of the site
    • Reset rating and emotions
    • Active - Enable/Disable
    • Style
      • Rating - star-styled rating
      • Emotion - Emotions
    • Emotions
      • Select image for each emotion
      • Live blank to disable the emotion

, plg gt rating2

Customize  names of rating and emotions : Language customization

 

Content

Translations - multilingual content

Basic Joomla settings - for details see Joomla manual

Please note, that this is not a full Joomla multilingual content manual! Instructions below contains only the basic settings for the Global Directory multilingual support.

 
  • Install new language pack
  • Create content language

, plg gt translations 1

, plg gt translations 2

 

  • Enable language filter plugin:  Plugin Manager->System -> Language Filter
  • Create menus for all languages, set homepage for all languages, add module positions

, plg gt translations 3

, plg gt translations 4

  • Enable language switcher module:  Module Manager->Module Language Switcher

 

, plg gt translations 5

 

  • Read carefully instructions in "Description" tab
 

Global Directory setting

  • Install Global Direcctory package 1.2.18 or higher
  • Install and enable traslations plugin (plg_gt_translations)


Create translations

  • Open Components->Global Directory->Translations and transate Categories, Locations and Tags.

 

, plg gt translations 6

 

  • Open an article and create Intro and Content translations

 

, plg gt translations 7

Content

Easy Admin - backend template

  • Backend template especially designed for the Global Directory.
  • Enable the plugin
    • Extensions->Template Manager->gt_easyadmin - set as default
  • Modified original isis admin template, added new options:
    • Redirect after login - after successful login the NON ROOT USER is redirected to the Global Directory
    • Hide menu - Hide/Show menubar for NON ROOT USERS - makes admin site transparent and easy as possible

Content

Atilla - frontend template

  • Install the template
  • For basic template configuration see the chapter Template - default frontend template.
  • The template Atilla have a new optios in folder Global Themes:
    • Redirect after registration - after successful registration the new user is redirected to admin login site
    • Show sticky header - make navigation bar sticky on the top of the site
    • Show developer credit in the footer - Show/Hide developers informations (Bootstrap, Apache, FontAwesome, ...)
    • Copyright text - Enter own Copyright content
    • Show social area - Show/Hide social icons in the footer
    • Your social area title - enter title for the social area
    • List of 14 social network URLs: facebook, twitter, googleplus, etc.

, tpl atilla

Content