TodayPlus Boards v2

The latest skin references can now be found  here (http://www.jhollin1138.com/forums/viewtopic.php?t=1454)

Timezone Reference (http://www.jhollin1138.com/files/timezones.txt)

Weather ID List (http://www.jhollin1138.com/files/widlist.zip)

Edit: Fixed links. jhollin1138

srs,

I know its a pain, but the skin reference currently is for v0.9.1, is there any possibility of updating it to v0.9.5?

I too would appreciate an updated skin reference.  I have updated the POOM sections of both of my newest skins to be compatible with v0.9.5, but I'm waiting to post them until I know if there's any more improvements worth implimenting in v0.9.5.

I made some corrections to the current documentation and am adding sections for the new commands (with information for the new commands gathered from the forums).  I will post it here shortly so that srs can make any corrections and repost.

thanks fishboy :)

Is it possible to add the version number that the reference file refers to in subject.
Or at least to the file you can download.
Thanks

Noticed one thing missing :

In the storage command (skin section) the FREE command is missing.

used – Display total used memory for storage device.
usedpercent -> Display total used memory for storage device as a percent.
free -> Display total free memory for storage device
freepercent -> Display total free memory for storage device as a percent
total -> Display total available memory for storage device.

Thanks Lightman, I have corrected the storage command.  

I am just about finished updating the reference file for version 0.9.7.  Waiting for the next release so that I can add a version number to the addvar and new if...else statement conditions.  

BTW, srs, what is the purpose of the command:

initregion,1,0

Does this specify the starting page for the region when starting up?  Wanted to know so that I can add this command to the reference file.

initregion initializes which page in the region will be active on startup.  it is executed only one (on startup)

I've also add "initvar" which does the same thing but for vars.

srs,
I believe I am ready to post the reference file for version 0.9.8 but I am not sure what the first parameter is for the calcspace command.  Please post the syntax for this command or send me a personnel message so I can update the reference.

Thanks.

calcspace,<x>,var<y>

calcspace subtracts the current y offset from <x> and stores the result specified by var<y>.  This is useful to have sections that autoadjust the height depending on other parts of the skin.

thanks fishboy :)

fishboy, thanks for the reference!
I just would like to give you a small hint - you can use Office 2000 HTML Filter (http://office.microsoft.com/downloads/2000/Msohtmf2.aspx) to reduce the size of resulting HTML almost twice without a noticeable difference in its appearance.
PIE just dies trying to load a 600+ KB HTML  :shock:

Thanks for the tip alpax, this reduces the file ~50%.  In the future, as the command set stabilizes, I may hand code it myself in HTML or use an HTML edit to further reduce the size.

I will upload a new version once the configuration file standards have been finalized.

FYI- the appointment %duration% should be just like starttime & endtime, the wording kind of implies it's just minutes.  Thanks!

Thanks kwerner.  So does %duration% allow specifying a time format like starttime and endtime (duration,<timeformat>)?

Yes, same as starttime.

Quote from: EitelSkin Reference (http://www.dark-mojo.com/TodayPlus/download/skin%20reference.zip)

Timezone Reference (http://www.dark-mojo.com/TodayPlus/download/todayplus%20reference%20-%20timezone.txt)

WidList (http://www.dark-mojo.com/TodayPlus/download/widlist.zip)

Eitel,
You and others are doing a fantastic job but to make it easier for other less experienced TodayPlus users, is it possible for you to indicate in this first message, the date of your reference files.  

For instance, I noticed Fishboy has posted another skin later, is there any way you can always have the latest reference files in your top post (with the date last updated along side it)

This would save us downloading an old file and also having to try to find the last one posted.
Many thanks :)

I agree.. it is hard to identify the current Reference files as well as the current program. Would it be possible to use a more conventional format for naming the files. I have downloaded the current Skin Reference at least 3 times now... lol...

I was maybe thinking something like the following:

v0.9.8 TodayPlus.arm.exe

v0.9.8.00 Skin Reference Guide.txt


v0.9.8.01 Skin Reference Guide.txt
(in case there are any ammendments before the executable is updated)

Unless srs objects, in future posts I will add the version number to the zip file (i.e. skin reference v0.9.8 r1.zip, where the last digit is the for document revisions).

That would be awesome Fishboy.. thanks. I took a look at your skn guide it is also a nice piece of work though it seems to be a bit incomplete. Are you planning to upgrade it...?

I was actually going to edit it into a doc format that could be printed out and bound so that people could use it as a true reference manual.

But then, I realized that SRS is showing no signs of slowing down with his upgrades... so I was just wondering when, if, there will be another revision.

A new version of the skin reference (and TodayPlus) are in the works.  I will post the reference when TodayPlus is released.  I have made some changes/correction for 0.9.8, but since I have also added stuff for the next version, I will have to wait to post it.  

I am removing some of the documentation and placing it into separate html files to help keep the skin file down (i.e. version history, weather icon id list, and other rarely used information).  The next release will use Microsoft's HTML filter to further decrease its size, which means it will no longer be a fully editable in word (i.e. table of contents can't be automatically rebuilt) except by me  :D .  This will help with those who use the reference on the Pocket PC.

And yes, you are correct, the skinning commands are in a constant state of flux at this time, which is why an electronic version is prefered.  Feel free to correct me on any documentation errors you or any one else find.  I would like to keep this document as error free and up to date as possible to help avoid confusion for new skinners.

Hi Fishboy,

Can you please help me understand what the Refresh Interval do in the RSS command (config.txt)?  Your reference says:

Quoteminimum time in seconds to refresh data when refresh button pressed / ActiveSync ends

I am having a hard time understanding this.  What is the refresh button?  Is it on the skin, or are you refering to the Synchronize button in ActiveSync?  Is this the minimum time allowed / alloted for a refresh?

Thanks in advance.

pli7

Hello!

In the Today Command, <Variable>, sky -> Display the ?.
It displays the sky status, clear, rain, cloudy, etc.

Hope it helps.

jS

pli7,

The refesh button is usually the icon with the curved arrows (one pointing up, the other down) but can vary for each skin.  It is the area/image associated with the imagebutton or button commands that specify the action value of 7 (refresh) in the skin file (i.e. imagebutton,156,2,refresh.png,t,0,7,,-1).  

The refresh interval specifies the minimum time to wait after last download before allowing new data to be downloaded (refresh button clicks and ActiveSync connections  are ignored until wait interval has expired).  When data is actually refreshed, a time stamp is each time data is succesfully downloaded.  If another refresh is performed before this interval (time stamp + refresh interval) no data will be downloaded.  

Example.  Last download = 10:00am, refresh inteval = 60.  Any clicks on the refesh button before 11:00 am will NOT download any new rss data.

Hope this helps.  By the way, in the future, please post all Help reguests in the Help & Support Forum so that it will reach a wider audience.  Thanks.

Quote from: pli7Can you please help me understand what the Refresh Interval do in the RSS command (config.txt)?  Your reference says:

Quoteminimum time in seconds to refresh data when refresh button pressed / ActiveSync ends

Fishboy's response was excellent and comprehensive, as we have come to expect.  One thing he alluded to, but was not explicit on, is that this is actually the time in minutes, not seconds.

Thanks very much, Fishboy.

You are welcome pli7, and thanks arbitrajeu, for the compliment and correction.  I have corrected the reference guide, which I hope to post in the next day or so after I get a few new commands ironed out.

fishboy,

is it possible to add 3 icons in widlist  :wink:

http://dark-mojo.com/TodayPlus/viewtopic.php?t=659

Quote from: NickMis it possible to add 3 icons in widlist

Thanks for the update, they have been added.

Documentation for version 0.10.2.

thanks fishboy.

I'm thinking it may be better if you start a new sticky thread with the latest reference file, and you can update the first post with the latest version.  This may make things easier to find.

Quote from: srsI'm thinking it may be better if you start a new sticky thread with the latest reference file, and you can update the first post with the latest version.  This may make things easier to find.

I agree!  It might help element some confusion from new users.

I will work on creating a new sticky for the documentation.  FYI, I have been updating Eitel's post at the beginning of thread to point to my uploaded files, but having mine own sticky will be better.

Quote from: EitelSkin Reference (http://dark-mojo.com/TodayPlus/download.php?id=443) Version 0.10.2, R1

Timezone Reference (http://www.dark-mojo.com/TodayPlus/download/todayplus%20reference%20-%20timezone.txt)

WidList (http://www.dark-mojo.com/TodayPlus/download/widlist.zip)

Do you have Skin Reference for Version 0.11.0
My Email: SupperPDA@hotmail.com

Once I have all the information on the new commands, I will be posting a new version in the Help & Support forum.

Quote from: fishboyOnce I have all the information on the new commands, I will be posting a new version in the Help & Support forum.

Thanks!  
:lol:  :lol: :oops:  :oops:  :oops:  :lol:  :lol:

Attempted to access Wid list...and came up empty.

The Weather ID List is also contained within the skin reference zip file.  Apperently the file this link references was not restored during the transition to the new server.  However, this forum will be deleted and a new one created in the Help & Support once the reference us updated.

Quote from: dp1donAttempted to access Wid list...and came up empty.

Fixed.  Sorry about that.   :oops:

Hi fishboy or anyone,

Is anyone working on updating the Reference Guides to v11 (or later)?

Thanks,
pli7

I had a version 0.11.0 almost ready to go but was waiting for some additional clarification on some commands.  Since then 0.12.0 has been released for limited testing, with some changes to the commands, I will be holding off until its release.

Hi Fishboy,

Can you post the reference for V11.

Thank you very much.

Jack

@fishboy :
after all the latest developments about TP's no-expiration, I'm also wondering (like jack here before me) if you intend to update/release the docs at least for v0.11. If you could, it would be SO helpful :) :)

I agree that it would be nice to see the v0.11 ref, but I'm also hoping that fishboy has good reason to soon release the ref for v0.12  :D

Scotty

OK, here is the documentation I have for versions 0.11.0 and 0.12.0.  The 0.11.0 documentation may be a little incomplete because I switched  to writing the 0.12.0 documentation after it was released (which I think was not long after 0.11.0).  

The 0.12.0 documentation has a different look; all commands are grouped by their function and in index is provided which lists the commands in alphabetical order.  The config file commands have also been removed.

Wow, thanks a bunch fishboy.   :)  

I'll see if I can add something to the 0.11 version  :roll:

Quote from: fishboyOK, here is the documentation I have for versions 0.11.0 and 0.12.0.  

Fishboy,

Thanks! You've done a good work!!!

Timmy

@fishboy

Are you planning on finishing the reference for 0.11?
Some of us may still use 0.11 instead of 0.12!

Quote from: bbiedermAre you planning on finishing the reference for 0.11?
Some of us may still use 0.11 instead of 0.12!

I will update as users find errors in the documentation.  It should have all commands for 0.11.0 listed.  I don't know yet if I will make its format similar to the 0.12.0 documentation since it was a lot of work to get there.  I may look into modifying the 0.12.0 doc to include 0.11.0 information.

I created a new Skin Reference sticky in the Help/Support forum and have locked this topic, so in the future post your messages there.

Go here (http://www.jhollin1138.com/forums/viewtopic.php?t=1454) for the last version that fishboy made.