Contributing

Do you have something you'd like to contribute to Virtualmin, Cloudmin, Webmin, or Usermin? Great! You can use the following as a guide for how to contribute.

Documentation

If you have a new document, or a change to an existing document, the best way to get that to us is to open a new support request using the "Support" link above, and submit it there.

If it's a new document, you can attach your document as a text file.

If you have some changes to an existing document, you can either attach the changes as a text file, or just include your changes as part of the message body.

Code

To contribute to Webmin, Usermin, or any of our plugins, you can find us on github! Currently nearly everything we develop (except Virtualmin Pro virtual-server module and Cloudmin Pro server-manager module) are developed in public GitHub repositories.


You can fork our projects and issue pull requests.

If you would like to contribute code to Virtualmin Pro or Cloudmin Pro the best way to get that to us is by attaching a patch to a request in the support tracker.

To make a patch, you'd first want to be sure that you have a copy of the original code, in addition to the new code that you've created.

Then, you can use the 'diff' command to create a patch. You can use syntax such as this to create a patch against a single file:

diff -u new_file.pl old_file.pl > my.patch

If you have multiple changed files, you can generate a patch against a series of files and directories by using the following:

diff -ur new_directory old_directory > my.patch

Obtaining the Source

If you performed the installation using the virtualmin-install.sh script, you will find the source code in /usr/libexec/webmin or /usr/share/webmin.