Joomla 1.5 – vtiger 5.04 JFusion plugin

Olen ottamassa käyttöön CRM- eli asiakkuudenhallintajärjestelmää, jonka avulla asiakkaille, jälleenmyyjille sekä heidän asiakkailleen voidaan tarjota entistä monipuolisempia palveluja.

Vertailevan tutkimuksen jälkeen valitsin CRM-ohjelmistoksi avoimen lähdekoodin vtiger CRM:n. Valinnan keskeisenä vaikuttimena oli vtigeriin valmiina olemassa oleva Customer Portal -laajennus, jonka avulla voidaan toteuttaa ns. HelpDesk asiakastikettien ja tietämyskannan hallintaan.

Käyttöönottoprojektin aikana nälkä kasvoi syödessä. Syntyi halu liittää vtigerilla toteutettu HelpDesk ja www-sivuston sisällönhallinnasta vastaava Joomla CMS toisiinsa niin, että asiakkaat voivat käyttää yksiä ja samoja käyttäjätunnuksia HelpDeskin ja muun sivuston tunnistautumista vaativissa osioissa.

Koska tuoreimpien vtiger 5.04 ja Joomla 1.5 -versioiden integrointiin ei ollut olemassa valmista ohjelmistoa, sellainen piti kehittää itse. Valitsin toteutuksen pohjaksi Joomlan JFusion-laajennuksen. JFusion-ohjelmistokehyksen avulla useiden eri sovellusta käyttäjäautentikoinnit voidaan integroida toisiinsa. JFusioniin oli paljon nopeampaa kehittää vtiger-plugin, kuin tehdä koko vtiger-Joomla -integrointipakeketti alusta alkaen. Tärkeä vaikutin oli myös se, että tulevaisuudessa JFusionin avulla voi integroida myös muita ohjelmistoja kuten esim. verkkokaupan tai foorumin samaan nippuun.

Ohjelma on siis kehitetty omiin tarpeisiin. Aikomukseni ei ole tuotteistaa sitä tämän pidemmälle. Laitan ohjelman julkiseen jakeluun, jotta muut voivat halutessaan käyttää sitä ja kehittää tarvittaessa pidemmälle. Koska suurin osa potentiaalisesta käyttäjäkunnasta on muita kuin suomenkielisiä, itse ohjelman tarkempi esittely alla on englanniksi.

In English

JFusion plugin for Joomla 1.5 and vtiger 5.04 Customer Portal authentication integration

This JFusion vtiger_cportal plugin enables vtiger customer portal users to login to Joomla by using their customer portal user credentials. System administrator doesn’t need to create separate Joomla user credentials for the users.

This plugin authenticates vtiger Customer Portal users, not vtiger CRM users. Customer portal users are Contacts whose ‘Portal User’ setting is set to value ‘yes’.

I have developed this program for my own use. Since it meets my needs, I have no plans to develop additional features. Others are welcome to continue its development. I will not provide free support for its installation or use.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY. It is still in early alpha state, so use it at your own risk. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License.

Requirements and development environment

PHP5 only!

Developed and tested by using the following software versions

• vtiger 5.04
• Joomla 1.5.7
• JFusion 1.07e alpha

Additional information about the development and test environment

• MySQL 5.0.51a
• PHP 5.2.4 cgi-fcgi
• Apache 2.2.8
• Kubuntu 8.04

Master/slave

vtiger must act as the master user database. Importing users from JFusion slaves into vtiger is not implemented.

Dual login

Dual (shared) login is experimental and requires Joomla to use session handler ‘none’, ie. the native PHP session handler. By default Joolma 1.5 uses custom ‘database’ session handler.

To change the session handler, see Joomla Global Configuration / System / Session Settings / Session Handler, or make the following modification to Joomla’s configuration.php file:

Installation

Follow the installation instructions of JFusion Documentation Wiki.

Screenshots

These screenshots may help you to set up the vtiger_cportal plugin.

JFusion plugin configuration

JFusion plugin configuration

JFusion plugin editor: vtiger_cportal

JFusion plugin editor: vtiger_cportal

Joomla Module Manager: mod_jfusion_login

Joomla Module Manager: mod_jfusion_login

Download

The installation ZIP can be downloaded from here.

The ZIP-package contains program files, change log, license, API-documentation etc. Only the program files are installed to Joomla during the automatic JFusion plugin installation procedure.

Future

If others find this program useful, I hope it will find its permanent home from JFusion website. I’ll participate the discussions in JFusion Support Forums.