Creating a widget
A simple widget
Take a look at /root/.pwidgets/configs/ScrollText. Change the text at bottom of the file. Save new file with another name (keep it in /root/.pwidgets/configs/). Restart Pwidgets, and your new widget is available.

A more complex widget
1.) ENGINE
Pwidgets supports 4 widget engines, but 3 of them are hardcoded for a unique widget. Conky is what we have used to build most of our widgets.
- conky (base engine)
- xli (Slideshow)
- xwinwrap (Tv)
- xonclock (Analog-clock)

2.) CONFIG
A widget MUST have a config file in /root/.pwidgets/configs/ (See examples). Normally this is a ordinary conky config file. The config filename will be the widgets name. Content of this directory shows up in 'Available widgets' list in the main gui.

3.) SCRIPTS
If external code needs to be run to fetch new info for the widget, call up the widgets script in /root/.pwidgets/scripts/. The script should have the same name as the config file. It is also possible to run a specified script before reading config file. 'Downspeed' is an example of this. The script file has the same name as the config file with a -pre ending (Downspeed-pre), and is placed in /root/.pwidgets/scripts/.

4.) THEME
Your new widget will follow the global theme settings. If you want to override this you can hardcode colors in config files. Though, the best solution is to make a unique theme for your widget. Themes are placed in /root/.pwidgets/themes/THEME/main. The main file works for all widgets. If a unique theme is specified, this one overrides the main theme. The unique theme should have the same name as the config file (widget name).

5.) PLUGIN
If the new widget requires user configuration to works properly, a plugin may do the job. A plugin is a small gui that edits the widget config file. Plugins are stored in /root/.pwidgets/plugins/, and has the same name as the config file. It will show up automatically when user adds your widget from 'Available widgets' to 'Widget list'. After user input, let the plugin execute:
. /usr/local/pwidgets/locals/english
. /usr/local/pwidgets/func -apply
fixwidgets
This builds the chosen widget tree including the changed info from this plugin.

IMPORTANT UPDATE
Pwidgets-1 is now released. The clock is now handled a little differently. The basic pinciple is the same but now the file Clock-analog.png is stored in a new directory called misc,
~/.pwidgets/misc .
Have fun!_________________Woof Mailing List | keep the faith | Edited_times_total

Rename the .pet to .tgz and extract it somewhere,
you will get a directory called: gdesklets-0.36-i586-2gsb-MU-200clocks[/url]
you will find most of the clocks in: gdesklets-0.36-i586-2gsb-MU-200clocks/usr/lib/gdesklets/Displays/Clock/gfx/clocks

I renamed: /root/.pwidgets/misc/Clock-analog.png
then created a symlink to whatever took my fancy out of the 200 clocks.

You have to edit a file. Ok, it can be done. Open the 'file' (rox or home) icon on the desktop. You will see a bunch of folders and a menu bar at the top of the window. There is a nice looking icon that resembles an eye, Left click it. A whole bunch more of folders and files will appear. Scroll down and find one that says '.pwidgets' (yes it has a 'dot' before it.) Click it once. A bunch more folders will appear, click(once) the 'Config' folder. Click the file (there are a bunch there) that is titled 'Weather'. It will open up in a program, which is what we call a text editor, something like 'Notepad', called 'Geany'. There you can read the contents. Peruse them. Try to understand what's going on. Go right down to a line that says 'TEXT'. Under that you will see the default listing of "EUR|NO|NO009|Val%E5moen". Replace this with your code. If you live in the US it is easy, just replace it with your zipcode, otherwise, do the following

goto "http://www.accuweather.com/us-city-list.asp"
goto 'enter an international location'
type your city (doesn't matter where you are, just type it in English if you can)
It will come up with some options, choose what suits you.
THEN in the browser bar (address bar I spose) there is a url, copy only the bit after "code=" and there will be something like 'OCN|AU|GOLD%20COAST' or 'EUR|UK|UK241|LONDON' or 'OCN|NZ|NZ000|AUCKLAND' or 'SAM|CL|CI011|SANTIAGO' or 'AFR|EG|EG011|CAIRO' (for Cairo, Egypt) or 'OCN|AU|NSW|Cairo' (for Cairo, NSW, Australia) or 'ASI|TH|TH017|BANGKOK'
FOR US, just do the zipcode, such as '90210' for Beverly Hills, California (yes, too much TV!)

Update: (Only if you have <puppy4.2Deepthought, keep the date of this post in mind) Pwidgets now has a new weather font. Download the font file 'pweather1.ttf.gz' from Pwidgets thread (you may have to scroll down a bit to find it) and unzip it. Install it in 'usr/share/fonts/default/TTF' Try it out in Abiword, It will appear as 'pweather'. Edit the file I mention in the 1st paragraph of this 'howto'. Another way to get to that file is open the Pwidgets gui, on the left highlight 'Weather', click the config button at the top and the file will open in the default text editor. At the beginning of the line where the weather code goes, 'line 51', you will see

To change the degrees C to degrees F in Pwidgets Weather you must edit another file. Goto /root/.pwidgets/scripts/WeatherIcon and open in your preferred text editor. Goto line 5 and you see 'METRIC=1', change to METRIC=0,. Save the file. Restart Pwidgets from the GUI, choose weather and you will see the temperature in degrees F. (You may not even need to restart Pwidgets)

I've got the RSS Feed widget on my puppy 'desktop', but it just seems to throw up indonesian news headlines all the time, instead of rss feeds I'm actually interested in . However, I can't find how to change this anywhere?_________________Buy silver, crash JPMorgan

I've got the RSS Feed widget on my puppy 'desktop', but it just seems to throw up indonesian news headlines all the time, instead of rss feeds I'm actually interested in . However, I can't find how to change this anywhere?

Copy the url of your rss feed to the relevant plugin of the rss widget.

I've got the RSS Feed widget on my puppy 'desktop', but it just seems to throw up indonesian news headlines all the time, instead of rss feeds I'm actually interested in . However, I can't find how to change this anywhere?

You need to edit the config file for the rss widget

I thought I made a plugin for this...please open menu - desktop - pwidgets - plugins - rss_________________My apps

I've got the RSS Feed widget on my puppy 'desktop', but it just seems to throw up indonesian news headlines all the time, instead of rss feeds I'm actually interested in . However, I can't find how to change this anywhere?

You need to edit the config file for the rss widget

I thought I made a plugin for this...please open menu - desktop - pwidgets - plugins - rss

Yes you did! I corrected my post. Been a while!

The cluster seems to have a bug. I have just been testing and the check boxes aren't showing... but I am using a slowish machine.... any ideas?_________________Woof Mailing List | keep the faith |