Design-A-Badge

Downloads

Documentation

NEW! Feature Switches - COMPLETE DOCUMENTATION
Download the the document below for a complete list of Feature Switches.

Feature-Switches.pdf
IFRAME User Interface with Email Data Return.
Download the the document below for details on how to embed the "Design-A-Badge" application into your website and receive completed designs via email.

iframe-email.pdf
IFRAME User Interface with HTTP POST Data Return.
Download the the document below for details on how to embed the "Design-A-Badge" application into your website and configure advanced data return capabilities that will seemlessly POST design data back to your website.  This data can then be written to a database or further integrated into a shopping cart solution.

iframe-httppost.pdf
Features and Configuration Questions - ANSWERED!
Download the the document below for answers to many questions regarding features and integration capabilites.  Great questions and even better answers.

configuration-questions.pdf

Support Files

IFRAME User Interface with Email Data Return and HTTP POST Data Return examples.
In an effort to simply the support file aspects of the integration process, a single support.zip file is now downloadable.  This ZIP file allow will contain all support files that are needed both on the client and server side.

The download contains supporting files for IFRAME user interface placement and both Email and HTTP POST integration data return.  Server side support for PHP, ASP.NET, and Classic ASP are all contained within the new download.

support.zip

Blackinton Design-A-Badge Logos


200 x 200
 

300 x 100  


300 x 200  


600 x 100  

To download all the Design-A-Badge Logos, click the link below

Logos.zip

Support Articles

Support Articles

DesignCompleted() Client-Side Event

DesignCompleted() is a client-side event that will fire within the hosting page of the dealer website.  The hosting page is the web page that contains the IFRAME element tag.  The SRC attribute of the IFRAME element points to the web content pulled from the Blackinton.com web infrastructure.

The CheckDesignStatus() JavaScript function, which is included in the newest release of the supporting files, polls at a set interval (1 second) for the existance of a 'footprint' file associted with the user session and design transaction.  This file is created when data is posted from the Blackinton.com web infrastructure to the dealer website via an HTTP POST.  The postback.asp, postback.aspx, or postback.php server side pages (which are located on the dealer website) create this 'footprint' file.

Once the 'footprint' file is confirmed to exist on the dealer server (the footprint file consists of the transaction number and the suffix 'completed', i.e. vbh99999999.completed), the event DesignCompleted() is fired and the polling is stopped.

To use the DesignCompleted() event, do the following:

1.  Download the latest support files.
2.  Update the <HEAD> section of your hosting page with the contents of HEAD.HTML (found in support.zip).
3.  Copy CheckDesignStatus.asp, CheckDesignStatus.aspx or CheckDesignStatus.php (depending on your hosting enviornment) to the dealer website.
4.  Uncomment the code for the CheckDesignStatus() function.
5.  Confirm the existance of postback.asp, postback.aspx, or postback.php on the dealer website.
6.  Examine the postback code and confirm the path to the postData folder is correct.
7.  Confirm the permissions are set correctly on the postData folder (this folder will contain the footprint files).

Known Issues

Design-A-Badge in a pop-up window

Using a pop-up window to host the Design-A-Badge interface will result in the inability to close the pop-up window at the end of the design process. This is a result of "cross-site" scripting prevention within today's web browsers. Due to the potential security risks associated with concepts associated with "cross-site" scripting, browsers block script from one domain (blackinton.com) that attempts to access content within another (i.e. dealersite.com).

There is a now a work-a-round for this issue.  Please download the latest supporting files shown above.  Utilize the CheckDesignStatus.asp,  CheckDesignStatus.aspx, or CheckDesignStatus.php on your web site, in conjunction with the DesignStatusCheck() JavaScript function to poll for design completion, which will trigger the DesignCompleted client side event.  This event runs within your dealer site and will have the ability to use window.close() to close the pop-up window at the end of the design process.

Live Support

For non-critical support issues:
please email [email protected] with the details of your issue.  You will recieve a response with 24 hours.

For critical support issues:
please call 401.714.0499 x105,  Monday - Friday, 9AM - 5PM (EST).