{module_webappscustomer}

Description

Displays the list of Web App Items submitted by a customer (must be logged in).

Syntax

{module_webappscustomer render="item|collection" id="webappID|webappName" filter="item" itemId="categoryId|categoryName|itemId" targetFrame="" useBackupTemplate="true" resultsPerPage="" hideEmptyMessage="true|" rowCount="" sortType="ALPHABETICAL" collection="my_custom_collection_name" template="/folder/template.tpl"}

Note: When using named parameters always wrap the individual parameters in double quotes. Also, do note that modules using named parameters do not work for campaigns just yet.

Parameters

  • render - possible values are item or collection (the default is item). The render parameter indicates whether the template content is used to render a collection or to render a single item. Take a look at the render parameter's article for more details on how to use it
  • id - web app id or the web app's name
  • filter - filtering criteria for display and can be one of the following:
    • item - individual item
    • all - all items
    • latest - latest items
    • latestClassified - latest items in a category
    • random - random item
    • randomClassified - displays a random item in a particular category
    • classified - all the items in a category
  • itemid - system generated individual item id (do not change)
  • targetFrame - e.g. _blank. Specify the frame you want the item to open in
  • useBackupTemplate - specify True if you want to use the backup list template or leave empty
  • resultsPerPage - total number of items per page before pagination is used (limit of 500 items per page)
  • hideEmptyMessage - specify true if you don't want the No Items Found message to be displayed.
  • rowCount - will limit the number of items per row when items are displayed as a list. Default is 1 item per row.
  • sortType
    • ALPHABETICAL (default) - items are sorted in alphabetical order form A-Z
    • DATE - items are sorted from newest to oldest. The most recent item is displayed first.
    • DATEREVERSE - will display the web app items oldest to newest
    • WEIGHTREVERSE - allows you to display the web apps by weight but in reverse, that is the item with the smallest weight is displayed first.
  • collection - use this if you need to access the module's Liquid output tags
  • template - render the module using a custom template. You can leave the value of the template parameter blank to suppress the original output and use Liquid output tags instead

This module can be rendered using:

  • the webapp list layout - on this layout you can use either the legacy tags or Liquid output tags. Here is a list of all the tags you can use the Webapp List Layout's reference page
  • your own custom layout - take a look at the custom templates article for more details
  • Liquid collections - here are the Liquid output tags you can use:

Warning: if you need to access a liquid tag that has a space in its name, for example tag_large image_value use this syntax: {{cars1.items[0].["large image_value"]}} - Liquid does not allow for the name of its output tags to contain spaces. In this case the tag that contains a space needs to be wrapped in square bracketsĀ and quotes and preceded by the name of the collection (in this case cars1).

Liquid tag Legacy tag Description
{{itemid}} {tag_itemid}Item's system ID
{{address1}} {tag_address1}Address1
{{address2}} {tag_address2}Address2
{{city}} {tag_addresscity}City
{{country}} {tag_addresscountry}Country
{tag_addressglatlng}This tag provides a shortcut to generate GLatLng objects for use with the Google Maps API.
{{latitude}} {tag_addresslatitude}Latitutde of web app item address
{{longitude}} {tag_addresslongitude}Longitude of web app item address
{{state}} {tag_addressstate}State
{{zipcode}} {tag_addresszipcode}ZIP code
{tag_addtofavorites,add_Image, remove_Image} Add the news item to favorites list. Optionally customize to display your own custom image for adding and removing. Here is an example - {tag_addtofavorites,<img alt="" src="/images/add.gif" />,<img alt="" src="/images/remove.gif" />}<br/>
For additional information on how to render the output of this tag using Liquid take a look at the Enable other Liquid tags article.
{{button}} {tag_button,Your Text}will output a hyperlink with the text "Your Text" and when clicked will take the site visitor to the detail layout
{{commentCount}} {tag_commentcount}Number of comments for current post
{{counter}} {tag_counter}Incremental count of the item on the page
{tag_delete} Creates a link that allows current customer to delete a web app item they have previously submitted (only available if customer logged in to a secure zone)
{{deleteUrl}} The URL that allows current customer to delete a web app item they have previously submitted (only available if customer logged in to a secure zone)
{{description}} {tag_description,number of characters}Description of item (editor content). On the "List Layout (Backup)" you can use {tag_description,10} to display the first 10 characters of the webapp item's description.
{tag_edit}Creates a link that allows current customer to edit a web app item they have previously submitted (only available if customer logged in to a secure zone). Clicking this link will open up the edit layout
{{editUrl}} Creates a link that allows current customer to edit a web app item they have previously submitted (only available if customer logged in to a secure zone). Clicking this link will open up the edit layout
{{expiryDate}} {tag_expirydate}Expiry date of item in this format - 01-Jan-9999
{{lastUpdateDate}} {tag_lastupdatedate}Last update date of item in this format -01-Jan-9999
{{name}} {tag_name_nolink}Name of item (without hyperlink)
{tag_name}Name of the item - will have hyperlink that points to the item's detail layout
{{releaseDate}} {tag_releasedate}Release date of item in this format - 08-Sep-2014
{{weight}} {tag_weight}Weighting of item
{{urlWithHost}} {tag_itemurl_withhost}Full URL of the web app item including host for example http://mysamplesite.com/car-catalogue/ford-explorer
{{url}} {tag_itemurl_nolink}Relative URL of the web app item for example /car-catalogue/ford-explorer
  {tag_rowcss,myclass}Replate myclass with your own CSS class. Alternates between classes, such as "myclass" and "myclass_alternate"
{{image}} {tag_image} For "Image" type fields only - renders the image wrapped in a hyperlink
{{image_value}} {tag_image_value} For "Image" type fields only - renders the image's src
{{image_nolink}} {tag_image_nolink} For "Image" type fields only - renders only the image
{{datasource_id}} {tag_datasource_id} Renders the ID of the datasource field e.g. - if my datasource field is named country, the tag will be {tag_country_id}
{{datasource}} {tag_datasource} Renders a link to the datasource item e.g. - if my datasource field is named country, the tag will be {tag_country}

Examples

  • {module_webappscustomer id="56" filter="all"} - will display all web app items that belong to the customer that's logged in for a web app with ID 56
  • {module_webappscustomer id="56" filter="classified" itemid="14609" targetFrame="_blank" resultsPerPage="13" template="/layouts/custom/walist.html"} - will display the webapp items in the category with the ID 14609 using the walist.html custom template, 13 items per page
  • {module_webappscustomer id="56" collection="collection1" template=""} - in this case nothing will be displayed, however the module's Liquid tags will become available in the collection1 collection.

Syntax

{module_webappscustomer,ID,filter,itemID,,target,bkp,resultsPerPage,hideEmptyMessage,rowLength,sortType}

Parameters

  • ID - system generated web app id (do not change)
  • filter - filtering criteria for display and can be one of the following:
    • i - individual item
    • a - all items
    • l - latest items
    • r - random item
    • cl - latest items in a particular category
    • cr - displays a random item in a particular category
  • itemID - system generated individual item id (do not change)
  • target - e.g. _blank. Specify the frame you want the item to open in
  • bkp - specify True if you want to use the backup list template or leave empty
  • resultsPerPage - total number of items per page before pagination is used (limit of 500 items per page)
  • hideEmptyMessage - specify true if you don't want the No Items Found message to be displayed.
  • rowLength - will limit the number of items per row when items are displayed as a list. Default is 1 item per row.
  • sortType
    • ALPHABETICAL (default) - items are sorted in alphabetical order form A-Z
    • DATE - items are sorted from newest to oldest. The most recent item is displayed first.
    • DATEREVERSE - will display the web app items oldest to newest
    • WEIGHTREVERSE - allows you to display the web apps by weight but in reverse, that is the item with the smallest weight is displayed first.

Layouts

Examples

  • {module_webappscustomer,56,a,} - will display all web app items that belong to the customer that's logged in for a web app with ID 56
  • {module_webappscustomer,56,c,14609,,_blank,,13 template="/layouts/custom/walist.html"} - will display the webapp items in the category with the ID 14609 using the walist.html custom template, 13 items per page