SiteGroundTutorials

GroupWareTutorial
eGroupwareandphpGroupwareapplications
eGroupwareisflexibleandfreetousecollaborativesoftware,whichwillhelpyoutointeracteasierwith yourteammembers.eGroupwareprovidesin builttoolslikegroupcalendar,addressbook,e mail, accounting,inventory,andmore.Thesetoolsshareacommonuserstoreandaflexibleaccesscontrol systemtocontrolinformationsharing. phpGroupWareisaweb basedcollaborativeapplication,writteninPHP.Italsocomeswithmanypre configuredapplications,likecalendar,addressbook,todolist,notes,email,newsgroups,filemanager, etc.

Serverrequirements
EgroupWareandPHPGroupWarerunonLinuxorWindowswebserverwithPHP4.3orhigher,and MySQLdatabase4.1or5.Fortheemailoperation,youwouldneedSMTP,POP3orIMAPServers.All theseareavailableonSiteGroundwebhosting package.

GroupwareTutorialcoversthefollowingtopics: HowtoinstalleGroupwareonyourwebsite DetailedexplanationoftheeGroupwareapplications phpGroupwareinstallationinstructions HowtousephpGroupwareapplications

SiteGroundhaslongexperienceinprovidingwebspaceGroupwarewebsites.OurGroupwarehosting serviceisthebestchoiceforyouforitofferstherichestsetoffeatures,Groupwareexpertizedsupport teamandlotsofFREEtools.

(c)Copyright2006SiteGroundwebhostingprovider.Allrightsreserved Youmayusethistutorialforyourownuse.Youmaynotdistributeitinanyformwithouttheexpresspermissionof thepublisher.Youmayprovidealinktothepublisher'swebsite,wherethistutorialcanbeusedfrom.Thistutorial isprovidedfreeofchargeandwithoutanywarrantyofanykind.

eGroupwareTutorial:eGroupwareInstallation
HowtoinstalleGroupwareonyourwebsite?
YoucaninstalleGroupwaresoftwarebyfollowingtheseStep bystepinstructions: Step1:DownloadtheinstallationfilefromEgroupwareDownloadspage byclickingon"Follow thislinktodownloadthelateststablerelease".Youshouldchoosetheplatformindependentreleasein tar.gz,tarorzipformat.Thenyouwillhavethelateststablereleaseofthescriptinyourcomputer. Step2:Uploaditin public_html folderofyouraccount.Youcandothatthrough FTPwith aclientlikeFileZillaorthroughcPanel >FileManager>Uploadfile(s).Inthesecondway,afterthe installationiscompleted,thefilescriptwillshowifyougotothemainpageofyoursite (www.YourDomain.com).YoucanalsoinstalleGroupwareinasubfolder simplyuploadtheinstallation fileinthefolder: public_html/subfolder .TheeGroupWareinstallationwillthenbeaccessibleat: www.yourdomain.com/subfolder. Step3:WhenyouareincPanel>FileManager,pleasenavigatetotheuploadedfileandextract itbyclickingon"ExtractFileContents".Anotheroptionistoextractthefilesonyourlocalcomputer andthenuploadtheminthedesiredfolderthroughFTP. Step4:Oncethefilesareextractedinthedesiredfolder,youshouldcreateaMySQLdatabase foreGroupWare.Please,learn howtocreateaMySQLdatabaseanduserhere. Step5:Youshouldopenthe .htaccess filefromtheinstallationdirectoryandcommentall

Step3:WhenyouareincPanel>FileManager,pleasenavigatetotheuploadedfileandextract itbyclickingon"ExtractFileContents".Anotheroptionistoextractthefilesonyourlocalcomputer andthenuploadtheminthedesiredfolderthroughFTP. Step4:Oncethefilesareextractedinthedesiredfolder,youshouldcreateaMySQLdatabase foreGroupWare.Please,learn howtocreateaMySQLdatabaseanduserhere. Step5:Youshouldopenthe .htaccess filefromtheinstallationdirectoryandcommentall thelines,whichstartwith PHP_value .Youshouldputthesign "#" infrontofthem.Thenyou shouldtakethesevariablesandcopytheninanewlycreatedfile,called PHP.ini .Thecontentofthe PHP.ini fileshouldbe:

memory_limit=32M max_execution_time=60 register_globals=Off magic_quotes_gpc=Off magic_quotes_runtime=Off upload_max_filesize=16M session.use_trans_sid=Off session.gc_probability=1 session.gc_divisor=10 mbstring.func_overload=7

ThenyoushouldcopythisfileundereverysubfolderoftheeGroupWareinstallationdirectory. Step6:ChangethefilepermissionsfortheeGroupWareinstallationdirectoryto755through cPanel>FileManager. Step7:NavigatetothewebaddressofyoureGroupWareinstallationandruntheinstallation tests.Oncetheyarecompletedyoushouldnavigatebackto"SetupMainMenu"andclickon"Skipthe installationtests(notrecommended)".However,ifthereisaproblem,whichoccursduringthetests andyoucannotfixit,pleasepostaticketfromyourCustomerArea >Getsupport >Post&Review tickets>Addnewticket.ThenamemberofourTechnicalSupportTeamwillassistyouwiththe installationofthescript.

Step8:NowyouarereadytosetuptheprimaryconfigurationofyoureGroupWarescript installation.

Thefirsttwovariables(ServerRootandIncludeRoot)areautomaticallysetbythescriptandyou shouldnotchangethemunlessyouknowwhatyouaredoing.Thenyoushouldsetthelogindetails fortheadminuserfortheheadermanager.Thisuserhastherightstochangetheprimary configurationofthescriptaftertheinstallationiscompleted.Thenextfieldallowslimitingtheaccessto thesetuptodesiredIPaddressesorhostnames.Youcanleavethenextninefieldsunchanged,since theycontaindefaultvalues.Thenyoushouldsetthedatabasename,thedatabaseuserandthe password.Youshouldusetheones,whichyouhavesetinStep4fromtheinstallationinstructions. Onceitiscompletedyoushouldsetthelogindetailsfortheconfigurationuser.Thelaststepistowrite theconfigurationandcontinuetothesetupsection. Step9:Inthesetupsectionyoucanreconfigurethescriptthroughthe"HeaderAdminLogin" ortosetupthescriptthroughthe"ConfigAdminLogin".

thesetuptodesiredIPaddressesorhostnames.Youcanleavethenextninefieldsunchanged,since theycontaindefaultvalues.Thenyoushouldsetthedatabasename,thedatabaseuserandthe password.Youshouldusetheones,whichyouhavesetinStep4fromtheinstallationinstructions. Onceitiscompletedyoushouldsetthelogindetailsfortheconfigurationuser.Thelaststepistowrite theconfigurationandcontinuetothesetupsection. Step9:Inthesetupsectionyoucanreconfigurethescriptthroughthe"HeaderAdminLogin" ortosetupthescriptthroughthe"ConfigAdminLogin".

Step10:Onceyouloginwiththeconfigurationlogindetails,youwillbeabletosetupyour applications,includedinthescript.

Firstyoucanselectthedesiredchar setforyourdatabase.Thenyoushouldinstalltheapplications. Afterthisrechecktheinstallations. Step11:Navigatetostep2andeditthecurrentconfigurationofthescriptapplications,which youhaveinstalled:

Inthepathinformationsectionyoushouldspecifytheabsolutepathstotwofolders,calledfilesand backup,whichshouldbecreatedthroughyourFileManagerintherootfolderofyouraccount.They shouldbeonthesamelevelasthepublic_htmlfolder.Iftheuserofyouraccountis"user"(theone, whichyouusetologinyourcPanel),thentheabsolutepathswillbe:

/home/user/files

and

/home/user/backup

/home/user/files

and

/home/user/backup

YoucanleavetheHostInformationunchanged,sinceitisautomaticallyconfiguredbythescript. However,ifyouinstallthescriptoutsidetheaccount,whichyouhavewithSiteGround,youcouldedit thissection. TheStandarde mailserversettingswouldlooklikethefollowingones:

