Blog

Sommige mensen hebben één fysiek adres en één Twitter-account. Anderen hebben meerdere adressen, helemaal geen Twitter en één Quora-account. Het is lastig met alle situaties rekening te houden, maar we willen gebruikers hun contacten laten ordenen zoals zij dat willen.

Een fysiek adres, een Twitter-account: al die manieren om iemand te bereiken noemen we een contactveld.

Vanaf nu kun je zoveel contactvelden per contact toevoegen als je wilt. Eerder had je alleen 5 vaste velden.

Elk contactveld heeft een type: het kan een e-mailadres zijn, een Facebook-account of een faxnummer. Elk account begint met 6 algemene typen contactvelden:

• E-mail
• Telefoonnummer
• Facebook
• Twitter
• WhatsApp
• Telegram

Je kunt naar believen typen contactvelden toevoegen of verwijderen in je account, en hun namen instellen zoals je wilt, op het nieuwe tabblad Personalisatie onder Instellingen.

Aan elk type contactveld kan ook een protocol worden gekoppeld. Een protocol bepaalt wat de browser moet doen als je op een contactveld klikt. Bij een telefoonnummer zorgt het tel:-protocol er bijvoorbeeld voor dat de browser het programma opent waarmee je vanaf je computer belt.

De API is bijgewerkt om die twee nieuwe begrippen te ondersteunen (contactvelden en typen contactvelden).

We hebben ook de zijbalk bij een contact iets anders ingedeeld. Informatie over partners en kinderen staat nu bovenaan de zijbalk, omdat dat volgens mij veel belangrijker is dan bijvoorbeeld het adres van het contact.

Deze wijzigingen zitten in versie 1.1.0, die al in productie staat, en je kunt hem, zoals altijd, installeren op een server die van jou is.

Veel plezier ermee.

Monica is eindelijk klaar voor v1.0.0.

We proberen bij Monica de SemVer-aanpak te volgen. Een nieuw hoofdversienummer duidt op grote wijzigingen in de API. Daarom ben ik erg blij de release van v1.0.0 aan te kondigen. Er komen veel functies bij en het vormt de basis voor alle mooie dingen die ik de komende maanden wil uitbrengen. Eerst de functies, daarna de technische veranderingen in deze versie.

API

Monica heeft eindelijk een API. Nog niet alles is via de API beschikbaar, maar de meeste gegevens over contacten wel. Een volgende versie brengt ook alle instellingen en accountgegevens. Mijn doel is dat alles via de API beschikbaar is. We ondersteunen OAuth 2.0 en persoonlijke tokens. Onder de motorkap regelt Laravel Passport alles rond OAuth.

Niets helpt ontwikkelaars beter een project in te duiken dan goede documentatie. Daarom hebben we ook een nieuw documentatieportaal uitgebracht dat zo volledig mogelijk probeert te zijn. Op elke pagina staat ook de datum van de laatste wijziging, zodat je weet hoe actueel de documentatie is.

Het is nu aan de ontwikkelaars om creatief met de gegevens van Monica om te gaan en er mooie dingen mee te doen. Aan onze kant werken we aan de eerste officiële mobiele applicatie voor Monica, voor zowel Apple als Android, maar daarover later dit jaar meer.

Hoe je iemand hebt leren kennen (oftewel kennismakingen)

Monica bestaat om iedereen te helpen belangrijke informatie te onthouden over de mensen die hun dierbaar zijn, privé en alleen voor eigen ogen. Als je veel contacten hebt, is het soms lastig te onthouden hoe en waar je ze hebt leren kennen. Daarom kun je nu noteren hoe je iemand hebt ontmoet, of dat een ander contact jullie aan elkaar heeft voorgesteld. Je kunt zelfs vragen om aan de verjaardag van die ontmoeting herinnerd te worden.

Een contact als overleden markeren

Soms is het leven oneerlijk en gaan mensen dood. We hebben de mogelijkheid toegevoegd een contact als overleden te markeren, met eventueel een datum voor die trieste gebeurtenis. Je kunt er bovendien aan herinnerd worden als je dat wilt. Is een contact als overleden gemarkeerd, dan staat er in de hele applicatie een klein ⚰ naast de naam.

Sneller contacten toevoegen

Ons doel is je zo snel mogelijk te helpen doen wat je wilt. Daarom hebben we een kleine knop toegevoegd aan het scherm om een contact toe te voegen, waarmee je het huidige contact opslaat en er meteen daarna een nieuw contact bij zet. Dat scheelt je kostbare seconden.

Grote veranderingen onder de motorkap

