<Logtabel met mijn taken en de uren die ik gespendeerd heb aan deze taken>.
Dag 1 (26 maart)

De eerste job van de week was het uitleggen van de despat Meertaligheid die ik in het begin van mijn stage geschreven heb. Zo moest ik tonen wat het systeem allemaal kan, waar bepaalde functies gevonden kunnen worden enzovoort.

Eens dat ik alles had uitgelegd kon ik mijn taak van vorige vrijdag verder zetten. Zie Weekoverzicht 7 voor meer info.

Dag 2&3 (27 maart)

Deze 2 dagen heb ik mij bezig gehouden met het verder verbeteren van de PDF-export en ervoor gezorgd dat de PDF-export kan gebruikt worden op de despat-site.

Eens al deze dingen in orde waren en de PDF-export dus volledig online stond moest ik ervoor zorgen dat de PDF-file hetzelfde formaat, kleur, … zou krijgen als de despat-website. Aangezien CSS-styles niet worden overgenomen in de PDF, moesten we de styling doen aan de hand van een XSL-file.

Dag 4 (28 maart)

Met nog 2 dagen te gaan kreeg ik een nieuwe job toegewezen. Deze bestond erin ervoor te zorgen dat een versie kan toegekend worden aan de despat-applicatie. Dit betekent dus dat een klant een bepaalde versie van de despat-applicatie kan aankopen, en ze dus ook kunnen controleren of er een nieuwere versie beschikbaar is.

Dit systeem is in principe heel systeem. Men krijgt de keuze om ofwel een nieuwe major (bijv van 1.5 naar 2.0) versie ofwel een nieuwe minor (bijv van 1.6 naar 1.7) versie aan te maken. Als er een nieuwe versie wordt aangemaakt, gaat het systeem alle artikels aflopen en de recentste versie van het artikel opslaan in de database onder de nieuwe despat-versie.

Dag 5 (30 maart)

Normaal gezien moest deze dag een vrij rustige dag worden. Er werd van ons verwacht dat we alle aanpassingen, applicaties, … die we tijdens onze stage hebben gemaakt documenteerden.

Maar in de loop van de voormiddag kreeg ik een telefoontje van David die nog enkele opmerkingen had in verband met een paar van de export-functie’s van de despat-website. Al een geluk waren het maar kleine aanpassingen en had ik ze klaar voor het einde van onze laatste werkdag.

Dag 1 (19 maart)

Deze dag bestond mijn taak erin het overzetten van een website naar een Joomla-platform. Dit heb ik vorige week reeds uitgebreid besproken, dus voor meer info zie “Weekoverzicht Week 6″.

Dag 2 (20 maart)

Normaal gezien zou ik mij ook hebben bezig gehouden met het porten van de website naar Joomla, maar doordat ik contact heb gehad met de ontwikkelaar van de PDF-export. Deze had nog een paar opmerkingen en tips om errors te voorkomen. Opdat ik hem zo snel mogelijk een antwoord kon geven over het feit of zijn opmerkingen effect hadden, heb ik dit zou snel mogelijk toe gepast.

Het heeft wel wat tijd gekost en er werden een deel mails heen en weer gestuurd, maar uiteindelijk ben ik er toch in geslaagd om de grootste errors te elimineren.

Dag 3&4 (21-22 maart)

Aangezien de grootste problemen met de PDF-export van de baan waren, kon ik terug verder werken aan het porten van de website naar Joomla. Wederom zie “Weekoverzicht Week 6″ voor meer info.

Dag 5 (23 maart)

Nu de porting van de website naar Joomla in theorie voltooid zou moeten zijn, stond mij een andere taak te wachten.

Een tijdje geleden heb ik jullie verteld over een applicatie die het gemakkelijker zou maken om screenshots te nemen van webpagina’s. Zie “Weekoverzicht Week 5 – Dag 4″ voor meer info. Blijkbaar ging deze applicatie nog niet ver genoeg. De applicatie moest volledig automatisch kunnen lopen. Dus heb ik een paar aanpassingen gemaakt. Zo worden nu ook de X en Y coördinaten in de XM-file bijgehouden.

Tevens heb ik een applicatie ontwikkeld die het gemakkelijker zou maken om een XML-file aan te maken voor mijn screenshot applicatie. In principe is de interface gelijkaardig aan die van de screenshot applicatie. Je krijgt eerst een scherm zoals hieronder wordt afgebeeld:

Hier kan je verschillende instellingen aanpassen. Zo kan je kiezen uit welke folder hij de HTML-files zal tonen en naar welke XML-file je wil schrijven. Tevens heb je de mogelijkheid om een nieuwe XML-file te starten, of een reeds bestaande XML-file aan te vullen.

Eens de applicatie start zal hij de input-folder scannen op HTML-files en deze weergeven.

Daarna zal volgende interface verschijnen:

Je kan deze kader verplaatsen en herschalen totdat het gebied waarvan je een screenshot wil nemen, zich in de kader bevindt. Eens je tevreden bent met de positie en grootte klik je op “Capture It”. Dit zal volgende interface openen:

Zoals je ziet worden de hoogte, breedte en de X- en Y-coördinaten vanzelf ingevuld. Hier kan je vervolgens de naam van de output file ingeven. Dit is de naam die zal gegeven worden aan de screenshot (bijv. address.jpg) .

Het is al een tijdje geleden dat ik nog iets geplaatst heb, dus het wordt hoog tijd dat ik jullie eens een update bezorg in verband met mijn stage.

De 6de week van onze stage zit er reeds op. Dit wil dus zeggen dat we nog 2 weken te gaan hebben en dat de welverdiende vakantie steeds maar dichter en dichter komt.

Waar heb ik mij nu de laatste week mee bezig gehouden? Wel, hierin kan ik heel kort zijn: Joomla.

Wat is Joomla?

DutchJoomla geeft volgende definitie voor Joomla

Joomla! is één van de meest krachtige Open Source Content Management Systemen op deze planeet. Het wordt over de hele wereld gebruikt voor alles van een simpele website tot complexe bedrijfsapplicaties. Joomla! is eenvoudig te installeren, simpel te beheren en betrouwbaar.

Allereerst en boven alles, is Joomla! een Content Management Systeem (CMS). Het is de motor achter je website die het makkelijk maakt content aan te maken, aan te passen, te beheren en te delen.

Het doel van het Joomla! project is om tegemoet te komen aan de eisen die weergegeven staan in bovenstaand artikel. Elke dag in de ontwikkeling van Joomla! komen we dichter en dichter bij ons einddoel, terwijl tegelijkertijd een solide basis gebouwd wordt welke uitgebreid kan worden door extenties van derden. In de handen van de ontwikkelaars maakt dit Joomla! tot een krachtig platform voor een breed scala aan Internet applicaties die veel verder gaan dan het simpel aanmaken van content.

Onze opdracht?

Onze opdracht bestaat erin het overzetten van een bepaalde website naar het Joomla platform. Dit lijkt allemaal vrij simpel, maar het is alles behalve dat als je het CMS niet gewend bent. Het neemt al bijna een dag in beslag voor je een beetje een gedacht hebt van tot wat de Joomla interface in staat is.

Static Content

Nadat we een beetje bekend waren geraakt met het Joomla CMS, konden we beginnen met het toevoegen van statische informatie. Aangezien dit pagina’s zijn die normaal gezien weinig tot nooit veranderen, was dit een vrij eenvoudig proces. Je maakt gewoon een nieuw artikel aan, je geeft het een naam en je kan beginnen typen.

Dynamic Content – Nieuws

Het is van zodra je met dynamic content begint dat het lastiger begint te worden. Zo moest er eerst een pagina worden gemaakt waarop alle nieuws pagina’s worden weergegeven met paginering. Al een geluk zit paginering standaard in het Joomla CMS en hadden we op dat gebied dus niet veel werk.

Vervolgens moest er een 2de pagina worden gemaakt, die op de homepage zou getoond worden, die de 5 recentste nieuws artikels bevat + een link naar de nieuws pagina.

Dynamic Content Guestbook

De 2de dynamische pagina die op de website zal komen, is een guestbook. Op het net zijn er genoeg Components te vinden voor Joomla die deze functionaliteit bieden voor Joomla, maar geen van die Components leken te werken voor onze versie. En we vonden ook geen guestbook die gebruik maakt van de anti-SPAM functie die wij wensten. Meeste guestbooks werken met een CAPTCHA ( Completely Automated Public Turing test to tell Computers and Humans Apart). Dit is iets waar we allemaal al wel eens mee in contact zijn gekomen. Als je je bijvoorbeeld registreert op een forum moet je soms een code overtypen uit een afbeelding om SPAM te voorkomen.