POP/IMAPmailserverhostnameorIPaddress:mail.yourdomain.com Mailserverprotocol:IMAPorPOP3 Mailserverlogintype:standard(login nameidenticaltothe eGroupWareusername) Maildomain(forVirtualmailmanager): SMTPserverhostnameorIPaddress:mail.yourdomain.com SMTPserverport:25 UserfortheSMTPauthentication(leaveitemptyifnoauth required):emailuser@yourdomain.com PasswordfortheSMTP authentication:thecorrespondingpassword, whichyouhavesetduringthecreationofthee mailaccountin cPanel>Mail>Manage/Add/Removeaccounts.

TroubleshootingTips: Pleasemindthatyoushouldchangeyourdomain.comwiththeactualdomain,whichyou haveusedinStep2oftheinstallationinstructions.Youshouldalsochangeemailuser@yourdomain.comwithan existingemailaccount,whichyouhavecreatedthroughcPanel>Mail>Manage/Add/Removeaccounts.

Youcanleavetherestofthefieldswiththeirdefaultvaluesandnavigatetothe"Save"button.Inthis wayyouhavecompletedthesetupofyourscript.Nowyoushouldcreateanadministratoruserforit. Step12:Youcancreatetheadministratoruserbyclickingon"Createadminaccountbutton". Onceyouareready,youcannavigatetothemainURLofyoureGroupWareinstallation.Youhave successfullycompletedtheinstallationprocedure. Theotheroptionsinthesetuppartallowyoutochangethedefaultlanguage,tomanagetheinstalled applications,whichareincludedinthescript,toaddnewapplicationsoruninstallexisting,tocreateand restorebackupsofyourscriptinstallation.

(c)Copyright2006SiteGroundwebhostingprovider.Allrightsreserved

eGroupwareTutorial:eGroupwareApplications
ThemostpopulareGroupWareapplications
OnceyouloginthewiththeadminaccountinyoureGroupWarewebsite,youcanmanagethe availableapplications,whichareincludedinthescript.

Thefirsticonislabeled"Admin"andallowsyoutosettheconfigurationofthedifferentapplications. Thereyoucanalsomanageuseraccountsandgroups,theglobalscriptconfiguration,viewthelogfiles, createandrestorebackups.Youcanaddcustomfieldsandmanagetheglobalcategoriesforthe differentapplications.

Thefirsticonislabeled"Admin"andallowsyoutosettheconfigurationofthedifferentapplications. Thereyoucanalsomanageuseraccountsandgroups,theglobalscriptconfiguration,viewthelogfiles, createandrestorebackups.Youcanaddcustomfieldsandmanagetheglobalcategoriesforthe differentapplications.

Ifyounavigatetotheemailadminsection,youcansetthedefaultaddressofthesender,theSMTP andtheIMAP/POP3configurations.

HereisalistandabriefdescriptionofthemostpopulareGroupWareapplications:

FelaMiMailisauserfriendlyemailclient.ItallowsyoutosendmessagesthroughtheSMTPserver andtoreceivethroughtheIMAPserver.Thesettings,whichyouhavetoconfigureintheemailadmin areasfollows:

SMTPserver:yourdomain.com Port:25 UseSMTPauthentication.Withthefollowinglogincredentials: Username:emailuser@yourdomain.com Password:thecorrespondingone.

TroubleshootingTips: Pleasemindthatyoushouldchangeyourdomain.comwiththeactualdomain,whichyou haveusedduringtheinstallationprocess.Youshouldalsochangeemailuser@yourdomain.comwithanexistinge mailaccount,whichyouhavecreatedthroughcPanel>Mail>Manage/Add/Removeaccounts.

Besidesallthestandardoperationofcomposing,sendingandreceiving,thisapplicationallowsyouto setfiltersandtoadde mailaddressestoyouraddressbook.

Calendar includesthetraditionalholidays.Youcanalsomakeyourownweeklyandmonthly schedulesandaddcustomevents.Thechangeswillappearinthemainwebpage.Youcansetalarms forsomedesiredevents.

