Forum Discussion

SuneR's avatar
SuneR
Guide
15 years ago

Description of default Components and FreeMarker information

I am currently trying to figure out the possibilities of our Lithium install, and am therefore interested in finding out more about the default components that are available.   I have searched thou...
  • KaelaC's avatar
    KaelaC
    15 years ago

    At this time, there is not a complete list of the default components and description of what they do although I do believe that is coming soon to studio (descriptions at least). There is not a lot of customization that can be done to default components but you can use those components in custom components.  For example, if I wanted to show search only to logged in users

    <#if user.registered >  <#-- if the user is not anonymous -->
<@component id="common.widget.search-form" showAdvancedSearchLink="false" />

</#if>

    You can use a user avatar with freemarker, you just also need to use our REST API like this:

    <#assign avatar = rest("/users/id/[user id]/profiles/avatar").image />
    <#if avatar.url?length gt 0>
    <img src="${avatar.url}">
    </#if>

    You will need to replace [user id] with the id of the user whose avatar you want. If you are looking to display the current user's avatar you can use

    ${user.id}

    . Hope that helps.

     

    Edited - I had a longer example but my html is code is being interpreted instead of displayed. I will update when I fix that :)

KaelaC's avatar
KaelaC
Lithium Alumni (Retired)

At this time, there is not a complete list of the default components and description of what they do although I do believe that is coming soon to studio (descriptions at least). There is not a lot of customization that can be done to default components but you can use those components in custom components.  For example, if I wanted to show search only to logged in users

<#if user.registered >  <#-- if the user is not anonymous -->
<@component id="common.widget.search-form" showAdvancedSearchLink="false" />

</#if>

You can use a user avatar with freemarker, you just also need to use our REST API like this:

<#assign avatar = rest("/users/id/[user id]/profiles/avatar").image />
<#if avatar.url?length gt 0>
<img src="${avatar.url}">
</#if>

You will need to replace [user id] with the id of the user whose avatar you want. If you are looking to display the current user's avatar you can use

${user.id}

. Hope that helps.

 

Edited - I had a longer example but my html is code is being interpreted instead of displayed. I will update when I fix that :)

MoniqueL's avatar
MoniqueL
Lithium Alumni (Retired)
15 years ago

Just adding on to Kaela's post, I've found a list of many (not all) common default components and the pages they appear on. While they lack a formal description, the name kind of implies the of data they show.

 

How do they work?

Summary

All contributed components are FreeMarker templates. Default components exist in the res/components directory in dev.lia.components.resources. Contributed components are contributed in the mirror location in a custom plugin. Both Tapestry and FreeMarker components are referenced by name from a Quilt. The first step in rendering a Quilt starts by looking for a FreeMarker component. If one is not found (contributed or default), the search continues for Tapestry components.

 

Widget List

<component id="blogs.widget.archives"/>
<component id="blogs.widget.bios"/>
<component id="blogs.widget.blogroll"/>
<component id="blogs.widget.labels"/>
<component id="blogs.widget.latest-articles"/>
<component id="blogs.widget.latest-comments"/>
<component id="blogs.widget.management"/>
<component id="blogs.widget.moderators"/>
<component id="common.widget.announcement"/>
<component id="common.widget.node-description"/>
<component id="community.widget.admin-links"/>
<component id="community.widget.notes"/>
<component id="community.widget.quick-links"/>
<component id="custom.widget.template"/>
<component id="forums.widget.board-browser"/>
<component id="forums.widget.board-browser-column"/>
<component id="forums.widget.board-browser-list"/>
<component id="forums.widget.polls"/>
<component id="forums.widget.recent-messages"/>
<component id="forums.widget.recent-threads"/>
<component id="forums.widget.tooltip-message-views"/>
<component id="forums.widget.top-boards"/>
<component id="forums.widget.users-online"/>
<component id="ideas.widget.labels"/>
<component id="ideas.widget.management"/>
<component id="ideas.widget.most-populars"/>
<component id="ideas.widget.statuses"/>
<component id="images.widget.gallery"/>
<component id="images.widget.moderation"/>
<component id="kudos.widget.authors-leaderboard"/>
<component id="kudos.widget.givers-leaderboard"/>
<component id="kudos.widget.messages-leaderboard"/>
<component id="kudos.widget.messages-recently-kudoed-by-user"/>
<component id="kudos.widget.my-recent-kudos-from-users"/>
<component id="kudos.widget.my-recent-kudos-to-users"/>
<component id="kudos.widget.my-recently-kudoed-messages"/>
<component id="kudos.widget.my-top-kudoed-messages"/>
<component id="solutions.widget.recently-solved-threads"/>
<component id="subscriptions.widget.bookmarks"/>
<component id="subscriptions.widget.featured-threads"/>
<component id="subscriptions.widget.subscriptions"/>
<component id="tags.widget.frequent-tagged-messages"/>
<component id="tags.widget.leaderboard"/>
<component id="tags.widget.leaderboard-community-title"/>
<component id="tags.widget.leaderboard-messages"/>
<component id="tags.widget.leaderboard-messages-community-title"/>
<component id="tags.widget.leaderboard-messages-title"/>
<component id="tags.widget.leaderboard-title"/>
<component id="tags.widget.my-recent-tagged-messages"/>
<component id="tags.widget.my-related-tag-cloud"/>
<component id="tags.widget.my-related-tag-cloud-content"/>
<component id="tags.widget.my-tags"/>
<component id="tags.widget.recently-tagged-messages"/>
<component id="tags.widget.related-tag-cloud"/>
<component id="tags.widget.tag-cloud"/>
<component id="tags.widget.tagger"/>
<component id="users.widget.about-me"/>
<component id="users.widget.contact-me"/>
<component id="users.widget.moderator-controls"/>
<component id="users.widget.my-friends"/>
<component id="users.widget.my-friends-by-request"/>
<component id="users.widget.my-public-statistics"/>
<component id="users.widget.my-statistics"/>
<component id="users.widget.quick-stats"/>
<component id="users.widget.registration"/>

Blog Side Widget

<?xml version="1.0" encoding="UTF-8"?>
<components>	
	<component id="common.widget.announcement"/>
	<component id="blogs.widget.bios"/>
	<component id="blogs.widget.management"/>
	<component id="blogs.widget.blogroll"/>
	<component id="blogs.widget.latest-articles"/>
	<component id="blogs.widget.latest-comments"/>
	<component id="blogs.widget.archives"/>
	<component id="blogs.widget.labels"/>
	<component id="kudos.widget.messages-leaderboard"/>
	<component id="kudos.widget.authors-leaderboard"/>	
</components>

Idea Side Widget

<?xml version="1.0" encoding="UTF-8"?>
<components> 
 <component id="common.widget.announcement"/>
 <component id="ideas.widget.management"/> 
 <component id="blogs.widget.latest-articles"/>
 <component id="kudos.widget.authors-leaderboard"/>
 <component id="blogs.widget.latest-comments"/>
 <component id="ideas.widget.statuses"/>
 <component id="ideas.widget.labels"/>
</components>

Board Side Widgets

<?xml version="1.0" encoding="UTF-8"?>
<components>
<component id="common.widget.node-description"/>
 <component id="common.widget.announcement"/>
 <component id="solutions.widget.recently-solved-threads"/>
 <component id="kudos.widget.messages-leaderboard"/>
 <component id="kudos.widget.authors-leaderboard"/>
 <component id="kudos.widget.givers-leaderboard"/>
 <component id="tags.widget.tag-cloud"/>
<component id="tags.widget.tagger"/>
</components>

Community Side Widgets