Een voorbeeld van CAPTCHA-images

Maar aangezien we hier bij Internet Architects streven naar een gebruiksvriendelijke en toegankelijke website, is een CAPTCHA geen goede optie. Dus moesten we een andere manier zoeken om op SPAM te filteren. De manier die we uiteindelijk bedacht hebben is gebruik maken van een Blacklist met SPAM messages in.

In het begin zal deze blacklist natuurlijk niet echt efficiënt werken, maar des te meer de gebruiker zijn guestbook gaat gebruiken, des te beter dat de blacklist gaat worden. Telkens als een gebruiker een SPAM bericht opmerkt in zijn guestbook, kan hij dit in de Admin-interface als SPAM flaggen. Het bericht wordt dan naar de SPAM folder verplaatst en kan dan gemakkelijk verwijderd worden. Als een andere gebruiker nu hetzelfde bericht plaatst, zal dit direct als SPAM geflagged worden en naar de SPAM-folder verplaatst worden.

Dag 2 (6 maart)
Voor de verandering moest ik op deze dag niet richting Antwerpen, maar wel richting Mechelen. Omdat op deze dag de Terugkomdag werd georganiseerd door de KHM. Het begon met een evaluatie over hoe onze stage verloopt, dit konden we dan vergelijken met de impressie die onze stagementor heeft. Ik had een positieve evaluatie en was dus heel tevreden. Na de evaluatie volgden 2 presentaties van Ex-IMS’ers.
Na de presentaties kregen we de mogelijkheid om de jobbeurs in de Nekkerhal te bezoeken, dit hebben we dan ook gedaan. We hebben daar dan een tijdje rond gelopen, met paar bedrijven gepraat.

Dag 3 (7 maart)
Voor deze dag hadden we een mail ontvangen met verschillende opdrachten.
De eerste opdracht waar ik mij mee bezig heb gehouden was het aanpassen van de XHTML export voor de PDF generator. In de mail stonden allerlei instructies om ervoor te zorgen dat de XHTML pagina wordt aanvaard door de generator. Tegen het einde van de dag had ik zo goed als alle errors eruit gehaald. Maar aangezien je met input van een gebruiker werkt, is het lastig om de code volledig XHTML valid te maken. De paar fouten die er nog in zaten waren blijkbaar te wijten aan de PDF generator. Ik heb hierover een mail gestuurd naar de ontwikkelaars van deze applicatie. Aangezien ik moest wachten op een reply zat mijn werk aan deze export functie er tijdelijk op.

Dag 4 (8 maart)
Aangezien ik nog geen antwoord had ontvangen ivm de PDF generator ging ik maar over naar de volgende opdracht. Deze bestond erin om een applicatie te maken die het nemen van screenshots van de despat applicatie zou vergemakkelijken en versnellen.
Dit heb ik opgelost door eerst een XML file aan te maken met de naam van alle te nemen screenshots. Deze XML bevat de volgende gegevens: Naam van de design pattern waar een screen van moet genomen worden, beschrijving van het onderdeel van de design pattern, standaard hoogte en breedte van de screenshot, bronbestand met de XHTML layout en ten slotte de bestandsnaam van de screenshot.

Als het programma nu gestart wordt, zal hij de XML doorlopen en per screenshot de interface tonen. De interface bestaat uit een formulier met een browser in (om het bronbestand te openen) en uit een formulier dat er bovenop ligt. Dit bovenliggend formulier bevat een kader die zal aanduiden waar de screenshot genomen wordt en een knop om de eigenlijke screenshot te nemen. Telkens je naar de volgende screenshot gaat, zal het capture venster worden aangepast naar de standaard breedte en hoogte gedefiniëerd in de XML-file. Maar je hebt de mogelijkheid om in de interface het capture venster te verplaatsen en te vergroten of te verkleinen.
Hieronder zie je een voorbeeld van het capture venster over de website van google:

Dag 5 (9 maart)
Op de laatste dag van de week heb ik nog de laatste aanpassingen gemaakt aan mijn screenshot applicatie. Dankzij deze applicatie is het nu mogelijk om screenshots te nemen van design patterns in slechts enkele seconden.
Voor de rest van de dag heb ik Jonas geholpen met de porting van een website naar Joomla.

Vandaag was David even aanwezig op het bureau, maar aangezien hij ’s middags naar Brussel moest, heb ik geen tijd gehad om hem vragen te stellen over de meertaligheid. Dit zal dan moeten worden uitgesteld tot woensdag (aangezien het morgen de “terugkeerdag” is en we dus niet moeten gaan werken). Maar David had nog wel juist tijd genoeg om mij een andere opdracht te geven: er moesten views aangemaakt worden. Eerst kon ik niet direct volgen wat er daarmee bedoeld werd, maar na een kleine demonstratie werd alles glashelder.

De design patterns zijn samengesteld uit ongeveer 9 blokken tekst, elke blok bevat specifieke informatie rond een bepaald gebied (technische info, …). De bedoeling is dus dat een gebruiker in een interface kan kiezen welke blokken tekst hij wil laten weergeven wanneer hij een artikel bekijkt. Zo worden blokken die informatie bevatten die niet van toepassing zijn voor hem verborgen en krijgt hij dus geen informatie die hij niet nodig heeft.

Ook heb ik ervoor gezorgd dat in deze zelfde interface, de gebruikers kunnen instellen wat de standaard taal is waarin ze op de despat applicatie willen surfen. Van zodra ze inloggen zal de taal dus ingesteld worden op hun standaard taal en zien ze alle artikels direct in de taal die ze gekozen hebben.

Dag 2 (27 februari) <lees meer>
Deze dag heb ik mij grotendeels bezig gehouden met het debuggen van 2 applicaties waar ik mee bezig ben. Enerzijds moest ik een paar kleine aanpassingen maken aan de export-functie die ik op Dag 1 heb gemaakt en anderzijds moesten er nog een paar bugs gehaald worden uit de scripts die ik al had geschreven voor de meertaligheidsfunctie.