Addressbook youcancreateyourownaddressbookandincludesomeimportantdetailslikethe Fullnameofthecontact,thecompanyname,thephonesandthee mailaddress.Youcanexportand importtheaddressbookdataandaddVCards.

ProjectManagerallowsyoutocreateyourownprojectsandtocalculatetheestimatedvalueof them.Youcanlist,add,edit,anddeleteprojectsandprojectelements.

InfoLog itisamanager,whichallowsyoutocreatetodolists,notesandsupportsallthe aspectsofaCRM(customer relationmanagement).

Resources allowsyoutomanagetheavailableresourcesandinventorylikebuilding,storages andothers.Ithasabookingfunctionalityintegrated.

InfoLog itisamanager,whichallowsyoutocreatetodolists,notesandsupportsallthe aspectsofaCRM(customer relationmanagement).

Resources allowsyoutomanagetheavailableresourcesandinventorylikebuilding,storages andothers.Ithasabookingfunctionalityintegrated.

TimeSheet atimetrackerapplication.ItworkswiththeProjectManager.Youcandefineand checkperiodsoftime.

Manual/Helpprovidesyouwithadetailedscriptmanual.Thereyoucanfindanswerstoallthe questionsrelatedwiththescriptfunctionality.

Filemanagerallowsyoutocopy,move,delete,renameandmanipulatethefilesandthefolders aseverystandardfilemanager,whichyouuse.

SiteMgr allowsyoutobuildyourwebsitefromatemplate.Thereyoucanselectanew templateandmanageit.Theavailablelistoftemplatescanbeusedbyvisitorstochangethevisual appearanceofthewebsiteduringthebrowsing.Youcandownloadfreetemplatesfrom Egroupware officialsite. UnpackthedownloadedtemplateinyourtemplatesdirectoryundertheeGroupWareinstallation directory: (/sitemgr/sitemgrsite/templates) .Thenyoucansetthenewtemplate,which youwilluseforyoureGroupWarewebsitefromSiteMgr>ConfigureWebsite >Templateselect.

Work FlowitisusedtocreateandmanageworkflowprocessesthroughaGUI(GraphicalUser Interface).Thegoalofthisapplicationistoprovideareferenceimplementation,stableandcomplete towhatcanbedonewiththisAPI(ApplicationProgrammingInterface).

Wiki itisaneGroupWareversionofawikiscript.ItallowsuserstocreateandeditWebpage content.

Bookmarks allowsyoutocreateandshareyourownlistswithbookmarks.Youcansetthe URLandsomedetailsaboutthewebpage,whichyouwanttoaddtothelist.

NewsAdmininthissectionyoucancreate,edit,publishinadefinecategoryandreadnews.

Pools allowsyoutocreateyourownpoolsandcollectpeople'sopiniononadefinesubject.You canaddsurveys,questionsandanswers.

KnowledgeBase youcancreateanduseyourownknowledgebase.

eTemplate allowsyoutocreateyourowneGroupWaretemplates.Thisapplicationhasa detailedtutorialandreadingityouwillunderstandhowtobuildyourowntemplates.Itislocatedon theleftmenuoftheeTemplatesectionpage.

KnowledgeBase youcancreateanduseyourownknowledgebase.

eTemplate allowsyoutocreateyourowneGroupWaretemplates.Thisapplicationhasa detailedtutorialandreadingityouwillunderstandhowtobuildyourowntemplates.Itislocatedon theleftmenuoftheeTemplatesectionpage.

Translationtools theapplicationiscreatedfordevelopersandtranslators.Ithasthefollowing features:

showsallphrasesfromtheenlang file,thealreadyavailabletranslationsandallowsto enteratranslation searchesfornewphrasesinthesourcecode addsnewphrasestoalangfile changestheapplicationnameofaphrase lowercaseandalphabeticallysortsthephrases/message_id writes(ifthewebserverhaswriteaccesstothesetupdirortothefile)ordownloadsthe changedlangfile updatesthedatabasewithoutrunningthesetuptocheck/seeyourtranslations usesmultilinetextareasforlongmessages r e a d s t h e p h r a s e s f r o m t h e f o l l o w i n g f i l e s hook_ {admin|preferences|sidebox_menu|acl_manager} (theycontainnolangcalls)

