[Tweak] iWidgets

[eldwin]

This tweak is based on the awesome PerPageHTML, with some changes to address my personal preferences. Credits to WyndWarrior for the great work and code snippet which helped me get started (http://modmyi.com/forums/iphone-4-ne...rpagehtml.html). The concept is mostly similar to PPH, for differences in usage and creation of widgets, see sections below.

I only own an iPhone 4 ( iOS 4.2.1 ), help with testing on various devices on iOS 4 or 5 would be much appreciated. I will not be supporting iPad actively as I do not own one. Feel free to donate your rusting first-gen iPads

Installation
Search and install iWidgets from Cydia, tweak is available in ModMyi repo, which should be in the sources by default. To find more widgets, search "iWidget" in Cydia.

Here are some sample widgets. Please do not ask me to update them as I do not own or maintain any widgets. I've merely converted them into iWidgets as samples for widget developers to learn from. All credits go to their original creators.
HTC - https://dl.dropbox.com/u/3992850/iWidgets/HTC.zip
ASUS - https://dl.dropbox.com/u/3992850/iWidgets/ASUS.zip

Usage
Place widgets in /var/mobile/Library/iWidgets
Preference file is /var/mobile/Library/Preferences/iWidgets.plist
Long press on blank areas on SpringBoard to bring up menu for adding widgets.
Long press on any icons or widgets to trigger edit mode, then drag and drop to arrange widgets.

Screenshots


Widget Developers
Widget's css top & left properties should be zeroed.
Widgets can have simple user interaction such as button presses.
A new file which defines the widget's dimensions, Widget.plist, must be created in the same directory as Widget.html.
An optional options file, Options.plist can also be provided to create custom options.
Each option is represented by a dictionary, where the key name refers to the name of the variable to be defined in JavaScript.

Widget.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
        <key>size</key>
        <dict>
                <key>width</key>
                <integer>300</integer>
                <key>height</key>
                <integer>150</integer>
        </dict>
</dict>
</plist>

Options.plist (Optional, corresponds to 2nd screenshot with long list of options removed, find full file in HTC/ASUS widgets below ):

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<array>
        <dict>
                <key>name</key>
                <string>showForecast</string>
                <key>type</key>
                <string>switch</string>
                <key>label</key>
                <string>Show forecast</string>
                <key>default</key>
                <true/>
        </dict>
        <dict>
                <key>name</key>
                <string>showWeatherAni</string>
                <key>type</key>
                <string>switch</string>
                <key>label</key>
                <string>Show Animation</string>
                <key>default</key>
                <true/>
        </dict>
        <dict>
                <key>name</key>
                <string>isCelsius</string>
                <key>type</key>
                <string>select</string>
                <key>label</key>
                <string>Temperature Unit</string>
                <key>default</key>
                <string>Celsius</string>
                <key>options</key>
                <dict>
                        <key>Celsius</key>
                        <true/>
                        <key>Fahrenheit</key>
                        <false/>
                </dict>
        </dict>
        <dict>
                <key>name</key>
                <string>locale</string>
                <key>type</key>
                <string>select</string>
                <key>label</key>
                <string>Locale</string>
                <key>indexed</key>
                <true/>
                <key>default</key>
                <string>Singapore - Singapore</string>
                <key>options</key>
                <dict>
                        <key>Afghanistan - Ghurian</key>
                        <string>AFXX0001</string>
                        <key>Afghanistan - Herat</key>
                        <string>AFXX0002</string>
                        <key>Afghanistan - Kabul</key>
                        <string>AFXX0003</string>
                        <key>Afghanistan - Qandahar</key>
                        <string>AFXX0004</string>
                        <key>Afghanistan - Bost/Laskar</key>
                        <string>AFXX0005</string>
                </dict>
        </dict>
</array>
</plist>

New 'edit' option type in v 1.0.1:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<array>
        <dict>
                <key>name</key>
                <string>scrollingText</string>
                <key>type</key>
                <string>edit</string>
                <key>label</key>
                <string>Scrolling Text</string>
                <key>default</key>
                <string>insert favorite quote</string>
        </dict>
</array>
</plist>

[kooris]

Awesome

[iPod]

You should post it to cydia. Make sure you give credits to wyndwarrior though.

[GUNNY29]

I just downloaded on 4s 5.0.1 how do I get the menu up to add a widget to home screen? Nice work man

Ignore my stupid question sorry completely missed it lol seems to be working fine on my device stated above. Thanks for sharing

Just found a small bug when widget is in wiggle mode if you press it device goes into safe mode

[eldwin]

@kooris: Thanks!

@ipodtouchman77: Thanks for the suggestion. I apologize for being unclear but this is really a beta version since I haven't gotten it tested on many devices besides my own. Release never occurred to me until a couple of friends expressed interest. I may have been sloppy with the package information but I'll be sure to credit wyndwarrior when I submit an official package.

@GUNNY29: Thanks! I can't seem to reproduce the bug on my own device so I may have to wait till my dad returns with his phone assuming the bug is iOS5-related. Did you mean long press or a normal tap? Are you unable to arrange the widgets since you can't press them?

[.:JimmyL:.]

This is what innovation all about gna try it later

Thanks for sharing with us
Jim

[hemptation]

Hmm. This seems interesting. So multiple widgets on same page. And can add whatever widgets, are in the widgets folder that you gave us the path to ? On any page, at any place.

So let me ask ou this, if you want he same widget running on 3 different screens, is it running the same mod, or does it see the mod as 3 different mods?

[eldwin]

@GUNNY29

Thanks for trying this out! I tried replying earlier but was apparently under some sort of moderation. Could you clarify if you meant long press or a tap? Also, does this mean you're unable to move the widgets? I'm not able to reproduce this on my side so I suspect it may be related to iOS 5. Will check this out when I get hold of my dad's phone.

[GUNNY29]

I am able to move the widgets after further testing it appears not to happen every tap now just every now and again. At first It was every tap seems to have got slightly better

[iPod]

@kooris: Thanks!

@ipodtouchman77: Thanks for the suggestion. I apologize for being unclear but this is really a beta version since I haven't gotten it tested on many devices besides my own. Release never occurred to me until a couple of friends expressed interest. I may have been sloppy with the package information but I'll be sure to credit wyndwarrior when I submit an official package.

@GUNNY29: Thanks! I can't seem to reproduce the bug on my own device so I may have to wait till my dad returns with his phone assuming the bug is iOS5-related. Did you mean long press or a normal tap? Are you unable to arrange the widgets since you can't press them?

Oh ok, you also might want to contact wyndwarrior to make sure it's ok.

[GUNNY29]

I don't feel the need for him to ask permission aslong as he gives credits for the base idea as he said he would all is ok imo plus wynd warrior isn't around anymore is he?

[eldwin]

I just downloaded on 4s 5.0.1 how do I get the menu up to add a widget to home screen? Nice work man

Ignore my stupid question sorry completely missed it lol seems to be working fine on my device stated above. Thanks for sharing

Just found a small bug when widget is in wiggle mode if you press it device goes into safe mode

This is really weird. I'm unable to reproduce this problem with an iPhone 4 on iOS 5.0.1 even when I'm tapping on the widgets like crazy. Is anyone else facing such an issue?

[GUNNY29]

Not sure if it matters but I'm in a 4s. I make the widget wiggle I can press and hold and all is good if I tap the widget while in wiggle mode I go straight to safe mode

[gadezu]

Thanks! This tweak is awesome!

iPhone 4 and iPhone 4S firmware 5.0.1 working fine!

[eldwin]

Glad you like it and thanks for the confirmation =)

EDIT: Nice screenshot, your phone is really beautifully themed

[GUNNY29]

I'm guessing it must be a tweak it is clashing with then let me know if you want a list of all the tweaks I have installed

[eldwin]

Sure, do list them, via PM if you prefer. I'm guessing it's a tweak which modifies springboard icons.

[GUNNY29]

The tweak that is causing the issue is multi icon mover I just turns it off in mobile substrates and the problem wasn't there turnt it back on and the problem was there hope this helps

[eldwin]

EDIT: Sorry. Fix caused other problems instead. BRB

[Illmatic636]

Nice tweak. Thanks eldwin!

Has anyone had an issue moving a widget to a new screen that has no icons on it. Basically dragging the widget to a new screen. It does not seem to work for me on an iPhone 4s 5.0.1.

Thanks again!