[Windows Mobile Apps and Games] JMHL:
Configuration/Parameter Informations

JMLTodayV5.90 skin

​

use JMLPicture to build CLOCK picture, see JMLTodayTime.xml file.

use JMLPicture to build NOTIFICATIONS (Sms, Tel....) picture, see JMLTodayTotal.xml file.

use JMLPicture to build FAVORITES picture (Page5), see JMLTodayFavorites.xml file.

use JMLPicture to build CURRENT-WEATHER picture (Page2), see JMLTodayMeteo.xml file.

use copy/duplicate registry keys functionality to decrease number of item in CPR file, see JMLTodayV5.90.ini

show last unread SMS-Contact photo.

use JMLPanexV2.70 scan < button > tag in .CPR file : see JMLTodayV5.90.plg file.

use JMLPanexV2.70 conditionnal action : see JMLTodayV5.90.pnx file

use JMLPanexV2.70 long clic feature for Cellular/Sound/Backlight function : see JMLTodayV5.90.pnx file

See also JMLPanexV2.70 - post#2

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

Page2 : Weather

​

MSN Weather

List of cities : CitiesMSN.txt file (Format : codeMSN,cityName,mapNumber)

-> mapNumber : See MSN Weather Maps List. The number is showing in the status bar when you put the mouse on the link (Doppler radar, Weather forecast, High temperatures, .... Cloudiness forecast)

FRXX0016,Bordeaux,0
FRXX0076,Paris,0
USNY0996,New York,1
SPXX0050,Madrid,0

MSN Map

To download map, use 'Parameters/Weather/MSN' menu

To show map, clic on icon (IconA item in .cpr file).

To hide map clic on the bottom of map (Infos item in .cpr file).

You must implement this function in .pnx file (coded in JMLTodayV5.90 skin, same action for switching)

[Page2]
Infos=%JMLTODAY%\JMLMeteo.exe;-infos -jmltoday
IconA=%JMLTODAY%\JMLMeteo.exe;-infos -jmltoday

ACCU Weather

List of cities : CitiesACCU.txt file (Format : codeACCU,cityName)

EUR|FR|FR002|BORDEAUX,Bordeaux
EUR|FR|FR012|PARIS,Paris
EUR|ES|SP013|Madrid,Madrid

GOOGLE Weather

List of cities : CitiesGOOGLE.txt file (Format : cityName)

Bordeaux
Paris
New York
Madrid

My Cities

List of cities showed in 'My City' submenu : MyCities.txt file (Format : source:cityName:code)

msn:Bordeaux:FRXX0016,Bordeaux,0
msn:Grenoble:FRXX0153,Grenoble,0
accu:Béziers:EUR|FR|FR013|BEZIERS
google:Paris:Paris

GPS location

use 'GPS' menu to choose :

GPS location with JMLMeteo built-in GPS function

GPS location with Sleuth's myLocation Service :

- first, install http://xdaforums.com/showthread.php?t=607102

- use it to update Latitude/Longitude coordinates

- next, you can update weather

GPS location with Google Latitude:

- first, copy your googleLatitude account in google.ID file in JMLToday folder.

- use googlemaps to update Latitude/Longitude coordinates

- next, you can update weather

User format for weather

Register keys 'Text0, TextA, Text1... ' formatted according to weathertext in JMLToday.ini.

Format example : weathertext=%sky% (-> default value)

%jour% = day

%temp% = temperature (according to low/high, high/low defined in .ini)

%sky% = description weather

%LF% = line feed

Auto-Update Weather

Parameters in [RunAt] section in JMLToday.ini :

-	enable : 0=disabled, 1=enabled

-	time : start time

-	pgm : program launched for updating

Optional Parameters :

-	every : number of minutes between 2 updates

-	endTime : end time

[RunAt]
enable=1
time=00:35
every=120
endTime=16:00
pgm=%JMLTODAY%\JMLMeteo.exe;-jmltoday

You can enable/disable auto-update in 'Parameters/Weather' menu

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

