First Of all, i would like to say thanks to PHP-EDITORS.COM
for making such an effort to organize this contest.
This is my first PHP application since i know the language about 2 month ago.
So, pardon me for all the chaos coding :p

Installation : How to setup MyDiary
-------------------------------------------------

MyDiary is built using MYSQL the database Platform.

So, First of all, you need to create a MYSQL database..
If possible, please name it mydiary

Next, use the provided MYSQL-Dump file (mydiary.sql)
to create Database structure.

When done setting up the database..

edit the mydb.inc file, to change your password, user name.. etc.
make sure the $db_dbase is the same as the database name you just created
this file should be edited carefully, as it is the heart for the application to make a database connection
Screwing up on this will result ina no comply situation.. or in ither word, a whole lot of errors..

After finish editing the mydb.inc,

Run the index.php

Since this is your first time using this application,
you will be prompted to a installation page

Please fill in all the information accurately,
as some of it, (especially E-Mails!)
will be used as part of the program
(e.g lost password, mail contact.. etc.)

click 'Register MyDiary' to complete registration..

you will now redirected back to index.php.

Login using your password, and you can now start using Mydiary.

------------------------
How To : Mydiary features
-------------------------

MyDiary consist of a 'To Do List', Appointment tracking, and also a Reminder, besides the COntact features.
Here's a brief explanation on what each of them do.

-----------
To Do List.
-----------

Basically, this is for user to keep track of what they need to do on that particular day.
This feature would best use to say, record or plan personal chores.
This could also be used for scheduling purposes.

How to Use TO DO List.

To View List
---------------
By default, To Do List will show you the schedule for the current day
if you would like to view other day's list,
simply select your month and year, then press go.
after that, choose a specific date.

To Add List
-----------
To add a list on the current date, just oress the + add list button
Select your time, and then fill in the particulars.

you can either press Done when you have fill in the particulars you need.

or if you would like to add more list, just simply press the Add More Button

If you would like to add list to a specific date,

on the add list page, simply select your month and year, then press go.
after that, choose a specific date. the rest is the same as above.

if you decided not to put anything, just press cancel.
you'll then be brought back t the View list page.

To delete a specific list
-------------------------

on the view list page, there is a delete button under each To Do List.
Simply pressing the Delete button will delete your to do list.

To Go To Current Date
-----------------------

Incase if you are lost while browsing the dates...
and you would like to get back to current date,
dont worry, MyDiary has provided a 'Go To current Date' link.
just click to the 'Go TO Date' Tab.

Navigating the view.
---------------------
there are two arrows at the bottom right of the view page
that you can use as navigational purposes.
the blue button would bring you to the next or previous day
and the yellow button will navigate you trough the page,
in case the selected list consist of more than one viewable page.

------------
Appointment
-------------

The Appointment features is used to track appointments and meeting.
Basically, this feature will provide you a brief detail of a specific meeting.

How to Use Appointment Features.
-----------------------

To View Appointment
---------------
By default, the Appointment page will show you the appointment for the current day
if you would like to view other day's appointment,
simply select your month and year, then press go.
after that, choose a specific date.

To Add an appointment
---------------------
To add a list on the current date, just press the + add appointment button
Select your time, and then fill in appointment details and the place where the appointments will be held..

you can either press Done when you have fill in the particulars you need.

or if you would like to add more appointment to the displayed date, just simply press the Add More Button

If you would like to add appointments to a specific date,
on the add appointment page, simply select your month and year, then press go.
after that, choose a specific date. the rest is the same as above.

if you decided not to put anything, just press cancel.
you'll then be brought back t the View appointment page.

To delete a specific appointment
-------------------------

on the view appointment page, there is a delete button under each List.
Simply pressing the Delete button will delete the appointment.

To Go To Current Date
-----------------------

same as above,
just click to the 'Go TO Date' Tab.

Navigating the view.
---------------------
there are two arrows at the bottom right of the view page
that you can use as navigational purposes.
the blue button would bring you to the next or previous day
and the yellow button will navigate you trough the page,
in case the selected list consist of more than one viewable page.

--------
Reminder
--------
the reminder feature is for user to keep track of an annual happenings...
or things that would occur every year on the same date...
this would best used to keep birthday's annivesaries, payment notice, or even any other thing
that repeats itself every year.. (e.g Holidays or festivals..)

To View reminder
---------------
By default, the reminder page will show you the reminder list for the current day
if you would like to view other day's reminder note,
simply select your month, then press go.
after that, choose a specific date.
Since reminder are not Year Specific, it would make no diffrence to what year you choose.

To Add an appointment
---------------------
To add a reminder on the current date, just press the + add reminder button
Select the type of reminder, and then fill in the reminder's details

you can either press Done when you have fill in the particulars you need.

or if you would like to add more reminder to the displayed date, just simply press the Add More Button

If you would like to add reminder to a specific date,
on the add reminder page, simply select your month, then press go.
after that, choose a specific date. the rest is the same as above.

