How to help KyaPanel

Here we related some ways that you can help KyaPanel project. This is important because there is many ways to do this. So take a look and choose your favorite way.

See each topic description to know more and remember you don’t have to ask authorization to do any of those jobs, after all KyaPanel is a GPL software and you are free to start wright now.

Spreading

An easy way to help is spreading out the KyaPanel in all possible ways. You can:

  • Talk about KyaPanel with your freinds that work with IT. Do not forget your boss or your teachers and friends;
  • Submit speeches about KyaPanel in IT congresses all around the world;
  • Organize KyaPanel presentations in your work, university or in any nerds barbecue that you are going :-)
  • Organize a campaign to collect founds to make “regular propaganda” in the regular media, like news paper or TV;
  • Buy and use the KyaPanel T-shirts;
  • Send nice messages to the discussions lists that you are subscribed. In fact this discussions lists don’t have to be about IT, just don’d forget to use [OFF-TOPIC] term in front of the subject.

Development

KyaPanel is developed in two very simple programing languages:

  • PHP;
  • and Shell Script.

Why? Just because they are very easy! So any one, even without to much expertise can have access to all Free Software freedoms.

* Programing Languages

Each language has it’s own objective in KyaPanel:

  • PHP on interface

All the KyaPanel interface is developed in PHP. So the layout and all the core links are very easily madded. Here is where we need more help.

      Problem

HTML code is mixed with the PHP code, so KyaPanel doesn’t have support to templates yet. Unhappyly we started the project many years ago in this wrong way and because the low number of contributors and the biggest requests for new features we couldn’t fix this already.

  • Core and Daemon in Shell Script

The system core is developed in Shell Script organized in directories for the main core and each module core.

Today KyaPanel has two modules: E-mail Management and Samba Management

So if you are fluent in one of those languages and want to help let us know.

  • Database

Today KyaPanel uses OpenLDAP or SQL as users and domains database.

So if you are fluent in one of those databases and want to help let us know.

  • Modeling and Programming Documentation

This documents wasn’t done already.

Testing

Become a KyaPanel tester. This is a very important job for the project. Test new versions before it get published to the public. This can prevent serious system errors happen in the users machines.

The tester must have a computer or virtual machine and a lot of patience to always install a compatible Gnu/Linux distribution with KyaPanel from scratch, and then proceed with KyaPanel installation to test everything.

To become a tester you must be a patient person, be methodical and write well to report the errors in a productive way.

Any error report must be described using the Trac tool available in https://projetos.ossystems.com.br/kyapanel/newticket

This reports mus be written in english.

Documentation

Help others to know how to use and install KyaPanel.

KyaPanel documentation is quite developed, but it is in Portuguese. So if you want to write the documentation in English go ahead!

To write new documents or modify the existing ones you must to subscribe yourself in the wiki. In the subscribe form use a valid e-mail address, your password will be sent to this address.

To subscribe clink in the link below:

http://www.kyapanel.net/wiki/doku.php?id=kyapanel&do=register

All documentation are available in this wiki, just take a look in the wright menu.

If you have writing skills and want to help the project and it’s users see this major topics:

  • Install Guide

This is the first guide, so if find any error on it or just want to make any part of it more explicit just do it.

  • User Guide

This contain all the end users interface options description.

  • Troubleshooting

In this we describe the known problems and bugs whit it’s solutions.

  • New documentation

The KyaPanel is always growing so it’s documentation too. So if you want to write any new document from scratch do it and let us know.

Translation

The world wants to know KyaPanel and you can help translating it.

If you know any other language, even any dialect from China, help to translate KyaPanel.

This is the kind of help that any one can do. It’s don’t require any IT skills, just understand the Free Software principals and hant to help.

KyaPanel have support to i18n normalization, that’s uses gettext to do it. Don’t be afraid with all this technical stuff it’s very easy to translate or fix any existent translation.

It’s very simple:

  • Translation to a new language

  1. Download KyaPanel tar.gz file in http://www.kyapanel.net
  2. Open your favorite terminal
  3. Untar the file with the command: tar -zxvf kyapanel-XXXX.tar.gz
  4. Get into po/ directory with command: cd po
  5. Run getpo script, like this: ./getpo

Done! the jegue.po file has all KyaPanel text that need to be translated. Just edit it with your favorite text editor and start!

You will see lines that starts with msgid, this is the original text extracted from the KyaPanel files. The translation must be written in the line below that starts with msgstr.

When all translation has be done sent it to anahuac@anahuac.biz

  • Fixing an existing translation

The translations files for each language are in a gettext predefined directories structure. Like this:

locale/en/LC_MESSAGES/

Where:

locale is the root language directory;

en is the main language (Ex: es = Spanish, pt = Portuguese, etc)

LC_MESSAGES is where the translated files are, the compiled and the textual one.

So in the sub directory LC_MESSAGES of each translated language you will find two files: jegue.po and jegue.mo

The jegue.mo file is the compiled one and it’s can’t be modified directly . To change or fix the translation folow this steps:


  1. Edit jegue.po file
  2. Do your changes and save it
  3. Run this command: msgfmt -o jegue.mo jegue.po
  4. Sent an message to anahuac@anahuac.biz with both files.

Donations

Any Free Software project survives from the related services to the developed product. But also from donations.

If you want to help KyaPanel but don’t want to do any job, make some financial donation to the project. In many cases this is the most helpfully way.

There is two places here you can make your donation to KyaPanel:

  • BRPay

BrPay is the brazilian PayPal version. The biggest advantage for the project is that we can use the money in Brazil.

To do your donation using this site, click in the link below:

      www.brpay.com.br_security_imagens_btndoacao.jpg

  • PayPal

PayPal is the biggest and more famous payments site in the world. If you feel more comfortable using it, please click in the link below.

     

Graphical Art

This is a very specialized work. Unfortunately the KyaPanel team don’t have any expert in it.

If you are an Webdesigner, good with images and want to help, please contact us.

kyapanel/how_to_help_en.txt · Last modified: 2008/05/07 06:06
Recent changes RSS feed Creative Commons License Donate Driven by DokuWiki