Giter Club home page Giter Club logo

kerst's Introduction

kerst

Drawing lots with the family for Christmas. Do you want to celebrate Christmas with presents? And do you want everyone to prepare a present for someone? And do you want to link givers and receivers in advance such that everyone gives and receives one present? Then you may be interested in this project. It is an open-source alternative for commercial sites.

Usage

  • You need a dedicated email address. This is needed for technical reasons, but it is also nice to impersonate Santa Claus with his own email address. I tested with a gmail address.
  • IMPORTANT: You probably want to make sure that you will not see everyones lots. For Gmail, you should make a filter for your new email address that deletes all messages coming FROM itself. You should check that the sent folder remains empty during test runs.
  • For Gmail, you need to turn on "Allow less secure apps". Go to your new Google account, select "Sign-in & security" and then "Apps with account access".
  • Under src/main/resources, make a property file named credentials. Here go the username and the password of Santa Claus' email address. This address will send the emails. The property names are username and password.
  • Santa Claus tells a better story then "blabla". Edit src/main/resources/body.html to tell it.
  • Edit class com.github.mhdirkse.kerst.Member with the members of your party. While testing, I recommend that you give every member your email address. Then you do not disturb them with your test runs.
  • The mail opens with a picture presenting Santa Claus. You may want to replace this picture. It is file src/main/resources/home.jpg.
  • Some unit tests may fail now because the Member class was edited. Fixing them should be trivial.
  • Google limits the number of emails you can send with their SMTP server. To test, please make some code that runs com.github.mhdirkse.kerst.MailSender. You want to send only one email at a time when you are testing your message contents.
  • When all your tests were successful, do not forget to enter the real email addresses in class Member.
  • Run the app to invite and draw lots!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.