< FothoFax V0.31 >

? 10 week calendar
 MTWTFSS
Apr 15 16 17 18 19 20 21
Apr 22 23 24 25 26 27 28
Apr 29 30 01 02 03 04 05
May 06 07 08 09 10 11 12
May 13 14 15 16 17 18 19
May 20 21 22 23 24 25 26
May 27 28 29 30 31 01 02
Jun 03 04 05 06 07 08 09
Jun 10 11 12 13 14 15 16
Jun 17 18 19 20 21 22 23

V0.31 Documentation
Note: This is an old version of the software.

V0.31 Features

  • Various bugfix's and code improvements (see the changelog in the README file).
  • Added anniversary reminder.
  • All features of the previous version:
    • A calendar with a small footprint displayed week by week.
    • Displays birthday reminder symbols with popup birthday information. (for an example, hover your mouse over a candle icon)
    • Displays remembrance symbols for people who have passed away.
    • Indicates whether an event has been planned on a day by making the day number bold.

Installation notes:

  1. Pre-requisites: You have write permission to a directory accessible to a webserver that runs PHP (The software has been tested using PHP Version 4.4.0).
  2. Download fothoFax.zip. When you unzip it a new directory called "FothoFax_0_31" will be created. Move the new directory to a location accessible to your webserver via a URL.
  3. Use a browser to look at the index.php file in the FothoFax_0_31 directory. Hopefully, you can see a test page that has a working version of fothoFax using dummy data.
  4. Open AddressBook.txt in a text editor and replace the dummy names with real ones (keeping the same format) so fothofax has some meaningful data to display. Do the same for the EventsBook.txt file. Alternatively, replace them with a symbolic link to a wikiwiki page so that you can edit the data online. e.g.
    sudo ln -s /var/www/html/myPublicWiki/data/text/AddressBook AddressBook.txt
    sudo ln -s /var/www/html/myPublicWiki/data/text/EventsBook EventsBook.txt
    
  5. Optional: Edit the fothoFaxConfig.inc file. For example, change the variable called "$bdayFileEditURL" in FotherFaxCode.php to the location where the AddressBook.txt can be edited (e.g. a wikiwiki page) or set it as blank.
  6. Optional: embed fothofax into another part of your website (it's not much good in a page all on it's own).

Instructions on storing data

Two data files are needed. One is used to store people's birthdays and the other is used to store dates of events. These two files are simple text files:

This is an example of the structure of the file used to store birthdays:

 * Name: Edd
  * Birthday: 09/Jul/1983
 * Name: James
  * Birthday: 20/Jun/1992
 * Name: Test
  * Birthday: 25/Aug/1992
 * Name: Dad
  * Birthday: 17/Sep/1953
  * Deathday: 27/Jul/2001
 * Name: Mum
  * Birthday: 28/Apr/1954

This is an example of the structure of the file used to store events:

 * Date: 01/Dec
  * Event: Go for a walk on the riverbank.
 * Date: 03/Dec
  * Event: kill an hour with a wiskey sour.
 * Date: 08/Dec
  * Event: Feed the ducks with stale bread.
  * Event: Try to not think about polar bears
 * Date: 15/Dec/06
  * Event: Notice that this event has a year. i.e. it is not recuring!
  * Event: Have a staring contest with ourselfs in the mirror.
  * Event: Snap our fingers as if suddenly we have a bright idea and see if we get any.

This data is static right? Yes but although these text files can be kept anywhere, I choose to keep them as a wiki page so I can edit them online and immediately see the updates in FothoFax.