Voor v1.0.0 hebben we de code bijgewerkt naar Laravel 5.5, om voor onze API gebruik te maken van de mooie Resources-functionaliteit die in die versie is geïntroduceerd.

Dankzij @mauricew hebben we ook het vorige buildsysteem voor de front-end, gebaseerd op Gulp en Bower, vervangen door mix, het standaard buildsysteem dat nu bij Laravel zit. We hebben veel afhankelijkheden kunnen verwijderen, de code kunnen opschonen en, belangrijker nog, ervoor kunnen zorgen dat er in de toekomst geen conflicten meer ontstaan tussen CSS- en JS-bestanden in onze pull requests.

Tot slot

Versie 1.0.0 staat al in productie en je kunt hem, zoals altijd, installeren op een server die van jou is.

v1.0.0 bevat letterlijk duizenden nieuwe regels code. Het is het resultaat van een gezonde gemeenschap. Persoonlijk voel ik me erg bevoorrecht dat Monica zoveel mensen helpt. Jullie voortdurende feedback helpt me enorm om zo hard mogelijk aan dit product te blijven werken. De komende maanden worden erg druk: veel nieuwe functies, een mobiele applicatie en andere verrassingen. De toekomst ziet er goed uit voor onze gemeenschap.

Veel plezier ermee.

Ik ben de afgelopen 40 dagen wat minder actief geweest in de communicatie. Ik ben ook trager met het beantwoorden van issues en het samenvoegen van pull requests. Dat is geen situatie die me bevalt, maar het is moeilijk voor me om daar de komende maand iets aan te veranderen. Het wordt wel beter.

Waar ben ik in vredesnaam mee bezig

Ik werk zoveel ik kan aan het project. Elk vrij uur dat ik heb gaat naar Monica. Om alle mensen gerust te stellen die me blijven mailen over mijn betrokkenheid bij het project en of ik het niet snel laat doodbloeden: ik ben er nog net zo gemotiveerd voor als eerst en het blijft een prioriteit voor me.

Op dit moment werk ik echter aan de API en zorg ik dat die werkt zoals het hoort. Ik bouw ook de documentatie eromheen, want de documentatie moet uitstekend zijn wil iemand de API gaan gebruiken. Om die redenen, en ook omdat dit voorlopig nog een project naast mijn werk is totdat ik manieren vind om het mijn fulltimebaan te maken, wil ik me nu niet laten afleiden door feedback, bugs of nieuwe functies. Zodra de API klaar is, ga ik weer met de gemeenschap in gesprek. Ik heb simpelweg niet de fysieke tijd om alles te doen wat ik zou willen, en ik moet me heel scherp richten als ik dingen af wil krijgen.

Wat komt er hierna

De komende dagen verschijnt er een eerste opzet van de API, met daarna nieuwe methodes erbij.

Zodra de API klaar is, moeten we aandacht besteden aan het idee van activiteiten met je contacten. We zouden het dashboard nuttiger moeten maken en het dagboek zo veranderen dat het echt bruikbaar wordt. Ook moeten we het CardDAV-protocol implementeren, al weet ik op dit moment niet hoe goed dat in de huidige opzet past.

Ik ben ervan overtuigd dat dit project enorme mogelijkheden heeft. Ben je nu al gebruiker, dan zoek ik nog steeds feedback en ervaringen. Bedankt voor je hulp.

De meest gevraagde functie in Monica (sinds de vorige) was de mogelijkheid een bestaand contact aan te wijzen als partner of kind. Met 0.6.3 kan dat.

Hoe werkt het

Als je een partner of een kind toevoegt, heb je nu twee nieuwe mogelijkheden:

• Je kunt bij het toevoegen van deze nieuwe persoon kiezen tussen een gedeeltelijk contact of een volwaardig contact. Een gedeeltelijk contact is de oude manier: die contacten staan niet in de contactenlijst en je kunt er geen eigen herinneringen of notities aan hangen. Bij een "echt" contact wordt er daadwerkelijk een nieuw contact aangemaakt voor deze persoon, en kun je daar weer eigen kinderen of partners aan toevoegen.

• In plaats van een nieuw contact aan te maken, kun je ook simpelweg een bestaand contact koppelen als kind of partner van dit contact.

Dit was tot nu toe de grootste verandering in de code, en degene die de meeste tijd kostte. Wie Monica zelf host: wees voorzichtig bij het bijwerken van je installatie en maak vooral een back-up van de database voordat je upgradet.

Andere belangrijke wijzigingen in deze release

