LiveWhale

Welcome, Guest Login

Support Center

Using the format arg in widgets

Last Updated: Dec 22, 2014 09:24AM PST

All widgets have a default output format that dictates the structure and styling of each listed result. In special cases, you may wish to change the format on a case-by-case basis. This functionality will be difficult for basic users to grasp, but savvy users or admins may help provide assistance where needed using this feature.

  • From the LiveWhale interface, click the “Widgets” link.
  • Click the widget you wish to edit, or click “Add a New Widget” and then select the type of widget you wish to create.
  • Find the arg named “format” (or format_starred, if you wish to use a special format for starred items in your widget’s results). By default, the format field will be empty, in which case the default format is used. To create a custom format, click on the available format variables beneath the text field and they will be added to your format field one at a time.
  • If you wish to customize the format further, you may edit the text field directly to fine tune the structure or to add any CSS classes you want.
  • Use the widget preview box to preview your changes, before saving your widget with the custom format.

 Note: In some circumstances, a or Using the format arg in widgets var will come pre-wrapped with an <a> tag, linking to the item. If you wish to use a title or headline inside an HTML attribute, and therefore do not want the <a> tag, you can use or Using the format arg in widgets instead. All other variables can have “_clean” appended to the variable name for use in HTML attributes. i.e. .

eb8f96c071020d8b0923da726d6cab65@livewhale.desk-mail.com
https://cdn.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete