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 tag 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:
- And/Or plain text anywhere outside of the cURL and HTML tags
CodeREADr supports Webify tags in two places: Service Description and 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|
Note: We recommend a simple and clean UI so the app user is informed and can take action if needed.
Full-Screen In-App Window or Browser
If you want the app user to have the option to tap a button to view web content, the URL can open in its own full-screen window from a webify container if you 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.
The codereadr:browser: prefix will open it in the device’s default browser app (i.e. Chrome or Safari).
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 text – 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.
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 a specific image or Web page if using contextual variables. Any of these contextual variables can be used:
- USER_NAME = $(USER_NAME)
- USER_ID = $(USER_ID)
- SERVICE_ID = $(SERVICE_ID)