LINKBUILDINGTOOL. Technische Universiteit Delft Faculteit EWI. stageverslag BSc-project IN3405. Auteurs: Lennaert van den Brink #

Transcriptie

1 Technische Universiteit Delft Faculteit EWI stageverslag BSc-project IN3405 Auteurs: Lennaert van den Brink # Cees-Willem Hofstede # Begeleidend docent: Peter van Nieuwenhuizen Coördinator: Bert van Heerde 19 augustus 2010

2 Voorwoord Dit verslag is het resultaat van het BSc project van Lennaert van den Brink en Cees-Willem Hofstede. Het project, bestaande uit een bedrijfsstage, is volbracht bij webdesignbureau Insyde te Delft. Tussen 19 april en 8 juli 2010 is op het kantoor van Insyde gewerkt aan de linkbuildingtool. De insteek van de opdracht was het uitbreiden van deze tool met een betaalsysteem en extra features om zodoende de linkbuildingtool tot een extra inkomstenbron te maken. Hierbij is ons veel vrijheid geboden, zowel in implementatie keuzes als in werkwijze. Daarvan hebben wij dan ook dankbaar gebruik van gemaakt. Tijdens de stage werd besloten het linkbuildingproject binnen Insyde anders aan te pakken dan in eerste instantie gepland was. Ons eindproduct was niet meer een werkende website, die aan het eind van onze stage te vinden zou zijn op maar werd meer een showcase van mogelijke nieuwe functionaliteiten voor deze tool en andere projecten van Insyde. De reden hiervoor is dat men bij Insyde zo enthousiast was geworden van alle ideeën die tijdens deze stage naar boven kwamen, dat er besloten is om na de stage een volwaardig ontwikkeltraject te starten binnen het bedrijf. We vinden het natuurlijk jammer dat onze features niet direct online zijn geplaatst, maar zijn wel erg enthousiast over de komende nieuwe versie en kijken dan ook halsreikend uit naar de release van de nieuwe linkbuildingtool. Naar aanleiding van de stage is ons beiden gevraagd om verder te werken aan de linkbuildingtool. Momenteel wordt er gekeken wat hiervoor de mogelijkheden zijn. Tot slot willen wij de medewerkers van Insyde en onze stagebegeleider bedanken voor het beschikbaar stellen van alle tijd en middelen die benodigd waren in deze stage. Ook willen wij Drs. Peter van Nieuwenhuizen bedanken voor het begeleiden van dit project vanuit de TU delft. Wij kijken terug op een interessante en gezellige stage waarin wij een hoop ervaring hebben opgedaan. Lennaert van den Brink & Cees-Willem Hofstede i L. v.d. Brink

3 Samenvatting BSc project Probleemstelling Dit verslag is onderdeel van de stageopdracht van webdesignbureau Insyde te Delft. De stageopdracht betreft het ontwerpen en implementeren van een betaalsysteem en een uitbreiding van features voor de linkbuildingtool. Linkbuildingtool, te vinden op linkbuildingtoo.nl, is een webtool waarmee het linkbuilding proces georganiseerd kan worden. Linkbuilding is het verwerven van links naar de eigen website, met als doel hoger te komen in de resultaten van zoekmachines voor relevante zoekwoorden. De linkbuildingtool is vooralsnog een gratis te gebruiken tool, maar het snel groeiende aantal accounts heeft Insyde doen besluiten hiervoor een betaalde variant te maken. Beschrijving van de werkzaamheden Allereerst is binnen dit project geörienteerd op de wensen van de huidige gebruikers door middel van een gebruikersenquête en statistisch onderzoek. Ook is er gekeken naar concurrerende linkbuilding tools en opties voor betaalsystemen. Vervolgens is een lijst features en functionele eisen samengesteld. De features zijn verdeeld in prioriteitsklassen, daar het aantal te groot bleek voor volledige implementatie. Op basis van deze eisen is per feature met hoge prioriteit een ontwerp en implementatie gemaakt. Voor het betaalsysteem is gekozen om PayPal als betaalprovider te gebruiken vanwege de mogelijkheid om recurrente betalingen af te handelen en het feit dat Insyde reeds ervaring had met ideal implementaties. Voor features is er gekozen om import en export functionaliteiten te implementeren omdat deze veel verzocht werd door invullers van de enquête. Daarnaast is op verzoek van de specialist bij Insyde een keywordfunctionaliteit geïmplementeerd en is er een aanzet gemaakt voor het automatisch genereren van rapporten vanuit de tool. Bij het implementeren van dit project is gebruik gemaakt van de talen PHP, Javascript, AJAX en LaTeX. Resultaten en conclusies Een aantal features zou ingrijpende veranderingen inhouden in de structuur van de linkbuildingtool. Deze voerden te ver om binnen de stage aan te brengen. Echter, Insyde heeft besloten deze features wel te willen implementeren en zal derhalve na de stage een nieuw project beginnen om de tool volledig te herzien en deze features daarin vanaf het begin mee te nemen. Dit houdt in dat het eindproduct van de opdracht niet de lancering van een nieuwe versie van linkbuildingtool is geworden, maar een showcase van een aantal features binnen de huidige tool. Deze features zijn niet openbaar gemaakt, maar worden wel door de specialist binnen Insyde gebruikt tijdens het linkbuilden. Daarnaast is voor het schrijven van commentaar bij de code een systeem opgezet waarmee de code geautomatiseerd kan worden uitgelezen en geïntegreerd in de ontwikkelomgeving. Dit proces is door Insyde overgenomen en wordt nu gebruikt door de programmeurs. Het betaalsysteem wordt op het moment van schrijven uitgebreid om te worden toegepast in een nieuw project van Insyde. ii L. v.d. Brink

4 Verklarende woordenlijst BSc project Hieronder volgt een overzicht van de in dit document gebruikte termen, afkortingen en hun verklaring. account-dashboard Dit is een pagina van de linkbuildingtool waar ingelogde gebruikers de status van hun account kunnen bekijken en gegevens kunnen wijzigen. agile programmeermethode Ontwikkelingsmethode gebaseerd op het meerdere malen doorlopen van korte perioden. Deze perioden, iteraties genaamd, zijn in feite kleine projecten waarvan het eindresultaat een bruikbaar stuk code op te leveren. Na iedere iteratie wordt opnieuw afgewogen war de prioriteiten voor het gehele project zijn. De nadruk ligt op directe communicatie, wat tot gevolg heeft dat bij agile programmeermethoden doorgaans minder documentatie wordt gegenereerd. API Een verzameling definities op basis waarvan een computerprogramma kan communiceren met een ander programma of programma-onderdeel. De programmeur hoeft geen details van de functionaliteit of implementatie te kennen, maar weet dankzij de API wel hoe deze kan worden aangesproken. backlink Backlinks zijn inkomende links vanaf andere websites. CMS Content Management System. Wordt gebruikt om de inhoud van bijvoorbeeld een website te beheren. CSE IDE Google Custom Search Engine, een persoonlijke zoekmachine die gebruik maakt van de zoektechnieken van google. De beheerder van een CSE kan aangeven waar de CSE wel en niet in zoekt. Integrated Development Environment. Een ontwikkelomgeving waarin code kan worden geschreven, en direct kan worden gecompileerd en gedebuged. Bij Insyde wordt het IDE Eclipse gebruikt. Insyde Webdesignbureau te Delft. Tevens opdrachtgever. javascript Serverside scripttaal die het mogelijk maakt om samen te werken met de statische html en deze waar nodig aan te passen. jquery Een javascript bibliotheek die veelgebruikte javascript functionaliteiten combineert en makkelijk beschikbaar maakt. keyword Een keyword staat in het SEO jargon voor een woord waarvan de beheerder van een website graag ziet dat als er op dit woord gezocht wordt, de website zo goed mogelijk gevonden wordt. linkbuilding Het verwerven van links naar een website. Onderdeel van SEO. linkpartner Een website die naar de te optimaliseren website linked. Als wederdienst wordt vaak naar deze website terug gelinked. iii L. v.d. Brink

5 LMT Link Management Tool, het gedeelte van de LBT waarin de gebruiker links kan beheren. MoSCoW methode Methode om gewenste features te prioritiseren. De features worden, op volgorde van prioriteit, onderverdeeld in Must have, Should have, Could have, Wont have [?]. NVP Name Value Pair. Een paar bestaande uit de naam van een variabele en de bijbehorende waarde. PHP Hypertext Preprocessor, scripttaal origineel ontworpen voor het maken van dynamische websites. Tegenwoordig is PHP uitgegroeid tot een volwaardige programmeertaal die ook voor andere toepassingen (zoals het maken desktopapplicaties) gebruikt wordt. PSP Een Payment Service Provider, nodig om online betalingen te kunnen verwerken. SEO Search Engine Optimisation. Voor een website de kans zo groot mogelijk maken om gevonden te worden door bezoekers. shadowbox Wordt gebruikt om afbeeldingen, video s of webpagina s te laden in een frame dat bovenop de huidige pagina getoond wordt. Dit wordt veel gebruikt om vaak terugkerende taken makkelijk te tonen. SQL Structured Query Language, database taal om data te beheren in relationele databases. SVN SubVersioN versiebeheer. Wordt gebruikt voor versie beheer van code en verslagen. textarea HTML element, toont een vak waar tekst kan worden ingevoerd. token Een gecodeerde string die verzonden wordt naar een andere computer of server. Het bestaat binnen PayPal uit NVPs die doorgaans een methode en zijn argumenten coderen. tool Een stuk software (al dan niet online) waarmee een specefieke taak kan worden uitgevoerd. TOPDesk Service Management pakket. Wordt in dit project gebruikt bij de planning van activiteiten en taken. URL Uniform Resource Locator, het adres van een website. web-based Een applicatie is web-based wanneer hij niet gedownload hoeft te worden voor gebruik. Webmagiër Het CMS van Insyde. XML Een standaard voor de syntaxis van formele markuptalen waarmee men gestructureerde gegevens kan weergeven in de vorm van platte tekst. Deze representatie is zowel machineleesbaar als leesbaar voor de mens en kan worden gebruikt voor de opslag van gegevens of het versturen hiervan over internet. iv L. v.d. Brink

6 XP Staat voor extreme Programming. XP is een agile programmeermethode. Onderscheidende kenmerken zijn test-driven ontwikkeling en paarsgewijs programmeren. Ook zijn bij deze variant de iteraties doorgaans erg kort. v L. v.d. Brink

7 Inhoudsopgave BSc project Voorwoord Samenvatting Verklarende woordernlijst i ii iii I Introductie 1 1 Linkbuildingtool.nl 1 2 De opdracht 1 3 Projectinrichting 1 4 In dit verslag 2 II Oriëntatie 3 5 Gebruikersonderzoek 3 6 Concurrerende Linkbuilding Tools 5 7 Online Betaalsystemen 6 III Plan van Aanpak 7 8 Kwaliteitsborging 7 9 Planning 9 IV Design Randvoorwaarden Betaalsysteem Overige functionaliteiten Keywords CSV import CSV export Rapportage module V Implementatie betaalsysteem keywords tool CSV import CSV export 25 vi L. v.d. Brink

8 17 Rapportage module Skinnable selectfield 29 VI Na de Stage Conclusies Aanbevelingen 31 VII Referenties 32 VIII Appendices 33 A Oriëntatieverslag 33 B Plan van Aanpak 57 C Design Document 67 vii L. v.d. Brink

9 Deel I Introductie BSc project 1 Linkbuildingtool.nl Zoekmachines zijn voor veel mensen het startpunt van het internet. Na een zoekopdracht zal een gebruiker over het algemeen als eerste kijken naar het eerst gegeven resultaat. Mocht dit niet de pagina zijn die wordt gezocht, dan wordt het tweede resultaat bekeken, enzovoort. Website eigenaren hebben er dus baat bij dat hun website zo hoog mogelijk in de zoekresultaten eindigt bij de voor deze website relevante zoektermen (keywords). De kunst van het zo hoog mogelijk komen in de zoekresultaten wordt zoekmachineoptimalisatie genoemd (Engels: Search Engine Optimisation, afgekort met SEO). Een van de factoren die door zoekmachines gebruikt wordt om de volgorde te bepalen is het aantal relevante websites dat naar de gevonden website verwijst (zogeheten backlinks ). Een van de meest tijdrovende activiteiten van een SEO-er is dan ook het zoeken van linkpartners en het aanmelden van hun site bij deze partners. Om dit proces makkelijker te maken heeft Insyde linkbuildingtool.nl ontwikkeld. Deze linkbuildingtool is een online applicatie en is ontwikkeld op een door Insyde gebouwde kernel. Deze kernel wordt door Insyde gebruikt bij het ontwikkelen van hun websites. Een belangrijk onderdeel van deze kernel is de Webmagiër, het Content Management Systeem (CMS) van Insyde. 2 De opdracht De linkbuildingtool is vooralsnog gratis in het gebruik. Gebruikers moeten hiervoor wel een account aanmaken. Sinds de introductie van een aantal nieuwe features heeft een grote toename in het aantal accounts plaatsgevonden. Door deze toename heeft Insyde zich gerealiseerd dat er meer uit de tool te halen valt en wil graag een betaalde versie van de tool lanceren. Om dit te realiseren heeft Insyde dit stageproject opgezet. Het doel van de stage is het opzetten van een volledig functionerende structuur voor betaalde accounts. Daarnaast is het doel van de opdracht ook om voldoende functionaliteiten te leveren die het betalen voor een account aantrekkelijk maken. De linkbuiding tool is in eerste instantie ontworpen om de taken van de SEO specialist binnen Insyde te helpen bij het uitvoeren van zijn taken. Daarnaast wil Insyde met de tool meer naamsbekendheid verwerven en wil zij de tool gebruiken als extra bron van inkomsten. Vanuit dit doel is een opdracht geformuleerd. De uiteindelijke stageopdracht luidt als volgt: De linkbuildingtool moet worden uitgebreid met een betaalsysteem waarmee betaalde accounts kunnen worden aangemaakt. Daarnaast moet een betaald account meerwaarde hebben voor de klant. Dit moet gebeuren door middel van functionaliteiten die exclusief zijn voor deze gebruikersgroep. Onderdeel van de opdracht is een onderzoek naar de wensen van de huidige gebruikers. De gekozen extra functionaliteiten moeten vervolgens worden geïmplementeerd. 3 Projectinrichting De stagelopers (Cees-Willem Hofstede en Lennaert van den Brink) zijn beiden student aan de TU Delft. Zij doen deze opdracht als onderdeel van hun bachelor eindproject. Zij zijn verantwoordelijk voor de uitvoering van de opdracht. Hieronder vallen zowel het onderzoek naar features, als de implementatie hiervan en van de betaalstructuur. De stagebegeleider vanuit Insyde, Bert van Heerde, is verantwoordelijk voor de begeleiding van de studenten in hun activiteiten bij het bedrijf. Tevens is hij eindverantwoordelijke voor de gemaakte keuzes ten opzichte van de te implementeren oplossing. Daarnaast helpt hij mee in de uiteindelijke beoordeling van de stage. De begeleidend docent (Peter van Nieuwenhuizen) is verantwoordelijk voor het geven van richtlijnen ten 1 L. v.d. Brink

10 opzichte van de aanpak en uitvoering van de opdracht. Tevens is hij beoordelend docent. Rapportage zal geschieden door middel van een stageverslag aan het eind van de opdracht. Dit verslag zal tevens worden gepresenteerd aan de begeleiders. Daarnaast zullen tussendoor mondelinge afspraken gemaakt worden tussen de stagelopers en hun begeleiders. 4 In dit verslag Dit verslag is een documentatie van het doorlopen proces tijdens de stage. Het eerste hoofdstuk biedt een introductie tot de opdracht en linkbuildingtool.nl. In het tweede deel wordt verslag gedaan van de oriëntatie op de opdracht. Er wordt verslag gedaan van een gebruikersonderzoek, een onderzoek naar concurrerende tools en een oriëntatie op de verschillende alternatieven voor een betaalsysteem. Het derde deel toont vervolgens een plan van aanpak. Hierin is onder andere een tijdsplanning te vinden. Ook wordt hier aangegeven welke vormen van kwalitietsborging zijn toegepast gedurende het project. Ook wordt in dit deel uitgebreid ingegaan op het ontwerp van het betaalsysteem en de gekozen functionaliteiten. Dit ontwerp wordt onder andere toegelicht met behulp van use-cases en objectmodellen. Deel 4 zal een toelichting geven op de ontwerpen achter de geproduceerde features en systemen. In deel vijf worden de implementaties van deze onderdelen verder toegelicht. Ook is hier onder andere een verantwoording te vinden voor het gekozen betaalsysteem, maar er wordt ook aandacht besteed aan het testen van de implementaties. Tot slot is in het zesde deel een aantal aanbevelingen en conclusies te vinden naar aanleiding van het eindproduct. Deze aanbevelingen richten zich vooral op het gebruiken van de eindproducten bij verdere ontwikkeling van de linkbuildingtool. 2 L. v.d. Brink

