How can I get the SVN version?

From e107 Wiki
Jump to: navigation, search

e107 Wiki: English | Русский | Deutsch | Français | Magyar | Português | Български | Česky | Nederlands | Ελληνικά | Italiano | Norske | Polska | Slovenščina | Español | Svenska | Translate: Wiki | Page


Current Release 1.0.4 | | Download | Changelog | Forum | Plugins | Themes | RSS Feed of Latest Changes | Atom Feed of Latest Changes

Development part of the e107 handbook
Main page > I : First Aid > II : Development > III : Administration > IV : How To's > V : Plugin Writing > VI : Theming & Shortcodes

Developer Information
Release Information

In software development, Subversion (mostly indicated with its acronym: SVN) is a version-control system initiated in 1999 by CollabNet Inc. Developers use Subversion to maintain current and historical versions of files such as source code, web pages, and documentation. Its goal is to be a mostly-compatible successor to the widely used Concurrent Versions System (CVS).

SVN is a tool used by many software developers to manage changes within their source code tree. SVN provides the means to store not only the current version of a piece of source code, but a record of all changes (and who made those changes) that have occurred to that source code. Use of SVN is particularly common on projects with multiple developers, since SVN ensures changes made by one developer are not accidentally removed when another developer posts their changes to the source tree.

In order to access a Subversion repository, you must install a special piece of software called a Subversion client. Subversion clients are available for most any operating system.

As of 9 February 2010 CVS was replaced with SVN. The old CVS files have been marked read only and the following information is in place while everything is updated.

Development of E107 is controlled using a system called SVN, which logs file versions and enables the changes between versions to be identified. It allows access to not only the latest version of each file, but all previous versions. There is a link to the SVN on the main E107 site.

It may be necessary to obtain files from SVN for various reasons - typically to fix a bug which is important on a particular site. However, be warned:

  • The files in SVN may be an 'interim' state which could break your site. (This is very likely to be the case if a major update is in progress - for example, at the time of writing this, application of SVN updates from the 0.7 (now 1.0) 'branch' to version 0.7.x will probably work OK, but any attempt to use the 2.0(0.8) SVN files is pretty much guaranteed to break your siteuntil it's at least at 'Beta release' stage.)
  • The changes may cause different problems.
  • You cannot always 'cherry pick' the files you need to solve a problem - you may need multiple files which have been modified to work together.

In short:

 Don't update your live site from the SVN unless you really need to!
 Make sure you can roll back the changes if they don't work
 Test on a private site first.

Direct access of SVN requires an appropriate client like Tortoisesvn.

To simplify updates, one or two users produce 'compilations' of all the changes since the last stable release, which can be downloaded as a single zip file. On some occasions there is also a 'semi-stable' update pack available, containing all updates up to a point where the files in SVN appeared to be stable. Information on this can be found within the forums and in e107 Downloads.

Accessing SVN from a Unix Machine

(Thanks to MrNiceGuy for this information)

1. Log into your shell.

2. Type: 'export'.

3. Type 'cvs login'.

4. Press <enter> when prompted for a password.

5. In your home dir, type 'cvs checkout e107_0.7'

6. In ~/e107_0.7, you should have a copy of the latest SVN version of e107.


o You can 'svn logout', but you don't need to.

o You don't need to go through this whole process every time. If you want to get a SVN version of e107 at a later time, you can just 'cd ~/e107_0.7' and type 'svn update -CdAP'.

o If you experience errors when using 'export', you might be using tclsh as a shell. If so, try using the command 'setenv' instead of 'export':

 setenv SVNROOT 

Accessing SVN from a Windows Machine

If you are working from a Windows Machine one of the easiest ways to check out the sources is Tortoise. Download and install TortoiseSVN from TortoiseSVN. You need to restart Windows.

Go to the directory where you want to download, right click and select 'SVN Checkout...' from the context menu.

In the opened window set the parameters like in the screenshot: Tortoise1.gif

The parameters are:

protocol: pserver
Repository folder: /cvsroot/e107
User name: anonymous

After that click on 'Fetch list' (right hand bottom of screen). After a while the Modules list is populated. Choose one, and click on OK to start the check out.

The modules you may want are:

  • e107_1.0 - the latest for version 1.0 (the current major version)
  • e107_2.0 - the latest for version 2.0, which is in development
  • e107_langpacks - the language packs

Once you have set up your repository and downloaded all the files, you can update by simply right clicking on the directory and selecting 'SVN Update'. Only the files which have changed will be downloaded.

Downloading a SVN Zip File

SVN packages are also available to download from, check the dates and use at your own risk.

Get SVN on Windows

First, download a SVN package; e.g. Tortoise SVN.

For Windows platforms, install the downloaded installer.

Allow execution of it, when your pc is guarded by a firewall.

Accept the End-User License Agreement and continue to install it with all default settings or apply your custom set-up.

TortoiseSVN adds new icons to your folder icons, so for first time installations and some updates it is needed to restart your computer.

Create a new folder somewhere on your system, e.g. e107SVN

Right click on the new folder name and select 'SVN checkout'.

Fill in at the URL of repository for version 1.0 (0.7):

Fill in at the URL of repository for version 2.0 (0.8):

'NOTE: the information on is incorrect on this point!

From that moment on; you can update your SVN version by right clicking on the folder, and select option 'SVN Update'

Get SVN on Linux

Go into the folder that you want to run your website from and enter the command:

svn checkout .

This will download the most recent revision to your computer. If you want to update to a newer revision, just type

svn update

</div> |}