Werk aan de Muur

July 08, 2024

Werk aan de Muur Plugin

Integrate your "Werk aan de Muur" shop into your own Wordpress site.

“Werk aan de Muur” / “Art Heroes” is an online marketplace for print on demand wall art. Artists and photographers can upload their images, set their commissions, and instantly sell custom art prints to customers from across Europe.

With this plugin, you can easily integrate your “Werk aan de Muur” or “Art Heroes” shop into your own WordPress site. After installation, there are two tags you can use to add a list of artworks to a page or post. Note that all shortcodes / tags are available in two variants, wadm_xxx and artheroes_xxx. The older omp_xxx is still supported for backwards compatibility, but you shouln’t use it anymore. Functionally they’re exactly the same, they’re just aliases for eachother.

All artworks

[wadm_artlist] / `[artheroes_artlist]` / `[omp_artlist]` (old alias, don't use this anymore) 

This tag prints a paginated list of your artworks. The output can be customized with a few attributes:

  • limit: Number of artworks per page. Default is 12 artworks. Max. 33 artworks per page.
  • columns: Specifiy the number of columns. Defaults to 3 columns.
  • order: Set the artwork order. Defaults to order as in shop. Accepted values are date_asc, date_desc, title_asc, title_desc and rating
  • medium_id: Show prices of a specific medium. Defaults to the preferences in your shop. Accepted values are:
    • 1: Canvas
    • 2: Framed print
    • 3: Poster / photoprint
    • 4: Alu-dibond
    • 5: Xpozer
    • 8: Wood
    • 11: Steel
    • 12: Wallpaper
    • 13: Acoustic prints
    • 15: Alu-dibond Acryl
    • 16: Seamless wallpaper
    • 17: Round
  • size: Show prices of a specific size. Defaults to the preferences in your shop. Accepted values are: small, medium, large and xlarge
  • locale: Set the desired locale. Defaults to your shop language. Accepted values are: nl_NL, de_DE, de_AT, de_CH, fr_FR, fr_CH and en_GB

For example, show 20 artworks in 2 columns, ordered by date (descending, newest first) with this tag:

[wadm_artlist limit=20 columns=2 order=date_desc] 

Or a second example, show artworks with small Alu-dibond as default material with this tag:

[wadm_artlist medium_id=4 size=small] 

Specific album

[wadm_album albumid=999] / `[artheroes_album albumid=999]` 

The album tag allows you to print artworks from a specific album. You can find the album id in your artist dashboard. The output can again be customized with the limit, columns and order attributes. The albumid attribute is required. For example:

[wadm_album albumid=999 limit=20 columns=2]

Single artwork

[wadm_artwork artid=999] / `[artheroes_artwork artid=999]` 

Prints a specific artwork. Use the ‘werkcode’ as artid.

Specific locale / website to link to

[wadm_artwork locale=de_AT] / `[wadm_artwork locale=de_AT]` 

If your website has locale support you can redirect the visitor directly to the matching “Werk aan de Muur” or “Art Heroes” website. Currently supported locales are nl_NL, de_DE, fr_FR, de_AT, de_CH, fr_CH and en_GB (english/international).

Installation

Installation of this plugin is simple:

  1. Extract the plugin into your /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Open the plugin settings page and enter your User ID and API key
  4. Use one of the short tags (more info @ FAQ) to display a list of artworks

Screenshots

  1. Example screenshot of an artlist.

    Example screenshot of an artlist.

FAQ

Usage

See the ‘Description’ section for some examples how to use this plugin.

I don’t see my changes at Werk aan de Muur on my WordPress site!

Due to caching there can be a delay of approximately 2 hours before you see any changes like title or price updates appear on your WordPress site. This is intended behaviour, sometimes some patience is required!

The plugin doesn’t work!

There’s a short list of things you can check if the plugin doesn’t work.

  • Is the plugin activated?
  • Did you supply the correct Artist ID and API key?
  • Does the page or post you’re testing contain a shortcode? The simple code [wadm_artlist] should always show a list of artworks.

Still don’t get the expected result? Then there are a few more technical things to check.

  • Your site should be able to connect to the outside world. Check (with your hosting provider) if the ‘fopen wrappers’ are enabled, and that you’re allowed to use ‘file_get_contents()’.
  • The plugin connects on an HTTPS url. Make sure your server has the appropriate (OpenSSL) libraries enabled, and is able to make an SSL connection.

Do you have any questions or requests?

Please contact us at [email protected] with any questions or suggestions. We’ll continually add them to this FAQ!

Changelog

1.4

  • Include translations for de_DE, nl_NL, fr_FR and en_US

1.3.1

  • SEO optimization

1.3.0

  • Add support for additional locales
  • Make shortcodes available through artheroes_ alias

1.2.1

  • Make shortcodes available through both wadm_ and omp_

1.2

  • As frequently requested, it’s now (finally) possible to change the default price and size of displayed items.
  • Language can be influenced by passing language_code parameters. Defaults to shop language, but can be overriden per shortcode.
  • Add parameters to set custom medium_id, size or language_code for the features mentioned above.

1.1.12

  • Bugfix, feed abstract cannot really be abstract because it’s used for conneciton testing

1.1.11

  • Implement more aggressive caching; cache errors too (but retry within 10 minutes)
  • Prefer cURL over file_get_contents

1.1.10

  • Tweaks to ease debugging in case of a problem

1.1.9

  • Allow sorting artlists and albums by rating

1.1.8

  • Fix PHP notice

1.1.7

  • Fix another PHP Warning

1.1.6

  • Made getHtml compatible with abstract method to prevent an PHP Warning
  • Styling tweak to inherit line-height
  • Added code which can replace file_get_contents calls with a CURL call. Commented code in feed-abstract, if you know what you’re doing, you’re welcome to use it.
  • Introduced a ‘tools’ directory with script to debug API connection issues

1.1.5

  • Use HTTPS image url when ssl is enabled

1.1.4

  • Reset some widths to prevent theme styling from overriding wadm plugin styling

1.1.3

  • Display artist name in listing when available

1.1.2

  • Use correct link and title for single artworks

1.1.1

  • Added some plugin configuration and connection tests

1.1

  • Don’t print empty navigation containers
  • Basic validation of admin settings input
  • New tag [wadm_artwork] to fetch a single artwork
  • Increase max per page limit to allow for 3×11 artworks

1.0.2

  • Tweaked some styling rules to counter-effect specific theme styling

1.0.1

  • Added support for custom artwork order (by title or date)

1.0

  • First release

Details

  • Version: 1.4
  • Active installations: 1,000
  • WordPress Version: 3.0.1
  • Tested up to: 6.5.5

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars