Authors

General Usage

Example

<authors
    source="followers"
    source_site="current_site"
    limit="25"
    template="jinja/authors.html"
/>

Attributes

  • source (default: permissions)
  • source_site (default: current_site) – sets up the context
    • current_site
      • author/community – for profile pages and community posts pages
      • runner/roar – for other pages
    • parent_site - runner/roar – for all pages
  • limit – sets the max number of results
  • template – path to Jinja template that takes the following structure as input:
{
    'node': node,  # <authors> node reference
    'sites': node_input['site_data_list'],  # list of sites
    'count': node_input['total_count'],  # total number of sites
}

Sources

Permissions source

Example

<authors
    source_site="current_site"
    source="permissions"
    group="editors"
    order="rating"
    limit="25"
    template="jinja/authors.html"
/>

Attributes

  • group (default: none)
    • readers
    • editors
    • coowners
    • approvals
    • guest_writer
    • guest_editor
    • admins
    • developers
  • order (default: none)
    • title
    • rating

Followers source

Example

<authors
    source_site="current_site"
    source="followers"
    order="rating"
    limit="25"
    template="jinja/authors.html"
/>

Attributes

  • order (default: none)
    • title
    • rating

Following source

Example

<authors
    source_site="current_site"
    source="following"
    order="rating"
    limit="25"
    template="jinja/authors.html"
/>

Attributes

  • order (default: none)
    • title
    • rating

Search source

Example

<authors
    source_site="parent_site"
    source="search"
    phrase="{{getparams.q}}"
    type="author"
    limit="25"
    cache_ttl_in_seconds="120"
    template="jinja/authors.html"
/>

Attributes

  • phrase (default: value from q query parameter)
    • Can be a specific phrase
    • Can be a Skeleton Expression
  • type (default: author)
    • author
    • community

Ids source

Example

<authors
    source="ids"
    ids="123123,4356546,67896879"
    template="jinja/authors.html"
/>

Attributes

  • ids – comma-separated list for author IDs
    • Can be a specific list
    • Can be a Skeleton Expression