(c)Copyright2006SiteGroundwebhostingprovider.Allrightsreserved

phpGroupwareTutorial:phpGroupwareInstallation
HowtoinstallphpGroupwareonyourwebsite?
YoucaninstallphpGroupwaresoftwarebyfollowingtheseStepbystepinstructions: Step1:Downloadtheinstallationfilefrom phpGroupwaredownloadspage.Youshouldchoose theplatformindependentreleaseintar.gz,tarorzipformat.Thenyouwillhavethelateststable releaseofthescriptinyourcomputer. Step2:Uploaditin public_html folderofyouraccount.Youcandothatthrough FTPwith aclientlikeFileZillaorthroughcPanel >FileManager>Uploadfile(s).Inthesecondway,afterthe installationiscompleted,thefilescriptwillshowifyougotothemainpageofyoursite (www.YourDomain.com).YoucanalsoinstalleGroupwareinasubfolder simplyuploadtheinstallation fileinthefolder: public_html/subfolder .TheeGroupWareinstallationwillthenbeaccessibleat: www.yourdomain.com/subfolder. Step3:WhenyouareincPanel >FileManager,navigatetotheuploadedfileandextractitby clickingon"ExtractFileContents".Anotheroptionistoextractthefilesonyourlocalcomputerand thenuploadtheminthedesiredfolderthroughFTP. Step4:Oncethefilesareextractedinthedesiredfolder,youshouldcreateaMySQLdatabase forPHPGroupWare.Please,learn howtocreateaMySQLdatabaseanduserhere. Step5:ChangethefilepermissionsforthePHPGroupWareinstallationdirectoryto755through cPanel>FileManager Step6:NavigatetothewebaddressofyourPHPGroupWareinstallation.Thereyoucansetup theinstallationofthescript.

Thefirsttwovariables(ServerRootandIncludeRoot)areautomaticallysetbythescriptandyou

Step6:NavigatetothewebaddressofyourPHPGroupWareinstallation.Thereyoucansetup theinstallationofthescript.

Thefirsttwovariables(ServerRootandIncludeRoot)areautomaticallysetbythescriptandyou shouldnotchangethemunlessyouknowwhatyouaredoing.Thenyoushouldsettheadmin password.Youcanleavethenextninefieldsunchanged,sincethesearethedefaultvaluesforthem. Thenyoushouldsetthedatabasename,thedatabaseuserandthepassword.Youshouldusethe ones,whichyouhaveusedinpoint4.2.4.oftheinstallationinstructions.Onceitiscompletedyou shouldsetthepasswordfortheconfigurationuser.Thelaststepistowritetheconfigurationand continuetothesetupsection. Step7:Inthesetupsectionyoucanreconfigurethescriptthroughthe"HeaderAdminLogin" ortosetupthescriptthroughthe"ConfigAdminLogin".

Step8:OnceyouloginwiththeConfigAdmindetails,youwillbeabletosetupthe applications,includedinthescript.

Step9:Installtheapplicationsandthenrechecktheinstallation. Step10:NavigatetotheConfigurationsection.

Inthissectionyoushouldonlyspecifytheabsolutepathtoafolder,calledfiles,whichshouldbe createdthroughyourFileManagerintherootfolderofyouraccount.Itshouldbeonthesamelevelas thepublic_htmlfolder.Iftheuserofyouraccountis"user"(theone,whichyouusetologinyour cPanel),thentheabsolutepathwillbe:

/home/user/files
Thenyoucanleavethedefaultvaluesoftheothervariables,sincetheyarealreadysetbythescript installation.However,ifyouarefamiliarwiththescriptfunctionalityandyouneedachangeinthe values,youcanproceed.Attheendyoushouldclickonthe"Save"buttontowritetheconfiguration. Step11:Youcancreatetheadministratoruserbyclickingonthe"ClickHeretosetupanadmin accountand(optionally)3demoaccounts"link.Onceyouareready,youcannavigatetothemainURL

