It is possible to load remote JPEG images of artworks directly into your SimulArt account. To do so, you need to create links with specific variables passed in the URL. With this feature, you can create "Frame This Item" buttons in your existing site or make customers frame specific remote artworks.
Page Location
The page to load is named "bridge" and is located in the root of your account. For our demo account, the page is located at https://demo.framing.studio/bridge but variables are required to use it.
Variables
| redir | Required - The page where customers should be directed. This can be set to "design" to redirect to your SimulArt account or "connect_page" to redirect to Shopify or WooCommerce (when connected). |
| imageURL | Required - The URL of the remote JPEG image to frame. |
| width | Optional - If framing a physical artwork, you can specify it's width. When supplied, cropping is not offered and customers cannot change the image. |
| height | Optional - If framing a physical artwork, you can specify it's height. When supplied, cropping is not offered and customers cannot change the image. |
| widthPix | Optional - For print-on-demand images, the width in pixels of the image file to be printed for the minimum resolution check (if different from the actual file supplied with imageURL). |
| heightPix | Optional - For print-on-demand images, the height in pixels of the image file to be printed for the minimum resolution check (if different from the actual file supplied with imageURL). |
| title | Optional - The urlencoded title of the artwork if available |
| preset | Optional - The ID of the preset you want to use to frame the image. When supplied, the image is automatically loaded in the preset. Preset IDs can be found in the "Edit Preset" button link. |
| price | Optional - The price of the artwork if applicable. This value will be added to the frame price. |
| royaltiesID | Optional - For print-on-demand images, the code of the royalties to add to the frame price. |
Link Examples
Loading a print-on-demand image without dimensions to allow cropping:
https://demo.framing.studio/bridge?redir=design&imageURL=https://demo.framing.studio/data/images/SIM001.jpg&widthPix=4800&heightPix=3840&title=Van%20Gogh&royaltiesID=Z
Loading a print-on-demand image with specific dimensions to bypass cropping:
https://demo.framing.studio/bridge?redir=design&imageURL=https://demo.framing.studio/data/images/SIM001.jpg &width=20&height=16&widthPix=4800&heightPix=3840&title=Van%20Gogh
Loading a physical artwork directly in a double matted frame preset:
https://demo.framing.studio/bridge?redir=design&imageURL=https://demo.framing.studio/data/images/SIM001.jpg &width=20&height=16&widthPix=4800&heightPix=3840&title=Van%20Gogh&preset=313&price=199.95
Using Forms
Our bridge also accepts variables passed using the "POST" method. Using a form with the "POST" method makes it more difficult for malicious users to manually alter the variables.
<form action="https://demo.framing.studio/bridge" method="POST"> <input type="hidden" name="redir" value="design"> <input type="hidden" name="imageURL" value="https://demo.framing.studio/data/images/SIM001.jpg"> <input type="hidden" name="title" value="Van%20Gogh"> <input type="hidden" name="width" value="20"> <input type="hidden" name="height" value="16"> <input type="hidden" name="widthPix" value="4800"> <input type="hidden" name="heightPix" value="3840"> <input type="hidden" name="preset" value="313"> <input type="hidden" name="price" value="199.95"> <button type="submit">FRAME THIS ITEM</button> </form>