• Voor wie van polygamie houdt: je kunt meer dan één partner per contact hebben.
• Nieuwe vertalingen toegevoegd: Italiaans en Duits. Dank aan de gemeenschap.
• Ondersteuning voor Markdown in notities en genoteerde telefoongesprekken. Daarmee kun je bijvoorbeeld lijsten gebruiken.
• We ondersteunen nu alle valuta ter wereld.
• Veel opgeloste fouten en een aantal beveiligingsfixes.
• We zijn begonnen Tachyons als nieuw CSS-framework te gebruiken. Dat gaat Bootstrap geleidelijk vervangen.

Tot slot

Versie 0.6.3 staat al in productie en je kunt hem, zoals altijd, installeren op een server die van jou is.

Veel plezier ermee.

We hebben zojuist een geweldige mijlpaal bereikt.

Dat is fantastisch en een mooie mijlpaal die ik graag met jullie allemaal deel. Gebruikers hebben tot nu toe meer dan 50 000 contacten in Monica gezet, en dat aantal groeit elke dag. Daar zitten de installaties die mensen op hun eigen server hebben gedownload en geïnstalleerd niet eens bij.

Persoonlijk sta ik versteld van de gemeenschap rond het project. Op GitHub hebben we meer dan 200 pull requests uit de gemeenschap ontvangen en mensen lijken het project overal op internet te delen om het goede nieuws te verspreiden.

Ik kan niet wachten om te zien waar we over een jaar staan. Bedankt allemaal voor het vertrouwen.

Als je Monica installeert op een server die van jou is, wil je waarschijnlijk weten wanneer er een nieuwe versie beschikbaar is. Met Monica 0.5.0 is dat precies wat je krijgt.

Hoe werkt dit

Kort gezegd stuurt je Monica-installatie dagelijks een ping naar https://version.monicahq.com. Die ping bevat drie gegevens:

• een UUID: de unieke, anonieme identificatie van je installatie.
• de huidige versie van je installatie
• het aantal contacten in je installatie.

Dat laatste gebruik ik om te weten hoe groot de installaties zijn van de mensen die Monica downloaden. Ik moet dat weten (en alleen dat) zodat ik verder kan met een beter beeld van hoe mensen Monica gebruiken. Er is bovendien geen enkele manier om te weten wie je bent: de UUID is willekeurig, uniek en anoniem.

De code van https://version.monicahq.com is open source en staat op GitHub, zoals alles wat we doen.

Als antwoord op die aanroep krijg je een JSON met:

• of er een nieuwe versie beschikbaar is, als booleaanse waarde,
• wat de nieuwste beschikbare versie is,
• alle releasenotes van elke release sinds de versie in de ping,
• het aantal versies dat er sinds de versie in de ping is verschenen.

Die informatie wordt in de interface gebruikt. In de voettekst verschijnt een nieuwe link als er een nieuwe versie is. Klik je erop, dan opent er een venster met de releasenotes van de nieuwe versie.

Hoe schakel je dit uit

Elke functie die iets fundamenteels aan Monica verandert kan worden uitgeschakeld, en deze is niet anders. Wil je voorkomen dat er informatie naar https://version.monicahq.com gaat, voeg dan het volgende toe aan je .env-bestand:

• CHECK_VERSION=false

Dat is alles. Er verlaat dan nooit informatie je server. Het nadeel is dat je niet automatisch bericht krijgt als er een nieuwe release is.

Zoeken in je contacten

Je kunt nu in je contacten zoeken met een nieuw zoekveld in de kop. De zoekactie kijkt naar de volgende gegevens van je contacten:

• Voor- en achternaam
• E-mail
• Straat
• Plaats
• Postcode
• Provincie
• Voorkeuren voor eten
• Beroep
• Bedrijf

Zoeken zou ook behoorlijk snel moeten zijn. We zijn erg blij met deze functie.

Tot slot

Versie 0.5.0 staat al in productie en je kunt hem, zoals altijd, installeren op een server die van jou is.

Veel plezier ermee.

Bijhouden wat je tegen de mensen die je dierbaar zijn hebt gezegd is belangrijk. Notities over je contacten bewaren kon al. Nu kun je ook een telefoongesprek noteren, wat heel handig is om te weten wanneer je iemand voor het laatst hebt gebeld en waar jullie het toen over hadden.

Versie 0.4.0 staat al in productie en je kunt hem, zoals altijd, installeren op een server die van jou is.

Veel plezier ermee.

Let op: dit is een technisch bericht.

