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:
    <curl>http://mywebpage.com</curl>
  • 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:

  1. Service Description
  2. Scan Response

Service description text.

Web InputApp Display
web-describe_normalapp-describe_normal

Scan response text.

Web Pattern Response InputApp Scan Response Display
web-pattern_normalapp-scan_normal
Web Database InputApp Database Display
web-db_normalapp-db_normal

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:

  1. cUrl – the first choice when present.
  2. Html – the second choice when present.
  3. 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)
in Services