11 Deel II Oriëntatie BSc project In dit hoofdstuk wordt verslag gedaan van de uitgevoerde oriëntatie op het project. Opgenomen is het resultaat van een gebruikersonderzoek, een vergelijking van concurrerende tools en een oriëntatie op bestaande online betaalmethoden. Dit hoofdstuk is een samenvatting van het oriëntatieverslag, dat is opgenomen als appendix A. 5 Gebruikersonderzoek De vragenlijst Om uit te vinden wat de gebruiker graag verbeterd ziet aan linkbuildingtool.nl is er een vragenlijst opgesteld. De bedoeling van deze lijst is uitvinden welke onderdelen van de tool het meest gebruikt worden, wat de voornaamste gebruikersgroep van linkbuildingtool.nl is en hoe de gebruiker denkt over een betaalde variant. Ook wordt de gebruiker gevraagd mee te denken over nieuwe functionaliteiten. De vragenlijst is met opzet beperkt tot 10 vragen, om de invuller tegemoet te komen. Een volledig overzicht van de gestelde vragen is te vinden in het oriëntatie verslag. Hierin wordt ook het benaderen van gebruikers omschreven. Uiteindelijk zijn 12 vragenlijsten ingevuld. Dit is een tegenvallend resultaat, maar gelukkig leverden deze vragenlijsten wel relevante resultaten op. Opvallend was bijvoorbeeld dat alle ge-enquêteerden ideal aangeven als de betaalmethode die hun voorkeur geniet. De helft van de geênqueteerden geeft aan te willen betalen voor een uitgebreidere versie. Ook werd duidelijk dat de import en export functionaliteit hoog op de prioriteitenlijst gezet kon worden. Deze werd niet alleen door meerdere mensen aangevinkt als onderdeel dat ze graag zouden zien in een nieuwe versie, maar werd zelfs door een aantal personen genoemd als antwoord op de vraag welke functionaliteiten gemist werden in de tool. Tot slot is opvallend dat onder de 12 invullers slechts 2 hobbyisten zitten. Van de overige 10 geven 3 mensen aan in de SEO dienstverlening te zitten en de rest ziet linkbuilding als noodzakelijk onderhoud aan hun website. Belangrijke opmerking bij deze resultaten is wel dat het aantal ingevulde lijsten erg laag is in verhouding met het aantal aangemaakte accounts op linkbuildingtool. Derhalve kunnen deze resultaten niet als feiten beschouwd worden. Ze zullen echter wel dienen als richtlijn. Gebruikersstatistieken Om te kunnen bepalen hoe de abonnementsstructuur opgezet moet worden voor de betaalde versie is de database ook ondervraagd op het aantal websites dat elke gebruiker aan heeft gemaakt. In tabel 1 is per aantal aangemaakte websites te vinden hoeveel gebruikers een dergelijk aantal websites heeft aangemaakt in de linkbuildingtool. Zoals verwacht hebben de meeste gebruikers slechts 1 website aangemaakt. Echter, er zijn toch een goed aantal gebruikers met meerdere websites en zelfs een aantal gebruikers met meer dan 15 websites. Hieruit valt te concluderen dat de tool een goed aantal actieve gebruikers heeft. Daarnaast is het reëel om een beperking in aantal aan te maken websites te gebruiken als onderscheid tussen verschillende abonnementen. Tot slot blijkt ook hieruit dat de tool geschikt is voor SEO dienstverleners, omdat er overduidelijk al een aantal actief zijn op linkbuildingtool. 3 L. v.d. Brink

12 Aantal websites Aantal gebruikers Tabel 1: aantal websites per gebruiker 4 L. v.d. Brink

13 6 Concurrerende Linkbuilding Tools Linkbuildingtool is niet de enige in zijn soort. Op het internet zijn vele vergelijkbare tools te vinden, al dan niet commercieel. Om een beeld te krijgen van de linkbuildingmarkt is er onderzoek gedaan naar deze tools. In dit onderzoek is onder andere gekeken naar de kosten van de tools, de gebruiksvriendelijkheid, uitstraling en onderscheidende features. Gekeken is vooral naar de betaalde varianten van de concurrentie, maar ook een aantal gratis tools is meegenomen. In Appendix A, hoofdstuk 2 wordt dit onderzoek uitgebreid omschreven. Hier is ook een overzicht te vinden van de onderzochte tools. abonnementsstructuur Bij de betaalde tools zijn er twee gangbare abonnementsstructuren te onderscheiden. Enerzijds zijn er tools die een eenmalig bedrag in rekening brengen voor gebruik. Deze variant komt vooral veel voor bij tools met een client die gedownload moet worden en vervolgens vanaf de harde schijf wordt gedraaid. Anderzijds zijn er tools die werken met terugkerende kosten. Vaak maakt een tool onderscheid in verschillende abonnementen per gebruikersgroep. Grofweg wordt de gebruikersgroep onderverdeeld in kleine SEO bedrijven en particuliere webmasters aan de ene kant en grote SEO bedrijven met een groot aantal klanten aan de andere kant. Verschillen in kosten komen voornamelijk tot uiting in aantal gebruikersprofielen, projecten en hoeveelheid links die kan worden opgeslagen. De bedragen voor de eerste klasse liggen doorgaans tussen de $ 10 en $ 30 per maand. Voor de tweede klasse ligt dit tussen de $ 200 en $ 250 per maand. functionaliteiten Wat betreft functionaliteit wordt het verschil tussen betaalde tools en gratis tools vooral gemaakt op het gebied van beheerfuncties als import en export functionaliteit en geautomatiseerd controleren van backlinks. Interessante features die bij de duurdere varianten naar voren komen zijn vooral op het gebied van rapportage en sjablonen. Opmerkelijk is dat een browser plug-in door geen enkele tool echt goed geïntegreerd is, terwijl deze feature een hoop gebruikersgemak belooft. Als een gebruiker de toolbar van een tool installeert heeft hij altijd de mogelijkheid snel naar de tool te gaan om daar bijvoorbeeld een website aan te melden waar hij bij toeval op terecht kwam. Daarnaast geeft het de gebruiker meer vrijheid in zijn manier van werken, gezien hij niet telkens de website van de tool open hoeft te hebben. De tool van Raven SEO stel wel een toolbar beschikbaar voor haar klanten, maar deze toolbar weigert regelmatig dienst, waardoor het gebruikersgemak verandert in ongemak. Ook in onze enquête kwam naar voren dat een aantal gebruikers een dergelijke toolbar op prijs zouden stellen. uitstraling Vooral bij de uitgebreidere betaalde tools valt op dat de gebruiker in het begin te maken krijgt met een onoverzichtelijke interface met een hoop knoppen direct in beeld. De tools die dit niet hebben voelen gelijk professioneler aan. Het belang van een schone interface voor web apps wordt door Fred Wilson in zijn presentatie 10 golden principles of succesfull web apps [?] duidelijk gemaakt en is ook zeker van toepassing op de linkbuildingtool. De gemiddelde gebruiker van linkbuildingtool zal zeker meer weten van de wereld van web apps gezien de aard van linkbuilding, maar ook deze gebruiker heeft de keuze uit een hoop alternatieven. Een overzichtelijk uiterlijk kan ervoor zorgen dat een oriënterende gebruiker eerder door zal klikken en dus de tool sterker zal overwegen. In hetzelfde kader is de snelheid van de applicatie een belangrijke factor. Opvallend bij enkele grotere pakketten is dat deze een dusdanig zwaar zijn voor de computer, dat de gebruiker niks anders meer kan doen tijdens het wachten op resultaten. Het zou in dat geval een afweging kunnen zijn om een dergelijke zoekactie iets langer te laten duren om de computer te ontzien. 5 L. v.d. Brink

