Title: Custom Etsy Widget
Author: jcoxwell
Published: <strong>Onwa-asaa 18, 2010</strong>
Last modified: Onwa-anö 28, 2010

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/etsy-widget.svg)

# Custom Etsy Widget

 By [jcoxwell](https://profiles.wordpress.org/jcoxwell/)

[Download](https://downloads.wordpress.org/plugin/etsy-widget.1.0.8.zip)

 * [Details](https://ibo.wordpress.org/plugins/etsy-widget/#description)
 * [Reviews](https://ibo.wordpress.org/plugins/etsy-widget/#reviews)
 *  [Installation](https://ibo.wordpress.org/plugins/etsy-widget/#installation)
 * [Development](https://ibo.wordpress.org/plugins/etsy-widget/#developers)

 [Support](https://wordpress.org/support/plugin/etsy-widget/)

## Description

This plugin adds a sidebar widget that displays a grid of thumbnails linking to 
items in an etsy store. The user can select the number of rows and columns to display.
The results are similar to Etsy Mini but since it doesn’t use flash or an iframe
the theme sidebar style is inherited. Users can also customize the display by adding‘
etsy’ css class definitions to their theme style sheet.

You can choose to show the most recent items or a random set on each load.

This plugin has only been tested on linux, but I can’t think of any reason why it
wouldn’t work on windows as well.

You can see it running at [blog.cheyenneweil.com](http://blog.cheyenneweil.com).

This plugin requires PHP5.

The term ‘Etsy’ is a trademark of Etsy, Inc. This application uses the Etsy API 
but is not endorsed or certified by Etsy, Inc.

## Screenshots

 * [[
 * The admin interface.
 * [[
 * How it looks on the page.

## Installation

 1. Upload `etsy-widget.php` to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Use the Etsy widget in your sidebars and click ‘[EDIT]’.
 4. Enter your etsy shop name and the number of rows and columns to display.
 5. Choose how items are chosen (Most Recent, or Random).
 6. If desired, add custom styling to your theme for the ‘etsy’ css class, otherwise
    it will default to sidebar style rules.

## FAQ

  Why not use the other etsy sidebar widget?

At the time I wrote this plugin another etsy sidebar widget was available. However,
it didn’t meet my needs because it only allowed you to embed Etsy Mini code. Functionality
which could just as easily be obtained with the default ‘Text’ widget.

  Why not use Etsy Mini?

Etsy Mini uses an iframe or flash object. In either case there is no easy way to
control the styling. Also, you must go to your etsy account to generate new code
if you want to change the basic layout. This widget allows complete styling and 
an equivalent number of layout options in the widget configuration.

  Does it cache the Etsy API call results?

Yes. By default, a json cache file is stored in the system temp directory. The cache
is refreshed every 6 hours. You can change the cache location in the configuration
window.

  Why not use the wordpress object cache?

The wordpress object cache is not enabled by default. I choose not to use it because
I wanted the plugin to be as easy as possible to install.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Custom Etsy Widget” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ jcoxwell ](https://profiles.wordpress.org/jcoxwell/)

[Translate “Custom Etsy Widget” into your language.](https://translate.wordpress.org/projects/wp-plugins/etsy-widget)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/etsy-widget/), check
out the [SVN repository](https://plugins.svn.wordpress.org/etsy-widget/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/etsy-widget/) by
[RSS](https://plugins.trac.wordpress.org/log/etsy-widget/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.8

Fix optional link to store home page.

#### 1.0.7

Clear the cache on activation. This solves a couple of problems. Most importantly
if Etsy changes the API format the cache will be cleared automatically on upgrade.
It’s also handy to be able to clear the cache manually by deactivating and reactivating
the plugin.

You must use your shop name. An error will appear if an old version of the plugin
was set to use you user id number. If this happens go to the widget configuration
and change it.

#### 1.0.6

Upgrade to use Esty API V2.

Removed invalid image size options.

#### 1.0.5

Add option to change cache location. The default is to use whatever is returned 
by the php function sys_get_temp_dir (usually /tmp on unix systems).

#### 1.0.4

Fixed bug in column layout. Older version wouldn’t render more than 2 columns.

#### 1.0.3

Add admin option to choose image thumbnail size for display.

Set cache life to 6hrs to comply with etsy api requirements.

#### 1.0.2

Fix a cache problem that would occur when showing the widget from multiple blogs
installed as different users.

#### 1.0.1

Add readme, comments, and documentation.

## Meta

 *  Version **1.0.8**
 *  Last updated **15 years ago**
 *  Active installations **70+**
 *  WordPress version ** 2.2 or higher **
 *  Tested up to **3.0.5**
 *  Language
 * [English (US)](https://wordpress.org/plugins/etsy-widget/)
 * Tags
 * [etsy](https://ibo.wordpress.org/plugins/tags/etsy/)[sidebar](https://ibo.wordpress.org/plugins/tags/sidebar/)
   [widget](https://ibo.wordpress.org/plugins/tags/widget/)
 *  [Advanced View](https://ibo.wordpress.org/plugins/etsy-widget/advanced/)

## Ratings

 1 out of 5 stars.

 *  [  0 5-star reviews     ](https://wordpress.org/support/plugin/etsy-widget/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/etsy-widget/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/etsy-widget/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/etsy-widget/reviews/?filter=2)
 *  [  1 1-star review     ](https://wordpress.org/support/plugin/etsy-widget/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/etsy-widget/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/etsy-widget/reviews/)

## Contributors

 *   [ jcoxwell ](https://profiles.wordpress.org/jcoxwell/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/etsy-widget/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=11250185)