How to Use Webify
Webify allows you to display web-formatted content in-app when plain text is not enough. Webify can also be used with contextual variables for customizing the Response text the app user sees after a scan.
You can show HTML directly using standard W3C
HTML tags. CodeREADr will render your HTML within the application just like a web page. If you are using an ‘on-device’ database or ‘scan mask’ you can load a full HTML page from a URL using the
cURL tag. The
cURL is not supported for online database services or postback services at this time.
NOTE: Because the
cURL tags are not supported for online database services or postback services you must return full
HTML tags only. If you have questions about this feature, please feel free to contact us.
The Basic Syntax
NOTE: the curl and/or html tag must be properly opened and closed or the app will treat it as plain text.
- One curl tag containing one URL:
- And/Or one html tag:
<html><img src="https://mywebpage.com/picture.png" /></html>
- And/Or plain text anywhere outside of the curl and html tags.
Where is Webify supported?
CodeREADr supports Webify tags in two places:
- Service Description
- Scan Response
Service description text.
|Web Input||App Display|
Scan response text.
|Web Pattern Response Input||App Scan Response Display|
|Web Database Input||App Database Display|
Full-Screen In-App Window or Browser
To have a link open in its own full-screen window from a webify container you need to include a prefix. In both cases, the app user can seamlessly continue scanning after closing the window or browser.
The codereadr:_blank: prefix will attempt to open it in-app but in a full view window.
<a href=‘codereadr:_blank:http://example.com’>_blank example</a>
The codereadr:browser: prefix will open it in the device’s default browser app (i.e. Chrome or Safari).
<a href=‘codereadr:browser:http://example.com’>browser example</a>
Combination and Precedence
In the event you provide more than one format ( curl tag, html tag and plain text), the app will only display one of the three based on the following precedence:
- cUrl – the first choice when present.
- Html – the second choice when present.
- Plain – the third choice is plain text and is displayed when curl and html are both not available. Note: any text not inside a curl or html tag is considered plain text.
Example of a single input that contains all three Webify display formats:
<curl>http://example.com/product.html</curl>Product details in plain text.<html> <h1>Product Title</h1> <img src="http://example.com/product.jpg" /></html>
Change Response Screen Labels and Colors
As an added feature to customize the Response to a scan, on the Advanced step when creating or editing a service you can change the screen’s labels and colors to best fit your intended response to the app user.
Web Content as a Service
In addition to the typical recording and validation Services offered, you can also create a Web-View-Only Service with our Webify feature. Webify will present to the app user an image (such as your logo) or Web page or, if using contextual variables, a specific image or Web page. Any of these contextual variables can be used:
- USER_NAME = $(USER_NAME)
- USER_ID = $(USER_ID)
- SERVICE_ID = $(SERVICE_ID)