14 7 Online Betaalsystemen BSc project Vanuit Insyde zijn een aantal eisen gesteld waaraan een betaalsysteem moet voldoen. eisen: De gestelde ˆ Het systeem moet in staat zijn betalingen automatisch te controleren. ˆ Betalingen moeten direct kunnen worden uitgevoerd. ˆ Het systeem moeten voldoende veilig zijn. ˆ Er moet zowel van binnen als buiten Nederland makkelijk kunnen worden betaald. ˆ Het systeem moet integreerbaar zijn in de Insyde kernel. Op basis van deze eisen is een aantal bestaande systemen voor online betalingen onderzocht. Aangezien het systeem moet worden geïntegreerd is alleen gekeken naar losstaande systemen en zijn de betaalpakketten achterwege gelaten. De systemen zijn getoetst op kosten, snelheid en gebruikseisen. Na onderzoek zijn een aantal systemen verworpen omdat zij niet voldoen aan de eisen die Insyde gesteld heeft. De Wallie-card, acceptgiro en cash brengen ongewenste kosten met zich mee en vereisen extra administratie. Creditcard, ideal en PayPal zijn allen wel geschikt bevonden voor implementatie. Zowel ideal als PayPal bieden een API die het mogelijk maakt een standaard te creëren die gebruikt kan worden in de kernel van Insyde. Een belangrijk nadeel van ideal is dat dit systeem geen recurrente betalingen ondersteund. Dit botst met het verlangen van Insyde om een betaalsysteem te maken dat zowel directe als recurrente betaalmogelijkheden kent. Daarnaast bestond er binnen Insyde al ervaring op het gebied van ideal integratie. Daarom is besloten om te gaan voor een betaalsysteem met PayPal. 6 L. v.d. Brink

15 Deel III Plan van Aanpak BSc project In dit hoofdstuk wordt aangegeven welke stappen er zijn ondernomen om de kwaliteit van de code te waarborgen. Er wordt uitgelegd voor welke ontwikkelmethode is gekozen en waarom. Vervolgens wordt ingegaan op de gebruikte manier van documenteren en vervolgens zijn enkele ondersteunende maatregelen behandeld. Tot slot wordt ingegaan op de planning die tijdens het project is gehanteerd. In het volledige plan van aanpak in appendix B is extra documentatie te vinden over dit onderwerp. 8 Kwaliteitsborging Ontwikkelmethode Voor deze stage is gekozen om gebruik te maken van agile ontwikkelmethodes. Kenmerkend voor agile programming methoden is dat het ontwerpproces bestaat uit herhaalde ontwikkelingscycli. Dit feit sluit goed aan op het deel van de opdracht waarin gevraagd wordt meerdere features te ontwikkelen. Door voor elke feature de hele ontwikkelingscyclus opnieuw te doorlopen wordt slechts voor die features ontworpen en ontwikkeld, waardoor voorkomen wordt dat er tijd wordt gestoken in features die uiteindelijk niet afgemaakt kunnen worden. Dat niet alle features die bedacht werden uiteindelijk geprogrammeerd zouden worden was niet ondenkbaar, in verband met de beperkte tijd voor de stage. Een andere reden om agile programming te gebruiken is het feit dat de stage volbracht wordt door 2 personen en de communicatie daartussen vrijwel constant is. Hierdoor vermindert de noodzaak tot documentatie van alle gemaakte keuzes. Voor enkele grotere en belangrijke features is gekozen om extreme Programming (XP), een variant van agile programming, te gebruiken. Kenmerkend van XP is het paarsgewijs programmeren. Doordat er constant wordt meegekeken met de programmeur worden fouten eerder opgemerkt. Voordeel hiervan is dat het corrigeren van fouten in een zo vroeg mogelijk stadium een stuk goedkoper is, in termen van tijd, dan wanneer achteraf een fout ontdekt wordt [?]. Daarnaast is specifiek het betaalsysteem een risicovolle feature en is het noodzaak deze met zo min mogelijk fouten te implementeren. PHPdoc Aan het begin van de stage bestonden er bij Insyde nog geen regels voor documentatie. Dit viel op door het gebrek aan documentatie in de kernel. Hierdoor is het erg lastig voor nieuwe werknemers om te leren werken met de kernel. Ook gaat er relatief veel tijd verloren omdat een werknemer de tijd moet nemen te achterhalen of en hoe een bepaalde functie geïmplementeerd is. Om hier verandering in aan te brengen is besloten gebruik te maken van PHPdoc. PHPdoc is een manier van commentaar schrijven die uitgelezen en geparsed kan worden. Door middel tags kan de gebruiker functies en variabelen definiëren, kenbaar maken welke eisen er gesteld worden aan invoervariabelen en concreet maken wat de functie terug geeft. Het grote voordeel van PHPdoc is dat deze stijl van documenteren geïntegreerd kan worden met Eclipse, het IDE waarmee binnen Insyde wordt gewerkt. Hierdoor ziet een programmeur bij het aanroepen van een functie direct het commentaar wat hierbij is geschreven. Tot slot is een pakket geïnstalleerd dat het commentaar kan uitlezen en met deze informatie een digitale API genereert. Tijdens de stage is deze manier van commentaar bij de code opnemen zo goed bevallen dat ook na de stage dit systeem van kracht zal blijven. Insyde verlangt nu van haar programmeurs dat zij bij hun code dergelijke commentaren schrijven en is ook langzaam maar zeker bezig met het op deze manier documenteren van de bestaande kernel. Overige hulpmiddelen Binnen Insyde wordt gebruik gemaakt van TOPdesk voor het beheren van de planning. Een gebruiker kan binnen TOPdesk activiteiten aanmaken en aan iemand toewijzen. Zodra aan een activiteit gewerkt is, kan een opmerking worden opgeslagen bij de activiteit. Daarnaast kan worden aangegeven hoe lang 7 L. v.d. Brink

16 er aan de desbetreffende activiteit gewerkt is. Binnen de stage is gebruik gemaakt van dit systeem om de verschillende fasen van het project bij te houden. Tevens is het systeem gebruikt om te bepalen welke taken nog open stonden. Daarnaast wordt er gebruik gemaakt van SVN als versiebeheerprogramma. SVN houdt bij door wie en wanneer wijzigingen zijn aangebracht in de code en waarschuwt wanneer twee personen aan de zelfde code hebben gewerkt. Het nadeel van TOPdesk is dat het systeem niet beschikt over een met SVN geïntegreerde vorm van bugtracking. Hiervoor is geprobeerd een oplossing te zoeken in de vorm van het bugtrackingprogramma Trac. Echter, de aanwezige operatingsystem installatie op de server van Insyde maakte het lastig om aan alle afhankelijkheden van dit programma te voldoen. Daarnaast werd door Insyde aangegeven dat het wenselijk was zo min mogelijk te installeren op deze server. Daarom is ervoor gekozen om toch handmatig bugs bij te houden. 8 L. v.d. Brink

