Book Image

SugarCRM Developer's Manual: Customize and extend SugarCRM

By : Dr Mark Alexander Bain
Book Image

SugarCRM Developer's Manual: Customize and extend SugarCRM

By: Dr Mark Alexander Bain

Overview of this book

<p>SugarCRM is the world's leading commercial open-source customer relationship management (CRM) software for companies of all sizes. SugarCRM easily adapts to any business environment by offering a more flexible, cost-effective alternative to proprietary applications. SugarCRM's open-source architecture allows companies to more easily customize and integrate customer-facing business processes in order to build and maintain more profitable relationships. SugarCRM offers several deployment options, including on-demand, on-premise and appliance-based solutions to suit customers' security, integration, and configuration needs. <br /><br />This book will help you to customize the SugarCRM code. You will get learn about the database and application architecture. The book provides you with a module development tutorial, showing the essential steps for hooking your module into the SugarCRM infrastructure. You will learn about common customizations that can be performed against the codebase.</p>
Table of Contents (16 chapters)
SugarCRM Developer's Manual
Credits
About the Author
About the Reviewers
Preface
Index

Customizing SugarCRM URL


At this stage we're not even going beyond SugarCRM's logon screen. If you've used an automatic installer (such as the very effective SpikeSource Windows Installer) then you'll be able open a browser, and type in the equivalent of http://achilles/sugarcrm. If you've manually installed SugarCRM on Linux then you'll probably need to type in something like: http://hector/SugarOS-Full-4.5.0f.

It doesn't matter if you're using Linux or Windows—in either case you'll be directed to the logon screen:

And you'll see that the URL reads: http://achilles/sugarcrm/index.php?action=Login&module=Users or http://hector/SugarOS-Full-4.5.0f/index.php?action=Login&modules=Users. There's nothing actually wrong here, but the URLs don't really tell you much (apart from the fact that you're using SugarCRM), so it seems a good idea to change the URL to something more meaningful—something related to the actual project that you're working on. Fortunately this is a very easy change to make.

Changing the SugarCRM URL in Windows

If you're using Windows then the first thing that you'll have to do is to find the SugarCRM directory. Obviously if you've installed everything manually then you'll know where the directory is—however, if you've used the Windows installer then it may not be quite so obvious. You may (or may not) know that the SugarCRM directory has to be in the document root for your web server, and if you've used the installer then this will probably be something like C:\Program Files\SugarCRM\oss\httpd\htdocs:

All you have to do is rename the directory (for instance our friend Pygoscelis might want it renamed penguin_pi for the Penguin P.I. organization), and then type the new URL into your browser (and for the Penguin P.I. organization this would be http://achilles/penguin_pi).

Changing the SugarCRM URL in Linux

In this instance Linux isn't too different from Windows—all you need to do is find the SugarCRM directory (again it will be in your web server's document root), and then rename it appropriately:

mv SugarOS-Full-4.5.0f penguin_pi

With that done the new URL will work: (e.g. http://hector/penguin_pi/index.php?action=index&module=Home)

Having sorted out SugarCRM's URL we can turn our attention to the rest of the screen.