Bijdragen aan EekBoek

Tips en technieken

U kunt uw eigen ervaringen delen met de andere gebruikers door handige tips en technieken op deze wiki te plaatsen.

Publiciteit

Laat weten wat u van EekBoek vindt, onder het motto “niet tevreden, zeg het ons -- wel tevreden, zeg het anderen”.

Schema's en administratie-sjablonen

Sinds versie 2 kunnen automatisch administraties worden aangemaakt aan de hand van sjablonen. Een bibliotheekje van sjablonen waarmee startende gebruikers kunnen beginnen zou waardevol zijn. Als u een specifieke administratie heeft opgezet die wellicht ook voor anderen bruikbaar zou zijn, laat dat dan even weten op de mailing list.

Aanpassingen en uitbreidingen aan de programma's

EekBoek is een open source programma. De EekBoek-licentie is GPL, wat er in het kort op neer komt dat de broncode volledig vrij is en u er mee kan doen wat u zelf wilt, zolang u niemand anders belemmert om hetzelfde te doen wat u heeft gedaan.

Als u zelf aanpassingen heeft gemaakt is het natuurlijk fijn om deze ook weer terug te geven aan de EekBoek community, want dan kunnen anderen er ook van profiteren.

Gevonden problemen en gewenste uitbreidingen kunt u aanmelden bij de trackers zodat we allemaal weten wat er speelt. Gebruik de eekboek-devel mailing list (niet eekboek-users) om deze te bespreken.

Voor het aanleveren van patches gelieve het volgende in acht te nemen:

• 'unidiff' is het geprefereerde formaat;
• geef aan op welke versie de patch is gebaseerd;
• geef een korte beschrijving van wat de patch doet of welk probleem (tracker nummer) de patch oplost.

Indien mogelijk patches graag vergezellen van een test case. In de t/ directory van de EekBoek source kit zit een aantal tests als voorbeeld en ter inspiratie.

Omdat veel aspecten van een boekhoudkundig proces moeilijk te vangen zijn in simpele test cases zijn losse tests niet altijd mogelijk. De geïntegreerde functionaliteit wordt getest in de ivp (installatie-verificatie procedure) tests. Deze tests kunnen dan worden uitgebreid om ook de nieuwe functionaliteit mee te nemen.

Coding conventions

Coding conventions zijn regels die programmeurs hanteren om de code beter leesbaar en beter onderhoudbaar te maken. Voor Eekboek wordt met de volgende coding conventions gewerkt:

# $data =
#   { %$data,
#     author          => 'Johan Vromans (jvromans@squirrel.nl)',
#     abstract        => 'Elementary Bookkeeping (for the Dutch/European market)',

• Variabele namen zijn in lowercase
• Opening brace ({) van een variabele staat op de volgende regel
• Indent is twee spaties
• De values van de key-value pairs zijn uitgelijnd

# sub vcopy {
#     my (%ctrl) = @_;

Voor functies, zoals de bovenstaande vcopy, gelden de volgende conventions:

• De opening brace ({) staat op dezelfde regel als de functienaam
• De indent is 4 spaties

# my $sql = "SELECT * INTO TEMP TAccounts FROM Accounts WHERE acc_id = 0";

Voor SQL code dienen de reserved words, zoals SELECT, UPDATE, DELETE, FROM, WHERE, GROUP BY, ORDER BY etc, in uppercase te staan.