[j101399j]

I have moved the active version of this here:
http://forum.xda-developers.com/showthread.php?t=542727



Preparation

FIRST and MOST IMPORTANT: Back up your phone

1. Start by downloading one of the iPhone_Today.cab files from the 1st post (http://forum.xda-developers.com/showthread.php?t=508429)

1.If you download v1.0; then it will install all the files for you; just copy to your phone and install. Skip steps 2-5

2. Download the “icons and settings.zip” from the 1st post

3. Unzip the “icons and settings.zip” file to the PC. It will create a folder named “iPhoneToday” (it has the icons.xml, settings.xml and icons folder)

4. Edit the settings file (see below)

5. OPTIONAL, if you want to do this the old way, edit the icons file (see page 5). If you want to do this the simple way, don't manually edit the icons.xml file; trust me it creates headaces.
--------------------------------------------------------------------------

Editing the settings file

I recommed using v1.0 and not editing the settings file manually. Just goto Start-->Steeings-->Today select the iPhoneToday plug-in and click options. That file is self expaining. Really if you get a scroll bar, change the screen height till it goes away. If you like to torture yourself you can edit it the old way, see below...

The old and complex way; doing it yourself:

On your PC Edit the setting.xml file with notepad. There are a lot of settings you can mess with, I only recommend touching these:

Start with: <?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<root>

a. <iconWidth>48</iconWidth>
This is the size of the icons in pixels

b. <numIcons>4</numIcons>
This is how many icons per row (left to right)

c. <moveThreshold>15</moveThreshold>
<maxVelocitiy>130</maxVelocitiy>
<minVelocitiy>3</minVelocitiy>
<refreshTime>15</refreshTime>
Leave these alone

c. <screenHeigth>265</screenHeigth>
This is how tall the screen is. Remember you have bars on the top and bottom so this is not your screen height.

d. <screenHeigthL>187</screenHeigthL>
This is how tall the screen is in Landscape. Remember you have bars on the top and bottom so this is not your screen height.

e. <factorMov>5</factorMov>
Leave this alone

f. <fontSize>7</fontSize>
Set the size of the font

g. <fontBold>1</fontBold>
Set the font to bold

h. Set the name of the days; I use Sun, Mon, Tue… . These will display at the top of your calendar.

<Sunday>Sun</Sunday>
<Monday>Mon</Monday>
<Tuesday>Tue</Tuesday>
<Wednesday>Wed</Wednesday>
<Thursday>Thu</Thursday>
<Friday>Fri</Friday>
<Saturday>Sat</Saturday>

i. <backTransparent>0</backTransparent>
Set this to 1 if you want a transparent background for iPhoneToday

End with: </root>

See Appendix B for recommended settings files that are prewritten
---------------------------------------------------------------------------------------------------------------

How to install:

Skip to Step 6 if you are using v1.0 since the cab does all this for you

1. On your PC, open your device (usually in my computer). You can also use Active Sync, but this is a lot easier. Once you open your device you will be looking at the phone’s root directory. Copy the “iPhoneToday” folder from the zip file, onto your phone.

1a. If you copied the folder to your phone another way, open your phone’s file explorer and navigate to that folder. Move the folder to the root of your phone, most phones call this location “My Device”. If you need to find my device, just keep pressing “up” command in the lower left corner in folder explorer until you can’t go "up" anymore. It should say "my device" at the top of the screen.

2. Copy the iPhgoneToday.cab file to your phone and install it.

3. Turn off the iPhoneToday plug-in: on your phone click “start -> settings -> today -> items”; uncheck iPhone Today; press ok 3 times.

4. Reset the phone; do not skip this step!!!!

5. Turn on the iPhoneToday plug-in; same way you turned it off. At the worst, you will have the blank black screen.

6a. If you installed this using v1.0 Reset the phone;
6. Use the icon UI manager to add/edit icons (See below for UI instructions).

7. For advanced functions and the “missing bars” see see post 199 for advanced functions

----------------------------------------------------------------------

The Icons:
I. The old and complex way; doing it yourself:
On the PC Edit the icons.xml file with notepad.

The start each window with the text <screen>; and end each window with the text </screen>. So every “<screen> … </screen>” you have, will be a window of icons. You can put as many as will fit and you do not need to fill a window before adding icons to the next window. For the bottom bar insted of screen add <bottombar> </bottombar> The icons inside these will be in the static bottom.

Now for the icons:
You will need to know what icon picture you want, where the file it points to is located on your phone and if it is one of the special icons. We will use the following example:

<icon name="E-Mail" name="E-Mail" exec="\Windows\tmail.exe" parameters=’ -service "Hotmail" -open "Inbox"’ type="4" animation="1" execAlt="" parametersAlt=""/>

1. <icon
Start with the text <icon this tells the program this is an icon


2. name="E-Mail"
This icon will be called “You Tube”; this is the text under the icon


3. name="E-Mail"
This is what the icon looks like. Stored your icons in the “iPhoneToday\icons” folder. If the icon is somewhere else, it will not display correctly. For this icon, I am using the youtube.pgn picture;

4. exec="\Windows\tmail.exe”
when pressed, it will run the youtube link stored in my windows folder. You can have any icon run an exe, link/shortcut, and mortscript file.

5 parameters=’ -service "Hotmail" -open "Inbox"’
this is a command or text that is passed to the program. Say you use a phone dialer, this is where the phone number goes

6 type="4"
Select “0” for most icons. Here you select if the icon is special and has a display or notifaction:
0: Normal
1: Missed called (red bubble showing number of missed calls)
2: Unread SMS messages
3: Unread MMS messages
4: Unread E-mails
5: Calendar with appointment notification (displays number of appointments coming up)
6: Tasks (displays number of tasks coming up)
7: Calendar (does not display number of appointments coming up)
8: Unread SMS and MMS (display total of unread SMS and MMS messages)
9: WiFi states (use for your WiFi icon; shows a green “ON” when WiFi is on”)
10: Bluetooth state (use for your Bluetooth icon; shows a green “ON” when Bluetooth is on”)

7 animation="1"
Set this to 0 id not wanted, set to 1 if you want a simple animation when the icon is pressed
8 execAlt=""
This is normally blank, unless it is one of the 7 icons. This is what program runs when the icon has a notification bubble.

9 parametersAlt=""
this is a command that is passed to the Alt program.

10. />
End with the text/>

11. WARNING Do not select any exe, lnk, mscr files with any of these characters !@#$%^&*()_+=-<>,./? This will crash iPhoneToday. If you need to use a file with one of these create a shortcut to that file and aim the icon at that shortcut. See Page 6 for creating shortcuts and MortScript files.

12. Also If you add quotations “ to parameters this way, you are fine. However if you add them in the parameters of the UI (see below) it will crash the plug-in
---------------------------------------------------------------------------------------------------------------

II. The new and easy way; using the user interface:

Press and hold anywhere on the screen. A menu will pop up asking if you:
Add Icon
Edit Icon (if you press and hold on an icon)
Delete Icon
Cancel

When you select “Add Icon” or “Edit Icon” you will enter the edit menu



Screen: This should be filled out all ready; to add the icon to a different screen or a new screen, change this number. To set the icon to the bottom static bar (the bottom icons do not move) set screen to -1. Note that the 1st page is number 0, the second page is number 1 and so on.

Icon: Location of the icon on that page. Note that the 1st icon is number 0; the second icon is number 1 and so on.

Name: This is the name that will display under the icon


Image: this is the location of the picture for the icon

Type: If this is a special icon, select it, otherwise select normal


Execute: This is the program that runs when the icon is pressed. WARNING Do not select any exe, lnk, mscr files with any of these characters !@#$%^&*()_+=-<>,./? This will crash iPhoneToday. If you need to use a file with one of these create a shortcut to that file and aim the icon at that shortcut. See Page 6 for creating shortcuts and MortScript files.


Parameters: this is a command or setting used for the program being run. For example if you have a program that dials a number, this is where you would put the phone number (Warning If you add quotations (“) to parameters it will crash the plug-in)


ExecuteAlt: What runs when the icon (special icon) has a status


ParamsAlt: this is a command or setting used for the Alt program being run if any.

Launch Animation: Check this if you want a simple animation when the icon is pressed