Nadat ik Monica op Hacker News had gelanceerd, kreeg ik veel vragen over waarom ik het hulpmiddel in PHP en met name in Laravel heb geschreven. Ik was eerlijk gezegd verbaasd over zoveel vragen hierover, want ik vind dat een taal er niet toe doet: alleen wat je ermee doet telt.

In dit bericht vertel ik waarom ik voor PHP en Laravel heb gekozen en welke moeilijkheden ik moest overwinnen om de eerste versie van het product te bouwen. Dit bericht is niet bedoeld om een oorlog tussen talen te beginnen.

PHP heeft een interessante geschiedenis. Veel goede webontwikkelaars, die waarschijnlijk allang geen PHP meer gebruiken, hebben er de beginselen van het programmeren mee geleerd. Het was zo eenvoudig om te gebruiken en om mee te beginnen, en hoewel het geen elegante taal was, effende het de weg naar een carrière in webontwikkeling. Daarna werd PHP steeds minder geliefd, tot het punt dat het bijna gênant was om PHP te gebruiken of zelfs maar op meetups te zeggen dat je bedrijf het gebruikte. Andere talen, aantoonbaar eleganter, werden erg populair (Python, Ruby) dankzij prachtige frameworks die erop gebouwd werden. Tegelijkertijd verschenen er nieuwe PHP-frameworks. Symfony bijvoorbeeld. Maar Symfony was nog steeds lastig te leren en te gebruiken. En toen stierf PHP. Dat zeiden mensen althans, en ze negeerden daarbij blijkbaar dat heel veel bedrijven het nog steeds gebruikten en er dol op waren. Toen kwam PHP 5.5, gevolgd door PHP 7, en verscheen er een nieuw framework met een rare naam: Laravel. En het beeld dat mensen hadden veranderde volledig. PHP is nog steeds niet zo elegant als andere populaire talen, maar het is er veel op vooruitgegaan. En het werd ook snel.

Toch blijft PHP de taal die mensen graag haten, vooral op Hacker News. Ze zeggen dat PHP niet schaalt. Dat zal wel de reden zijn dat Facebook en Mailchimp, onder andere grote namen, PHP vandaag op enorme schaal gebruiken.

Waarom heb ik met die achtergrond voor PHP en Laravel gekozen?

• PHP is eenvoudig te leren en eenvoudig te gebruiken.
• Er zijn heel veel PHP-ontwikkelaars, en als mensen met mij aan het project willen werken is de vijver aan PHP-ontwikkelaars, in elk geval waar ik woon, groter dan die aan Ruby- of Python-ontwikkelaars. Bovendien gebruiken veel mensen op GitHub PHP, en als ik wilde dat dit open source project ergens zou aanslaan, moest ik het schrijven in een taal waarin mensen van heel verschillend niveau makkelijk konden bijdragen.
• Het belangrijkste bij het kiezen van een technische basis voor een nieuw project is hoe makkelijk het op de lange termijn te onderhouden zal zijn. PHP is eenvoudig. Het is makkelijk te debuggen (al kon dat beter) en makkelijk te schalen (al is dat op dit moment totaal mijn zorg niet).
• Laravel is verreweg het beste PHP-framework dat ik ooit heb gebruikt. Het maakt ingewikkelde dingen zo eenvoudig. Het is duidelijk dat het framework is gemaakt om heel snel nieuwe webapplicaties te beginnen, en het is echt een genot om mee te werken. Maar de sterkste eigenschap van Laravel is de kwaliteit van de documentatie, vergeleken met andere PHP-frameworks en zelfs met veel frameworks in andere talen. Alles is uitstekend gedocumenteerd. Ik kan niet genoeg benadrukken hoe belangrijk goede documentatie is (wat me eraan herinnert dat ik Monica nog beter zou moeten documenteren).
• Er is een enorme gemeenschap rond PHP en Laravel in het bijzonder: Laracasts, Forge, Envoyer en een sterke Slack-gemeenschap, om er een paar te noemen. Heb je hulp nodig, dan staan er veel mensen klaar om die te geven.

Welke uitdagingen kwam ik tegen tijdens dit project?

Al met al liep ik tijdens het bouwen van de huidige versie van Monica niet tegen zoveel uitdagingen aan. Het is geen ingewikkelde applicatie, en ik heb geen schaalproblemen omdat het aantal gebruikers nog vrij klein is (ongeveer 7800 gebruikers in totaal en 4300 actief). Maar er zijn wel wat implementatiekeuzes die ik verkeerd heb gemaakt, niet omdat het slechte programmeergewoontes waren, maar omdat mijn technische vaardigheden op dat moment niet goed genoeg waren om die problemen snel op te lossen. Hopelijk helpt het opsommen van die fouten anderen ze te vermijden, of sturen aardige mensen me een mail over hoe ik ze had kunnen oplossen.

