vtlib 2.1 is now available!
January 7th, 2009 by Prasad
I’m happy to inform you of the release of vtlib 2.1 today. This version adds some key features, and provides several useful APIs to make it easy to build new modules, and customize the functionality of vtiger CRM.
Thanks to the community for their valuable support and feedback on earlier versions.
Following are some of the highlights of the new features bundled in vtlib 2.1
* Language Pack Installation
Language Packs are now treated as a special type of module, which can be installed or upgraded using Module Manager.
* Upgrading Modules
Module Manager provides basic support to upgrade custom modules developed using vtlib
* Custom Actions for Module
You can add custom actions that open web links for your module. These links are displayed on the DetailView. Using this feature, custom actions like Add Event, Export to PDF can be provided easily.
* Tooltip for Module Field
vtlib provides an API to set Tooltip text for the module field which could be useful in educating the users when they are in Create/Edit view.
Please check out the documentation for more details. Kindly share your feedback with us.
vtlib 2.1 Download URL: http://forge.vtiger.com/frs/?group_id=174&release_id=480
ZohoMeeting Integration Module for vtiger CRM
With the new capabilities of vtlib 2.1, we developed an integration module for ZohoMeeting.
We used the Custom Actions feature to add ZohoMeeting links for vtiger calendar events.
You can download this extension from here: ZohoMeeting-1.0
Regards,
Prasad
vtiger Team