17 9 Planning BSc project Tijdens dit project is de planning een aantal keer drastisch veranderd. Oorspronkelijk was de planning als in tabel 2. In deze planning wordt de agile programmeerstijl benadrukt door de herhaalde ontwerp cycli. Daarnaast is te zien dat gedurende het project doorlopend is gerapporteerd, wat geresulteerd heeft in de verschillende tussentijdse documenten. In de eerste, langere, ontwerpfase zou het betaalsysteem worden ontworpen. De volgende ontwerpvakken waren bedoeld voor de verschillende features. fase \week Oriëntatie Analyse Ontwerp Implementatie Testen Rapportage lage intensiteit gemiddelde intensiteit hoge intensiteit Tabel 2: Oorspronkelijke planning Naarmate de ontwikkeling van het betaalsysteem verder vorderde was er ook meer duidelijkheid omtrent de verschillende features die geïmplementeerd zouden gaan worden. Om de ontwikkeling van deze features in goede banen te leiden is vervolgens een planning gemaakt voor de implementatie hiervan. In overleg met de opdrachtgever is een prioritisering gemaakt van de verschillende features. Deze prioritisering, gebaseerd op de MoSCoW methode (zie verklarende woordenlijst) gaf aan of een functie hoge, gemiddelde of lage prioriteit had. Functies met hoge prioriteit moesten geïmplementeerd worden voor het succesvol afronden van de stage. Functionaliteiten met gemiddelde prioriteit waren interessante features die Insyde graag terug zag in de linkbuildingtool, maar waarvan een deel waarschijnlijk niet geïmplementeerd kon worden in verband met tijdsgebrek. Features met lage prioriteit waren enerzijds ideeën voor features die nog niet volledig uitgewerkt waren en anderzijds ideeën die beschouwd werden als niet essentieel voor de linkbuildingactiviteiten. Deze features zouden slechts ontworpen worden op het moment dat alle andere features geïmplementeerd en geïntegreerd waren. In tabel 3 is de planning terug te vinden. Het idee was dat elke feature gezamenlijk ontworpen zou worden, waarna elk aan een eigen feature zou werken. Dit zou vervolgens door de ander getest worden. Het idee hiervan was zo veel mogelijk features te implementeren, zodat bij het online gaan van de nieuwe versie klanten een goede reden zouden hebben om te kiezen voor de betaalde variant. ma/di do/vr ma/di do/vr ma/di do/vr ma/di do/vr ma/di do/vr ma/di do/vr week 22 4 juni week juni week juni week juni week 26 2 juli week 27 9 juli Keywords Log in Varianten Importeren / Exporteren Meerdere link beschrijvingen template Zoekfunctie LMT Betalingen 3 3 Abonnement structuur / privileges Legenda Ontwerp Implementatie Deadline Testen 1 = Cees-Willem 2 = Lennaert 3 = Beiden Tabel 3: Planning voor de verschillende features (31 mei-9 juli) Tijdens de stage is echter binnen Insyde besloten dat het toch beter is om de linkbuildingtool volledig te herzien. Vooral de implementatie van een client-administrator systeem bleek enorm lastig binnen de huidige database opzet. Hierdoor verschoof de stageopdracht enigszins. In plaats van het uiteindelijk lanceren van een betaalde variant van linkbuildingtool was nu de opdracht om prototypes van features te maken voor in de versie die na de stage ontwikkeld zou worden. Naar aanleiding hiervan is ook besloten om het aantal features waaraan wij zouden werken te verminderen. Hierdoor kon meer aandacht besteed worden aan enkele grote features en kon de tijd worden genomen deze zo goed 9 L. v.d. Brink

18 mogelijk te ontwerpen en te implementeren. Daarnaast is besloten om alle features op de XP manier te ontwikkelen en werd er dus volledig paarsgewijs geprogrammeerd. De resulterende planning is terug te vinden in tabel 3 Maandag Dinsdag Woensdag Donderdag Vrijdag Maandag Dinsdag Woensdag Donderdag Vrijdag Maandag Dinsdag Woensdag Donderdag 21-Jun 22-Jun 23-Jun 24-Jun 25-Jun 28-Jun 29-Jun 30-Jun 1-Jul 2-Jul 5-Jul 6-Jul 7-Jul 8-Jul Import impl impl test x x test deadline Betaalsysteem impl impl test deadline PDF impl impl test deadline CSS CSS online zetten (online) Legenda Implementatie Deadline Testen Bijzondere activiteit Tabel 4: Uiteindelijke planning (21 jun-9 juli) 10 L. v.d. Brink

19 Deel IV Design BSc project Dit hoofdstuk is een samenvatting van het Design document dat is opgenomen in appendix. Allereerst zal worden ingegaan op alle randvoorwaarden als psuedo requirements en niet-functionele eisen aan het project. Vervolgens zal het ontwerp van het betaalsysteem worden toegelicht. Hierbij komen onder andere de functionele eisen aan bod en zal worden geschetst hoe de klassen met elkaar samenwerken. Tot slot zal voor het viertal grote features het ontwerp worden toegelicht. 10 Randvoorwaarden Het systeem is gebouwd met de kernel van Insyde als basis. Deze kernel is zo gebouwd dat zowel PHP4 als PHP5 (tot PHP5.3) ondersteund zijn. Dit betekent dat als er iets aan de kernel wordt toegevoegd of gewijzigd, deze compatibiliteit gewaarborgd moet blijven. De tool zelf draait op een PHP5 server. Dit betekent dat code die in het project zelf staat PHP5 moet ondersteunen, maar compatibiliteit met PHP4 is hier niet vereist. Daarnaast wordt gebruik gemaakt van MySQL 4. Dit betekent onder meer dat in SQL-queries geen gebruik gemaakt kan worden van views. Daarnaast moeten alle pagina s van de tool binnen enkele seconden geladen kunnen worden. Hierbij mogen de snelheid van de internetverbinding en de capaciteit van server buiten beschouwing gelaten worden. De tool dient te werken in alle veelgebruikte browsers en moet bruikbaar zijn als de gebruiker javascript uit heeft staan of als hij gebruik van cookies heeft uitgeschakeld. De gegenereerde HTML code moet valideren volgens de w3c richtlijnen en waar mogelijk aan de Nederlandse webrichtlijnen. Tot slot moeten de gemaakte functies in logische modules worden geplaatst. Het doel is dat de functionaliteiten, met name het betaalsysteem, herbruikbaar zijn en gemakkelijk geïntegreerd kunnen worden in andere prjecten van Insyde. De functionaliteiten moeten goed te onderhouden zijn en er moet worden geanticipeerd op latere toevoegingen of wijzigingen. 11 L. v.d. Brink

20 11 Betaalsysteem BSc project Een van de belangrijkste onderdelen van de stage is het betaalsysteem. Naast standaard beveiligingseisen die gepaard gaan met iets gevoeligs als een betaalsysteem werden er door Insyde nog een aantal andere eisen gesteld aan het betaalsysteem. Het systeem moet zowel directe als recurrente betalingen af kunnen handelen. Het systeem moet kunnen controleren of de betaling succesvol is afgerond en moet deze kunnen factureren. Daarnaast moet voor recurrente betalingen kunnen worden gecontroleerd wanneer de laatste betaling heeft plaatsgevonden en wanneer de volgende betaling plaatsvindt. Als payment provider is gekozen voor PayPal. Om hiermee het betaalsysteem te kunnen opzetten is het van belang hoe de communicatie met PayPal in zijn werk gaat. PayPal stelt twee verschillende API s beschikbaar aan zijn gebruiker, een zogeheten SOAP API en een NVP API. SOAP staat voor Simple Object Acces Protocol en is een protocol waarmee door middel van XML berichten worden uitgewisseld tussen client en server. NVP staat voor Name-Value Pair en houdt in dat de communicatie verloopt via tokens met daarin per variabele zijn naam en de waarde die de variabele aanneemt. Door de variabele METHOD in te vullen weet de server welke methode hij moet aanroepen. Wij hebben gekozen om gebrruik te maken van de NVP API omdat de code hierdoor leesbaarder is en omdat hiervoor betere documentatie beschikbaar was. Om een recurrente betaling te initiëren moeten de volgende stappen doorlopen worden (zie figuur 1). Allereerst moet met de methode SetExpressCheckout (1) de PayPal server op de hoogte gesteld worden van de inkomende betaling. PayPal reageert hierop met een token (2). Dit token wordt gebruikt om de betaling verder mee te identificeren. Vervolgens wordt de gebruiker met dit token verwezen naar de PayPal site (3), waar hij zijn akkoord geeft voor de betaling. Als dit is gebeurt stuurt PayPal de gebruiker weer terug naar de website (4). Door middel van het token kan met de GetExpressCheckout- Details (5) de gegevens van de betaling opgevraagd worden. Tot slot wordt met DoExpressCheckout- Payment (6) de directe betaling doorgezet en met CreateRecurringPaymentsProfile wordt uiteindelijk de recurrente betaling geïnitieerd. De directe betaling is nodig omdat deze direct geverifieerd wordt, waar een recurrente betaling 24 uur kan duren om actief te worden. Omdat we gelijk de gebruiker toegang willen kunnen geven is ervoor gekozen om de eerste termijn met een directe betaling af te rekenen. Figuur 1: PayPals Recurring Payment flow Omdat wij een betaalsysteem willen opzetten waar in de toekomst de gebruiker de keuze krijgt tussen verschillende betaalsystemen moet hiervoor een framework gebouwd worden. In figuur 2 is te zien hoe dit framework in elkaar steekt. De communicatie met de PayPal server zoals die hierboven wordt weergegeven wordt door een klasse genaamd de PayPalService afgehandeld. Het af te rekenen product wordt vertegenwoordigd door een webproductmoduleitem. In dit item staan alle details van een product, waaronder bijvoorbeeld de privileges die de gebruiker krijgt na aanschaffen, maar ook de kosten ervan. Vanuit dit product wordt een zogeheten DefaultPaymentModuleItem gecreëerd. De DefaultPaymentModule kan vervolgens aan dit item alle details opvragen die nodig zijn voor de betaling. Ook wordt uit dit item gehaald welke provider de klant heeft gekozen. De module roept vervolgens de juiste methoden aan van de service, die vervolgens alles met de provider afhandelt. Tot slot vertelt de module na afloop aan het account of de betaling geslaagd is, waardoor deze toegang kan krijgen tot de betaalde features. 12 L. v.d. Brink

21 WebProductmoduleItem createpayment DefaultPaymentModuleItem DefaultPaymentModule Account PaypalService Figuur 2: Het betaalsysteem 13 L. v.d. Brink

22 12 Overige functionaliteiten 12.1 Keywords BSc project voordat een gebruiker aan de slag gaat met linkbuildingtool doet hij doorgaans eerst onderzoek naar keywords die mogelijk geassocieerd worden met zijn website. Het resultaat hiervan wordt vervolgens gebruikt in combinatie met de CSE s van de linkbuildingtool. Het probleem was dat er voor de gebruiker geen manier was om zijn lijst aan keywords in één keer in te voeren in de linkbuildingtool. Hier is de keyword tool voor bedoeld. Een gebruiker moet in de keyword tool een lijstje kunnen uploaden of copy / pasten. Dit lijstje bestaat uit een aantal regels met op elke regel 1 keyword. Dit lijstje moet kunnen worden gewijzigd of gesorteerd. De keywords uit dit lijstje worden naast het zoekveld van de linkbuildingtool getoond. Door op een woord uit het lijstje te klikken wordt direct op dat woord gezocht, zonder dat eerst nog op enter gedrukt hoeft te worden. Met behulp van vorige en volgende knoppen kan een gebruiker stap voor stap door de keywords heenlopen. Tot slot moet de gebruiker de mogelijkheid krijgen de keywordtool te verbergen en weer te tonen. Deze keuze moet per account onthouden worden. De keywords worden per account opgeslagen. Omdat het hier in feite slechts een lijste met woorden betreft met elk keyword op een nieuwe regel. Het toevoegen van een tekstveld aan het account was voldoende om alle informatie in op te kunnen slaan. Deze lijst kan worden aangepast vanaf het account-dashboard, of direct vanuit het zoekformulier. Om dit te faciliteren is er een vaste pagina aangemaakt waarop de functionaliteit wordt getoond. Deze pagina wordt geladen in een shadowbox. Op deze manier is deze pagina later eventueel ook zeer gemakkelijk te tonen vanaf andere onderdelen van linkbuildingtool. Deze lijst van keywords moet kunnen worden gesorteers. Dit wordt gedaan met javascript. De sorteerknop (die alleen wordt getoond als javascript beschikbaar is) heeft via jquery een click-event die een sorteeralgoritme uitvoert op de text in het textvak en vervolgens de tekst in het tekstvak overschrijft met het resultaat. Het algoritme dat wordt gebruikt, en hoe dit wordt gekoppeld aan de knop is te zien in codefragment 1 1 $ ( '#s o r t k e y w o r d s ' ). c l i c k ( f u n c t i o n ( ) { 2 var k e y w o r d s = $ ( '#k e y w o r d l i s t ' ). val ( ) ; 3 var k e y w o r d L i n e s = k e y w o r d s. s p l i t (/\ n /). s o r t ( ) ; 4 var n e w K e y w o r d s = ' ' ; 5 f o r ( var i =0; i<k e y w o r d L i n e s. l e n g t h ; i++) 6 { 7 n e w K e y w o r d s += ( trim ( k e y w o r d L i n e s [ i ] )!= ' ' )? ( k e y w o r d L i n e s [ i ] + \n ) : ' ' ; 8 } 9 $ ( '#k e y w o r d l i s t ' ). val ( n e w K e y w o r d s ) ; 10 }) ; Codefragment 1: code om met jquery een sortering uit te voeren op de lijst van keywords 12.2 CSV import Een van de meest aangevraagde functionaliteiten van de linkbuildingtool was de import en export functionaliteit. Gezien CSV de standaard voor importeren en exporteren van grote databestanden blijkt is gekozen om hiervoor een import functie te maken. Oorspronkelijk moest de gebruiker de mogelijkheid krijgen om een upload bestand van de linkbuildingtool te downloaden, zodat hij in een programma als bijvoorbeeld Microsoft Excel zijn links hierin kon plakken om vervolgens weer te uploaden naar de linkbuildingtool. Omdat echter tijdens de stage besloten werd de focus te verleggen naar een kleiner aantal functionaliteiten is besloten om een import editor te maken, waarin de gebruiker op de website van linkbuildingtool zelf zijn CSV bestand in orde kan maken en dus niet tussendoor naar een ander programma hoeft over te schakelen. Hierdoor wordt de drempel om een dergelijk bestand gereed te maken voor uploaden aanzienlijk verlaagd. 14 L. v.d. Brink

23 De import editor wordt getekend door een enkele klasse. De editor bestaat uit een aantal controle elementen bovenaan de pagina en uit een vlak van dynamische grote, bestaande uit tekst-invoer velden. De grootte is afhankelijk van het aantal verplichte velden (er moet ten minste 1 kolom zijn voor elk verplicht veld) en van de data in de door de gebruiker geuploade CSV. Om de verplichte velden te kunnen herkennen worden deze opgevraagd aan de webregistratiemodule. Hierdoor kan de import editor makkelijker in andere websites gehangen worden, omdat slechts deze module hoeft worden aangepast aan de juiste variant. Een belangrijk vraagstuk bij deze editor is de vraag hoe de gebruiker weet wanneer zijn CSV voldoet aan de eisen om geïmporteerd te kunnen worden. Om dit op te lossen is besloten om realtime de gegevens die de gebruiker invoert te controleren door middel van AJAX. Zo zijn er velden, datum velden en velden die slechts beperkte waarden kunnen aannemen. Deze velden kunnen niet gecontroleerd worden met behulp van lokale functionaliteiten omdat daar geen functie voor beschikbaar is binnen de beschikbare modules. Daarom wordt gebruik gemaakt van AJAX calls. In plaats van aan een lokale module in te schakelen wordt de server gevraagd een specifieke functie toe te passen op de inhoud van een cel en het antwoord terug te sturen. Hierdoor wordt voorkomen dat loze functies worden opgenomen in een module waar ze eigenlijk niet thuis horen. Belangrijk is op te merken dat deze controles geen garantie geven dat de ingevoerde data ook daadwerkelijk klopt op het moment dat de gebruiker kiest om de gegevens op te slaan. Immers, zodra de gebruiker javascript uit heeft staan in zijn browser of er om een of andere reden een fout optreed binnen javascript krijgt hij geen feedback meer over de correctheid van zijn invoer en wordt hij ook niet weerhouden van het indienen ervan. Daarom wordt na het bevestigen van de invoer door de gebruiker het hele bestand nog een keer aan de server kant gecontroleerd. Dit wordt zo lang mogelijk uitgesteld omdat deze bewerking een hoop tijd kan kosten, afhankelijk van de grootte van het bestand. Echter, de snelheid is van minder belang op dit punt, omdat de gebruiker in de tussentijd geen bewerkingen meer kan uitvoeren CSV export Zodra er gesproken wordt over een import functie is de stap naar een export functie snel gemaakt. Doel van de export functie is dat het voor de gebruiker makkelijk wordt gemaakt om zíjn informatie uit de tool te halen. Dit is niet alleen handig als de gebruiker deze informatie wil verwerken buiten de linkbuildingtool, maar helpt ook vertrouwen te kweken bij potentiële gebruikers. Immers, wanneer zij gemakkelijk hun gegevens uit het systeem kunnen halen mochten zij beslissen de linkbuildingtool niet verder te willen gebruiken kunnen zij zonder gevaar beginnen met gegevens invoeren in de tool. Belangrijk is dat de gebruiker kan kiezen om niet alleen het hele project te exporteren, maar ook om slechts een export te maken voor een bepaalde site of van een specifieke categorie. Dit om de gebruiker te faciliteren in het rapporteren naar zijn klanten en het gebruik van externe hulpprogramma s Rapportage module Een belangrijk onderdeel van de meeste (duurdere) betaalde linkbuilding tools is een rapportage functionaliteit. Omdat Insyde ook interesse toonde in een goede manier om PDF documenten te genereren vanaf een website werd besloten de rapportage module een hogere prioriteit te geven. Desalniettemin is deze functionaliteit van minder groot belang dan de overige onderdelen met een hoge prioriteit. Een gebruiker moet zelf plaatjes kunnen uploaden voor de header en de footer van het document. Daarnaast moet de gebruiker de mogelijkheid hebben om aan te geven welke categoriën hij in het rapport wil opnemen en moet hij de mogelijkheid hebben per categorie een begeleidende tekst op te nemen. Tot slot is de bedoeling dat een gebruiker rapporten automatisch op door hem gekozen tijdstippen kan laten genereren en opsturen naar een adres. Aan het eind van de stage bleken er niet voldoende tij om alle functionaliteit in een werken prototype te verwerken. Het aanmaken van een rapport met logo s werkt, maar dit automatisch laten doen nog niet. Deze functionaliteit is dan ook nog niet direct toepasbaar in andere projecten zoals de andere 15 L. v.d. Brink

24 onderdelen, maar echt een proof of concept. BSc project Voor het maken van de pdf wordt gebruik gemaakt van latex. Eerst is onderzocht wat de huidige mogelijkheden waren binnen de kernel van Insyde. Deze bleken helaas niet toereikend om aan alle wensen te kunnen voldoen. Derhalve is besloten uit te zoeken of het mogelijk is om latex te gebruiken. Omdat Insyde de servers waar hun projecten op draaien zelf kunnen beheren stond de mogelijkheid voor latex open, omdat dit moet worden geïnstalleerd op de server. Voor de rapportage is een PDFLatex class gemaakt. Deze class extend de Configureable class uit de kernel van Insyde, zodat het makklijk is om instellingen per site te bepalen en in een loas bestand op te slaan. De class biedt methoden om gegeven een bepaalde text en een latextemplate hier een pdf van te maken. Deze pdf kan worden opgeslagen op de server of direct worden gedownload. In beide gevallen wordt eerst een tijdelijk bestand aangemaakt. Een classdiagram is gegeven in figuur 3. settings:string[] Configureable initsettings():void getinifilepath():void dolog(messagetype:string, message:string):void getinifilepath():void readinifile():void set(settingname:string, setting:*string):void initdefaultsettings():void initsettings():void hassetting(settingname:string):boolean getsetting(settingname:string, givewarning:boolean, defaultvalue:string):string get(settingname:string):string getsettings():string[] setsettings(settings:string[]) pathtopdflatex:string PDFLatexTempDir:string tmpdir:string PDFLatex createtmppdf(content:string, debugmode:boolean):string createpdf(sourcedir:string, filename:string, content:string, debugmode:boolean):string downloadaspdf(content:string, filename:string, debugmode:boolean) Figuur 3: de PFLatex class 16 L. v.d. Brink

25 Deel V Implementatie BSc project 13 betaalsysteem Voordat een klant een abonnement kan kopen moet dit abonnement eerst door de beheerder van de website worden aangemaakt. Door de opzet van het systeem met productmoduleitems kan de beheerder via het CMS een abonnement aanmaken (zie figuur 4). Om het abonnement aan te maken moet deze een naam en omschrijving krijgen. Daarnaast moet worden aangegeven wat het abonnement kost en of hij af te rekenen is. Dit laatste is omdat Insyde de mogelijkheid wil hebben delen van de linkbuildingtool gratis beschikbaar te stellen aan recensenten en andere samenwerkende partijen. Door middel van aanvinken kan de beheerder bepalen welke rechten het specifieke abonnement verleent. Als het abonnement is aangemaakt is deze terug te vinden in het abonnementen overzicht (figuur 5). Figuur 4: Aanmaken van een abonnement 17 L. v.d. Brink

26 Figuur 5: Overzicht van aangemaakte abonnementen Om een abonnement aan te schaffen moet de ingelogde klant naar zijn account-dashboard. Hier kan hij vervolgens kiezen welk abonnement hij wil aanschaffen. Omdat in ons systeem nog geen keuze bestaat voor een payment provider wordt de klant standaard doorverwezen naar PayPal (figuur 6). Figuur 6: PayPals log in scherm Nadat de klant hier inlogt met zijn gegevens krijgt hij op het scherm de gegevens van de betaling gepresenteerd door PayPal. Deze gegevens zijn dezelfde als die zijn ingevoerd bij het aanmaken van een abonnement (figuur 7). 18 L. v.d. Brink

27 Figuur 7: De gegevens uit het abonnement item gepresenteerd door PayPal Nadat de klant zijn gegevens bij PayPal bevestigt wordt hij weer terug verwezen naar de linkbuildingtool website. Hier krijgt de klant nog een maal een overzicht van de betaling die hij gaat doen en kan hij controleren of alles klopt (figuur 8). Figuur 8: De laatste controle van de betaling. Als de gebruiker de betaling bevestigt zal deze worden doorgezet bij PayPal en wordt definitief de eerste termijn afgeschreven. Als dit allemaal lukt krijgt de gebruiker direct toegang tot het betaalde deel van de website. Op zijn account-dashboard kan hij zien welk abonnement hij heeft. Daarnaast is hier terug te vinden wanneer de eerste en de laatste betalingen waren en kan hij zien wanneer de volgende termijn wordt afgeschreven. Tot slot kan de gebruiker hier aangeven zijn abonnement stop te willen zetten (figuur 9). Figuur 9: Overzicht op het account-dashboard. 19 L. v.d. Brink

28 Testen BSc project Gezien de aard van het betalingssysteem is de feature lastig te testen. Immers, het is niet wenselijk om met echte bedragen transacties uit te voeren om te kijken of deze doorkomen. Gelukkig heeft PayPal hierover nagedacht en heeft zij een zogeheten sandbox omgeving opgezet. In deze omgeving kan een ontwikkelaar virtuele accounts aanmaken voor zowel de klanten als de verkoper. Hierdoor werd het mogelijk om uitgebreid te testen met verschillende scenario s. Zo is er getest op accounts die te weinig geld hebben voor de eerste termijn, accounts die na verloop van tijd te weinig geld hebben, het stopzetten van abonnementen en het tussentijds afbreken van een betaling. Daarnaast is gekeken hoe waterdicht het systeem is. Gedacht kan worden dat de klant door middel van het aanpassen van de URL het systeem voor de gek kan houden bij terugkeer naar de website van linkbuildingtool. Echter, doordat de tool de gegevens verifiëert bij PayPal door middel van het token dat PayPal genereert kan de tool erachter komen of de betaling ook inderdaad succesvol is gebleken. Dit token is overigens zichtbaar voor de klant, maar kan slechts in combinatie met een wachtwoord gebruikt worden. Dit wachtwoord is voor de klant onzichtbaar. 20 L. v.d. Brink

29 14 keywords tool BSc project Als op het account-dashboard of op de zoekpagina het keywords bewerken scherm wordt geopend, dan wordt een pagina getoond waarop een formulier wordt getekend met een textarea en een aantal knoppen voor sorteren, opslaan en sluiten, en sluiten (zonder opslaan). Figuur 10 toont hiervan een voorbeeld. Figuur 10: Het venster waarin de keywords kunnen worden aangepast. De keywords kunnen vervolgens direct bij het zoeken worden gebruikt. Als de keywords nog niet getoond zijn, zoals in figuur 11, kan op de knop keywords tonen worden geklikt. Het resultaat staat is te zien in figuur 12. De keywords kunnen weer verborgen worden door op de knop X te klikken. Hier kan dan door de keywords gebladerd worden. Door op keywords bewerken te klikken opent het venster zoals te zien in figuur 10, waarin de lijst met keywords kan worden aangepast. Figuur 11: De keywords kunnen worden verborgen. 21 L. v.d. Brink