Page3 : Appointments

​

Appointment contextual menu

To show contextual menu, to hide the Appointment-View, use follow actions in your .PNX skin file.

[Page3]
Infos=%JMLTODAY%\JMLCalendar.exe;-infos -jmltoday
IconA=%JMLTODAY%\JMLCalendar.exe;-action:1
Icon1=%JMLTODAY%\JMLCalendar.exe;-action:2
Icon2=%JMLTODAY%\JMLCalendar.exe;-action:3
Icon3=%JMLTODAY%\JMLCalendar.exe;-action:4
Icon4=%JMLTODAY%\JMLCalendar.exe;-action:5
PagesPNG=[PagesPNG]

-> JMLCalendar.exe;-infos -jmltoday hide the Appointment-View

-> JMLCalendar.exe;-action:N build the contextual menu (JMLCalendar.mnu file) and show it with JMLMenu.exe

[/color]---------------------------------------------------------------------------------------------------------

Page4 : SMS

​

SMS type

For unread SMS or all SMS, use 'Parameters/SMS' menu

SMS contextual menu

To show contextual menu, to hide the SMS-View, use follow actions in your .PNX skin file.

[Page4]
Infos=%JMLTODAY%\JMLSms.exe;-infos -jmltoday
IconA=%JMLTODAY%\JMLSms.exe;-action:1
Icon1=%JMLTODAY%\JMLSms.exe;-action:2
Icon2=%JMLTODAY%\JMLSms.exe;-action:3
Icon3=%JMLTODAY%\JMLSms.exe;-action:4
Icon4=%JMLTODAY%\JMLSms.exe;-action:5
PagesPNG=[PagesPNG]

-> JMLSms.exe;-infos -jmltoday hide the SMS-View

-> JMLSms.exe;-action:N build the contextual menu (JMLSms.mnu file) and show it with JMLMenu.exe

SMS predefined text

Use MySMS.txt file to store your predefined text ( one text per line)

I'am here
Happy birthday !

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

Page5 : Birthdays/Events/Favorites

​

Icon4 = Private event (in Private.txt)

Icon1 to Icon3 = birthday

IconB to IconG = favorites contacts (clic on "+" icon to add a favorite)

Contextual menu

To show contextual menu, use follow actions in your .PNX skin file.

[Page5]
Icon1=%JMLTODAY%\JMLContacts.exe;-action:1
Icon2=%JMLTODAY%\JMLContacts.exe;-action:2
Icon3=%JMLTODAY%\JMLContacts.exe;-action:3
IconB={Page5_IconB_Action}
IconC={Page5_IconC_Action}
IconD={Page5_IconD_Action}
IconE={Page5_IconE_Action}
IconF={Page5_IconF_Action}
PagesPNG=[PagesPNG]

[Page5_IconB_Action]
.jpg=%JMLTODAY%\JMLContacts.exe;-actionfavorite:1||%JMLTODAY%\JMLContacts.exe;-callfavorite:1
unknown.png=%JMLTODAY%\JMLContacts.exe;-actionfavorite:1||%JMLTODAY%\JMLContacts.exe;-callfavorite:1
add.png=%JMLTODAY%\JMLContacts.exe;-addfavorite:1 -jmltoday
...

- use long clic feature

- use JMLPicture to create 6-favorites picture

-> {Page5_IconB_Action} conditionnal action

- if .jpg or unknow.png -> it's a contact -> show contextual menu

- if add.png -> add favorite

-> JMLContacts.exe;-action:N build the contextual menu (JMLContacts.mnu file) and show it with JMLMenu.exe

-> JMLContacts.exe;-actionfavorite:N build the contextual menu (JMLContacts.mnu file) and show it with JMLMenu.exe

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

Page6 : Tasks

​

Task contextual menu

To show contextual menu, to hide the Task-View, use follow actions in your .PNX skin file.

[Page6]
IconA=%JMLTODAY%\JMLTasks.exe;-action:1
Icon1=%JMLTODAY%\JMLTasks.exe;-action:2
Icon2=%JMLTODAY%\JMLTasks.exe;-action:3
Icon3=%JMLTODAY%\JMLTasks.exe;-action:4
Icon4=%JMLTODAY%\JMLTasks.exe;-action:5
PagesPNG=[PagesPNG]

-> JMLTasks.exe;-action:N build the contextual menu (JMLTasks.mnu file) and show it with JMLMenu.exe

[/color]---------------------------------------------------------------------------------------------------------

Skin Management

​

Folder Structure

One folder per skin in skins folder.

In your skin_name folder :

- a skin_name.plg

- a skin_name.pnx (optional)

- a skin_name.ini (optional)

- clock, clockA, sys.... forder for pictures

-> Some image folders are optional. JMLToday uses default image folder, if the skin doesn't use an own folder.

-> Some images in folders are optional. JMLToday uses default image if the image was not found in skin-images folders.

List of skins at installation :

- default

-------- accu

-------- batt

-------- cal

-------- clock

-------- clockA

-------- msn

-------- google

-------- sys

-------- zodiacs

-------- default.plg

-------- default.pnx

- JMLTodayV5.90

-------- sys

-------- JMLTodayV5.90.plg : skin

-------- JMLTodayV5.90.pnx : actions

-------- JMLTodayV5.90.ini : copy/duplicate registry keys

-------- JMLSkin.mscr : install skin script

-------- JMLSkinOff.mscr : uninstall skin script

-------- *.png : static images

-------- notification.mscr : notification script launched per default

-------- notification.xml : notification JMLPicture xml file launched per default

Operations of 'Skin Change'

The 'Skin Change' context menu launch the script JMLTodaySkins.mscr which :

1 - call JMLSkinOff.mscr script in your previous skin folder if it's exist (-> you can clean folder/files/registry key)

2 - copy new skin_name.pnx file in JMLToday folder

3 - update register keys for clock, batt.... folder

4 - apply new skin_name.plg

5 - call JMLSkin.mscr script in your new skin_name folder if it's exist (-> you can add/modify registry keys for personnal use)

6 - call JMLUpdate.mscr script to make a manual update

7 - refresh Titanium

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

Copy/Duplicate registry keys

​

Use skin_name.ini file in your skin folder.

- One section for each Page

- Format :

DefaultItemPage = NewItem

DefaultItemPage = NewItem,OtherPage

Duplicate propagation : use ; to separate couple of item,page

JMLTodayV5.90 skin example :

[Page1]
Icon=Icon3
Current=Label3
CellularPNG=IconB
BluetoothPNG=IconC
WifiPNG=IconD
DataPNG=IconE
BackLightPNG=IconF
SoundPNG=IconG
BattPNG=Icon4
SystemVal=Label4

[Page3]
IconA=Icon1,Page1
LabelA=Label1,Page1

[Page5]
PrivatePNG=Icon4
Private=Label4
IconB=Fav1
IconC=Fav2
IconD=Fav3
IconE=Fav4
IconF=Fav5
IconG=Fav6

[Page6]
IconA=Icon2,Page1
LabelA=Label2,Page1

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

Others informations

​

MultiLanguage

One file JMLLang_xx.ini per Country in lang folder.

1 – Parameters Ex. JMLLang_us.ini :

[us]
[i]; Language name (appear on the select list)[/i]
us=English (US)
[i]; 12h/24h format[/i]
hour=12
[i]; time Format (HH:mm = 14:00 for french , hh:mm = 02:00 for english)[/i]
time=hh:mm

[i]; Weather[/i]
weatherlang=en-us
weathertemp=F
[i]; LH=low/high HL=high/low[/i]
weatherlohi=HL
[i]; metrique/imperial for weather : 'km/h' or 'mph'[/i]
weatherwind=mph
[i]; user format for weather[/i]
weathertext=%sky%

[i]; Dates[/i]
smallDate=ddd, MMM dd
mediumDate=dddd, MMM dd
fullDate=dddd, MMMM dd
userDate=dddd dd MMMM