• In eerdere versies gebruikte ik veel events en listeners. Het concept is prachtig, maar ik had er veel problemen mee bij het unittesten van de basisklassen. Bovendien gebeurde er, hoe meer ik ze gebruikte, hoe meer magie achter de schermen. Ik dacht dat mensen die in de code doken moeite zouden hebben te begrijpen waarom sommige dingen gebeurden zodra er bijvoorbeeld een object werd aangemaakt. In mijn hoofd maakten events en listeners de applicatie moeilijker te begrijpen, dus besloot ik ze allemaal te verwijderen (nou ja, 99% ervan, er zijn nog twee listeners waar ik vanaf moet).
• In het begin was de database volledig versleuteld. Om redenen die ik nog steeds niet begrijp gingen er af en toe dingen mis bij het ontsleutelen, wat leidde tot gegevens die ik niet kon herstellen. Omdat ik dat probleem in dit stadium niet wilde oplossen, besloot ik de versleuteling te verwijderen. Daar kwam bij dat versleutelde gegevens het onmogelijk maakten om in mijn queries te sorteren of te zoeken, wat op de lange termijn lastig had kunnen worden. Er zijn vast oplossingen voor deze twee problemen, maar ik wilde me richten op het maken van nieuwe functies in plaats van op dat ene probleem.
• Ik heb geen unittests geschreven voordat ik de applicatie lanceerde. Dat heeft me flink pijn gedaan. Ik denk niet dat we naar 100% testdekking moeten streven, maar zorg op zijn minst voor enige tests voor de belangrijkste functies van je site. Anders eindig je met een berg bugs waar je niet aan gedacht had, en terwijl je die probeert op te lossen raken andere delen van de applicatie beschadigd door je oplossing. Dat wordt al snel een nachtmerrie. Laravel maakt unittesten heel eenvoudig; ik had dat serieuzer moeten nemen. Vanaf de volgende versie van Laravel wordt geen enkele pull request samengevoegd zonder unittests en misschien zelfs functionele tests.

Conclusie

Dit zijn een paar redenen waarom ik voor Laravel heb gekozen. Zoals ik aan het begin van dit bericht zei: je project gaat niet over de taal. Tenzij je project juist bedoeld is om een nieuwe taal te leren, moet je geen weken besteden aan het kiezen van een taal of framework. Blijf bij wat je kent en maak gewoon iets. Je gebruikers zal het niets kunnen schelen dat je code lelijk is of dat je Python boven Ruby hebt gekozen.

Amper 5 dagen na v0.2.0 alweer een grote release. Zo groot dat er een nieuw versienummer voor nodig was.

Heb je veel contacten in je account, dan kun je ze nu indelen met labels. Labels lijken op mappen, maar je kunt meerdere labels aan één contact hangen. Dat geeft je maximale vrijheid om je contacten te ordenen zoals jij dat wilt.

Labels kun je invoeren direct onder de naam van het contact.

Zodra contacten labels hebben, zie je ze in de contactenlijst en kun je erop klikken om de lijst te filteren.

Tot slot kun je labels verwijderen, zowel vanuit het contact als in een nieuw instellingenscherm dat daarvoor is gemaakt.

Versie 0.3.0 staat al in productie en je kunt hem, zoals altijd, installeren op een server die van jou is.

Veel plezier ermee.

Een van de grootste wensen is de mogelijkheid contacten uit Google te importeren. Google laat je gegevens over je contacten exporteren in het vCard-formaat, de universele standaard om contactgegevens uit te wisselen. Monica 0.2.0 voegt de mogelijkheid toe je gegevens uit een vCard-bestand te importeren (.vcard of .vcf), zodat je je account met het grootste deel van je gegevens kunt vullen in plaats van je vrienden één voor één toe te voegen.

Zodra je contacten geïmporteerd zijn, kom je op een overzicht waar je de status van de import kunt zien. Omdat gebruikers duizenden contacten kunnen hebben, importeert Monica ze asynchroon. Je zult even moeten wachten voordat alle contacten binnen zijn.

Je kunt op een specifieke import klikken om te zien wat er gebeurd is.

We hebben ook een functie toegevoegd om je account leeg te maken, wat goed van pas komt als je duizenden contacten importeert en er iets misgaat. Een account leegmaken verwijdert alles, behalve jou.

Versie 0.2.0 staat al in productie en je kunt hem, zoals altijd, installeren op een server die van jou is.

Veel plezier ermee.