Contributing a Module with TortoiseCVS

This article is largely taken from http://drupal.org/node/112902. The following is essentially a walk-through focusing on the actual process involved when submitting modules to Drupal.org using TortoiseCVS. This is by no means a detailed CVS guide and I am not a CVS expert.

It is highly recommended that you read the detailed CVS instructions in the Drupal Handbook at some point. This guide is for Windows users and a CVS client is used, so you don't have to use command-line. There are decent instructions already available for Linux users. There is also a video available to help you out.

I also recommend that you familiarize yourself with the Drupal coding standards. I then suggest you download and install the Coder module for checking your application of the standards. [I now consider a Coder review a necessary step before committing changes.] Then it's always nice to at least lay the groundwork for translation of your module, so check out the Translation Template Extractor module. There will be more on this later.

The assumption is that a stable release will be submitted, meaning that the module has been tested thoroughly (preferably by others), the PHP code has been checked for security vulnerabilities, the CSS has been validated etc, and the module is ready to share with the Drupal community. Also make sure you have decided on the directory structure for your module. Renaming files in CVS is hard, and moving around directories is really hard (without the help of the extremely busy CVS admins). If you have your directories structured and files named how you want them before your first CVS commit, you will save yourself (and those busy admins) a ton of grief.

Adding a module to Drupal CVS

1. First you will need to apply for a CVS account with Drupal.org and CVS service not blocking by your firewall (CVS port number is 2401).
2. After you have installed TortoiseCVS, browse to the folder that contains all of the files for your module. The commands for TortoiseCVS are accessed via the context menu when you right-click on a folder.
3. Right-click the folder for your module. Select CVS > Make New Module. Make sure that Password server (:pserver:) is selected for Protocol:. For CVSROOT: copy and paste or type the following line, replacing "username" with your username for your CVS account with Drupal (note: username is case-sensitive).
:pserver:username@cvs.drupal.org:/cvs/drupal-contrib
4. For the Module: field, copy and paste or type in the following line replacing "modulename" with the name of your module. This should match the name of the folder which contains your module files:
contributions/modules/modulename

Press OK. TortoiseCVS will do its thing and should report that the operation was successful. This has created a directory in Drupal CVS to contain the files for your module. You can verify that the directory was created by visiting the Index of contributions.

5. Time to add the files. Right-click on the module folder again and select CVS Add Contents. All of the files in your module folder will be selected automatically. Press OK.
6. Now the files have to be committed. Open the folder for your module. You will see orange plus signs on all of the files indicating that they have been added. Select these files, right-click and choose CVS Commit. In the Comment field, add something like "Initial Release for Drupal 5.0" and press OK. If your module folder contains sub-folders i.e. "/images" etc. you may need to repeat this procedure for all of the files in each sub-folder since the commit command is not always recursive.

When this is complete, the module has been registered on Drupal CVS.

Creating a project for your module on Drupal.org

7. It is now time to add your project on Drupal.org. Login to your account. Click on Create content > Project. Most of the fields on the Submit project form should be self-explanatory. The Short project name should match the name of the folder that contains your module files. For CVS tree, use the following URL and replace "modulename" with the short project name you entered earlier:
http://cvs.drupal.org/viewcvs/drupal/contributions/modules/modulename

After everything applicable has been filled in, click Submit. Don't worry, you can come back and fill in missing details later.



8. You now need to return to CVS to create a CVS tag for the specific version of the module you are releasing. This helps to keep track of different releases. Since this is the initial stable release you will start with 1.0. Use one of the following tags below depending on the version of Drupal:
   
   DRUPAL-6--1-0
DRUPAL-5--1-0
DRUPAL-4-7--1-0
9. Now to add the release that was uploaded to CVS earlier. This is an easy step to forget, but don't or you will have wasted all your time. Click the Add new release link for your project - the one on the project page (the "create content » release" doesn't do it). Select the appropriate CVS identifier. The next screen is fairly self-explanatory. Click Submit.

That's it! Whew! Now your module is officially managed through Drupal CVS and included as a project on Drupal.org. If you want to add a screenshot, first read the Theme screenshot guidelines. You will need to Submit an issue with the Drupal.org webmasters in order to have your screenshot added.

So there you have it. Ten "easy" steps to add your module to Drupal. Perhaps not that easy, but it is to be expected that there will be some tedious procedures to deal with in order to keep the quality of contributions high while maintaining a community effort like Drupal. Hopefully this has been informative and will save some time and headache for people who aren't familiar with CVS but would like to contribute a Drupal module. Again, it is recommended that you read through the Drupal handbook so that you have a more complete understanding of CVS; here is a good place to start.