Bijdragen aan EekBoek

U kunt uw eigen ervaringen delen met de andere gebruikers door handige tips en technieken op deze wiki te plaatsen. 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.
• Gebruikstips en workarounds kunnen het beste worden geplaatst op Gebruikstips.
• 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, kortweg gezegd: +/- is goed, >/< is slecht;
• 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. Deze paragraaf behandelt de coding conventions voor Eekboek.

Variables

$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

Functions

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

SQL

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.

Vertalingen

EekBoek is in het nederlands geschreven, dat wil zeggen dat de termen op het scherm nederlandstalig zijn. U kunt EekBoek gebruiken in een taal van uw keuze. Zo is er bijvoorbeeld al een engelstalige versie. Voor het bijdragen aan vertalingen, kijk op de pagina Vertalingen.

Testen

Tijdens de installatie van EekBoek wordt een zogenaamde installatie verificatie procedure (ivp) uitgevoerd. Hoewel deze test technisch van aard is, wordt er ook een aantal functionele zaken getest, zoals het opvoeren van boekingen en het rapporteren van balansen en resultaatrekeningen. In principe wordt voor iedere nieuwe functionaliteit een nieuwe test toegevoegd, zodat de applicatie alle bestaande en nieuwe functionaliteit correct ondersteund. Voor meer over hoe bij te dragen aan de testen van EekBoek, kijk op de pagina Testen.