if you decided not to put anything, just press cancel.
you'll then be brought back to the View reminder page.

To delete a specific reminder
-------------------------

on the view reminder page, there is a delete button under each List.
Simply pressing the Delete button will delete the selected reminder.

To Go To Current Date
-----------------------

What? your lost again?? dont worry!!:)
same as the above, just click to the 'Go TO Date' Tab. :)

Navigating the view.
---------------------
there are two arrows at the bottom right of the view page
that you can use as navigational purposes.
the blue button would bring you to the next or previous day
and the yellow button will navigate you trough the page,
in case the selected list consist of more than one viewable page.

The contact Features
--------------------

The contact features are as same as any handy address book...
it keeps all the necessary detail about a certain contact.
you can keep track of your friends here...

To Add a contact to your list
--------------

To add a contact person, just press the + add contact button
Fill in all the particulars. and when your done, press the + add contact button

if you decided not to put anything, just press cancel.
you'll then be brought back to the view contact page.

To View Contact Detail
----------------------

The contact view page will only display
the names, email, home phone numbers and mobile number
of a contact for a quick view...

if you would like to view more details,
simply clicking the view full button will bring you to the contact full details view.

To Edit or Delete a contact.
----------------------------

To delete a contact from your contact list
(in case if you think that fella is a waste of database space :p)
simply go to a Full View of the particular person
Pressing he delete button will delete the contact person instantly
There, the fella is gone now... at least in your contact detail.

to edit a contact persons info
(incase a change of address.. or simply a typo error...)
just click the edit button (next to the delete button !) on the View Full page.
you will then be brought to a edit page.
Edit the contact info that you want to change.
press Done when finish editing.

In case you decided not to do anything, just press cancel..

Email your contact
------------------

MyDiary has a built in Email Funtion.
to email a contact, just clik his or her email address...
(provided that your contact has one )
you will then arrive at an simple email page...
choose which one of your email you want to use to email this contact,
then enter the subject, write your email, and press send.

You will have a confirmation that your email has been sent...
then you will automatically redirected to the view contact page.

Search a contact
------------------

yup, you can easily search a contact by entering the name (or part of it)
in the search box at the top right of the contact view page.
dont forget to press the search button to start searchin'

clicking the contact search result will take you to the view full page.

Navigating the view.
---------------------
there are two arrows at the bottom right of the view page
that you can use as navigational purposes.
the blue button would bring you to the next/previous contact alphabet tab
and the yellow button will navigate you trough the page,
in case the selected list consist of more than one viewable page.

MyDiary's Other Features..
-----------------------------

Forgot your password??
-----------------------

incase if you forgot your password,
(memory lost.. or to much password to remember...)
dont worry, just enter any wrong password,
you will then be prompted with an error message,
together with an link for you to get your newly generated password
e-mailed to your personal email
(aaa.. now you know why i insist you enter a correct email in the registration process)
Check you mail,
enter the password...
your once again log in.

To change your password... read the next feature..

myProfile Tab Feature..
--------------------

my profile tab would allow you to make changes on your personal info.
it also has a button that you can click to go to the MyDiary settings..

at the mydiary settings,
you can change your password...
(making this a habbit is a good thing y'know)
you can also use this to change your password
incase if you have lost ercently your password.

in this tab, you can also change the way you want to log in.
by selecting 'YES' to the 'skip password login'
would enable you to login without having to enter password.
but make sure you seriously consider this, since a no password login
always means anybody can access your MyDiary.

MyDiary Future : So.. what's next..??

Well,, here are some plans for the next version...

• Do a proper help files / read me files..
• i plan to include a budget function, so you can track your cash flow...
• ermm.. i also have the intention to include
  a menstruation tracking feature for all the ladies out there.
  So then, they can track their menstruation cycle, say for health purposes
  or just simply for family planning...
• i also would like to upgrade the security feature...
• maybe develope a multi user capability.
  (in case you did not notice, the current version only support single user)
• and the most importantly, squah all the current bugs...

MyDiary Final COmment
-----------------------

I hope someone would find this useful, as i had..
without the contest, i probably dont quite ready to program any application yet..
This is my first try developing anything on PHP + MYSQL
So go easy on me will ya..
If you would like to contact me, you can reach me at jassh@mail.com

In case if anyone would like to know what make this MyDiary possible (or almost possible)
here's a list..

PHP-EDITOR.com
without em, i'd probably never had thought i could have done it..

A whole lotta potato chips, cornflakes, snacks and LinKin Park Latest Album... Meteora
-without this all, i'd probably drown in my own coding..

A very special person
The one inspiration that i need to build this application.
the morale boaster... that very special motivational catalyst..
Without her, this would not have been possible achieved...

MyDiary Copyrights..
--------------------

Respect MyDiary as you would like your stuff to be respected by others.
I wouldnt mind any modification made, as long as you e-mail me about it.
I might learn a lot by this too... since i honestly state that i'm a noobie..