/home/user/files
Thenyoucanleavethedefaultvaluesoftheothervariables,sincetheyarealreadysetbythescript installation.However,ifyouarefamiliarwiththescriptfunctionalityandyouneedachangeinthe values,youcanproceed.Attheendyoushouldclickonthe"Save"buttontowritetheconfiguration. Step11:Youcancreatetheadministratoruserbyclickingonthe"ClickHeretosetupanadmin accountand(optionally)3demoaccounts"link.Onceyouareready,youcannavigatetothemainURL ofyoureGroupWareinstallation.Youhavesuccessfullycompletedtheinstallationprocedure.Theother optionsinthesetuppartallowyoutochangethedefaultlanguageandtomanagetheinstalledscript applications.

(c)Copyright2006SiteGroundwebhostingprovider.Allrightsreserved

phpGroupwareTutorial:phpGroupwareApplications
ThemostpopularphpGroupWareapplications
OnceyouloginwiththeadminaccountinyourPHPGroupWarewebsite,youcanmanagethescript applications.Firstyoucancheckandmodifytheirconfigurationthroughtheadminsection.

Ifyouwanttousethee mailapplication,youshouldconfigureit.TheStandardemailsettingswould looklikethefollowingones:

EnteryourPOP3/IMAPmailserverhostnameorIPaddress: mail.yourdomain.com Selectyourmailservertype:IMAPorPOP3 IMAPServerType:CyrusorCourier Enteryourdefaultmaildomain(From:user@domain): emailuser@yourdomain.com Mailserverlogintype:standard EnteryourSMTPserverhostnameorIPaddress:mail.yourdomain.com EnteryourSMTPserverport:25

Thenyoucaneditthecustome mailsettings

UserfortheSMTPauthentication:emailuser@yourdomain.com PasswordfortheSMTPauthentication:thecorrespondingpassword, whichyouhavesetduringthecreationofthee mailaccountin cPanel>Mail>Manage/Add/Removeaccounts.

TroubleshootingTips: Pleasemindthatyoushouldchangeyourdomain.comwiththeactualdomain,whichyou haveusedinpoint4.2.2.oftheinstallationinstructions.Youshouldalsochangeemailuser@yourdomain.comwith anexistingemailaccount,whichyouhavecreatedthroughcPanel>Mail>Manage/Add/Removeaccounts.

Onceyouarereadywiththeapplicationsconfigurationyoucanstarttousethem.Theavailable applicationsare:

Emailthisisawebmailclient,whichallowsyoutosendandreceivemessages.

Calendar.Youcanmakeyourownschedulesforaweek,amonthorayear.

Onceyouarereadywiththeapplicationsconfigurationyoucanstarttousethem.Theavailable applicationsare:

Emailthisisawebmailclient,whichallowsyoutosendandreceivemessages.

Calendar.Youcanmakeyourownschedulesforaweek,amonthorayear.

Addressbook youcancreateyourownaddressbook.Youcandefinecategoriesofyour contacts,importandexportthecontacts,addVCardsandperformanalternativeCSVimport.

InfoLog itisamanager,whichallowsyoumonitoringofsomeprocesseswiththeirdescription, thestartandtheenddate,thepersonwhoisinchargeandotherspecifications.

Notesthisapplicationallowsyoutocreateandeditnotesindifferentcategories.

NNTPwiththisapplicationyoucancreate,readandmodifyallthelatestnews.

ToDoListallowsyoutoshapeyourdailyschedule.

FileManagerallowsyoutocopy,move,delete,renameandmanipulatethefilesandthefolders aseverystandardfilemanager,whichyouuse.Throughityoucancreatefilesandfolders,uploadand downloadfiles.

Manual providesyouwithdetailedinformationaboutthefunctionalityofthescriptandits applications. Please,feelfreetocontactusifyouhaveanyquestionsorrecommendationsaboutthistutorialat: tutorials'at'siteground.com

(c)Copyright2006SiteGroundwebhostingprovider.Allrightsreserved