Dag 3-4-5 (28 februari, 1-2 maart <lees meer>
De laatste 3 dagen van deze week heb ik mij gewijd aan de meertaligheid van de despat. Het is een langdurig proces maar het is dan ook een ingewikkelde functionaliteit. De meertaligheid zit in bijna elke interface van de despat ingewerkt. Zo moet je artikels en versies in verschillende talen kunnen beheren.

Ook heb ik een interface geschreven die kan gebruikt worden om te checken welke artikels nog vertaald moeten worden naar welke taal.

Vrijdag was de meertaligheidsfunctie in theorie af, maar dat zullen we pas weten na een uitgebreide testsessie die volgende week zal plaatsvinden.

Export
Ik had gisteren nog een mail ontvangen met een kleine aanpassing die moest gebeuren op de export-functie die ik maandag heb geschreven. Er moest met name een andere Print-CSS op gezet worden. Dit was op een minuutje gefixed en dus kon ik snel aan mijn andere jobs zetten.

Meertaligheid
Ook vandaag ben ik bezig geweest met de meertaligheidsfunctie van de despat-applicatie. Het is een langdurig proces maar het is dan ook een ingewikkelde functionaliteit. De meertaligheid zit in bijna elke interface van de despat ingewerkt. Zo moet je artikels en versies in verschillende talen kunnen beheren.

Het programmeren van de meertaligheid vlot vrij goed, maar in de namiddag heb ik wat tijd gemaakt voor een extensie van de meertaligheid. Een interface die zal weergeven welke artikels er nog naar welke talen moeten vertaald worden.

Despat meertaligheid
Mijn eerste actie van de dag was het fixen van een paar bugs in het vertaal-systeem van de despat applictie. Doordat het kleine bugs betrof, was dit werk vrij snel voltooid.
Als een gebruiker (met voldoende rechten) een artikel raadpleegt, zal hij vanboven een link zien verschijnen die hem de mogelijkheid biedt om het artikel te vertalen. Indien de gekozen versie van het artikel reeds vertaald is in alle mogelijke talen, zal de vertaal-link niet getoond worden.

In de vertaal-interface kan de gebruiker dan kiezen naar welke taal hij het artikel zal vertalen. De talen waarvoor reeds en vertaling aanwezig is zullen uit de keuzelijst worden gehaald aangezien het verloren tijd zou zijn om een artikel 2 maal te vertalen in de zelfde taal.

Html export per sectie
Voor de rest van de dag heb ik mij bezig gehouden met het fixen van een aantal kleine bugs in de html export die ik gisteren geschreven heb. Ook had ik een paar aanwijzingen gekregen van Kathy en Marc ivm extra pagina’s en gegevens die nog bij in de export zouden moeten zoals onder andere een startpagina en een sitemap.

Deze export is gebaseerd op de PDF-export die ik een tijdje geleden heb geschreven. De PDF-export maakt van heel de despat applicatie 1 lange HTML-file. De nieuwe export moet een soortgelijke functionaliteit voorzien, maar dan met 1 lange HTML-file per hoofdonderdeel. De despat applicatie bestaat uit een stuk of 5 hoofdonderdelen die de navigatie vormen. De export gaat dus per onderdeel de actie uitvoeren die bij een PDF-export wordt uitgevoerd.

Het volgende dat in de export moest gebeuren was het vervangen van de links door links naar de statische html dump. De statische html dump is een functionaliteit geschreven door mijn stagepartner en exporteert heel de despat applicatie in een browsable formaat.
Om een voorbeeld te geven: design pattern 1 behoort tot algemene designpattern “Verzameling”. Als je dan vanuit mijn export functie wil linken naar pattern 1, zal je volgende link moeten gebruiken: http://www.mijnsite.be/Verzameling/pattern_1/index.html
Dit moet dus gedaan worden voor alle links in het document.
Sinds een paar dagen heb ik mijn werkplaats uitgebreid met een 20” Widescreen monitor, als je aan het programmeren bent merk je zeker het verschil tov een klein 15inch laptop schermpje.

Something I’d like to share
In de loop van mijn stage heb ik met een deel nieuwe en handige programma’s/plugins/add-ons leren werken. Één daarvan is Firebug. Firebug is een Add-on voor de allombekende browser Firefox.

Firebug is een applicatie die je toe laat om gemakkelijk de html en css code van je web-pagina te controleren op structuur, eventuele tags die niet zijn afgesloten en natuurlijk CSS. Zeker de CSS functionaliteit is handig, zo kan je bijv door op een element te klikken zien welke klasses er toegepast zijn op dit element, en welke eigenschappen worden overschreven door andere.

Bijv: je zet een font-weight: 700; op een h2 tag, maar toch wil hij dit niet doen. Dan kan je in Firebug gaan zien door wat die font-weight wordt overschreven (maw: prioriteiten checken).

Dag 1 (19 februari) <lees meer>
Deze dag heb ik verder gewerkt aan de Visio-to-xhtml applicatie. Naar aanleiding van een paar opmerkingen van David heb ik een paar aanpassingen gemaakt. De volledige bespreking van de aanpassingen vind je bij het dagverslag van 19 februari.

Dag 2 (20 februari) <lees meer>
De 2de dag van de week is het eerste werk verricht met betrekking tot het meertalig maken van de despat applicatie. We hadden hier reeds een brainstorm sessie rond gehad, dus het werd tijd om die voorstellen en ideeën om te zetten in praktijk.

Dag 3-4 (21-22 februari) <lees meer>
Het werk aan de meertaligheid zette zich voort. Ik moest ervoor zorgen dat het voor de gebruiker duidelijk is wanneer een artikel niet beschikbaar is in zijn taal of wanneer het artikel eventueel outdated zou kunnen zijn. Hiervoor werden meldingen ontwikkeld die de gebruiker daarvan op de hoogte stellen:


Ze geven ook een link naar de up-to-date versie van het artikel, of in het geval van het niet beschikbaar zijn in de gekozen taal, zal er een lijst met alternatieve talen getoond worden.

Dag 5 (23 februari) <lees meer>
Ook op deze dag heb ik verder gewerkt aan de meertaligheidsmogelijkheid van de despat applicatie. Voor vandaag stond het ontwikkelen van de vertaalpagina op het menu. Deze bestaat uit een keuzemenu waar de gebruiker de taal van de vertaling kan selecteren en uit een reeks tekstboxen. Elke tekstbox bevat 2 tekstvakken (1 met originele tekst en 1 met de vertaalde tekst) zodat de gebruiker de te vertalen tekst direct kan raadplegen.