Zurmo CRM comes in two basic flavors, the commercial edition, and the community edition. The community edition is licensed under the AGPL/3 . Source code for the community edition is available for anyone to review, modify, and propose changes.
We define the term “repository”, or “repo” as a storage location for source code. In this post we will learn how to access the public source code repository for ZURMO CRM community edition. Even if you are not a developer, you will find it useful to browse the repo from time to time.
The official Zurmo code repository is located in Bitbucket here: Zurmo CRM Source Code. If you are already familiar with Bitbucket or another distributed source code management (SCM) system like Git, you should have no problem browsing the source using the very simple interface.
If you haven’t used Bitbucket don’t panic, read on! At the end of the article, you will find a very helpful tutorial which you can review for more in-depth discussion of how distributed source control works.
First, let’s address a nagging question. Many people wonder about the rationale for using Bitbucket as opposed to another SCM provider, like Git. The historical reason is that, when the decision was being made by the core Zurmo developers about which SCM to use, Bitbucket had a very compelling feature that Git lacked. Bitbucket allowed people to create as many public and private repositories as they liked of unlimited size, free, for up to 5 users. This was seen as a definite advantage for the community, since it gave folks a comfort level and some sense of security since Git, at least at that time, did not offer free private repositories. (Subsequently in May of 2014 Bitbucket started rolling out a 2GB limit on the size of all repositories. It remains to be seen how this will work out.)
You don’t need a Bitbucket login if you only want to browse the project. But if you do want to download or modify the source then you will want to signup for a Bitbucket account. It’s free and incredibly simple. You can just sign up at www.bitbucket.org
By convention, Bitbucket uses the sign-in name of the Bitbucket account holder followed by a slash and a character string as the name of the repo. So “https://www.bitbucket.org/zurmo/zurmo” is the fully qualified URL for Zurmo repository. The token “zurmo/zurmo” reflects the <owner>/<name>. Repository names can contain most alpha numeric characters but not spaces. You should avoid special characters when you name your repositories, and keep the names short, descriptive and simple.
The next thing we need to understand is that even though Bitbucket repositories include an optional issue-tracker and wiki, these documentation features, at least with respect to the Zurmo repository, are usually stale, out-of-date and not a very efficient way to monitor changes unless you are interested in the details of individual source-code commits. In a future post, we will learn about where to get the most up-to-date information and status about planned and actual Zurmo changes.
Just open your browser and type www.bitbucket.org/zurmo/zurmo . Viola! Now you can inspect the Zurmo source code.
In the next article, we will learn how Zurmo source code is organized.
Here is the official link to Bitbucket 101, a really comprehensive tutorial on Bitbucket.
(c) 2014 Windsor Wallaby, All rights reserved.