<?xml version="1.0" encoding="UTF-8"?>
<components> 
 <component id="common.widget.announcement"/>
 <component id="community.widget.admin-links"/>
 <component id="solutions.widget.recently-solved-threads" />
 <component id="kudos.widget.messages-leaderboard"/>
 <component id="kudos.widget.authors-leaderboard"/>
 <component id="tags.widget.tag-cloud"/> 
 <component id="tags.widget.leaderboard"/>
<component id="users.widget.registration"/>
 <component id="forums.widget.users-online"/>
 <component id="users.widget.quick-stats"/>
 <component id="images.widget.moderation"/>
</components>

Community (main content area) Widgets

<?xml version="1.0" encoding="UTF-8"?>
<components> 
 <component id="forums.widget.board-browser"/>
 <component id="forums.widget.board-browser-column"/>
 <component id="forums.widget.board-browser-list"/>
 <component id="forums.widget.top-boards"/>
 <component id="forums.widget.recent-threads"/>
 <component id="forums.widget.recent-messages"/>
<component id="tags.widget.leaderboard-messages"/>
 <component id="subscriptions.widget.subscriptions"/>
 <component id="subscriptions.widget.bookmarks"/>
</components>

 

  • MoniqueL's avatar
    MoniqueL
    Lithium Alumni (Retired)
    15 years ago

    cont. because I exceeded the character limit : )

     

    Tag Leaderboard Side Widgets

    <?xml version="1.0" encoding="UTF-8"?>
    <components>
     <component id="tags.widget.leaderboard-title"/>
     <component id="tags.widget.leaderboard-community-title"/>
    </components>

    Tag Leaderboard (main content area) Widgets

    <?xml version="1.0" encoding="UTF-8"?>
    <components> 
     <component id="tags.widget.leaderboard-messages-title"/>
     <component id="tags.widget.leaderboard-messages-community-title"/>
    </components>

    Tag View Side Widgets

    <?xml version="1.0" encoding="UTF-8"?>
    <components> 
     <component id="tags.widget.related-tag-cloud"/>
     <component id="tags.widget.tagger"/>
    <component id="tags.widget.my-related-tag-cloud"/>
    <component id="tags.widget.my-related-tag-cloud-content"/>
    </components>

    Tag View (main content area) Widgets

    <?xml version="1.0" encoding="UTF-8"?>
    <components> 
     <component id="tags.widget.recently-tagged-messages"/>
     <component id="tags.widget.my-recent-tagged-messages"/>
     <component id="tags.widget.frequent-tagged-messages"/>
    </components>

    View Profile Side Widgets

    <?xml version="1.0" encoding="UTF-8"?>
    <components> 
     <component id="users.widget.about-me"/>
     <component id="users.widget.contact-me"/>
      <component id="users.widget.my-friends-by-request"/>
     <component id="kudos.widget.my-recent-kudos-to-users"/>
     <component id="kudos.widget.my-recent-kudos-from-users"/>
     <component id="tags.widget.my-tags"/>
    </components>

    View Profile (main content area) Widgets

    <?xml version="1.0" encoding="UTF-8"?>
    <components> 
     <component id="users.widget.my-public-statistics"/>
     <component id="users.widget.my-statistics"/>
     <component id="forums.widget.recent-messages"/>
     <component id="kudos.widget.my-recently-kudoed-messages"/>
     <component id="kudos.widget.messages-recently-kudoed-by-user"/>
     <component id="images.widget.gallery"/>
     <component id="users.widget.moderator-controls"/>
    </components>
  • bdehamer's avatar
    bdehamer
    Guide
    15 years ago

    This is a helpful, but I would love to see a definitive list of all of the component IDs that can be used with the <@component /> macro along with all of the supported parameters.

    • DavidChaverri39's avatar
      DavidChaverri39
      Adept
      13 years ago

       

      bdehamer wrote:

      This is a helpful, but I would love to see a definitive list of all of the component IDs that can be used with the <@component /> macro along with all of the supported parameters.

      Yes, Please !!!!!!

    • raula_'s avatar
      raula_
      Expert
      14 years ago
      +1 me too :)