Interface DocumentHandler

Readonly Batch

Readonly Data

Readonly Fields

Readonly Global

Readonly Pages

AddCloneToBasket

• AddCloneToBasket(callback): void

• Adds the current job to the basket as a clone, but keeps the editor and the job open. This is useful if you want to allow the user to continue editing the job after adding it to the cart.

  Once the clone has been added, the optional callback will be triggered with information about the result.

  Parameters

  • callback: ((result) => void)

    The callback function that will be triggered once the process has finished. Check the parameter about success, warnings and the job id of the clone.

    • • (result): void

      • Parameters

        • result: AddCloneToBasketResult

        Returns void

  Returns void

AddToBasket

• AddToBasket(): void

• Adds the current job to the basket. If the item is already in the cart it will simply be saved. This will make any changes made to the job permanent. The editor will unload once the job has been saved and the item has been added to cart. The script will stop executing shortly after this call. If the job was previously saved as a project it will be removed, as a job can be only in one place at a time - either cart or saved project.

  Returns void

GetBaseDirection

• GetBaseDirection(): GlobalTextDirection

• This will return the current global text direction of the editor.

  Returns GlobalTextDirection

  The text direction of the editor.

JobId

• JobId(): number

• Retrieve the job id of the job currently being edited. Every job will always have a unique job id.

  Returns number

  Returns the job id of the job currently being edited.

Name

• Name(): string

• Little helper to get the localized name of the product.

  Returns string

  Returns the localized name of the product.

NeedSave

• NeedSave(): boolean

• Method to check if there have been any changes to the job since it was last saved.

  Returns boolean

  Returns true if the job is dirty and needs to be saved. Returns false if the job is clean and does not need to be saved.

OpvId

• OpvId(): number

• Retrieve the order product variant id of the job being edited. Only available if the job has been ordered already. Otherwise this will return -1.

  Returns number

  Returns the order product variant id of the job being edited.

Price

• Price(callback?, unitPriceOnly?, skipFormat?): number

• This function helps to retrieve the current price of the product to use within the scripting context. The price will be automatically calculated based on the product configuration, number of pages and global configuration, quantity and attributes as well as optional media costs.

  Parameters

  • Optional callback: ((number) => void)

    The callback to return the price. The price will be passed as a parameter to the callback function. Can be null to use the non-callback version.

    • • (number): void

      • Parameters

        • number: any

        Returns void

  • Optional unitPriceOnly: boolean

    Flag to control if the price should be the unit price or the total price based on the quantity.

  • Optional skipFormat: boolean

    Flag to control if the price should be formatted or not. If true, the price will be returned as a number. If false, the price will be returned as a formatted string.

  Returns number

  The final price.

ProductId

• ProductId(): number

• Retrieve the product id of the product currently being edited.

  Returns number

  Returns the product id of the product currently being edited.

Reset

• Reset(): void

• Resets the current job to the default state. This will clear any custom adjustments made to the job. Including pages added, layouts selected, fields added or edited, etc. The editor will reload after the reset has been initiated, meaning that the script will stop executing shortly after this call.

  Returns void

Save

• Save(callback?): void

• This function can be used in a non-embedded context to save the job. It will only work in a non-embedded context. Note: for normal operations, add to cart and saved project should be used. Save should only be used for internal purposes.

  Parameters

  • Optional callback: (() => void)

    The callback will be called once the save has finished. Check the parameter about success, to control if the save was successful. If the context is incorrect, it will not trigger the callback.

    • • (): void

      • Returns void

  Returns void

SaveAsProductDefault

• SaveAsProductDefault(callback?): void

• Saves the current setup as the product default. The product default is the clean template version of the current job. This means all content will be removed (text/images/etc). This function can only be called in an administration context. If the product is currently in use (aka has been ordered already) this function will trigger a confirmation dialog to warn the user that the product is in use and that the product default will not be used by existing orders.

  Parameters

  • Optional callback: (() => void)

    The callback will be triggered if the default product has been saved correctly. It will not be triggered if it couldn't be saved or if the user cancelled the confirmation dialog.

    • • (): void

      • Returns void

  Returns void

SaveAsProject

• SaveAsProject(callback?): void

• This function saves the current job as a project. This will then unload the editor and load the saved project list. If the job was previously added to the cart it will be removed, as a job can be only in one place at a time - either cart or saved project.

  Parameters

  • Optional callback: (() => void)

    'The callback will be called once it has been saved. Note that the editor will unload after the save has been initiated, meaning that the script will stop executing shortly after this call.

    • • (): void

      • Returns void

  Returns void

SaveEmbedded

• SaveEmbedded(callback?): void

• This function can be used in an embedded context to save the job. It will only work in an embedded context when the editor is embedded in a 3rd party application. E.g. in our external store plugins for Shopify and Magento.

  Parameters

  • Optional callback: ((success) => void)

    The callback will be called once the save has finished. Check the parameter about success, to control if the save was successful. If the context is incorrect, it will not trigger the callback.

    • • (success): void

      • Parameters

        • success: boolean

        Returns void

  Returns void

SetBaseDirection

• SetBaseDirection(direction): void

• Sets the new global text direction of the editor.

  Parameters

  • direction: GlobalTextDirection

    The new text direction of the editor.

  Returns void

SetCustomName

• SetCustomName(name, callback): void

• Sets the custom name of the job. The custom name is stored against the basket item and later against the order line item and can be used by the user to identify and label the job. The custom name is also available in other areas of the system like invoices and MIS connections.

  Parameters

  • name: string

    The custom name to set. Maximum lengths is 254 characters. Can be an empty string.

  • callback: ((success) => void)

    The callback function that will be triggered once the process has finished. Check the parameter about success, to control if the custom name could be set.

    • • (success): void

      • Parameters

        • success: boolean

        Returns void

  Returns void

SetProductAttribute

• SetProductAttribute(attributeName, value, callback?, createHidden?): void

• Sets a product attribute specified by name with the given value. If the product attribute does not exist it will create it on the fly and add it to the product. This is the only situation where the optional parameter createHidden is relevant.

  The product attribute value will not be validated. It is the responsibility of the code to provide a valid value. For enumerated values (dropdown, radio buttons, etc), the value must be the id of the option.

  Parameters

  • attributeName: string

    The name of the product attribute to set. If the product attribute does not exist it will be created on the fly and added to the product.

  • value: string | number | boolean

    The new value to set. The value will not be validated.

  • Optional callback: (() => void)

    The callback will be triggered once the process has finished. Check the parameter about success, to control if the product attribute could be set. Note that the calls to set product attributes are debounced in case of many subsequent calls, only a single AJAX call will be triggered.

    • • (): void

      • Returns void

  • Optional createHidden: boolean

    Boolean flag to control if the new attribute should be created hidden or as an info type attribute. This only applies if the attribute does not exist yet.

  Returns void

SetProductAttributes

• SetProductAttributes(attributes, callback?, createHidden?): void

• Sets multiple product attributes at once. This is a convenience function to set multiple attributes at once. See SetProductAttribute for more details.

  Parameters

  • attributes: {
        [key: string]: string | number | boolean;
    }

    A dictionary of attributes to set. The key is the attribute name, the value is the attribute value. The value will not be validated. Unknown attributes will be created on the fly and added to the product.

    • [key: string]: string | number | boolean

  • Optional callback: (() => void)

    The callback will be triggered once the process has finished. Check the parameter about success, to control if the product attributes could be set. Note that the calls to set product attributes are debounced in case of many subsequent calls, only a single AJAX call will be triggered.

    • • (): void

      • Returns void

  • Optional createHidden: boolean

    Boolean flag to control if the new attribute should be created hidden or as an info type attribute. This only applies if the attribute does not exist yet.

  Returns void

SetQuantity

• SetQuantity(quantity, callback): void

• Sets the job quantity. This will be stored against the basket item and later against the order line item. If the job has been ordered already, this function will fail and return false. Setting the quantity will also update the price if displayed in the editor and will log price script messages

  Parameters

  • quantity: number

    The new quantity to set. Must be a positive number. Note: the code will not validate if the quantity is valid (e.g. pack quantity, quantity tiers etc). The code is responsible to provide a valid quantity value.

  • callback: ((success) => void)

    The callback will be triggered once the process has finished. Check the parameter about success, to control if the quantity could be set.

    • • (success): void

      • Parameters

        • success: boolean

        Returns void

  Returns void