The graphical widget is an image with a highly-specific URL. You can build your URL piece by piece, checking the image in your browser. When you’ve got what you want, you will need to insert the image into your blog template. Usually, you will do this by adding <img src=”XXX” >, with XXX being the URL of the image, where appropriate.
The base URL is http://www.librarything.com/gwidget/widget.php?
To this base URL, you add parameters. You can add from one (just the user name) to fifteen, to control everything from what books are shown the colors they appear in. Each parameter must be separated by an & sign.
- view= your user name (default timspalding, but you don’t want that)
- type= what books to display; two options are “recent” and “random”
- tag= which tag to display (default: none)
- width= image width, in pixels (default: 200)
- fsize= font size, in points (default: 9)
- font= name of font to use (default: verdana). At present you can use “arial,” “arialuni” (if you have a lot of “special characters”), teletype, palatino, verdana
- num= number of books to display (default: 10)
- hbold=1 use bold text for the header (default: 0 off)
- tbold=1 use bold text for book titles (default: 0 off)
- top= text to display at the top of the widget (default: “Random Books From My Library” or “Random Books From My Library Tagged XYZ)
- ac= author text color (default: 000000 – black)
- bc= background color (default: ffffff – white)
- tc= title text color (default: 0000ff – blue)
- hc= header text color (default: 000000 – black)
- x= number of pixels from top and bottom to pad the text (default: 5 pixels)
- y= number of pixels from the left and right edges to pad the text (default: 5 pixels)
- The widget doesn’t link anywhere. We suggest you link it to your profile or catalog (see your profile for the URL). You will need to an an HTML link around the image.
- The widget can’t have cover images. To display cover images, Amazon requires links to their service. A graphical widget can’t do that.
That’s what I have for now. Feel free to post questions, examples you’re proud of and so forth.