Custom Gateway - Customer Support


Welcome to the Custom Gateway Support Portal

Here you can raise support tickets and read articles on common queries using the topic sections and search below

How to pass webform data to PERSONALISE-iT App

Follow

Preset Product Configurations

Step 1

User selects a product.

Step 2

Magento or other website module retrieves text area and image area data from EP3D JSON API:

POST http://my.easypromo3d.com/ep/json/text-areas

{ "products": [ { product_id: 7429 } ] }

RESULT:

{ "text_areas": [{ product_id: 7429, template_text_area_id: 70028, template_text_name: "Front"  }] }

POST http://my.easypromo3d.com/ep/json/image-areas

{ "products": [ { product_id: 7429 } ] }

RESULT:
{ "image_areas": [{ product_id: 7429, template_image_area_id: 20069, template_image_name: "Back"  }] }

Issues & Notes

  • Multiple product IDs are supported so that similar products can be grouped together, allowing for a single user inputted data set to be applied to multiple products. Limitation of this approach is that areas need to have consistent naming amongst groups of products.

Step 3

Magento module or other website uses the data from API to create a form for the product which the user can then fill in. e.g:

Text (front): input type = text
Image (front): input type = file

Step 4

When the user presses submit, Magento or other website module does the following:

  • Saves the image to a publicly accessible location.
  • Makes a call to the EP3D API to create the preset configuration (see Step 4.1)


Step 4.1 - EP3D API

POST http://my.easypromo3d.com/ep/post/sample
{
"images": [
{
"name": "foo.png",
"data": " << base64 encoded image data >>"
} ],

"samples": [
{
"product_id": 7429,

"text_areas": [
{
"area_id": 70028,
"user_string": "hello world"
} ],

"image_areas": [
{
"area_id": 20069,
"image_name": "foo.png"
} ]
} ]
}


RESULT:

{"samples":[{"sample_id":11427,"product_id":7429}]}

Step 5

The sample IDs retrieved in Step 4.1 can now be used within the Easycreate3D URLs using the parameter “su”.

Step 6

Template viewer looks up the data associated with the sample ID and displays the product accordingly.

Advantages of This Solution

  • Very flexible and can easily be extended to future uses.
  • Area names are retrieved dynamically and so will never be out of date.
  • Does not require any extra fields to be added to the EasyCreate3D extension other than a flag saying that a preset configuration should be used for the product.
Was this article helpful?
0 out of 0 found this helpful

Comments

  • Avatar
    Andrew Talbot

    Example php code that shows the posting of variables