After you have defined what user or users you want to show, you can tell Users Anywhere what user data you want to output to the page.
If you place nothing between the opening and ending tags, the full user will be placed:
{user title="Shetland Sheepdog"}{/user}
However, you will probably only want certain types of data to show, like only the text or only the title.
To define what data you want to get displayed, you place "Data Tags" within the {user}
and {/user}
tags.
For instance, to show only the title of the user with id 123, you can do:
{user id="123"}[title]{/user}
You can display a huge range of data types, including any user data, category data, dates, and even custom field values and dynamic data - pretty much anything you can think of.
Let’s take an in-depth look at the Data Tags available and their respective options and features.
This is a full list overview of all the data types you can use as Filters, Ordering, Data Tags and inside If Structures with Users Anywhere. Remember:
- When you want to output the data (Data Tags), you need to surround them with square brackets - for example:
[title]
. - When using these in all other cases (filters, ordering and If structures), then they must be used without the square brackets - for example:
{if title != 'Furry Animals'}...{/if}
.
Refer to the respective sections of the documentation for the full explanation and details on how to use each of these.
Tip: Data types that return True / False values are especially useful to do custom checks with If Structures.
User Data
Syntax | Example | Description |
---|---|---|
name |
Peter van Westen | The name of the user. |
username |
peter | The user of the user. |
id |
12 | The ID of the user. |
email |
The email address of the user. | |
accesslevels |
Public, Registered, Special | A list of all the access levels the user has. |
usergroups |
Public, Registered, Administrator | A list of all the user groups the user is in. |
address1 |
My Street 123 | Profile*: Address 1 |
address2 |
Suite 4 | Profile*: Address 2 |
address |
My Street 123 Suite 4 |
a combination of address1 and address2 . A break will only be added if both are not empty. |
city |
Cityville | Profile*: City |
region , state or suburb |
Main County | Profile*: Region |
country |
The Upperlands | Profile*: Country |
zipcode , postcode or postal-code |
12345 | Profile*: Postal/ZIP Code |
phone |
+99-12-345-6789 | Profile*: Phone |
website |
https://regularlabs.com | Profile*: Website |
[link-website]...[/link-website] |
<a href="https://regularlabs.com">...</a> |
Opening and closing tag to add a link to the profile* website (wraps the content with an a href tag). |
favoritebook |
Waar is Piep? | Profile*: Favourite Book |
aboutme |
Mostly tired | Profile*: About Me |
dob |
15-06-1979 | Profile*: Date of Birth |
my-custom-field PRO |
Green | The value of any Custom Field attached to the user. Use the name of the desired field, for example: [color] .A lot more custom field data is available - see the Custom Fields section for a full explanation. |
See the User Data section for a full explanation and more details.
Contact Data
Syntax | Example | Description |
---|---|---|
contact:name |
Peter van Westen | The name of the contact. |
contact:id |
4 | The ID of the contact record. |
contact:alias |
peter-van-westen | The alias of the contact. |
contact:image PRO |
![]() |
The image of the contact. See the Images section for a full explanation and more details. |
contact:position |
Great Giant Leader Guy | The contact's position. |
contact:email |
The contact's email address. | |
contact:address |
My Street 123 Suite 4 |
The contact's address. |
contact:city |
Cityville | The contact's city or suburb. |
contact:region , contact:state or contact:county |
Main County | The contact's state or county. |
contact:country |
The Upperlands | The contact's country. |
contact:zipcode , contact:postcode or contact:postal-code |
12345 | The contact's postal/ZIP code. |
contact:phone |
+99-12-345-6789 | The contact's telephone number. |
contact:mobile |
+99-12-345-6789 | The contact's mobile number. |
contact:fax |
+99-12-345-6789 | The contact's fax number. |
contact:website |
https://regularlabs.com | The contact's website. |
[contact:link-website]...[/contact:link-website] |
<a href="https://regularlabs.com">...</a> |
Opening and closing tag to add a link to the contact's website (wraps the content with an a href tag). |
contact:misc |
Tonight?
|
The contact's miscellaneous information. |
contact:form |
(See below) | The email form for the contact. |
See the Contact Data section for a full explanation and more details.
Images PRO
Syntax | Example | Description |
---|---|---|
contact:image |
![]() |
The image of the category attached to the user. |
contact:image:url |
/images/profiles/peter-240.png | The URL of the image of the category attached to the user. |
my-image-field |
The image from a Custom Field of type media . |
See the Images section for a full explanation and more details on the images features. The Pro version of Users Anywhere also has the ability to automatically create resized images (thumbnails) and much more.
Custom Fields PRO
Syntax | Example | Description |
---|---|---|
habitat-area |
Asia |
The rendering of a custom field via its field layout, without the label.
|
habitat-area:text |
Asia | Only the text value of a custom field, without any html markup around it. |
habitat-area:value |
as | The rawvalue of a custom field, without any html markup around it. |
habitat-area:label |
Habitat | The label of a custom field. |
habitat-area:title |
Habitat Area | The title of a custom field. |
habitat-area:name |
habitat-area | The name/alias of a custom field. |
habitat-area:id |
123 | The ID of a custom field. |
habitat-area:type habitat-area:description |
list | The type, description, or any other data attached to the field. It must match the name of the columns available in the database (you can replace the underscores with dashes). |
habitat-area:render_class habitat-area:prefix habitat-area:suffix etc. |
... | Any attribute related to the field "Options". It must match the attribute name in the params or fieldparams database column (you can replace the underscores with dashes). |
Field Groups
Syntax | Description |
---|---|
[fieldgroup:5] |
The full output of a fieldgroup based on the ID |
[fieldgroup:5:title] |
The title of a fieldgroup based on the ID. |
[fieldgroup:5:description] |
The description of a fieldgroup based on the ID. |
[fieldgroup:product-information] |
The full output of a fieldgroup based on the Title, where the Title is "Product Information" |
[fieldgroup:product-information:description] |
The description of a fieldgroup based on the Title, where the Title is "Product Information" |
See the Custom Fields section for a full explanation and more details.
Numbers PRO
In the following examples, let's say we're using Users Anywhere with pagination, to show users from the "Animals" category, which has a total of 75 users. But we're only showing 10 users per page, with an overall limit of 40:
{users usergroup="Customer" limit="40" per-page="10"}...{/users}
Let's say we're looking at the 3rd user returned on the 2nd page (so the 13th user overall). This is what the Numbers output would result into:
Current Page Numbers
The following numbers data tags return the corresponding values for the users displayed on the current page:
Syntax | Example | Description |
---|---|---|
total |
10 | The total number of users returned on the page. This also equals to the count of the last user. |
count |
3 | The number of the current user in the list of users on the page. |
previous |
2 | The number of the previous user on the page. This will return the number of the last user when the current is the first. |
next |
4 | The number of the next user on the page. This will return the number of the first user (1) when the current is the last. |
limit |
40 | The maximum number of users set to be returned. |
offset |
0 | The offset when showing a range of users not starting from the start. |
per-page |
10 | When using pagination, the number of users per page set to be returned. |
pages |
4 | When using pagination, the number of pages generated by the results. |
page |
2 | When using pagination, the number of the current page. |
previous-page |
1 | The number of the previous page. This will return the number of the last page when the current is the first. |
next-page |
3 | The number of the next page. This will return the number of the first page (1) when the current is the last. |
is-current |
false | A true or false value based on whether the current user is the user that contains the plugin tag itself. Equivalent to: {if id = this:id} |
is-first is-last |
false / false | A true or false value based on whether the current user is the first/last in the list of users on the page. |
is-even is-uneven |
false / true | A true or false value based on whether the current user is an even/uneven user in the list of users on the page. |
has-next has-previous |
true / true | A true or false value based on whether there is a next/previous user on the page (so can be false for first/last users). |
every-... |
true | A true or false value based on the number of the user in the list of users. For example every-3 . |
is-...-of-... |
false | A true or false value based on the number of the user in the list of users. For example is-2-of-5 . |
is-first-page is-last-page |
false / false | When using pagination, a true or false value based on whether the current page is the first/last. |
has-next-page has-previous-page |
true / true | When using pagination, a true or false value based on whether there is a next/previous page (so can be false for first/last pages). |
No-Pagination Numbers
The following numbers data tags return the corresponding values before pagination is applied. These will be different from the ones above only if pagination is used:
Syntax | Example | Description |
---|---|---|
total-no-pagination |
40 | The total number of users before pagination is applied. This also equals to the count-no-pagination of the last user. |
count-no-pagination |
13 | The number of the current user in the list of users, regardless of pagination. |
previous-no-pagination |
12 | The number of the previous user regardless of pagination. This will return the number of the last user when the current is the first. |
next-no-pagination |
14 | The number of the next user regardless of pagination. This will return the number of the first user (1) when the current is the last. |
is-first-no-pagination is-last-no-pagination |
false / false | A true or false value based on whether the current user is the first/last in the list of users. |
is-even-no-pagination is-uneven-no-pagination |
false / true | A true or false value based on whether the current user is an even/uneven user in the list of users. |
has-next-no-pagination has-previous-no-pagination |
true / true | A true or false value based on whether there is a next/previous user (so can be false for first/last users). |
No-Limit Numbers
The following numbers data tags return the corresponding values before limit
and offset
are applied:
Syntax | Example | Description |
---|---|---|
total-no-limit |
75 | The total number of users before limit is applied. This also equals to the count-no-limit of the last user. |
count-no-limit |
13 | The number of the current user in the list of users, not considering limit or offset. |
previous-no-limit |
12 | The number of the previous user. This will return the number of the last user when the current is the first. |
next-no-limit |
14 | The number of the next user. This will return the number of the first user (1) when the current is the last. |
is-first-no-limit is-last-no-limit |
false / false | A true or false value based on whether the current user is the first/last in the total list of users. |
is-even-no-limit is-uneven-no-limit |
false / true | A true or false value based on whether the current user is an even/uneven user in the total list of users. |
has-next-no-limit has-previous-no-limit |
true / true | A true or false value based on whether there is a next/previous user (so can be false for first/last users). |
See the Numbers section for a full explanation and more details.
Dynamic Data PRO
You can output at any point, dynamic values and data from a specific user, by using one of the prefixes listed below.
You can follow the user prefixes with any of the Data Types, including user data, category data, user data, and custom field values. See the Data from Specific User section for a full explanation and more details.
Syntax | Description |
---|---|
current:... |
Any user data of the currently logged-in user (visitor of the page). See the User Data section for a full explanation and more details. |
next:... |
Any data type from the next user in the list of users returned by the plugin tag. |
previous:... |
Any data type from the previous user in the list of users returned by the plugin tag. |
first:... |
Any data type from the first user in the list of users returned by the plugin tag. |
last:... |
Any data type from the last user in the list of users returned by the plugin tag. |
1:... 2:... 3:... etc. |
Any data type from a specific user in the list of users returned by the plugin tag. The data name must be prepended with the respective count number of the user. |
input:... |
Any input data from a URL parameter (query string) or form input. See the Input Values section for a full explanation and more details. |
date('today') date('yesterday') date('tomorrow') etc. |
Output a date relative to today, based on your custom date format. See the Relative Dates section for a full explanation and more details. |