Display user contact details using a contact card-style layout.

Description

This recipe uses a combination of the Reporting Plugin and the {float} macro from the Composition Plugin to display a flexible set of contact information for registered users.

Ingredients

Plugins

Composition Plugin, Reporting Plugin

Macros

report-block, report-body, report-image, report-info, text-sort, user-reporter

Suppliers

User Supplier

Extra Ingredients

float

1. First, we start by selecting the report generator style. In this case, since we'll be mixing in {float} we'll use the report-block generator:

   {report-block}
   

2. Next, we're reporting on users, so we'll use the user-reporter to create a list. And since we're just listing all users, we wont add any filters such as group membership or the like. We will sort by the user's full name however, specifying the "user:full name" key from the User Supplier:

   {user-reporter}
     {text-sort:user:full name}
   {user-reporter}
   

3. Next, we set up the body for each item:
   • Firstly, declare the opening report-body tag:

     {report-body}
     

   • Now, open the {float} macro, floating to the left:

     {float:left}
     

   • Now, let's display the user's personal picture (reduced to 16x16) and their full name. Also, the name should link to the user's profile, so we'll set 'link' to true:

     {report-image:user:picture|width=16px|height=16px} *{report-info:user:full name|link=true}*
     

   • Next, we'll display their unique user ID:

     *User ID:* {report-info:user:name}
     

   • Lastly, we'll list their email address. Note, however, that depending on the server's settings, users email addresses may be restricted or masked, so we'll also provide a default message of 'Unavailable' for cases where the current user doesn't have permission to view other people's email addresses:

     *Email:* {report-info:user:email|link=true|default=_Unavailable_}
     

   • To finish of the body, close the {float} and report-body macros:

     {float}
     {report-body}
     

4. Finally, close the report-block generator macro:

   {report-block}