Skip to main content Skip to navigation

Department of Economics

News Feed


    Data Attributes

    • data-type - news (specifies news processor)
    • data-url - url of page to grab news from
    • data-noimage - comma-delimited image urls to replace missing images from news posts / featured image (widest in post). If multiple images are supplied one will be selected at random
    • data-featured-width - specify the minimum width for the featured image. If no content images are suitable it will default to images specified in data-noimage
    • data-categories - querying the feed keywords only pull categories specified (comma delimited - if your tag has a comma in it please escape it with a backslash \,)
    • data-categories-logic - handle multiple categories with logic OR or AND (default OR)
    • data-ignore-categories - do not include the specified categories in the return (comma delimited - if your tag has a comma in it please escape it with a backslash \,)
    • data-start - pull news after this start date (use string value dates described hereLink opens in a new window)
    • data-end - pull news before this end date (use string value dates described hereLink opens in a new window)
    • data-order - any template variable below ASC / DESC (ASC default)
    • data-limit - limit the number of results
    • data-local-href - allow the {href} template variable to link to the newsbuilder page (false default)
    • data-schedule-update - force an update of the page (comma delimited - use string value dates described hereLink opens in a new window, preferably in the format 1:30am)

    Content Variables

    Variables placed at the start of a new paragraph in newsbuilder that influence the behaviour of specific posts (options are all comma delimited). Usage: 

    variable: option1,option2
    • categories - keywords
    • keywords - keywords
    • tags - keywords
    • authors - usernames
    • related - urls
    • title - overwrite page title

    Template Variables

    • {sitebuilderID} - id of the item in sitebuilder
    • {sitebuilderEdit} - url to edit the item
    • {sitebuilderDelete} - url to delete the item
    • {title} - title of news post
    • {titleNormalised} - convert accents and other special chars to their basic equivalent
    • {categories} - comma delimited categories
    • {classes} - space delimited lowercase categories (useful for classes)
    • {publicationDate} - publication date in default style i.e. Friday 6 Jun 2014
    • {publicationDateTS} - publication date millsecond timestamp
    • {lastUpdated} - last updated date in default style i.e. Friday 6 Jun 2014
    • {lastUpdatedTS} - last updated date millsecond timestamp
    • {image} - image src for the post, if empty can have default applied to attribute data-noimage
    • {featuredImage} - widest image in the content, if empty can have default applied by attribute data-noimage
    • {excerpt} - content stripped of HTML tags
    • {content} - content
    • {paragraphExcerpt(x)} - Any paragraphs found in the content where x corresponds to the order in which it is found stripped of HTML tags
    • {paragraphContent(x)} - Any paragraphs found in the content where x corresponds to the order in which it is found
    • {paragraphClass(x)} - Any paragraphs found in the content where x corresponds to the order in which it is found creating a class name based on the id followed by "-p" then x, i.e. news-p1
    • {contentUrl(x)} - Any urls found in the content will create a set of links where x corresponds to the order in which it is found
    • {image(x)} - Any images found in the content will create a set of links where x corresponds to the order in which it is found
    • {href} - link to news post or to the URL field if "Use a pre-existing web page for this item's detail" is selected

    Example

    <div id="news" data-type="news" data-url="/fac/soc/economics/intranet/news/" data-noimage="/fac/soc/economics/staff/placeholder.png"data-limit="10">
    <h2><a href="{href}">{title}</a> </h2>
    <p>{publicationDate}</p>
    <p><img src="{image}" border="0" height="150" /></p>
    <p>{excerpt}</p>
    </div>

    Output