hi,
i will try the new vtlib 2.1 version , but it has the some problem when try to select an account using search , like vtlib 2.0
i have deleted smarty/template_c but….
thanks
CarloB
Hi CarloB,
Adding records by popup-search will be addressed going forward. Thank you for reporting the issue.
Regards,
Prasad
vtiger Team
Congratulations!
Great job!
I find a litle bug.
file modules\Settings\AddCustomFieldToDB.php
Line 245 - Missing field “helpinfo”
$query = “insert into vtiger_field values(?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)”;
Replace with:
$query = “insert into vtiger_field values(?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,”)”;
Hi Marc, Carlo
I have tried to fix the issue of (CustomField Addition and Popup Search for UItype 10) and re-uploaded vtlib-2.1.zip
Let me know your feedback.
Regards,
Prasad
vtiger Team
Hi there,
I was able to get 2.0 installed on my first attempt, but I also manually moved everything to the right folders before realizing I could just unzip it and it would do it for me (after all these years you’d think I would have known that). I installed the vtwitter module, but had some problems so tried to uninstall to start over, but couldn’t do that, so ultimately I reinstalled vTiger fresh and in the process noticed you upgraded vtlib to v2.1.
So, I’ve got everything installed as it seems to need to be, I see the updated files and all seems well, but vtlib doesn’t seem to be loaded (there’s not “module manager” listed in “Settings”).
One thing I noticed:
In the vtlib directory, you added the version folder with files in that, but when you do the “include” it seems that the path hasn’t changed to reflect that fact that the files are a few folders deep. Seems I’m grasping at something that others aren’t having a problem with, but I just can’t find why it won’t load. Any ideas? I know it’s tough without seeing things…
Thanks, I’m looking forward to working with vTiger, I have a huge project that I hope I found the right software for.
LaMonte
Hi LaMonte,
Are you refering to ModuleDir changes?
To make it easy for developing module files for specific version of vtiger, we have copied files w.r.t vtiger version number. However you will need to copy the files under modules/ folder
Correct me if I did not understand your question
Regards,
Prasad
vtiger Team
Hi,
I have sketched out a diagram to explain how the Listview action for a module is processed. The code (or logic) will be in Listview.php and the display logic is delegated to Smarty.
Hope this gives more insight in understanding the use of Module (frontend) files.
vtlib-Module-FrontEnd.png
Regards,
Prasad
vtiger Team
I installed vtlib 2.1 on vtiger 5.0.4 and I now see the module manager. When I download Zoho Meeting and try to import with module manager I get the following error
“Invalid file provided for module import! Try Again.”
The file is a zip file.
Thank you,
Jason
Hi Jason,
Please refer to the install instruction as documented in vtiger-zohomeeting-v1.0.pdf
Regards,
Prasad
vtiger Team
This vtlib is awesome!! It just want I’ve been waiting for over the years.
I’ve installed vtlib 2.1 on 2 instances of vitger 5.0.4 I can not seem to see the module manager under settings on either, is there a file or dir I need to move some where in order for the module manager to populate?
Prasad,
Thank you for your response. I have already deleted Vtiger, and installed SugarCRM. I kept having a problem with a blank screen. Apache was throwing up all kinds of php errors. It seems to happen when I install the PDF configuator. The php errors seem to revolve around the Logger elements.
Thanks,
Jason
Hi Tommy,
Thank you for the appreciation.
You will need to unzip the vtlib-x.y.zip into your vtigercrm folder. Try deleting the files under Smarty/templates_c/*.tpl.php you should get module manager
Regards,
Prasad
vtiger Team
Prasad,
Thank you! That took care of it.
I’ve been trying for the last 2 days to post to the forum and I’ still can’t. I’ve copied the error I’m getting to here in hopes you can assist me. Once I can submit to the forum (Hopefully by E.O.D.) I will post to the VTLIB forum. Until can you or someone please advise about the following error:
Fatal error: Uncaught exception ‘Exception’ with message ‘result is not an object’ in /var/www/sandbox/include/database/PearDatabase.php:590 Stack trace: #0 /var/www/sandbox/data/Tracker.php(95): PearDatabase->query_result(false, 0, ‘entityname’) #1 /var/www/sandbox/data/CRMEntity.php(1060): Tracker->track_view(’1′, ‘Locations’, ‘91′, ”) #2 /var/www/sandbox/index.php(500): CRMEntity->track_view(’1′, ‘Locations’, ‘91′) #3 {main} thrown in /var/www/sandbox/include/database/PearDatabase.php on line 590
I’m more then happy to submit the files I created, yet I can’t post to the forum yet, so I can’t upload them for the community to see.
Thanks for your time!
- Tommy
Hi Tommy,
If you can share the Module Script (that was used to setup the module) and the modules/ files that will be helpful to analyze the issue.
Regards,
Prasad
vtiger Team
I didn’t want to congest this blog with a couple hundred lines of code, so I created a tar of the Install File and Module Directory and uploaded to here: /rbizsolutions.com/vtlib/Locations.tar
Let me know your thoughts.
Thanks,
-Tommy
Hi Tommy,
I have downloaded the file, you can remove it now.
Will review and get back to your shortly.
Regards,
Prasad
vtiger Team
Few developer tips:
1. Preferably use small case characters for field (name and columnname).
2. Avoid any special characters like (_,:,-) in names. You can use it for labels
3. Having same value for field (name and columnname) would make it easier to avoid confusion to start with.
Regards,
Prasad
vtiger Team
Prasad,
You’re suggestion to another user about deleting the files in the template_c folder did the trick for me. I literally spent three hours going through everything I could to figure this out including reinstalling vTiger and vtlib twice. I logged on tonight, saw your post deleted the files and had vTwitter installed and working in five minutes. It always seems to be the easiest solutions that we miss…
Thanks much, great program here, looking forward to seeing where it goes next.
LaMonte
Hi Prasad,
I posted the following on the usual forum….probably need to post it here…..pls have a look below….need ur advice on the issues….
Regards.
Mahamud
****************
I am trying to add new module with the help of vtlib 2.0. I am facing a problem of displaying the account name on the list view. If I use UI type ‘10′ for a field, and use ‘accounts’ as related module, the account name shows up on the detail view but not on the list view….Can anyone help….
Also how do i add an ‘attachment’ field to a module through vtlib?
I also need help in how to add a new module for e.g. ‘Payslip’ as related module under ‘More Information’ of the ‘Accounts’ module……
******************
Hi Mahamud,
Kindly look at the reply at: http://forums.vtiger.com/viewtopic.php?p=75726#75726
Regards,
Prasad
vtiger Team
Hi Prasad
i have tried vtlib 2.1 after your second post and now also searching inside popup runnig well
i have modified payslip sample to include a lintoA for accounts and a linktoP for products
and it run
i have try to use api function for create a relation between the new module and one’s from vtiger (accounts)
but i see two buttons (select payslip , add payslip)
and i not see nothing as list
could you help me ?
CarloB
Hi Carlo,
List records feature is not present in the related list currently.
You can look at Campaigns module and give a try to get a generic one. Will keep you posted if any progress is made.
Regards,
Prasad
vtiger Team
Thanks Prasad
i get a look to campaigns module but… i lost my self!
Could you give me a little help ?
I have review doc on how to create new module (project sample) but i have found only why i have start to work with vtlib…
Thanks again
Carlo
I noticed the new function that allows to add help information to individual fields. This is a useful extention. However, I am troubled to understand how to make this multi langual. How can I add help comments in English and in another language which will than be selected by the language a users logs in?
Hi Balduin,
We are certainly open for ideas on this now. The help content could be big-bunch of text that is not easy to be translated like a field label.
I can see translation files might come in useful here.
Regards,
Prasad
vtiger Team
Thank you for the explanation. I will look into this issue of help content on the long run. Most likely I would prefer something which is XML based to link the help funktion with content from a short docbook based manual.
But I do have another question. I am unable to figure out what the new Mail Scanner function is for. Since it uses IMAP it must be for incoming emails but these are configured at webmails for the individual users. What do I miss?
Hi Balduin,
Generally, a dedicated mail account will be used to track the support or feedback information. This is the mail box which will be used by Mail Scanner to scan for the messages and take action on them.
You can see similar discussion at:
http://www.vtiger.com/blogs/2008/10/21/vtiger-crm-51-progress-update-3/
Regards,
Prasad
vtiger Team
dear i m installing it .. but not working, after extracting it in my dir.. please solve the issue
Hi Naveed,
Did you try clearing the smarty compiled files under Smarty/templates_c/*.tpl.php folder?
Regards,
Prasad
vtiger Team
Hey Prasad!
Magic
well it showed up, i have del all the files, in _c folder, but i cant find this step in vlib Documentation.. is this mentioned? any how i am impressed with the service from you people…
Thanx Buddy!
xxx
Hi Naveed,
This step was discussed in same blog post earlier. I will add it to the documentation going forward.
Regards,
Prasad
vtiger Team
I’m having this same issue, I must be missing something, I unzipped into root of vtiger but see no Module Manager.
This is for a 5.04 installation.
Any help is very much appreciated.
Hi Keith,
I had the same issue earlier Prasad informed me as stated above to “try deleting the files under Smarty/templates_c/*.tpl.php, then you should get module manager.
It worked for me. just delete all files ending with .tpl.php under the Smarty/templates_c/ directory.
Very well done, I think the vtlib is a huge step forward. Now we can install modules and language packs easily. Will there a possibility of installing new themes as well or does this already work?
Dennis
Hi Dennis,
Installing themes for vtiger is very simple. You will need to copy the folder into vtigercrm/themes directory
Theme installation support is not present in Module manager yet, will review it as we go forward.
Regards,
Prasad
vtiger Team
Hi Prasad,
thanks for the quick reply. Yes, I know about copying it to the directory, I was just wondering if there will be support in the Module manager, so actually users without ftp access could install themes. I really like the Module manager concept combined with the new extension Marketplace. Keep going, I will see if I can help adapting the german language pack so we will have labels in the module manager and not blanc tabs.
Take care,
Dennis
Dear vTiger Team,
I tried using vtlib, and generated a script, actually i want to develop a letters module, which actually serve the purpose of in coming and outgoing postals in office, and assinage of them to users. It is very very similar to Trouble Tickets Module, except few fields which i dont wana use and few which i want to add, also want to link it with potentials and accounts. I want to show in accounts additional info that how many letters of this account have came also a potential should show the same when we relate it with some potential or account in letter module….
But problems i facing are as follow:
it stores the info but could not retrieve, sometimes problem in detail view, some time in list view, sometimes in edit view
whenever i run teh script after modification it actually inserts more values in DB. (i check them through PHPMYADMIN - via Vertrigo)
Kindly let me know oen of the following,
tell em what to do to create a letters module with the following fields:
Feilds: Type
——– —-
Letter Category—-Picklist (e.g Incoming, Out Going)
Diary No—- text box(Int)
Receipt Date—- Date
Letter Date—- Date
Ref. No.—- text box (varchar)
Account/Contact/Leads—-(Picklist) Rel to (standard provision)
Subject—- text box (varchar)
Assigned To—- Drop down (Standard field)
Priority—- Drop down (Picklist same as Ticket
Status—- Drop down (same as TTickets)
Attachment—- browse (same as tickets)
Description—- Text Area
Encl—- Text Box (varchar)
or tell me how to modify TTickets via phpmyadmin and which files i have to modify, i dont wnna add filed under CUSTOM FIELD LABEL coz it looks bad, like basic info and custom info,
thanx please help me i am really in some trouble!!!
Hi satrece,
As discussed in this comments earlier:
Regards,
Prasad
vtiger Team
I have the same problem as some of the others here with installing-activating vtlib 2.1.
I have uploaded the vtlib-2.1 files into the vtigercrm root folder.
I have deleted all the Smarty/templates_c files -many times over.
There is no module manager appearing on the setting page for the Admin account.
What exactly am I do wrong? What am I overlooking?
would be great with some input since I seem to be struggling to install modules in general (like the PDFconfig add on, French language etc).
Please make a check for write-access before unzipping vtlib-x.y.zip
* modules
* Smarty
* cron
* test
Or else Module Manager might go missing!
Regards,
Prasad
vtiger Team
Hi Prasad,
Great plugin, Not only me all are waiting for this module. Great job. One thing i could not figured out how we can link custom module to other modules like we create payslip and this have account information. when am adding a particular account it added and showing the account details in more information area of payslip. That is ok, but when am going to account module and more information i could not see this payslip detail (like account have the relative information about contacts, sales order ect.. in more information area) which we already created the payslip for this account. Can u get my question?
Is it possible to set the related module to the SAME module?
Let say, I am developing a module called Category
and set the related module of a field with uitype 10, and that is Category too.
$field4 = new Vtiger_Field();
$field4->name = ‘UpperCategory’;
$field4->label= ‘Upper Category’;
$field4->table = ‘vtiger_category’;
$field4->column = ‘uppercategory’;
$field4->columntype = ‘VARCHAR(255)’;
$field4->uitype = 10;
$field4->typeofdata = ‘V~O’;
$field4->helpinfo = ‘Relate to an existing category’;
$block1->addField($field4);
$field4->setRelatedModules(Array(’Category’));
It builds successfully. But when I try to use the popup list, it shows the error
Warning: Invalid argument supplied for foreach() in /var/www/html/dev/b2b/include/utils/ListViewUtils.php on line 1459
for every existing record
Please help, Thanks!!!!!!