From 77a17736b151769a2188dc9a7eba3e6226e691ae Mon Sep 17 00:00:00 2001
From: jensp <jensp@8810af33-2d31-482b-a856-94f89814c4df>
Date: Sun, 3 Nov 2019 08:38:24 +0000
Subject: [PATCH] Documentation for user-banner.ftl

git-svn-id: https://svn.libreccm.org/ccm/trunk@6284 8810af33-2d31-482b-a856-94f89814c4df
---
 .../freemarker/ccm-core/user-banner.ftl       | 57 +++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/ccm-core/web/themes/freemarker/ccm-core/user-banner.ftl b/ccm-core/web/themes/freemarker/ccm-core/user-banner.ftl
index 24d230a35..5abbe3963 100644
--- a/ccm-core/web/themes/freemarker/ccm-core/user-banner.ftl
+++ b/ccm-core/web/themes/freemarker/ccm-core/user-banner.ftl
@@ -5,38 +5,95 @@
 "ui": "http://www.arsdigita.com/ui/1.0"}
 >
 
+<#--filedoc
+    The user banner component provides several informations about the current
+    user.
+-->
+
+<#--doc
+    Retreives the value the `greeting` property from the user banner.
+
+    @return The value of the `greeting` property of the user banner.
+-->
 <#function getGreeting>
     <#return model["./ui:userBanner/@greeting"]>
 </#function>
 
+<#--doc
+    Determines if the current user is logged in.
+
+    @return `true` if the current user is logged in, `false` if not.
+-->
 <#function isLoggedIn>
     <#return (model["./ui:userBanner/@screenName"]?size > 0)>
 </#function>
 
+<#--doc
+    Determines if the current user is *not* logged in.
+
+    @return `true` if the current user is *not* logged in, `false` if the user
+    is logged in.
+-->
 <#function isNotLoggedIn>
     <#return (model["./ui:userBanner/@screenName"]?size == 0)>
 </#function>
 
+<#--doc
+    Retrieves the URL for changing the password. Only available if the current
+    user is logged in.
+
+    @return The URL for changing the password.
+-->
 <#function getChangePasswordUrl>
     <#return model["./ui:userBanner/@changePasswordURL"]>
 </#function>
 
+<#--doc
+    Retrieves the link to the login form. Only available if the current user
+    is not logged in.
+
+    @return The link to the login form.
+-->
 <#function getLoginLink>
     <#return model["./ui:userBanner/@loginExcursionURL"]>
 </#function>
 
+<#--doc
+    Retrieves the link for logging out. Only available if the current user
+    is logged in.
+
+    @return The link for logging out.
+-->
 <#function getLogoutLink>
     <#return model["./ui:userBanner/@logoutURL"]>
 </#function>
 
+<#--doc
+    Retrieves the screen name (user name) of the current user. Only available
+    if the current user is logged in.
+
+    @return The screen name of the current user.
+-->
 <#function getScreenName>
     <#return model["./ui:userBanner/@screenName"]>
 </#function>
 
+<#--doc
+    The given name of the current user. Only available if the current user is 
+    logged in.
+
+    @return The given name of the current user.
+-->
 <#function getUserGivenName>
     <#return model["./ui:userBanner/@givenName"]>
 </#function>
 
+<#--doc
+    The family name of the current user. Only available if the current user is 
+    logged in.
+
+    @return The family name of the current user.
+-->
 <#function getUserFamilyName>
     <#return model["./ui:userBanner/@familyName"]>
 </#function>
\ No newline at end of file