[i]; alarm[/i]
alarmDate=ddd, MMM dd
alarmTime=hh:mm tt
rdvTime=HH:mm

[i]; text for panel 3-4[/i][color=blue]
NOSMS=No Unread SMS
NOCAL=No Appointment[/color]

[i]; text of contextual menu[/i]
SMS=SMS
EMAIL=E-Mail
TEL=Missing call
VOICEMAIL=VoiceMail
Update=Update
Clock=Clock/Alarms
City=Modify City
Skin=Change Skin
Cancel=Cancel
Language=Select Language
Connect=Change Log
Config=Configuration
Titanium=Refresh Titanium

Date format :

dd = Day of month as digits

ddd = Day of week as a three-letter abbreviation

dddd = Day of week as its full name

MM = Month as digits

MMM = Month as a three-letter abbreviation

MMMM = Month as its full name

Time format :

HH = 24 hour clock

hh = 12 hour clock

mm = minutes

t = time marker : A or P

tt = time marker : AM or PM

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

Saint/Birthday/Private evenment...

1 – Ephemeris (Saint) : One Ephemeris file per year and per country :

French in 2010	: Ephemeride2010.fr

German in 2010	: Ephemeride2010.de

2 – File format : one line per day (dd/MM<tabulation>text)

3 – Private file

With Private.txt file , you can displayed birthday, …..(same format as ephemeris)

-> If a private evenment exist, it replace the Saint.

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

Constantes File-Path

You can use these constantes in your file-path name :

%PROGRAMFILES%

%WINDOWS%

%MYVIDEO%

%MYPICTURES%

%MYMUSIC%

%JMLTODAY%

%JMLPANEX%

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

Program/parameters separator

You can use ; in your file-path name :

Example :

...=%WINDOWS%\ctlpnl.exe;cplmain.cpl,3

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

Second Clock

Parameters to be added in JMLToday.ini :

[Offset]
; Offset in 24H format (with minutes)
Offset =-6:00
;City Name
City = New York

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

System Notification

After each system notification, JMLToday can call a personnal script.

-> Add a line parameter in [Notify] section in JMLToday.ini

[Notify]
JMLTodayTime=%PROGRAMFILES%\JMLToday\MyScript.mscr

NEW with v5.90 : if notification.mscr file exist in you skin forder, it run it. Not necessary to declare it in JMLToday.ini.

List of system notification you can intercept :

JMLTodayTel

JMLTodaySms

JMLTodayEmail

JMLTodayVoicemail

JMLTodayBatt

JMLTodayAlarm

JMLTodayTime

JMLTodayDate

JMLTodayCal

JMLTodayOperator

JMLTodayWifi

JMLTodayBlueTooth

JMLTodayActiveSync

JMLTodayData

JMLTodayCellular

JMLTodayMeteo

JMLTodayFavorites

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

Program Scheduler

You can launch a program at a predefined time:

-> Add a line parameter in [Sceduler] section in JMLToday.ini

[Scheduler]
22:00=%WINDOWS%\ctlpnl.exe;cplmain.cpl,3
00:05=%PROGRAMFILES%\JMLToday\JMLMeteo.mscr

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

Clock animation

Parameters in [Animation] section in JMLToday.ini :

-	sleep : milli-seconds between 2 pictures

-	nb : number of pictures for animation

-	image : base picture

Example 1 : Nothing or 0

[Animation]

sleep=0

-> NO animation

Example 2 :

[Animation]

sleep=120

-> JMLToday internal animation (minutes animation)

Example 3 :

[Animation]

sleep=120

nb=5

image=bg

-> RIC69 animation : This animation contains 5 pictures ( bg1.png, .... bg5.png)

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

SMS/TEL/MAIL/VMAIL central notification

With register keys Total, TotalPuce... you can use only ONE picture.

If you clic on (with JMLPanex >= 1.00) :

If only one type of notification -> launch the appropriate program

If some type of notification -> a contextual menu appear.

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