0 Comments

Nekidan na Twitter feedu vidio cvrkut da je Infinium napravio Ruby utility za prikaz upozorenja o korištenju cookia na webu. I pomislih, srijeda je ionako najdepresivniji dan u tjednu, ajmo se zabavit i napraviti .NET port tog utilitya! Dva sata kasnije, source je bio na Gitubu, a nedugo zatim objavljen je i PHP port!

Prema europskom zakonu web site mora prikazati obavijest da se cookiji koriste za praćenje korisnika, što je lijepo objašnjeno na Infinium blogu.

Poanta ovog utilitya (class library dll) je omogućiti dodavanje obavijesti jednostavnim umetanjem jedne linije u vaš HTML kod ASP.NET MVC aplikacije (Razor sintaksa):

@Html.Raw(Consent.Instance.Install())

ili dodavanjem opcionalnih parametara:

@Html.Raw(Consent.Instance.Install(linkUrl:"/kolaciciinfo.html"
    messageText:"ovaj web site koristi kolačiće",
    okkText:"okej",
    learnMoreText:"želim znati više!"))

za prikaz se koristi jQuery  i jQuery cookies plugin. Instalacija je putem Nuget-a. Unutar biblioteke se nalaze lokalizacije za engleski i hrvatski jezik, iako je u source dodan i klingonski, ali kod kompajliranja potrebni resource dll-ovi se ne kopiraju u Bin/Release i Debug direktorije, pa se klingonska lokalizacija nažalost ne nalazi u Nuget paketu Tužni smiješak Ako netko zna zašto .NET ne kompajlira tlh-KX kulturu, bio bih jako zahvalan na toj informaciji!
Source sadrži i potrebne unit testove, a da bi mockali (podvalili lažni) HttpContext koji nije dostupan u unit test projektu, Consent klasa prima ICookieService interface preko kojega čita i piše kolačiće. Dependency injection za sirotinju, dakle.

Par savjeta oko izrade biblioteke i distribucije putem Nugeta:
-  ako dodajete neke txt, html, … datoteke u vaš class library, označite ih kao “Embedded Resource”. Primjer čitanja takvih datoteka možete pronaći u sourceu
- ako niste vični radu u komandnoj liniji i Gitu, možete koristiti GUI alate Github Windows i Sourcetree (ja koristim Sourcetree)
- ne šaljite DLL-ove u source kontrolu! Koristite Nuget package restore funkcionalnost, i dodajte Bin/ i Debug/ foldere u .gitignore listu. Isto vrijedi za sve ostale source kontrole.
- dodajte readme.md i opišite vašu biblioteku. Github koristi markdown sintaksu pisanja
- Nuspec datoteka je XML opis vašeg paketa kojega želite objaviti na Nugetu. Za kreiranje i objavu se može koristiti Nuget Package Explorer. Nuspec također držite u Githubu.
- izrada open source softwarea je najbolji način dobivanja (novog) posla i zapošljavanja: na interview-u ili na natječaj samo pošaljite vašu Github/bibucket stranicu uz standardni CV/Linkedin profil, i dobroj firmi odnosno poslodavcu to govori jako puno o vama kao programeru!

https://github.com/hudo/EUCookiesNET