30 Figuur 12: Als de gebruiker de keywords toont dan kan er direct op worden gezocht. Als de gebruiker ervoor kiest om de keywords aan te passen en op te slaan, dan wordt de keuzelijst direct aangepast zodat de nieuwe keywords erin staan. De status van de keywords worden onthouden per account. Dit betekent dat als de gebruiker later opnieuw zoekt, dat de keywords wel of niet worden getoond afhankelijk van de status de laatste keer dat het werd gebruikt. Ook blijven de keywords onthouden. 22 L. v.d. Brink

31 15 CSV import BSc project De CSV import is terug te vinden in de Link Management Tool. Zodra de gebruiker op de import knop klikt opent zich een pop-up in een shadowbox. In dit formulier (figuur 13) kan de gebruiker aangeven waar op zijn computer het bestand te vinden is. Daarnaast kan de gebruiker, indien nodig, aangeven welk scheidingsteken hij in zijn bestand hanteert. Tot slot kan de gebruiker een template kiezen voor zijn CSV. Hierdoor kan veel tijd bespaard worden met invullen als het een export betreft van een bekend hulpprogramma. Figuur 13: In de eerste stap van import kan het bestand worden gekozen, het scheidingsteken en eventueel een template. Zodra de gebruiker op volgende klikt, wordt zijn bestand ge-upload naar de server en wordt de editor opgebouwd. In deze editor (figuur 14) kan de gebruiker vervolgens zijn CSV bestand in orde maken. Hij kan kiezen voor welke site hij deze links wil importeren. Daarnaast kan hij aangeven of hij Amerikaanse of Europese datumnotatie gebruikt. Vervolgens moet de gebruiker per kolom aangeven welke gegevens zich in deze kolom bevinden. Dit doet hij door in het drop-down menu de juiste waarde te selecteren. Als er zich in de kolom gegevens bevinden die niet in het juiste formaat staan, of als een verplichte kolom lege rijen bevat, wordt dit direct zichtbaar gemaakt aan de gebruiker door middel van het rood kleuren van de betreffende velden (figuur 15). Figuur 14: Het scherm van de importeditor voordat wijzigingen zijn aangebracht. 23 L. v.d. Brink

32 Figuur 15: Als bij het opslaan blijkt dat de import niet voltooid kan worden wordt dit duidelijk aangegeven. Door de knop selecteer rijen met conflict worden deze rijen geselecteerd. Afhankelijk van de fout kan de gebruiker deze nu corrigeren met behulp van de zogeheten bulk actions. Stel bijvoorbeeld dat hij deze rijen wil verwijderen, dan kiest de gebruiker in de eerste kolom voor de actie verwijder en in de tweede kolom voor geselecteerde rijen. Als hij nu op uitvoeren klikt, zullen de conflicterende rijen worden verwijderd uit de CSV. Op een zelfde manier kan een gebruiker kiezen voor wijzig, rijen waar leeg en in kolom adres beheerder om een door hem gekozen waarde in te voeren in alle lege rijen in de betreffende kolom. Op deze manier kan een gebruiker in hoog tempo zijn bestand zodanig aanpassen dat deze kan worden geïmporteerd. Als het bestand klaar is klikt de gebruiker op links opslaan. Zodra hij dit doet worden alle links nog een laatste maal gecontroleerd door de server. Mocht er nog een fout optreden, dan wordt de gebruiker terug gevoerd naar de editor met een melding van de fout. Als alles blijkt te kloppen, worden de links opgeslagen en wordt het scherm gesloten. 24 L. v.d. Brink

33 16 CSV export BSc project Net als de import functionaliteit is de export functionaliteit te vinden in de Link Management Tool. Zodra de gebruiker op export klikt opent wederom een pop-up in een shadowbox (figuur 16). Figuur 16: Voor het exporteren kunnen bepaalde voorwaarden worden gesteld aan de data. Allereerst moet de gebruiker kiezen voor welke websites hij wil exporteren. Vervolgens kan hij aangeven welke categorieën hij in zijn export wil zien. Daarna kan hij aangeven welke velden hij wil exporteren. Door deze met de muis te slepen (figuur 17) kan hij kiezen in welke volgorde de links in de CSV voor zullen komen. 25 L. v.d. Brink

34 Figuur 17: De volgorde van de velden is aan te passen door ze te slepen. Tot slot kan de gebruiker invoeren welke naam hij het bestand wil geven. Zodra de gebruiker op export klikt wordt het bestand gedownload en worden de gemaakte keuzes opgeslagen in het account. Hierdoor kan de gebruiker eenvoudig in een later stadium een export maken met dezelfde instellingen. Dit om te faciliteren in het gebruik van de gegevens bij rapportage. 26 L. v.d. Brink

35 17 Rapportage module BSc project Op de website beheren pagina in de LMT kan de gebruiker klikken op de knop rapport downloaden, te zien in figuur 18. Figuur 18: Knoppen in LMT. Als dit gedaan wordt, dan opent een shadowbox die een pagina toont met een formulier waarin gegevens ingevuld kunnen worden die nodig zijn voordat het rapport gemaakt kan worden. Een voorbeeld is te zien in figuur 19. De gebruiker heeft de mogelijkheid om een plaatje voor in de header toe te voegen en een plaatje voor de footer. Daarnaast kan gekozen worden welke categorieën opgenomen moeten worden in het rapport. Per categorie kan nog een extra tekst worden toegevoegd die in de PDF boven de tabel van de categorie komt te staan. Elke categorie begint op een nieuwe pagina in de PDF. Figuur 19: Voordat het rapport wordt gedownload kunnen nog logo s en teksten worden toegevoegd. Zodra alle gegevens naar wens zijn ingevuld drukt de gebruiker op download rapport en de pdf kan worden gedownload (zie figuur 20). Een voorbeeld van een rapportage is te zien in figuur L. v.d. Brink

36 Figuur 20: De download in firefox onder windows xp. Figuur 21: De eerste pagina van de PDF gegenereerd door de rapportagemodule. 28 L. v.d. Brink

37 18 Skinnable selectfield BSc project Tijdens de implementatie van enkele van de functies bleek dat selectvelden niet in dezelfde stijl werden getekend als de overige elementen. Dit HTML-attribuut toont een lijst met keuze opties. Op meerdere plaatsen wordt dit element in de linkbuilingtool gebruikt. Het blijkt echter dat het uiterlijk van deze elementen niet is aan te passen met CSS zoals andere HTML-attributen. Dit betekent dat het OS bepaalt hoe deze velden eruit zien. Dit is duidelijk zichtbaar in figuur 22 Figuur 22: Standaard zien de selectvelden eruit zoals het OS het definieert. Toen dit genoemd werd bleek het een ergernis te zijn van enkele medewerkers van Insyde dat het aanpassen van het uiterlijk van deze velden niet mogelijk was. Omdat we zelf ook graag wilden dat de linkbuildingtool ook voor het oog prettig is om naar te kijken is besloten kort aandacht aan dit probleem te besteden. Besloten is om een jquery-plugin te schrijven die het huidige selectveld onzichtbaar maakt en dat er een tekstveld overheen plaatst die niet gewijzigd kan worden. Dit veld is dan wel volledig aan de stijl van de website aan te passen. Doordat het selectveld bovenop het tekstveld ligt werkt het uitklapmenu nog steeds. Als de waarde wordt gewijzigd dan wordt dezelfde tekst in het tekstvak getoond. Er is gekozen om deze functionaliteit als een plugin te maken zodat het eenvoudig in andere projecten kan worden gebruikt. Daarnaast is het aanzetten van de functionaliteit heel makkelijk. Een voorbeeld is te zien in codefragment 2. 1 $ ( f u n c t i o n ( ) { 2 $ ( ' s e l e c t ' ). s k i n s e l e c t ( ) ; 3 }) ; Codefragment 2: De skinnableselect plugin is zeer makkelijk te gebruiken Als de plugin wordt gebruikt op het voorbeeld uit figuur 23, tezamen met goede definities in de CSS, dan is duidelijk een verbetering te zien. In figuur 23 is te zien dat met de plugin de selectvelden zo weergegeven kunnen worden dat ze niet uit de toon vallen met de rest van de elementen op de pagina. Figuur 23: Door de skinnableselect plugin te gebruiken kunnen de velden wel een bijpassend uiterlijk krijgen. 29 L. v.d. Brink