User Tools

Site Tools


Sidebar

addons:jfusion_plugin:start

This is an old revision of the document!


JFusion Plugin

The JFusion Plugin is available in the Public Downloads in our client area. It is currently considered a BETA release since this is a brand new plugin.

<tip c n>Note: It is not a Geo addon that you would administer in the Geo admin panel, but rather a JFusion plugin, that you administer inside of your Joomla installation admin panel. Again, This plugin is used inside a Joomla installation, NOT within Geo software.

Also note that JFusion itself is referred to as a Joomla extension that you use inside Joomla. On this page, when we use the term JFusion Plugin, we are referring to the plugin by Geodesic Solutions for use inside JFusion, we are not referring to JFusion extension itself. </tip>

Note that Joomla and JFusion are not created by us and are not affiliated with us. The plugin for the JFusion extension WAS created by us to allow you to bridge your Geodesic installation(s) with your Joomla installation(s) using the Joomla extension JFusion.

About the Plugin

Here is some information about the JFusion Plugin:

  • Requires at least Geo version 5.1.0. <
  • Still considered BETA until it is able to be tested on a wider variety of different sites and configurations. <
  • Minimal setup needed inside the Geo software. <
  • Capable of working remotely1): Unlike most other JFusion bridges made for other software, this one does not connect to the Geo database "directly" at all2), but instead goes through the Geo software's built in Remote API. This means you can use the bridge even if the Geo installation is on a totally different server. Note that the feature to automatically log into Geo software (the "log in once" feature) will not work however, unless both Joomla and the Geo installation are on the same domain name, due to how cookies work. <
  • It is available for free from the public downloads section. All you need is your own Joomla installation and a license of the Geodesic software, any product, any edition, version 5.1.0 or higher. <
  • We are currently looking for feedback on this plugin. If you use this plugin we invite you to let us know about your experience. It will help us to gauge when it is ready to be pulled out of BETA status, and the feedback will help make the plugin and this set of instructions better! :) <

Installation Instructions

These instructions are a work in progress, at this point we recommend to only use the JFusion Plugin if you are already familiar with JFusion and are able to test everything thoroughly.

  1. If you do not already have the latest version of JFusion installed inside of your Joomla installation, install it now. You can find instructions for that at JFusion - installation guide (instructions from JFusion site). <
  2. Download the Geo JFusion Bridge from the public downloads in the client area on our site. Note that you do not need to be logged into the client area to download items from the public downloads section. <
  3. Log into your Joomla Administration Panel, and go to Components > JFusion > Plugin Manager, and upload the Geo plugin zip file. <
  4. Refer to the instructions at the link to finish setting up the plugin: http://www.jfusion.org/docs/doku.php?id=installation;plugin_config. <
  5. Refer to the JFusion documentation to finish setting up JFusion with the Geo bridge. <
  6. If you want to make the Geodesic Solutions software the "slave":
    • You can turn registrations off in your Geo admin panel at Registration Setup > General Settings at the top of the page. This is a new setting added in version 5.1.0. <
    • The use, require, and length settings for each of the different registration fields in Registration Setup > General Settings apply to users registered through the JFusion bridge3), so make sure those settings match with what is allowed in the software set as the master, or you could get errors when user is registered through the JFusion bridge. <
    • If you use the Geographic Navigation Addon, in the admin at Addons > Geographic Navigation > Settings, in the section Geographic Location in Registration Data, make sure the require setting is un-checked for the same reasons as listed above. <
    • Make sure the Username length and the Password Length settings in the admin at Admin Tools & Settings > Security Settings > General Security Settings4) match with what is allowed in the software set as the master, or you could get errors when user is registered through the JFusion bridge. <

<

  1. The Joomla admin user and e-mail should match a "normal" user within Geo, not the main Geodesic admin user, or it will produce errors within Joomla. The Geodesic admin user is not able to be synced across the remote API for security reasons. If you do use the same user/pass for Joomla admin and Geodesic admin, you will receive errors every time you log into Joomla with that user.5) <
  2. In the JFusion admin, sync the users between Joomla and Geodesic. Note that the sync is not able to "mass sync" the users' passwords because of how passwords are saved in Joomla. The password will be synced the first time a user logs into Joomla after the "mass sync" was performed. Until then, existing Joomla users will not be able to log directly into Geo installation. <
  3. Remember the plugin is still beta, if you experience any problems contact us. <

Known Issues

As new issues are found, we will post them here until we are able to release a new version to fix the issues.

  • When using hashed passwords for clients in the Geo software security settings, the JFusion user sync does not function properly. This is fixed in Geo version 5.2.0 and higher as it requires changes to core files to fix. <
1)
from a totally different server
2)
Except if you use the config wizard, it will connect to the DB to pre-fill all of the settings for the plugin for you.
3)
Even when "normal registrations" are turned off!
4)
This page is currently Enterprise only.
5)
This is not a problem with multi-admin users that are given admin access through the use of the multi-admin addon, this only applies to the main admin user.
addons/jfusion_plugin/start.1308345675.txt.gz · Last modified: 2014/09/25 16:55 (external edit)