Zikula Community

Submitting your project

You have written up a really cool module that is serving your needs nicely and you think others may want to use it. First, thank you for sharing, this type of generosity is what makes open source work so well! Before you can become a Zikula developer, you first need to decide where you will release your code. There are two areas where the code is shared, at the cozi (Zikula code) and at the extdb. What is explained here is how to get yourself up and running in the cozi. The cozi is an svn repository of php code that has been written for Zikula. Hopefully at a later time, how to publish in the extdb will be explained also. They are not mutually exclusive.

Importing your project to the cozi

1. First get yourself added as a active developer. This can be achieved by posting to the Forum in the Modules development forum. Chris (aka slam at the Zikula forum) will probably get you set up or one of the other Zikula gods.
2. Get your project in a working condition. This really is not a requirement, but it is at least nice to have a working alpha version before you throw it in the svn repository.
3. If you are using NetBeans? IDE, do the following
4. Create a new project in the IDE that only contains the code you are adding. For example, if you are working on the Teleport module, created a new project with only the Teleport module code in it. I will use the Teleport name as an example through the rest of this tutorial.
5. Once the project is created, while in the NetBeans? IDE right click on the project in the projects window and choose Versioning > Import into Subversion Repository.
6. A svn wizard will come up. Specify the location of the repository such that it points at your module path within the repository. You can figure this out by looking in the cozi at your project page∞. When you look at that project page, near the bottom you will see a svn link such as this. https://code.zikula.org/svn/Teleport/trunk∞

1. Make the repository path https://code.zikula.org/svn/Teleport∞
2. Enter your username and password for the cozi in the User: and Password: fields
3. You may want to click the Save Username and Password checkbox. Then click next.
4. In the next dialog, the Repository Folder dialog, click on the Browse button for the Repository Folder text field and a view of your repository for your module should come up. Normally it is a good idea to put your projects in the trunk folder, using the following path trunk/modules/Teleport. Of course where you put it all depends upon what you are doing.
5. You will need to create the modules and Teleport folders using the Into a new folder button.
6. Write a message in the Specify a Message text field, something like Initial Import. Then click the next button.
7. Your files should be imported into the repository. Finally click finish and you are done.

Just a reminder, I used the Teleport name as an example project name. You should substitute your project name for Teleport when you perform this action.